Pull Docker images

This page provides the procedure to deploy Cyberwatch docker images on a disconnected machine.

Download docker images

  1. Connect to a machine with access to https://dl.cyberwatch.com

  2. On Linux, set these two environment variables with your Cyberwatch credentials:

    The credentials are in the license email sent by Cyberwatch. They are the same used to access Cyberwatch’s container registries.

    export CBW_USER=
export CBW_PASSWORD=

  3. Download the images archive by using one of the 3 methods below:

    • With curl:

       curl -u "$CBW_USER:$CBW_PASSWORD" -JLO https://dl.cyberwatch.com/download_images

    • With wget:

       wget --http-user="$CBW_USER" --http-password="$CBW_PASSWORD" \
   --content-disposition https://dl.cyberwatch.com/download_images

    • With PowerShell cmdlet Invoke-WebRequest:

       $pair = "$($CBW_USER):$($CBW_PASSWORD)"
 $encodedCredentials = [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes($Pair))
 $headers = @{ Authorization = "Basic $encodedCredentials" }
 Invoke-WebRequest -Uri 'https://dl.cyberwatch.com/download_images' -Method Get -Headers $headers -Outfile images_cbwonpremise_{version}.tar.gz

    • Manually:

      1. Go to URL https://dl.cyberwatch.com/images/ with a web browser
      2. Download the last version of the archive

  4. (Optional) Check the integrity of the downloaded file to ensure that the download is complete:

    • Download the sha256 checksum file of the previously downloaded archive:

      • With curl:

          curl -u "$CBW_USER:$CBW_PASSWORD" -JLO \
    https://dl.cyberwatch.com/images/$(ls images_cbwonpremise_*.tar.gz).sha256

      • With wget:

          wget --http-user="$CBW_USER" --http-password="$CBW_PASSWORD" \
    --content-disposition https://dl.cyberwatch.com/$(ls images_cbwonpremise_*.tar.gz).sha256

      • Manually:

        1. Go to URL https://dl.cyberwatch.com/images/ with a web browser.
        2. Download the sha256 checksum file associated with the previously downloaded archive.

    • Check the integrity:

       sha256sum -c images_cbwonpremise_*.tar.gz.sha256

Import images to the disconnected machine

  1. Import the archive to the disconnected machine

  2. Load the docker images:

    Loading images into the cache depends on the cbw-on-premise orchestrator you are using:

    • With Docker:

      docker image load -i images_cbwonpremise_*.tar.gz

    • With Podman:

      Move the archive to a location accessible by the cyberwatch user:

      cp images_cbwonpremise_*.tar.gz /home/cyberwatch
chown cyberwatch:cyberwatch /home/cyberwatch/images_cbwonpremise_*.tar.gz

      Using the cyberwatch user, load the images. Please note that the podman load command may take some time:

      sudo su - cyberwatch
podman image load -i images_cbwonpremise_*.tar.gz
  3. Check that the images have been imported:
docker images

or

podman images

The images must all have a name and a tag.

Back to top