Performing an update

This is how you update an existing on-premises installation. The procedure is the same on all platforms: download the update package → stop the Tomcat → run the deploy script → start the Tomcat → check the version. Always check the version-specific update notes beforehand.

Before every update: create a backup. Only one .war file may ever reside in the projectfacts directory. A downgrade to an older version is not permitted and can cause the system to stop starting.

Obtaining the update package

A teamspace-classic account is required to install the current version. If you do not yet have one, contact us.

1. Log in at teamspace-classic.de with your login details.
2. Go to the Files and navigate to » Main folder → Current version → READ THE UPDATE NOTES! «.
3. First read the update notes and the »Notice board« – it states whether minor adjustments are needed before a larger version jump.
4. Download the projectfacts-x.x.xx.war.

Performing the update

Linux

1. Copy the update into the /srv/projectfacts directory.
2. Stop the Tomcat and check that it has really stopped (systemctl stop tomcat10).
3. Observe the notice board and the update notes.
4. Run the deploy script:

   ./deploy-war.sh

5. Start the Tomcat. It may take a moment until the system is reachable again.
6. Log in and check the version number via the »(i)« button in the sidebar.

Windows

1. Copy the update into the C:\projectfacts directory.
2. Stop the Tomcat service and check that it has stopped.
3. Observe the notice board and the update notes.
4. Run the deploy script with administrator rights. First check the paths in the deploy script.
5. Start the Tomcat service. It may take a moment until the system is reachable again.
6. Log in and check the version number via the »(i)« button in the sidebar.

In addition, you can check in the projectfacts.log whether the update was successful. After the update, remove the .war file from the projectfacts directory. For a large version jump, please contact us.

Subscribing to update notifications

So that you are informed about new versions, you can watch the “Current version” folder in teamspace-classic:

1. Log in to teamspace-classic and click »Files«.
2. Select the »Current version« folder (via the rights selection box).
3. Open the dropdown menu, choose »Watch« and click »Action«.
4. Click »Overview« and select »Customise overview« on the left.
5. In the »Change report«, select the »Sending interval« and click »Save«.

As soon as a new version is placed in the folder, you receive an email.

Common questions & needs

Related topics

• Version-specific update notes Installation Reference
• Installing teamspace on Linux Installation Configuration
• Installing teamspace on Windows Installation Configuration