Upgrade a Linux Server Sensor Gateway

You can upgrade a Sensor Gateway on a Linux server by running a dedicated upgrade script.

Note: Upgrade of the Sensor Gateway does not enable proxy support. To configure a Sensor Gateway environment with a proxy, you must re-install the Sensor Gateway.

Prerequisites

• You must have the following information available from your initial Sensor Gateway installation.
  • The Sensor Gateway Entry point. Use the same name as before. If not, existing sensors can stop communicating through the Sensor Gateway.
  • API ID
  • API Key
• Supported Carbon Black Linux sensor versions are 2.13.2.997598+.
• Confirm that the existing version of the Sensor Gateway is running and has active connectivity with Carbon Black Cloud.

Procedure

1. Download and unzip the sensor-gateway-x.x.x.zip file on your Linux server.
2. Identify the current Sensor Gateway and stop it.
   1. Log in to the Linux server using root credentials.
   2. To get the running instance of the Sensor Gateway, excecute the following command:

      docker ps

      The first column displays the Container ID.
   3. To stop the running Sensor Gateway, execute the command:

      docker stop <the Container ID>

   4. To get a list of all containers, run the following command:

      docker ps -a

   5. Remove the Sensor Gateway instance.

      docker rm <the Container ID>

   6. Get a list of all containers and confirm that there is no Sensor Gateway in Running or Stopped status.

      docker ps -a

      If you do not see any result from executing the command, it indicates that the previous commands were unsuccessful. Do not proceed with the next step: contact Broadcom Carbon Black Support.
3. cd to the directory where you unzipped the latest version of the Sensor Gateway file.
4. Install the Sensor Gateway.

   ./sensor_gw_install.sh

   You are prompted to supply the same data as you input during the initial Sensor Gateway installation. See Install Sensor Gateway on a Linux Server.