Upgrade an existing version

Supported versions for upgrades

Minimum version for direct upgrade is Qlik Alerting October 2021.

Upgrade steps

Do the following:

1. Backup the MongoDB database named qlikalerting. For details, see Backup and restore the MongoDB database.
2. Backup any SSL certificates. If you have added these they will be found in the C:\Program Files/Qlik Alerting/config/certificates folder.

3. Download the Qlik Alerting installer from Product Downloads.

   See: Downloading installation files

4. Right-click on the download and select Run as administrator.

5. Follow the steps to accept license agreement and install.

   The install process will recognize the existing qlikalerting database and perform any database migration tasks required.

6. Once complete, check that all Qlik Alerting services are running, there are 10 services in this version.
7. In your browser, navigate to https://localhost:4552 to check that everything is working.
   • If you need to replace the SSL certificates, follow the instructions in Using trusted SSL certificates with Qlik Alerting.
   • If you need to reset the ports to nonstandard (i.e. not 4551/4552) ports, then follow the instructions in Changing the ports for Qlik Alerting web access.

Additional information for upgrades from versions up to and including November 2020

Releases from February 2021 have removed the requirement for the Redis database as MongoDB is now used for the activities that were previously managed in Redis. If you upgrade with the default settings the upgraded version of Qlik Alerting will automatically use MongoDB and Redis can be removed.

Remove Redis from the Qlik Alerting server (based on the default install configuration from versions to November 2020)

Do the following:

1. Remove the Windows service for Redis.

   1. Open a new command window with run as administrator privileges on the Qlik Alerting server, and run the following commands.

   2. Stop the Redis service:

      net stop redis

   3. Delete the Redis service.

      sc delete redis

2. You can now delete the c:\redis folder.

Troubleshooting

The upgrade installs fully but not all of the services are visible in the Windows Services.

We have identified some unusual instances where the ports are not released which blocks the setup of the new service. We have included a quick utility to support the clearing of the ports. Do the following:

1. Navigate to the C:\Program Files\Qlik Alerting\setup\port-clearing folder.
2. Right click on the portclearall.bat file and select run as administrator. If you have changed any of the standard ports you should make the changes to this .bat file directly.
   The cmd window will return information for each port, when the port was locked it will show a success message, when the port is clear already it will return a clear line.
3. Repeat step 2 until all ports show with blank line results.
4. Re-run the installer which will now reinstall the services correctly.