Installing BlueCat Cisco ACI from Quay - Adaptive Applications - BlueCat Gateway - 23.1

BlueCat Cisco ACI Adaptive Plugin Guide

Locale
English
Product name
BlueCat Gateway
Version
23.1

When installing the BlueCat Cisco ACI plugin, you'll download a custom BlueCat Gateway docker image that contains the plugin from Quay.

Before installing the plugin, you must do the following:

  • You must have an Address Manager server configured with the BlueCatGateway UDF and a BlueCat Gateway user. For more details, see Creating the BlueCatGateway UDF.

  • Your Quay account must have access to the Cisco ACI private repository on Quay, provided by BlueCat.

    For more details, see the information provided when you purchased the Cisco ACI Adaptive Plugin.

  • You should have mapped Gateway workspaces and log directories to appropriate locations for your system or device. For more details, see Setting up Gateway workspace and log directories.

To install BlueCat Cisco ACI from Quay.io:

  1. From the host machine, run the following command:

    docker login quay.io
  2. At the prompt, enter your Quay user name and password obtained when generating the encrypted password.

  3. Download the Cisco ACI Adaptive Plugin from Quay using the following command:

    docker pull quay.io/bluecat/cisco_aci:23.1
  4. Start the custom Gateway image using the following command:

    docker run -d \
    -p 80:8000 \
    -p 443:44300 \
    -v <path_to_mapped_log_directory>:/logs/ \
    -e BAM_IP=<your_bam_ip_address> \
    --name <gateway_container_name> \
                        quay.io/bluecat/cisco_aci:23.1
    If you are configuring the image with a proxy, start the custom Gateway image using the following command:
    docker run -d \
    -p 80:8000 \
    -p 443:44300 \
    -v <path_to_mapped_log_directory>:/logs/ \
    -e BAM_IP=<your_bam_ip_address> \
    --env HTTP_PROXY=<your_proxy_address> \
    --env HTTPS_PROXY=<your_proxy_address> \
    --name <gateway_container_name> \
                            quay.io/bluecat/cisco_aci:23.1
    If you are using Cisco ACI with custom certificates, you must store the certificate files locally within a <local_directory>/certificates/server folder and map that location to the /bluecat_gateway/certificates/server directory of the container to ensure that the certificates persist with the Cisco ACI container. You can define custom certificates to be used with the container using the following command:
    docker run -d \
    -p 80:8000 \
    -p 443:44300 \
    -v <path_to_mapped_log_directory>:/logs/ \
    -v <local_directory>/certificates/server:/bluecat_gateway/certificates/server/ \
    -e BAM_IP=<your_bam_ip_address> \
    --name <gateway_container_name> \
    quay.io/bluecat/cisco_aci:23.1