Change the Hostname or Server Address of the App Control Server

Products

• Carbon Black App Control (formerly Cb Protection)

Issue/Introduction

Steps to change the Server Address, FQDN, or hostname of the App Control Server.

Environment

• App Control Agent: All Supported Versions
• App Control Server: All Supported Versions

Resolution

1. Verify the DNS Server has entries to
   • Forward the old Server Address to the new Server Address.
   • Resolve the new Server Address accordingly.
   • Important Do not proceed until the DNS & networking changes are confirmed to be working.
2. Update the Server Address to match the new name
   1. Log in to the Console and navigate to Settings > System Configuration > General > Edit.
   2. Change the Server Address to match the new name.
3. Update the Communication Certificate
   1. In the Console navigate to Settings > System Configuration > Security
   2. Follow the steps to replace the Communication Certificate.
      • Be sure to use a Subject Alternative Name with the old Server Address.
      • Be sure to note the Certificate Update Schedule and specify accordingly.
4. Update the IIS Certificate
   
   • The Certificate bound to Port 443 in IIS will need to be updated.
   • The same certificate used for Agent Communication can be used.
5. Additional steps may be required depending on the environment
   • Existing Agents will continue to attempt to connect via the old Server Address, unless manually updated using the setserver command.
   • If SAML is in use, the Identity Provider may need to be reconfigured with the updated XML containing the new hostname.

Additional Information

• An Agent Upgrade will not change the Server Address the Agent uses.
• If the Console is inaccessible after making the changes, verify or make changes as outlined here.