Skip to main content

Installing a CxSAST Engine Pack in a Centralized Environment

To install a CxSAST Engine Pack in a centralized (a.k.a. All-in-One) environment do the following:

  1. Download the CxSAST Engine Pack installation package and run CxSetup.EnginePack. The setup appears.

    6436167297.png
  2. Click <INSTALLATION WIZARD>. The Checkmarx License Agreement window is displayed.

    6436167294.png
  3. Review and accept the license agreement by checking I accept the terms in the License Agreement.

  4. Click <NEXT> to continue. The Installation Options window is displayed.

    6436167327.png
  5. Since the CxEngine, CxAudit, and CxManager components are already installed, the screen displays check marks that cannot be edited, indicating that running the Engine Pack installation will update these components. The locations are pre-selected to match the locations of the previously installed components.

  6. Click <NEXT>.

  7. The Prerequisites Check window is displayed, indicating the status of the required third-party components.

    6436167324.png
  8. If all required components are installed, click <NEXT> to continue. The CxSAST SQL Server Configuration window is displayed.

    6436167321.png
  9. Select the server from the SQL Server Instance list. If using a non-standard database port, provide the server name with a comma followed by the port number (e.g., LOCALHOST\SQLEXPRESS,25).

    NOTE:For upgrades, previously defined SQL Server instance settings are loaded from the existing configuration and cannot be changed.

  10. For CxSAST, define a connection to the installed SQL Server or to any other SQL server on your network, by selecting one of the following:

    o Connect using Integrated Windows Authentication (login not required).

    o Connect using SQL Server Authentication (provide SQL user name and password for login with SA permissions).

  11. Click <Test Connection>. A message appears that the connection was successful.

  12. Click <OK>, and then click <NEXT> to continue. If you are installing the Engine, you are now asked to define your service account settings.

    NOTE: Version 9.4 introduces the possibility to select the service account with which the CxSAST related services are going to run. In previous versions, these services have been running with the Network Service account by default.

    6436167318.png
  13. Select the service account on which the CxSAST related services are going to run:

    o Network Service account (default)

    o This account: A dedicated account that you may have added to serve your CxSAST application. Enter the user credentials to enable CxSAST to access this account.

    The example below illustrates the services associated with the Network Service account.

    6436167315.png
  14. Click <Test User Account> to verify and test this account. If successful, <NEXT> is enabled (turns green) and you can continue the installation.

  15. Click <NEXT>. The Engine Configuration window is displayed.

    6436167312.png
  16. If you check Enable TLS, the TLS flag is enabled and additional manual configuration is required.

  17. Import the CxEngine configuration from the CxManager by doing the following:

    1. Generate the Engine Configuration JSON file using the Engine Configuration Tool batch file. In centralized installations the batch file tool is located on the host at: < installation folder >\Checkmarx\Tools\Engine Configuration Exporter\EngineConfigExporter.bat

      In distributed installations, the tool is located on the CxManager host at the same location.

      The batch file tool must be Run as administrator.

    2. Click Import Engine Configuration, and select the generated Engine Configuration JSON file located at < installation folder >

      \Checkmarx\Tools\Engine Configuration Exporter\Output\engineConfiguration.json When the port is available and all the settings in Engine Configuration screen are populated, the NEXT button is enabled (turns green).

    6436167309.png
  18. Click <NEXT>. The Setup Summary appears. It indicates the installation of the new engine.

    6436167306.png
  19. Click <INSTALL> to continue. The Installation in Progress window is displayed and the application is installed and configured.

    6436167303.png

    NOTE 1: Once the installation is complete, the Installation Completed Successfully window is displayed.

    NOTE 2: If the installation fails, the "Setup Failed" message is displayed. For more information, refer to the installation logs. If you need further assistance, please open a support ticket.

    6436167300.png