Upgrading the ScanCentral SAST Controller

The following procedure describes how to upgrade the Controller.

Caution! Before you upgrade the Controller, you must first download and configure a Java Runtime Environment (JRE). For information about supported JRE versions, see the Micro Focus Fortify Software System Requirements guide. For information about how to download and configure JRE, see the Oracle documentation for the supported JRE version.

To upgrade your ScanCentral SAST ControllerClosed Server that receives the Fortify Static Code Analyzer mobile build sessions and scan instructions from the ScanCentral SAST clients (or project packages with translation and scan instructions), routes the information to ScanCentral SAST sensors, and (optionally) uploads scan results (FPR files) to Fortify Software Security Center.:

  1. Go to the Micro Focus Software Licenses and Downloads (SLD) portal (https://sld.microfocus.com) and download the Fortify_ScanCentral_Controller_<version>_x64.zip file.

    Note: For detailed instructions on how to download Micro Focus Software, see https://www.brainshark.com/mfLD/vu?pi=zFszsRA7ezW1H3z0&nodesktopflash=1.

  2. (Recommended) Allow all jobs to finish.

    Note: If you do not allow all jobs to finish before you shut down the Controller, some jobs fail after the upgrade, and the failure may not be evident for some time. (See the worker_inactive_delay configuration parameter in the <new_controller_dir>/tomcat/webapps/scancentral-ctrl/WEB-INF/classes/config.properties file.)

  3. Shut down the Controller.

  4. Install the new Controller. (For information, see Installing the Controller.)

  5. If your existing config.properties file has been modified, you must merge it with the new config.properties file. (You cannot simply copy the existing config.properties file.)

  6. If (and only if) you are upgrading Controller from a 22.1.x or earlier version to version 22.2.0, run the migration script as follows:

    1. Extract the contents of the Fortify_ScanCentral_Controller_<version>_x64.zip file.

    2. Open a command prompt, and go to the db-migrate directory.

    3. Identify the cloudCtrlDb and Controller directories for the older (existing) Fortify ScanCentral SAST version.

      Example:

      C:/scancentral<version>/tomcat/cloudCtrlDb
      C:/scancentral<version>/tomcat/webapps/scancentral-ctrl

  7. If you are upgrading a 22.1.x or earlier version Controller to version 22.2.x, run the following command. (This command includes the example directories shown in the preceding step.)

    migrate C:/scancentral22.1/tomcat/cloudCtrlDb C:/scancentral22.1/tomcat/webapps/scancentral-ctrl

    The cloudCtrlDb directory is generated in the current working directory.

  8. Navigate to the jobFiles and cloudCtrlDb directories of the existing Controller, and then copy these to the new Controller. (If you used the preceding step to migrate the database, make sure that you use that migrated database rather than the unmigrated database.)

    Note: To change these directories, edit the config.properties file.

  9. Start the new Controller. (The database is automatically migrated.)

See Also

About Upgrading ScanCentral SAST Components

Upgrading ScanCentral SAST Sensors

Enabling and Disabling Auto-Updates of Clients and Sensors