Skip to main content

Manual Engine Pack Rollback

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.

The following steps can perform the rollback manually. For information, see how to use PowerShell scripts to roll back Engine Pack, see Automated Engine Pack Rollback Process using PowerShell.

For an Engine Pack installation with one of the following configurations:

  • Only CxEngine

  • Only CxAudit

  • Only CxEngine and CxAudit

Rollback to CxSAST 9.4.0 by doing the following:

  1. Run CxSetup.EnginePack.exe and click UNINSTALL. The CxEngine and CxAudit components will be completely removed from the host. Close the Engine Pack Setup.

  2. Run CxSetup.exe Start and click MODIFY. Follow the instructions in the Setup wizard to install the CxEngine or CxAudit or both.

  3. Restore the env vars (environment variables) and the CxAudit configuration files from the backup that was performed before upgrading to the Engine Pack. Restore this data by deleting the existing configuration files and env vars and by replacing them with the original files from the backup files.

  4. If there are more than one hosts with the CxEngine and CxAudit components, repeat steps 1 to 3 for each of these hosts.

  5. To rollback the database, run the ORM utility on one of the CxManager hosts. Even if there are multiple CxManager instances installed on more than one host, it is only necessary to run the utility on one CxManager host. Running the utility will revert the database back to the GA version.

For an Engine Pack installation with one of the following configurations:

  • A Centralized (a.k.a All-in-One) installation without CxAudit

  • A Centralized installation without CxEngine

  • A Centralized installation without CxEngine and CxAudit

Rollback to CxSAST 9.4.0 by doing the following:

  1. Backup the list of installed application Hotfixes (HFs) from the registry to a .reg file. Backup only the “Hotfix” values, in case it’s other than 0. In addition, exclude the CxAudit, CxEngine Agent and CxEngine Services).

  2. Backup the Checkmarx application root folder, excluding the Audit and Engine folders.

  3. Run CxSetup.EnginePack.exe and click UNINSTALL. The CxEngine and CxAudit components will be completely removed from the host. Close the Engine Pack Setup.

  4. Run CxSetup.exe Start and click MODIFY. Follow the instructions in the Setup wizard to install the CxEngine or CxAudit or both. This will run ORM in the background.

  5. Restore the Checkmarx application folder, by replacing all the files of the Checkmarx application root folder. Filter out the CxAudit and CxEngine folders since they are no longer relevant.

  6. Restore the “Hotfix“ values for all the components in Registry.

  7. Restore the env vars (environment variables) and the CxAudit configuration files from the backup that was performed before upgrading to the Engine Pack. Restore this data by deleting the existing configuration files and env vars and by replacing them with the original files from the backup files.