Connecting to multiple Address Manager servers during installation via the command line - Platform - BlueCat Gateway - 25.2

Gateway Installation Guide

ft:locale
en-US
Product name
BlueCat Gateway
Version
25.2

As of BlueCat Gateway v25.2, you can now specify multiple Address Manager servers when starting a Gateway container with the BAM_IP environment variable (instead of adding additional Address Manager servers through the UI). In the login screen, users can then select from all specified servers.

To specify multiple servers, within the docker run (or podman run) command, list all desired IP addresses or URLs when setting the value of the BAM_IP environment variable separated by commas.

-e BAM_IP=<BAM URL or IP address 1>,<BAM URL or IP address 2>,... 

Each entry can be an IP address or a fully-qualified domain name and must be unique within that list. The list can use a mixture of URLs, IPv4, and IPv6 addresses. For clarity, you can enclose the entire list within quotation marks. For example:

docker run —d -p 80:8000 -p 443:44300e —name gateway_foo - e BAM_IP="10.0.0.1,10.0.0.2,https://abc.example.com,http://[FDA5:1000:0:6::6]" gateway:latest
Note: If any URL or IP address in the list is invalid, Gateway will not start (even if others in the list are valid).

When specifying multiple Gateway IP addresses, we recommend that you make sure that your Gateway workspace folder is mounted to a folder on your host machine. Mounting the folder makes it persist when Gateway is later upgraded to a new version (as long as you map the new instance's workspace to the same folder). Whenever you deploy Gateway from the command line, Gateway adds any specified Address Manager servers to the api_url setting in the config.py file in the workspace folder (as long as that server wasn't already added). This means that upgraded versions of Gateway will use the complete list of Gateway IP addresses and URLs, so you don't have to specify the list in the command line again.