Troubleshooting - Adaptive Plugins - BlueCat Gateway - 20.6.1

Failover Package Administration Guide

prodname
BlueCat Gateway
version_custom
20.6.1
The following outlines tips and workarounds for possible issues you might encounter when using the Failover package:
  • When installing the container, you might receive the following error:
    “Error response from daemon: pull access denied for dns_master_failover, 
    repository does not exist or may require 'docker login': denied: requested access to the resource is denied.”
    This can be resolved by logging in to the Quay repository through the command line before executing the docker run command. Use the following commands to log in to Quay:
    docker login quay.io
    Username: <quay_username>
    Password: <quay_password>

    Once you have logged in, execute the docker run command again.

  • When installing the container, you might receive an error that a port is in use. On the BlueCat Gateway server, run the following command to retrieve information about what ports are in use:
    sudo docker ps -a
    In the following example output, ports 80 and 443 are used:
    STATUS          PORTS                                         NAMES
    Up 34 minutes   0.0.0.0:80->8000/tcp, 0.0.0.0:443->44300/tcp  gateway_20_3_1

    Once you verify the ports in use, execute the docker run command again with different <http_port> and <https_port> port values.

  • If you have trouble with your Docker Quay login credentials or you do not have access to the Quay repository, contact BlueCat Customer Care for assistance.
  • Refer to the table below that describes the docker run command:
    Table. Understanding the docker run command
    Code Segment Function
    docker run Is used to run a command in a new container
    -d The -d flag indicates to run the Docker container in detached mode. This means that the Docker container will run in the background of your terminal and will not receive any input or display output
    -p 80:8000 -p 443:44300
    This code segment specifies the allocation of the ports being used:
    • Port 8000 in the container is allocated to port 80 on the Docker host.
    • Port 44300 in the container is allocated to port 443 on the Docker host.
    -e BAM_IP=<your bam ip>

    The environment variable is used to specify the IP address of the BAM you wish to integrate with Gateway. You must enter the BAM IP as an environment variable when running the Gateway container for the first time

    --name bluecat_gateway Indicates the name of the container. By default, the name of the container is bluecat_gateway; however, this can be changed to reflect the needs of your environment
    quay.io/bluecat/

    Refers to the Gateway image tag from which the container will be created. If the image has already been pulled and is available locally, the container will be created from that image. If the image is not available locally, it will be pulled from the Quay.io cloud registry.