Upgrading the Controller

To upgrade your OpenText ScanCentral SASTController:

(Recommended) Allow all jobs to finish.
Place the Controller in maintenance mode so that sensors complete all currently running scans.
Shut down the Controller.
Back up the existing Controller directories.
Install the new Controller in a different location from the existing Controller directories.
If you plan to install the Controller as a Windows or Linux service, make sure that you install the Controller in a directory where the local service (Windows) or the user or group using the service (Linux) has access.
If your existing config.properties file has been modified, you must manually apply any changes you made to the new config.properties file.
You cannot simply copy the existing config.properties file.
If (and only if) you are upgrading your Controller from version 23.1.x to version 25.4.0, run the migration script as follows:
1. Open a command prompt and go to the new 25.4.0Controller installation directory.
2. At the command prompt, enter cd db-migrate.
3. Identify the cloudCtrlDb and Controller directories for the existing OpenText ScanCentral SAST version. In the following example, the existing Controller is installed on a Windows system in the C:\scancentral23.1.0 directory:
```
C:\scancentral23.1.0\tomcat\cloudCtrlDb
C:\scancentral23.1.0\tomcat\webapps\scancentral-ctrl
```
4. Run the following command.
  This command example includes the example directories shown in the preceding step.
```
migrate C:\scancentral23.1.0\tomcat\cloudCtrlDb C:\scancentral23.1.0\tomcat\webapps\scancentral-ctrl
```
  The migration script generates the cloudCtrlDb directory in the current working directory.
Go to the jobFiles and cloudCtrlDb directories of the existing Controller, and then copy them to the corresponding directories for the new Controller.
If you migrated the database (step 6), make sure that you copy the migrated database (cloudCtrlDb directory) to the new Controller installation directory.
The process owner must have write permission for the database file in the cloudCtrlDb directory. If you run the OpenText ScanCentral SAST Controller as a Windows service, make sure that the LOCAL SERVICE account has write permission to the database file.
To change these directories, edit the job_file_dir and db_dir properties in the config.properties file (see Configuring the Controller).
Start the new Controller.
The database is automatically migrated.
(Optional) Remove the Controller directories for the previous version.

See also

Installing the Controller

Upgrading OpenText ScanCentral SAST components

Upgrading sensors

Enabling automatic updates of clients and sensors