Upgrade iQSonar in a multiple-scan-engine scenario

Owned by Former user (Deleted)
Last updated: Aug 31, 2018

When iQSonar is deployed in an environment with multiple scan engines sharing the same back-end database, the upgrade process is slightly more involved than simply running the installer once. This document goes through a step-by-step process to update your iQSonar environment.

Step-by-step guide

  1. Pause all running projects.

  2. Once there are no active jobs showing on the system activity → performance page, then Make a backup of your database.
    The default name for the database is iQSonarSE. If you are unsure which database your installed version of iQSonar is using this article will help you find it.

  3. It is best practice to archive your log files so that any new logs created with the new version will be separate from logs created by the previous version. This should also help avoid running out of space.

  4. You need to stop the iQSonar service on all scan engines.
    a) Log in to the Windows host each scan engine is running on.
    b) Go to Administrative Tools > Services and find the service called "iQSonar ScanEngine".
    You need to stop this service. Some releases took an excessively long time to end the process - if the service does not stop you can use Task Manager to end the process.

  5. Go to the server with the scan engine that also has the user interface installed.
    Make a backup of your iqsonar.key file, and your iQuate.iQSonar.ScanEngine.exe.config files. These are found in the folder "C:\Program Files\iQuate\iQSonar ScanEngine 4.0\bin" in a default installation.

  6. Run the installer to upgrade this scan engine. The installer will restart the upgraded scan engine service.  Verify that you can log in.
    Wait until the UI displays the upgraded version number for the scan engine in the Locations tab.

  7. For each additional scan engine in turn
    a) Log in to the scan engine server
    b) Backup the iqsonar.key and iQuate.iQSonar.ScanEngine.exe.config files.
    c) Run the installer to upgrade this instance.
    d) Verify that the user interface shows the scan engine as upgraded in the Locations > Detail screen 

  8. You can now unpause any projects which you paused in step one.