TrackStudio Enterprise 3.5
Upgrading from Version 3.2.x

The following topic describes how to update from TrackStudio 3.2.x to TrackStudio 3.5.y.

To update TrackStudio WAR:
  1. Download the latest TrackStudio WAR.
  2. Re-deploy the TrackStudio WAR.
To update TrackStudio SA:
  1. Download the latest TrackStudio SA.
  2. Stop the TrackStudio 3.2.x instance.
  3. Install the TrackStudio 3.5.y into a separate directory.
  4. Configure the new TrackStudio instance using sman.
  5. HSQLDB only: Copy all database files (test.*) from the TrackStudio 3.2.x home directory into the home directory for the new instance.
  6. Copy all files from the TrackStudio 3.2.x upload directory into the Upload directory for the new instance. To determine the upload directory path, see the trackstudio.uploadDir property in the trackstudio.properties file.
  7. Delete the contents of the Index directory. To determine the index directory path, see the trackstudio.indexDir property in the trackstudio.properties file.
  8. Start TrackStudio 3.5.y
  9. Update e-mail templates:
Property 
Value 
Subject 
<${task.getProjectAlias()} | ${addval.reason} | ${addval.taskViewFactory.inEmailText(task).getNumber()}>: ${addval.taskViewFactory.inEmailText(task).getName()} 
Content Type 
HTML 
From 
Submitter 
Reply To 
TrackStudio 
E-mail Body 
Copy/paste from templates/common_html.ftl 
Property 
Value 
Subject 
<${task.getProjectAlias()} | ${addval.reason} | ${addval.taskViewFactory.inEmailText(task).getNumber()}>: ${addval.taskViewFactory.inEmailText(task).getName()} 
Content Type 
text 
From 
Submitter 
Reply To 
TrackStudio 
E-mail Body 
Copy/paste from templates/common_text.ftl 
  • Upgrading from version 3.2.x do not require a database upgrade.
  • The SA and WAR versions use the same database scheme and differ only in the distributed components – no special actions are required to transfer the data between the WAR and SA versions.
  • If you are using the default HSQLDB DBMS, your database files look like tsdb.lck, tsdb.log, tsdb.properties and tsdb.script. Do not delete them.
  • Both the Upload and Index directories can be specified in a flexible manner in trackstudio.* configuration files, to set them outside the TrackStudio instance directory. This has implications when upgrading.