2.2.6 quilliup pre-steps version upgrade (Linux)

This manual will guide you through the steps that should be performed before starting the version upgrade process on the Linux server.

First, please refer to the quilliup prerequisites manual and make sure that your server settings are up to date: quilliup Prerequisites.

Follow the next steps:

1. Java version should be at least 1.8.

2. Tomcat version should be at least 8.0.53, and not upper than 9.

Note: in order to check the current Java & Tomcat versions, follow the next steps:

- Go to the bin folder under the current quilliup installetion folder:

cd opt/tomcat/bin

- Run the following command:

./version.sh

Output for example:

Note:

• Upgrading quilliup to version 2.8.0 or higher requires Tomcat 9 and Java 11.
• Upgrading quilliup to version 2.9.0 or higher requires Tomcat 10 and Java 21.
• You can download both Java & Tomcat installations by following the relevant How to install Java & Tomcat in Linux manual.

3. It is highly advised to implement quilliup server snapshot.

4. Make sure that current quilliup UI is available and works properly.

5. Make sure to download latest *.war file to current quilliup server.

6. The folder containing quilliup execution's, needs to be copied across all environments.

The folder's path can be found through the quilliup UI, in the Administration module:

"System Admin -> System Settings -> General Settings -> System Properties", field "Test result location".

7. Notify all the quilliup users that quilliup UI will be inaccessible during the upgrade process.

8. Back up the current ROOT folder (usually “..\opt\tomcat\webapps”) in another location and save the folder with a different name, for example: "ROOT_backup_version_number".

9. Make sure you have full permission for Apache Tomcat's installation folder in quilliup server.

10. If using Active Directory mode, you need to make sure that all the connection details are correct,  available, and properly saved (current details usually are saved in the "...\opt\tomcat\webapps\ROOT\WEB-INF\web.xml" file).

12. Make sure that quilliup ports are available.

Once all these steps are done, please update quilliup support team by the email/ticket communication so we can be sure that we can proceed properly.