Installing the GSS Adaptive Application - Adaptive Applications - BlueCat Gateway - 20.6.1

Global Server Selector Administration Guide

prodname
BlueCat Gateway
version_custom
20.6.1

Before you begin, you must download the latest GSS Adaptive Application from Quay.

Downloading and installing from Quay

To install the custom Gateway image:
  1. From the Linux console of a host machine with internet access, log in to your Quay account using the following commands:
    docker login quay.io
    Username: <quay_username>
    Password: <quay_password>
  2. From the Linux console of a host machine with internet access, pull the latest GSS Adaptive Application image using the following command:
    docker pull quay.io/bluecat/gss:latest
  3. If a different server will be running the BlueCat Gateway instance, use the following command to export the GSS Adaptive Application file. Copy this image file to the server that will be running the BlueCat Gateway instance:
    docker save -o <path_to_image_tar_file> quay.io/bluecat/gss:latest
  4. Run the following command to import the image file created by the Docker save command:
    docker load -i <path_to_image_tar_file>
  5. Run the custom Gateway image using the following command:
    docker run -d \
    -p 80:8000 \
    -p 443:44300 \
    -v <SCHEDULER_LOG_DIR>:/bluecat_gateway/workflows/GSLBHealthCheckServer/schedule_logs/ \
    -v <GATEWAY_LOG_DIR>:/logs/ \
    -e BAM_IP=<your_bam_ip_address> \
    -e DISABLE_HEALTH_CHECK=no \
    --name <gateway_container_name> \
    quay.io/bluecat/gss
    Where:
    • <SCHEDULER_LOG_DIR> represents the directory where the health check logs are stored.
    • <GATEWAY_LOG_DIR> represents the directory where the BlueCat Gateway logs are stored.
    • The DISABLE_HEALTH_CHECK environment variable is used to disable the scheduled health checker when starting the BlueCat Gateway instance. The default value is no.
      Tip: BlueCat advises all customers to map Docker logs volumes to save data from BlueCat Gateway. This is the recommended best practice for Docker containers. However, if you prefer to mount logs directories to your local machine, you must manually set rwx (read, write, execute) permissions to those directories before running the container. If you do not map logs directories to your local machine during installation, BlueCat Gateway will write all the data to the container by default. If you then stop or restart the container, all this data will be lost.
      To set permissions to external volumes, run the following command:
      chmod -R a=rwx <mapped volume>