Upgrading Sensor Collector

This article outlines the procedure for upgrading in Sensor Collectors in a docker environment.

Download Latest Software Version

You can upgrade existing deployed Sensor Collectors when a new version of the software becomes available by downloading the latest version from the Provider Connectivity Assurance platform and running it in your environment.

Upgrade Procedure: Docker Environment

Important: In order to prevent issues during the upgrade, you must stop the Docker container currently running the existing Sensor Collector before deploying and running the latest version. This ensures a clean transition and avoids conflicts.

To upgrade a Sensor Collector in a Docker environment:

1. Download the Updated Sensor Collector from the user interface (it is the same process for initial download and upgrades):
   1. Navigate to your Sensor Collector by selecting Sensors > Collectors > Sensor Collector.
   2. Select your Sensor Collector from the list and click the ellipsis (three dots) in the upper-right corner and choose Download (Docker). This action triggers the download of the updated package to your local machine.
   3. Extract the Downloaded Tarball (.tar.gz) file at the location of the Sensor Collector you are upgrading.
      Example:

➜ mv sensorCollectorArchive.tar.gz sensorCollectorDir
➜ cd sensorCollectorDir/
➜ gunzip sensorCollectorArchive.tar.gz
➜ tar xvf sensorCollectorArchive.tar

2. Terminate the Existing Docker Container.
   Note: If your Sensor Collector is currently running in an environment (usually the case in an upgrade scenario), you must terminate its Docker container before running the shell script to pick up the new software.

To terminate, view running containers using the docker ps command: docker ps, as shown below:

Example output:

➜ docker ps
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES
8a705a524dac  gcr.io/npav-172917/adh-roadrunner:0.616.0  data --config=/tm...  7 seconds ago  Up 8 seconds              aod-connector-for-united.medley.npav.accedian.net-kevin-rr-test-f6ce394a-54f8-427b-be71-a10582d9370b

3. Find your container in the list, and use the container ID to stop it:

➜ docker stop 8a705a524dac

4. Launch the Upgraded Sensor Collector again using the run.sh script located in the extracted directory:

➜ ./run.sh