Skip to main content

Troubleshooting CxSAST Engine Pack installations

General guidelines

Warning

If you install the Engine Pack in a distributed environment, for example on the CxEngine host, you must also run the Engine Pack setup on the CxManager host to update the SQL database.

For details, see Running the Engine Pack Installation on a CxManager Host.

Notice

If you decide to uninstall CxSAST after you have installed a CxSAST Engine Pack on top of the CxSAST installation, you must first uninstall the Engine Pack, before uninstalling CxSAST.

CxSAST database reverts back to GA version

In some scenarios, when updating CxSAST components with Engine Packs, the CxSAST database might lose the contents of the installed Hotfixes and revert back to the GA version. This will result in reduced performance for the CxSAST installation.

Scenario 1

In a CxSAST v 9.4.0 distributed environment installation, a CxManager (called CxManager1) is located on a server with the CxSAST database. The latest Hotfix is installed on this machine so that the database is upgraded to 9.4.0 with the additional Hotfix. Afterwards, the Engine Pack 9.4.2 is installed on this server, so the database is upgraded to 9.4.2, which includes the Hotfix.

It is later decided to add to this distributed CxSAST environment another CxManager (called CxManager2) on another server with an Active MQ. So CxManager2 is added, but when CxManager2 is connected to CxManager1’s CxSAST database, the CxSAST database reverts back to version 9.4.0 and loses the Hotfix database upgrades!

To resolve this issue, on CxManager2 (the new CxManager) do the following:

  1. Install the 9.4.2 Engine Pack database on the CxManager2 to update the database.

  2. Execute the Hotfix script on the Checkmarx installation drive on the CxManager1 server with the database.

Scenario 2

In a CxSAST v 9.4.0 distributed environment installation, a CxManager is located on a server with the CxSAST database. The latest Hotfix is installed on this machine so that the database is upgraded to 9.4.0 with the additional Hotfix. Afterwards, the Engine Pack 9.4.2 is installed on this server, so the database is upgraded to 9.4.2, which includes the Hotfix.

It is later decided to add to the CxManager an Active MQ, using the Modify option of the Engine Pack installation. The CxSAST database reverts back to version 9.4.0 and loses the Hotfix database upgrades!

To resolve this issue, on CxManager do the following:

  1. Uninstall the 9.4.2 Engine Pack using the Control Panel.

  2. Install the 9.4.2 Engine Pack database on the CxManager server.

  3. Execute the Hotfix script on the Checkmarx installation drive on the CxManager server.