Configuring a dedicated network range for BlueCat Server Update Services - Adaptive Applications - BlueCat Gateway

Configuring a dedicated network range for BlueCat Server Update Services - Adaptive Applications - BlueCat Gateway - 22.1

BlueCat Server Update Services Administration Guide

Locale

English

Product name

BlueCat Gateway

Version

22.1

The following section outlines steps to install BlueCat Server Update Services for environments where you must specify the network range to which the BlueCat Server Update Services service containers are assigned.

Note: Networks created by Docker for the specified network range are only used for internal communication between service containers, and must not be able to reach the host network.

Attention: You must not specify network_mode: bridge for individual services, as this allows the containers to reach out to the host network and query for DNS.

To create a specified network range:

Create the network with a specified range using the following command:
```
docker network create --subnet <network_range> <network_name>
```
Modify the docker-compose.yml file to include the network range with the following information:
```
[services declaration]
...
networks:
    default:
        external:
            name: <network_name>
```
Run the docker container using the following command:
```
docker-compose up -d
```
The BlueCat Server Update Services Adaptive Application starts up. You can proceed to access the BlueCat Server Update Services Adaptive Application from the browser window once the service has started.
To verify that the service has started, run the following command:
```
docker-compose logs -f | grep "Declaring"
```
You'll see the following log message (in the log window) when the BSUS service starts:
```
Declaring exchange 'bsus' with type topic
```
Important: You must wait for the BlueCat Server Update Services Adaptive Application to start before attempting to access the UI. If you do not wait for the Declaring exchange 'bsus' with type topic message to appear and attempt to access the UI before the service has started, you will receive the following error:
```
Get Batches Error: NotFoundError(404, 'index_not_found_exception', 'no such index [batch], batch, index_or_alias)
```
If you receive this error, you must stop the current BlueCat Batch Update Services container, delete the container, and install a new container.