- You must have an Address Manager server configured with the BlueCatGateway UDF and a BlueCat Gateway user. For more information, refer to the Configuring BlueCat Gateway section of the BlueCat Gateway Installation Guide.
- You must have purchased the BlueCat Overlay for Microsoft Adaptive Application from BlueCat.
- You must have permissions to import and load the BlueCat Gateway instance.
- You must have a Quay account.
For more information on setting up your Quay account, refer to the information that was provided when you purchased the BlueCat Overlay for Microsoft Adaptive Application from BlueCat.
- You must have a Docker CLI password.
You can create one by clicking Generate Encrypted Password under Docker CLI Password on the Account Settings page in Quay.
- Log in to the console of the VM will be running the BlueCat Overlay for Microsoft Adaptive Application.
- Log in to Quay from the console using the following
command:
docker login quay.io
- At the prompt, enter your Quay user name and password obtained when generating the encrypted password.
- Download the updated BlueCat Overlay for Microsoft Adaptive Application from
Quay using the following
command:
docker pull quay.io/bluecat/overlay_microsoft:22.7-GA
- Run the custom Gateway image using the following
command:
docker run -d \ -p <http_port>:8000 \ -p <https_port>:44300 \ -v <path_to_mapped_log_directory_for_system_logs>:/logs/ \ -e BAM_IP=<your_bam_ip_address> \ -e username=<your_bam_api_service_account> \ -e password=<your_bam_api_service_account_password> \ --restart unless-stopped \ --name <gateway_container_name> \ quay.io/bluecat/overlay_microsoft:22.7-GA
Where <http_port> and <https_port> represent different ports than those used by the Gateway instance. For example, you can set port 81 as the <http_port> and port 444 as the <https_port> values.
If you need to configure BlueCat Overlay for Microsoft to use a proxy, refer to Configuring BlueCat Overlay for Microsoft with an HTTP or HTTPS proxy.
Tip: BlueCat advises all customers to map Docker volumes for their respective workspace and logs directory to save data from BlueCat Gateway. Volumes are completely managed by Docker and you do not need to set permissions manually when using Docker volumes. This is also the recommended practice for Docker containers. However, if you prefer to mount data and log volumes 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 data or log volumes 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 o=rwx <mapped volume>
Once you have downloaded and installed the custom Gateway image, you can configure the BlueCat Overlay for Microsoft Adaptive Application workflow permissions.
Configuring BlueCat Overlay for Microsoft with an HTTP or HTTPS proxy
When installing BlueCat Overlay for Microsoft , you can configure the Adaptive Application to use a proxy through which outbound connections are made. You can configuring the proxy information using the HTTP_PROXY and HTTPS_PROXY environment variables when performing the docker run command.
docker run -d \ -p <http_port>:8000 \ -p <https_port>:44300 \ -v <path_to_mapped_log_directory_for_system_logs>:/logs/ \ -e BAM_IP=<your_bam_ip_address> \ -e username=<your_bam_api_service_account> \ -e password=<your_bam_api_service_account_password> \ -e HTTP_PROXY=http://<your_HTTP_proxy_address>:<port> \ -e HTTP_PROXY=https://<your_HTTPS_proxy_address>:<port> \ --restart unless-stopped \ --name <gateway_container_name> \ quay.io/bluecat/overlay_microsoft:22.7-GA