Change the Hostname of the App Control Server

Products

• Carbon Black App Control (formerly Cb Protection)

Issue/Introduction

Steps to change the Server Address (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.
2. Log in to the Console and navigate to System Configuration > General > Edit.
3. Update the Server Address to match the new name.
4. Once the changes have been applied:
   • It is recommended to use a Subject Alternative Name.
   • The Agent Server Certificate will need to be updated.
   • The Certificate bound to Port 443 in IIS will need to be updated.
5. Existing Agents will continue to attempt to connect via the old Server Address, unless manually updated using the setserver command.
6. 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.