ISOWARE update guide

Version 17.0.0

Contents

• Updating third-party software
• Updating to version 17.0.0
  • Backing up the database
  • Installing a new .war file
  • Updating the database
  • Entering license information
  • Uninstalling old .war file
• I need help
• Appendix I - Updating Apache Tomcat
• Appendix II - Updating PostGreSQL

Update to version 17.0.0

In the following sections, it is assumed that Apache Tomcat is installed on the server you are logging on to, that Apache Tomcat is set to run on port 8080, and that the ISOWARE application is deployed with the name ISOWARE. If this is not the case, the address used (http://localhost:8080/ISOWARE) must be replaced with http://server:port/application, where server is the network name or IP address of the server. the server used, port is the port that Apache Tomcat listens on and application is the chosen name for the ISOWARE application, e.g. http://server01:8080/qualitymanagement. If Apache Tomcat is set to listen on port 80, the :port part can be omitted, e.g. http://server01/qualitymanagement.

If, as in the example above, you want the application to be called /qualitymanagement instead of /ISOWARE, you must rename the downloaded .war file to qualitymanagement##1700.war before deploying it on the server. server.

The following steps must be performed in the update:

1. Backup the database
2. Install new .war file
3. Update the database
4. Enter license information
5. Uninstall old .war file

Please perform the steps in the above order.

1. Backup the database

It is highly recommended that you take a backup of the existing database, as it allows you to roll back the system to the original configuration.

Here's how:

1. Log on to the server where PostGreSQL is installed with administrator rights
2. Open the PGAdmin 4 program
   
   
   
   
3. Enter the Master password
   
   
   
   
4. Click on PostGreSQL 17 in the menu on the left (under Servers)
   
   
   
   
5. Enter the password for the database server and click OK
   
   
   
   
6. Right-click on the database – isoware (or any other chosen name) – and select Backup
   
   
   
   
7. Select a location for the backup and click OK
   
   
8. Wait for the backup to complete.
9. Close PGAdmin 4

2. Installing a new .war file

ISOWARE is updated by deploying a new .war (Web Archive) file on the Apache Tomcat web server.

Here's how:

1. Log on to the server where Apache Tomcat is installed with administrator rights
2. Click here to download the new .war file and save it somewhere you can easily find it again
3. Open a browser and go to to http://localhost:8080/manager/html
   
   
   
   
4. Fill in your username and password and click OK
   
   
   
   
5. Scroll down to the bottom of the page
   
   
   
   
6. For Select WAR file to upload, select Browse
7. Enter the path to the .war file (the one you downloaded earlier) and click OK OK
8. Click Deploy
9. Wait until the file is uploaded and you receive a message that the upload was successful
10. The Tomcat server has a default upload limit of 50 MB. If you receive an error, it may be because this upload limit has been exceeded, as the ISOWARE .war file is larger than 50 MB. In particular In this case, you must perform steps 11, 12 and 13 and then try to upload the .war file again
11. Open the Manager app's web.xml in Notepad and find the section marked in the image below. On a standard installation, the file is located in this folder:
    C:\Program Files\Apache Software Foundation\Tomcat 11.0\webapps\manager\WEB-INF
    
    
    
    
12. Edit the section so that it looks like below and save the changes.
    
    
    
    
13. Then restart the Apache Tomcat service and start again from point 1

3. Updating the database

When you have finished deploying the new .war file, an update of the ISOWARE database must be made.

Here's how:

1. Open a browser and go to to http://localhost:8080/ISOWARE/Setup
   
   
   
   
2. Enter the username and password for the database server and click Log in
   
   
   
   
3. Click the Update database button and wait a moment while the system works
4. The update is completed by displaying a list of completed tasks. If one of the tasks cannot be completed, the entire update is rolled back. Please contact ISOWARE if the database update fails
   
   
   
   
5. Click Finish to complete the update

4. Entering license information

In order to use ISOWARE after an update, if this has not already been done in connection with previous updates, you must enter license information. The license information is received from ISOWARE A/S.

The message License check failed appears when users try to log in if the license is not valid for the ISOWARE version that you have installed.

Here's how:

1. Log in ISOWARE as System Administrator (sysadm)
   
   
   
   
2. Click on Settings at the top of the menu on the left
   
   
   
   
3. Click on License in the System folder
   
   
   
   
4. If no license information has been previously specified, click on Activate License
   If license information has been previously specified, click on button Reactivate license
   
   
   
   
5. Enter the username and license code that you received from ISOWARE and click Activate

5. Uninstalling old .war file

The old version of ISOWARE is removed by undeploying the old .war file on the Apache Tomcat web server.

Here's how:

1. Log in to the server where Apache Tomcat is installed with administrator rights
2. Open a browser and go to to http://localhost:8080/manager/html
   
   
   
   
3. Fill in your username and password and click OK
   
   
   
   
4. Find the version of ISOWARE in the list that you want to uninstall. You can see the version in Version
5. Click Undeploy next to the version that you want to uninstall

Appendix I - Updating Apache Tomcat

1. Uninstall the existing Apache Tomcat installation
   
   
   
   
2. Click on Uninstall
   
   
   
   
3. Answer No to remove all files
   
   
   
   
4. Click on Close to exit
5. Click here to download Apache Tomcat
6. Run the downloaded exe file
   
   
   
   
7. Click on Next
   
   
   
   
8. Click on I Agree
   
   
   
   
9. Click on Next
   
   
   
   
10. If you want to change the port that Tomcat listens on, you must change it in the http/1.1 Connector Port field. The default port is 8080.
    Enter a user name and password of your choice in the User Name and Password fields. The user name and password will be used when ISOWARE is later installed/updated.
    Click Next
    
    
    
    
11. Here you must tell Tomcat where your Java distribution is installed. The field will, in most cases, be filled in automatically.
    Click Next
    
    
    
    
12. Click Browse if you want to change the location of the Tomcat folder.
    Click Install
    
    
    
    
13. Click Finish to complete the installation
14. Apache Tomcat is now updated to the recommended version and you now only need to copy your existing ISOWARE installation to the new Tomcat server.
15. Open a file explorer and open the webapps folder in the old Tomcat installation. On a standard installation it is located here:
    C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps
    
    
    
    
16. Copy the folder where your existing ISOWARE installation is located, in this case it is called ISOWARE##1602
17. Open the webapps folder in the new Tomcat installation, on a standard installation it is located here: C:\Program Files\Apache Software Foundation\Tomcat 11.0\webapps
    Paste the copied ISOWARE folder into the webapps folder
    
    
    
    
18. Wait a few minutes and then your existing ISOWARE installation will be installed on your computer. the new Tomcat server.