TrackStudio Enterprise 3.1
Upgrading from Version 3.0.x

This topic describes how to update from TrackStudio 3.0.x.

To upgrade the system from TrackStudio 3.0.x to TrackStudio 3.1.x:

1) Backup your database. You can do this through the DBMS, for example, by using the imp/exp utility in ORACLE. The backup will allow you to use version 3.0 until possible problems with TrackStudio 3.1 are solved. 

2) Stop the TrackStudio 3.0 instance. 

3) Un-install Windows services if used:

>Wrapper.exe -r etc/hwrapper.conf
>Wrapper.exe -r etc/jwrapper.conf

4) Install the TrackStudio 3.1 to a separate directory. 

5) Upgrade database:

  • TrackStudio SA: Run Server Manager from TrackStudio 3.1, go to the Database Management tab, and press the Upgrade Database button.
  • TrackStudio WAR: Execute the update script for your DBMS.

6) Configure TrackStudio e-mail notification, e-mail submission and LDAP properties. Ensure that you set the correct upload directory path. 

7) Start TrackStudio 3.1 

8) Login as root 

9) Update e-mail templates:

Property 
Value 
Subject 
<${task.getProjectAlias()}>: ${addval.taskViewFactory.inEmailText(task).getName()} ${addval.taskViewFactory.inEmailText(task).getNumber()} 
Content Type 
HTML 
From 
Submitter 
Reply To 
TrackStudio 
E-Mail Body 
Copy/paste from templates/common_html.ftl 
Property 
Value 
Subject 
<${task.getProjectAlias()}>: ${addval.taskViewFactory.inEmailText(task).getName()} ${addval.taskViewFactory.inEmailText(task).getNumber()} 
Content Type 
text 
From 
Submitter 
Reply To 
TrackStudio 
E-Maill Body 
Copy/paste from templates/common_text.ftl 
Possible problems after upgrading the database.
  • During the first launch TrackStudio re-indexes the database and converts task/messages descriptions to HTML. It can take about several minutes for each 1000 tasks and messages.
  • XML Import/Export allows you to transfer the data of TrackStudio 3.1 between various DB, but it cannot be used to transfer data between various versions of TrackStudio.
  • If errors or problems occur while upgrading the DB, you should contact us and continue using TrackStudio 3.0 until the problem is resolved.
Copyright (c) 2005. All rights reserved.