- You must have Docker installed on the host machine that will be running the BlueCat Gateway instance. For more information, refer to the 'Requirements' section of the BlueCat Gateway Installation Guide.
- 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 a Quay account that has been granted read access to the BlueCat Server Update Services private repository. If you have not yet created a Quay account, create an account and give your Quay account username to a BlueCat representative to be granted access to the private repository.
- 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.
- From the host machine, run 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 bsus_installer-21.1.1-GA.zip installer from BlueCat Customer Care.
- Unzip the installer file.
- Create an environment variable file named
.env
that contains Address Manager, BlueCat Gateway, and RabbitMQ credentials.The following shows an example of the content of an.env
environment variable file:BAM_IP=192.168.88.54 BSUS_IP=192.168.88.64 RABBITMQ_DEFAULT_USER=guest RABBITMQ_DEFAULT_PASS=guest
Where the
BAM_IP
variable is the IP address of Address Manager,BSUS_IP
is the IP address of the BlueCat Gateway instance that will be running BlueCat Server Update Services,RABBITMQ_DEFAULT_USER
is the default username of the RabbitMQ service, andRABBITMQ_DEFAULT_PASS
is the default password of the RabbitMQ service.Important: Do not change the RabbitMQ user or password from the default of "guest
".Note: If you are installing BlueCat Server Update Services for environments where you must specify the network range to which the BlueCat Server Update Services service containers are assigned, refer to Configuring a dedicated network range for BlueCat Server Update Services. - 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"
The following log message indicates that the service has started:logstash_1 | [2021-05-17T16:06:42,205][INFO ][logstash.inputs.rabbitmq ] [main][ab3ce81ccc3d228c9c8d56d7f16bb605c6d35ff5bca7dd75ed83e6ab37dfa86e] 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 theDeclaring 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.