Appendix B - Upgrading the Connector (Application Access)

Note - To upgrade the Network Access Connector, see sk174504.

When a new version of the Connector is available, you must install it on the same computer where you run DockerClosed Docker is a set of platform as a service products that use OS-level virtualization to deliver software in packages called containers..

To run the Docker commands without sudo:

  1. On the host running the Connector, run these commands once to perform step 3 and later without sudo in the command:

    sudo groupadd docker

    sudo usermod -aG docker $USER

  2. Log out and log in to the shell again.

  3. Get the Connector container ID and use it as <CONTAINER-ID> in the steps below. Run:

    docker ps | grep odo_connector

  4. Stop the Connector container. Run:

    docker stop <CONTAINER-ID>

    Important - You must run the stop command before you run the remove command.

  5. Remove the Connector container. Run:

    docker rm <CONTAINER-ID>

  6. Get the Connector container image ID and use it as <IMAGE-ID> in the steps below. Run:

    docker images | grep odo_connector

  7. Remove the Connector image. Run:

    docker rmi <IMAGE-ID>

  8. In Harmony Connect, go to Assets > Application Sites.

  9. In the configured sites table, click to regenerate the key for the relevant site in the Actions column.

  10. Click to copy and run the Docker command in the target machine.

Upgrading the Connector Without Access to Docker Hub

  1. Download the Connector image to a host with access to Docker hub. Run:

    docker pull <IMAGE_NAME>

    For example:

    docker pull adanite/odo_connector:eu_v3

  2. Save the Connector image. Run:

    docker save <IMAGE_NAME > | gzip > <FILE_NAME>.tar.gz

    For example:

    docker save adanite/odo_connector:eu_v3 | gzip > connector_image.tar.gz

  3. Stop the Connector container on the host. Run:

    docker stop <CONTAINER-ID>

    Important - You must run the stop command before you run the remove command.

  4. Remove the Connector container on the host. Run:

    docker rm <CONTAINER-ID>

  5. Remove the images used by the removed Connectors. Run:

    docker rmi <IMAGE-ID>

  6. Upload the saved image file to the host with a Connector to upgrade.

  7. Load the image file. Run:

    docker load < <FILE_NAME>.tar.gz

    For example:

    docker load < connector_image.tar.gz

  8. To view the Connector image, run:

    docker images

  9. Redeploy the Connectors using the modified Docker command with the new loaded image file name in step 1.

    For example:

    curl --silent https://assets.checkpoint.security/connector-scripts/ConnectorOSValidator.sh | bash -s && docker run -d -e ODO_ENV=eu --cap-add=NET_ADMIN --network=host --restart=always --log-opt max-size=1g -e DeviceInterfaceName=eth0 -e Secret=eyJhbGciOiM4NCJ9.kgA4DBNkrkCJ4sAnHZ29uAAA.qo-xPqRdOvJ43pRYsM_-LuTwr1E3Cqy6RLTY9 adanite/odo_connector:eu_v3

Connector's Version Number

  1. To know version number of all the deployed Connectors, run:

    for c in $(docker ps | awk '/adanite/ {print $NF}'); do echo $c; docker inspect $c | grep VERSION=; done

  2. To know the latest Connector version available for you to deploy, run:

    curl --silent https://assets.checkpoint.security/connector-scripts/ConnectorOSValidator.sh | bash -s