Upgrading Cloud Discovery & Visibility using volume mounts - Adaptive Applications - BlueCat Gateway - 25.3

Cloud Discovery & Visibility Administration Guide

ft:locale
en-US
Product name
BlueCat Gateway
Version
25.3

If you prefer, you can upgrade to the latest version of CDV with volume mounts. This can be a more convenient method of updating your CDV system than exporting and importing the database separately.

Important: If you are upgrading from a version earlier than v24.1 to v24.1 or later, or from a version earlier than v24.1.2 to v24.1.2 or later, you cannot migrate the CDV database using the volume mount method. You must instead export the existing CDV database, upgrade CDV, and then import it again. For more details, see Upgrading Cloud Discovery & Visibility using the database export and import.
To upgrade Cloud Discovery & Visibility using volume mounts:
  1. Log in to the console of the Cloud Discovery & Visibility container.

  2. Retrieve information about the container using the following command:

    docker inspect <Container name or Container ID>
  3. In the response of the docker inspect command, find the volume information similar to the following:

    [
        {
            ...,
            "Mounts": [
                ...,
                {
                    "Type": "volume",
                    "Name": <volume_name>,
                    "Source": "/var/lib/docker/volumes/<volume_name>/_data",
                    "Destination": "/var/lib/postgresql",
                    "Driver": "local",
                    "Mode": "",
                    "RW": true,
                    "Propagation": ""
                },
                ...
            ],
            ...
        }
    ]
  4. Verify the existence of the volume using the following command:

    docker volume inspect <Volume name>
  5. Stop the container using the following command:

    docker stop <Gateway container name>
  6. Remove the container using the following command:

    docker rm <Gateway container name>
  7. Create a new container for Cloud Discovery & Visibility v25.3, by adding a volume that points to the database volume of the previously installed version of Cloud Discovery & Visibility container listed in the response of the docker inspect command:

    docker run -d \
    -p 80:8000 \
    -p 443:44300 \
    -v <path_to_mapped_log_directory>:/logs/ \
    -v <volume_name>:/var/lib/postgresql \
    -e BAM_IP=<Your BAM IP address> \
    --name <Gateway container name> \
    quay.io/bluecat/cloud_discovery_visibility:25.3
  8. After you successfully upgrade to Cloud Discovery & Visibility v25.3:

    1. Log in to the Cloud Discovery & Visibility UI and navigate to the Discovery or Visibility tab, depending on the jobs you set up.

    2. Select the Schedule managers (for the discovery jobs) or the Visibility manager (for Visibility jobs) that you need to update.

    3. Click Actions, then select Update credentials.

    4. Enter the required cloud and Address Manager credentials.

      For more details, see Changing authorization credentials for a Discovery job or Changing authorization credentials for a Visibility job.

    Note: If you have both Discovery and Visibility jobs, you must repeat this with both types of jobs.
  9. After you successfully update the cloud and Address Manager credentials, re-enable the scheduled discovery or visibility jobs from the Management tab.

If the CD&V container is on a BDDS:
  1. Prerequisite:
    Add the following line to the VOLUMES field in the BlueCat Address Manager user interface before starting the old version of a CDV instance via the Gateway server service on the BDDS. This makes sure that the host directory is bind-mounted into the container so that the CDV database data can be persisted and handled properly by the BDDS during the upgrade:
    /root/gwmount/:/var/lib/postgresql/

    For details on configuring the VOLUMES field, see Configuring Gateway service on a DNS/DHCP server in the BlueCat Address Manager Administration Guide.

  2. Follow the procedure detailed in Upgrading a Cloud Discovery & Visibility container on a BDDS to upgrade CD&V.