Skip to main content

Changing the Server Name, IP Address or Port for Checkmarx Components

Additional components have been introduced to CxSAST (v9.0) that include Access Control, Management & Orchestration, and ActiveMQ. The definition values for these components are saved in the database (CxDB) as {Protocol}://{FQDN}:{Port}. Fully Qualified Domain Name (FQDN) is the complete domain name for the host and consists of the hostname and the domain name, for example http://mqserver.company.com:5555. If you want to rename the server, change the IP address or the port, you have to change the key value definitions in the relevant database tables.

Notice

Starting with Version 9.4, CxSAST can resolve IP addresses in IPv6 format for all URLs.

Changing the Server Name, IP Address or Port

Changing the server name, the IP address or ports for Checkmarx components can be performed via the relevant database table and then through the Web Portal. These steps can be performed manually for each server:

1. Insert the new server definitions into the Domain Name System (DNS).

2. Open MS SQL Server Management Studio and connect to the SQL server.

3. Go to 6436181377.png Databases > 6436181371.png CxDB > 6436181374.png Tables > 6436181368.png dbo.CxComponentConfiguration ...

Notice

IPv6 addresses must be expressed in square brackets and contain % as a suffix in connection strings. For example, the string for IdentityAuthority looks as follows:

  • IdentityAuthority - https://[2001:0db8:3c4d:0015:0000:0000:1a2f:1a2b%]:8080/CxRestAPI/auth

4. Go to 6436181377.png Databases > 6436181371.png CxDB > 6436181374.png Tables > 6436181374.png CxARM > 6436181368.png dbo.DBSources and also update the DB_HOST database key value.

5. Update the following for each server:

6. To update the Java version or the Java path, apply the correct Java settings as follows:

7. Right-click 6436181380.png This PC and select Properties to display the System information and settings.

8. Go to Advanced System Settings to open the System Properties dialog box.

9. If not already open, open the Advanced tab.

10. On the Advanced tab, click Environment Variables... to open the Environment Variables dialog box.

11. Navigate to CX_JAVA_HOME to point to where the JRE folder is located, for example C:\Program Files\Java\jdk1.8.0_241\jre.

12. Update the Load Balancer configuration file (e.g., Nginx.conf) accordingly.

13. Update Access Control...

14. Restart all Cx Windows Services and the IIS.

15. Log in to the Web Portal and manually update the CxEngine Server name, the IP address or the port according to these instructions.

16. If required, update the IP Address in the TCP/IP Properties in the SQL Server Configuration Manager (see example).

Notice

  • After completing the steps above, you have to update the Environment Variables. You can use the Silent Reconfiguration option or edit the Environment Variables available under Windows Properties.

  • For Distributed Silent Installation and High Availability, you have to reconfigure Access Control after installing ActiveMQ. To do so, refer to Silent Reconfiguration for further information and instructions.

In this section: