Upgrade the application

Upgrading using the installer

Twproject once per week check if there are new updates available and, in case it founds one, it notifies the administrator with an e-mail.

The installer contains a complete upgrade procedure. Depending on your current version, the upgrade process may change the database schema; you should backup the database before upgrade your instance.

Stop the running instance service and then run the new installer.

In case of schema changes, consider that also minor version contains database changes (5.x->6.x but also 6.x -> 6.y, but not 6.0.x ->6.0.y), the upgrade process may require a few minutes (up to 20 if you are upgrading from version < 5.3)

Consider that every mayor version requires a new license: if you have a TW4 license you cannot use it on version 5; the same if you have a TW5 license that cannot be used on version 6. Contact us if you need to upgrade a license.

Upgrading by hand

If you installed Twproject by hand you must upgrade it by hand as well.

You must consider that:
Twproject 4 run on Java JDK 5
Twproject 5 run on Java JDK 6
Twproject 6 run on Java JDK 7 (Tomcat 7 required)

In order to upgrade by hand:

pre-requisite are to verify you are already using the correct JDK

1) make a complete backup of your application and data
2) stop the application server (Tomcat or other)
3) delete the directory WEB-INF/lib
4) delete the directory WEB-INF/classes  (if you added something there, save it)
5) extract the zip or tar.gz or rpm files, merging with the existing files. Take care that the pre-existing folders must be merged with the new ones, which is default on Windows, but not on Linuxes and OSXs.

The only files that should not be replaced, eventually synchronized, for an upgrade are:
· [ROOT]/WEB-INF/lic.properties
· [ROOT]/WEB-INF/config.properties
· [ROOT]/commons/settings/global.properties

5) remove Tomcat “work” directory
6) restart the application server

The application, on restart after upgrade, does also a database upgrade.

 

 Upgrading from version 4

Twproject version 4 used an old version of database configuration.
In order to upgrade, just proceed with the installer or by hand, then you need to edit
[ROOT]/WEB-INF/config.properties
and change the “dialect” and “driver” properties as described on the “Hand/custom install” page. Read carefully, the “dialect” property, differences are subtle.

Start Teamwork 6 service, it will update the database schema an data.

Consider that Twproject 4 and Twproject 6 are really different and the upgrade process may require up to 30 minutes.