Installing the DHCP lease visibility plug-in on the DNS/DHCP Server - Adaptive Applications - BlueCat Gateway - 22.7

BlueCat Overlay for Microsoft

Locale
English (United States)
Product name
BlueCat Gateway
Version
22.7

Downloading and copying the DHCP lease visibility plug-in to the DNS/DHCP Server

Prerequisites:
  • You must have a Quay account.
  • 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.

  1. Log in to the console of your local machine.
  2. Log in to Quay from the console using the following command:
    docker login quay.io
  3. At the prompt, enter your Quay user name and password obtained when generating the encrypted password.
  4. Download the DHCP lease visibility plug-in from Quay using the following command:
    docker pull quay.io/bluecat/msdhcp_lease_visibility:21.1
  5. Save the DHCP lease visibility plug-in to a tarball file using the following command:
    docker save quay.io/bluecat/msdhcp_lease_visibility:21.1 | gzip > msdhcp_lease_visibility_21.1.tgz
  6. Copy the tarball file to the DNS/DHCP Server using the following command:
    scp /path/to/file/msdhcp_lease_visibility_21.1.tgz root@<bdds-ip-address>:.
  7. At the prompt, enter your DNS/DHCP Server root password.
  8. Connect to the DNS/DHCP Server using the following command:
    ssh root@<bdds-ip-address>
  9. Start the Docker service on the DNS/DHCP Server using the following command:
    systemctl start docker
  10. Unpack the image using the following command:
    docker load -i /root/msdhcp_lease_visibility_21.1.tgz

Once you have loaded the image, you can configure Gateway service from the Address Manager UI.

Installing the DHCP lease visibility plug-in on the DNS/DHCP Server

Attention: Before you begin, ensure that you have reviewed the prerequisites, technical specifications, limitations, and best practices for deploying BlueCat Gateway on a BDDS. For more information, refer to Gateway Service on BDDS appliances in the Address Manager Administration Guide.
Prerequisites:
  • 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.
To configure the DHCP lease visibility plug-in on the DNS/DHCP Server:
  1. From the configuration drop-down menu, select a configuration.
  2. Select the Servers tab.
  3. Under Servers, click the name of the DNS/DHCP Server that the DHCP lease visibility plug-in will be installed on.
  4. Click the server name menu and select Service Configuration.
  5. From the Service Type drop-down menu, select BlueCat Gateway. Address Manager queries the server and returns the current values for the service settings.
  6. Under General Settings, set the following parameters:
    • Enable Gateway Service—select this checkbox to enable BlueCat Gateway service.
    • Ports—enter a list of ports to configure for BlueCat Gateway. The typical ports are 80:8000 and 443:44300.
    • Environment Variables—enter a list of environment variables. Set the following environment variable:
      • BAM_IP=<your_bam_ip_address>: The IP address of the Address Manager server that the DHCP lease visibility plug-in will connect to.
  7. Under Repository Settings, set the following parameters:
    • Repository—enter quay.io/bluecat/msdhcp_lease_visibility
    • Tag—enter 21.1
    • Username—leave this blank.
    • Password—leave this blank.
  8. Click Update.

After you click Update, Gateway Service initializes, pulls the images from the cloud or local repository, and initiates the container. Allow some time to register the configuration, after which Address Manager will redirect you to the Service Type dropdown menu page.

Before proceeding to configure the DHCP lease plug-in, log in to the console of the DNS/DHCP Server that has the DHCP lease plug-in install as root and enter the following commands:
mkdir -p /root/gwdata/workflows/installation_ms_dhcp_lease_visibility/dhcp_leases_config/
chown -R 9000.9000 /root/gwdata