Update the Server Address or Port on an Agent

Products

• Carbon Black App Control (formerly Cb Protection)

Issue/Introduction

Steps to instruct the Agent to use a new Server Address and/or Communication Port.

Environment

• App Control Agent: All Supported Versions
• Microsoft Windows: All Supported Versions
• Linux: All Supported Versions
• Apple macOS: All Supported Versions

Resolution

Windows:

1. Open an elevated command prompt and issue the following commands:

   cd "C:\Program Files (x86)\Bit9\Parity Agent"
   dascli password <GlobalCLIPassword>
   dascli tamperprotect 0
   dascli setserver <NewServerAddress> <NewServerPort>
   
   Example: dascli setserver AppControl.ACME.local:41002

2. Verify the changes were applied, and Tamper Protection is again enabled, by issuing:

   dascli status
   

Linux:

1. Log in to the Console and navigate to https://ServerAddress/support.php > Advanced Configuration.
2. Note the current Server ID listed.

   Example: {b9}ABCDEFG123456780HIJKLMNO=

3. Use Terminal to issue the following commands:

   cd /opt/bit9/bin
   ./b9cli --password 'GlobalCLIPassword'
   ./b9cli --tamperprotect 0
   ./b9cli --setserver NewServerAddress:NewPort:ServerID
   
   Example: ./b9cli --setserver AppControl.ACME.local:41002:{b9}ABCDEFG123456780HIJKLMNO=

4. Verify the changes by issuing the command:

   ./b9cli --status

macOS:

1. Open a Terminal and issue the following commands:

   cd /Applications/Bit9/Tools/
   ./b9cli --password GlobalCLIPassword
   ./b9cli --tamperprotect 0
   ./b9cli --setserver <new server address> <new server port>
   
   Example: ./b9cli --setserver AppControl.ACME.local:41002

2. Verify the changes by issuing the command:

   ./b9cli --status

Additional Information

• These steps are intended only to be used to update the Server Address/Port Number and cannot be used to migrate Agents to a new Console.
• On Windows this will initiate a Repair Install and generate a log file:

  C:\ProgramData\Bit9\Parity Agent\Logs\ParityHostAgentRepair.log