Upgrading from Cloud Discovery & Visibility v21.3 - Adaptive Applications - BlueCat Gateway - 21.3.1

Cloud Discovery & Visibility Administration Guide

Locale
English (United States)
Product name
BlueCat Gateway
Version
21.3.1
This procedure only applies if you have Cloud Discovery & Visibility v21.3 installed and are upgrading to Cloud Discovery & Visibility v21.3.1. Upon upgrading to Cloud Discovery & Visibility v21.3.1, visibility jobs are preserved but stopped. You must manually restart the visibility jobs from the Management tab in the Cloud Discovery & Visibility UI.
Attention: Once you run discovery and visibility jobs on the upgraded version of Cloud Discovery & Visibility, the UDFs from the older version of Cloud Discovery & Visibility are replaced with the updated UDFs from the current version. There is no backwards compatibility and you cannot run an older version of Cloud Discovery & Visibility.
To upgrade Cloud Discovery & Visibility from v21.3 to v21.3.1:
  1. Log in to the console of the Cloud Discovery & Visibility v21.3 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 Cloud Discovery & Visibility v21.3.1 container and add a volume that points to the database volume of the Cloud Discovery & Visibility v21.3 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:21.3.1
  8. Once you have successfully upgraded to Cloud Discovery & Visibility v21.3.1, log in to the UI and re-enable the visibility jobs from the Management tab.

Upgrading from Cloud Discovery & Visibility v21.3 deployed on a BDDS

If you deployed Cloud Discovery & Visibility v21.3 on a BDDS, perform the following steps to upgrade to Cloud Discovery & Visibility v21.3.1:

Exporting the visibility jobs
  1. Log in to the Cloud Discovery & Visibility UI.
  2. Click the Database icon in the top-right corner of the page.
  3. From the drop-down menu, select Export Visibility Jobs. The Export visibility jobs window opens.
  4. (Optional) Under Secret Key, enter a secret key value that will be used to decrypt the visibility job configuration file.
  5. Click Export.

Cloud Discovery & Visibility generates the visibility job configuration file and downloads it to your browser.

Upgrading the Cloud Discovery & Visibility container

Once you have exported the visibility job configuration file, you can proceed to upgrade the container. Depending on the deployment of the BDDS, you can upgrade the container via a cloud or local repository, or upgrade the container in a Production Environment. For more information on upgrading, refer to Upgrading a container in the Address Manager Administration Guide.

Importing the visibility jobs

Once you have successfully updated to Cloud Discovery & Visibility v21.3.1, you must import the visibility jobs.
  1. Log in to the Cloud Discovery & Visibility UI.
  2. Click the Database icon in the top-right corner of the page.
  3. From the drop-down menu, select Import Visibility Jobs. The Import Visibility Jobs window opens.
  4. Under File, click Upload and select the visibility job configuration file to upload.
  5. Under Secret Key, enter the secret key if you encrypted the visibility job configuration file.
  6. Click Import.

Cloud Discovery & Visibility attempts to import the visibility jobs from the configuration file. Once you have successfully upgraded to Cloud Discovery & Visibility v21.3.1, log in to the UI and re-enable the visibility jobs from the Management tab.