Update the Server Address or Port on an Agent
search cancel

Update the Server Address or Port on an Agent

book

Article ID: 289487

calendar_today

Updated On:

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