Upgrading from Version 3.0.x

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

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

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.x until possible problems with TrackStudio 3.1.y are solved.

2. Stop the TrackStudio 3.0.x 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.y to a separate directory.

5. Upgrade database:

TrackStudio SA: Run Server Manager from TrackStudio 3.1.y, 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.

7. Ensure that you set the correct Upload directory path.

8. Clean the Index directory content.

9. Start TrackStudio 3.1.y

10. Login as root.

11. 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 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.

Topic path: Installation Guide > TrackStudio Upgrading > Upgrading from Version 3.0.x

Contents | Index