Upgrade from version 3.5

For TrackStudio Standalone:

  1. Download the latest TrackStudio Standalone
  2. Stop TrackStudio
  3. Install downloaded TrackStudio Standalone in separate directory.
  4. Configure new TrackStudio instance using Server Manager (sman).
  5. If you using HSQLDB, copy all database files (tsdb.*) from old instance into new one.
  6. Copy all files from your UPLOAD directory into new one. See trackstudio.uploadDir in trackstudio.properties to locate upload directory.
  7. Remove files containing in index directory, but not the directory itself. See trackstudio.indexDir property in your trackstudio.properties file to locate index directory.
  8. Update your database with Server Manager or SQL update files.
  9. Start TrackStudio. System will update data in you database on first run and saves scripts, triggers and e-mail templates in etc/plugins directory.
  10. Stop TrackStudio.
  11. You should fix you e-mail templates in etc/plugins/email directory manually or use some of our default templates.
  12. Start TrackStudio again after that.

For TrackStudio WAR:

  1. Download the latest TrackStudio WAR.
  2. Stop TrackStudio
  3. Replace old TrackStudio WAR with new one
  4. In your trackstudio.properties file insert following
    trackstudio.reportBugsTo
    
    ## Time constants
    
    trackstudio.hoursInDay 8
    trackstudio.daysInWeek 5
    trackstudio.daysInMonth 22
    trackstudio.hoursInYear 2000
    trackstudio.monthsInYear 12
    
    ## Maximum number of items per tree level
    
    trackstudio.maxTreeItems 100
    
    ## DecimalFormat for custom-float
    
    trackstudio.decimalFormatUdfFloat 7
    
    ## Use compress html 
    
    trackstudio.compressHTML yes
    
  5. Replace trackstudio.adapter.properties file with same from new WAR
  6. Save current DBMS connection settings from trackstudio.hibernate.properties in some place. (Current settings are located in the end of properties file
  7. Replace your trackstudio.hibernate.properties file with new one from WAR.
  8. Then insert DBMS connection strings in this properties file and comment others
  9. Remove files containing in index directory, but not the directory itself. See trackstudio.indexDir property in your trackstudio.properties file to locate index directory.
  10. Update your database with SQL update files.
  11. Start TrackStudio. System will update data in you database on first run and saves scripts, triggers and e-mail templates in etc/plugins directory.
  12. Stop TrackStudio.
  13. You should fix you e-mail templates in etc/plugins/email directory manually or use some of our default templates.
  14. Start TrackStudio again after that.

Notes

  • Standalone and WAR versions are totally compatible. The difference is only in supplied components.
  • If you use HSQLDB, do not delete tsdb.lck, tsdb.log, tsdb.properties and tsdb.script. files
  • Directories with indices and attached files can be saved anywhere, but they just need to be mentioned in respective entries in trackstudio.properties.