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

Cloud Discovery & Visibility Administration Guide

Locale
English
Product name
BlueCat Gateway
Version
24.1.1

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.

Note: If you are upgrading from a version prior to v24.1, 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 v24.1.1, adding a volume that points to the database volume of the Cloud Discovery & Visibility v23.2 or v23.3.2 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:24.1.1
  8. After you successfully upgrade to Cloud Discovery & Visibility v24.1.1, log in to the UI and re-enable the 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 CD&V instance via the Gateway server service on the BDDS. This is to ensure that the CD&V database data is mounted to the host:
    /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 to v24.1.1.