Upgrade Your Linux Sensor Gateway

You upgrade your Sensor Gateway by running a dedicated upgrade script.

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

Prerequisites

• Ensure you have the following information available from your initial Sensor Gateway installation.
  • The Sensor Gateway Entry point. Use the same name as before. If not, the existing sensors can stop working.
  • API ID
  • API Key
• The following Carbon Black sensor versions are supported with the Sensor Gateway.
  • Carbon Black sensor for Windows 3.8.0.684+
  • Carbon Black sensor for Linux 2.13.2.997598+
• Ensure the old version of the Sensor Gateway is running and has an 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 with root credentials.
   2. To get the running instance of the Sensor Gateway, excecute the 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 and thus, see the Sensor Gateway instance as exited under the Status column, run the 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, which is 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 might not have been successful. Please, do not proceed with the next step and contact 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

   Prompts you for the same data as during the initial Sensor Gateway install. For more information, see Install Sensor Gateway on a Linux Server.

Results

Your Sensor Gateway upgrades successfully.