Deploying Distributed DDNS Data Nodes on a BDDS - Adaptive Applications - BlueCat Gateway - 21.2

BlueCat Distributed DDNS Administration Guide

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

The following section provides steps to installing multiple Distributed DDNS Data Nodes on BDDS.

Before you begin

The Distributed DDNS Data Nodes establish a database cluster. Ensure that the following ports are not in use on the BDDS that will be hosting the Distributed DDNS Data Node:
Attention: By default, the ports are opened on the firewall of the DNS/DHCP Server upon deployment of the Distributed DDNS Data Node. If you are deploying on different networks, ensure that the ports are open on your routers between the database nodes for communication between nodes.
  • Standard database service port (port 3306): Used for database client connections and State Snapshot Transfers.
  • Replication port (port 4567): Used for cluster replication traffic. Multicast replication uses both UDP and TCP on this port.
  • IST port (port 4568): Used for Incremental State Transfers (IST).
  • SST port (port 4444): Used for all State Snapshot Transfers (SST).
  • Port 4920: Used for the API service running on the data node.
If you install the Distributed DDNS Data Node on the same BDDS as the Distributed DDNS Application Node, you must manually add firewall rules on the BDDS using the following commands:
iptables -A INPUT -p tcp --dport 22 -j ACCEPT
iptables -A INPUT -p tcp --sport 22 -j ACCEPT
iptables -A OUTPUT -p tcp --sport 22 -j ACCEPT
iptables -A OUTPUT -p tcp --dport 22 -j ACCEPT
Prerequisites
  • The BDDS that are to operate as a Distributed DDNS Data Node must be under Address Manager control.
  • BlueCat Gateway must have access to the configuration name and view name in Address Manager that contains the BDDS that are to operate as a Distributed DDNS Data Node. To allow access to the configuration name and view name:
    1. Log in to the Distributed DDNS Application Node user interface.
    2. Navigate to BlueCat Gateway Administration > Configurations > General Configuration.
    3. Select the BAM Settings tab.
    4. Set the Default Configuration and Default View to the configuration and view that contains the BDDS.

Installing the first node of the cluster

When installing the first node of the cluster, you must specify that you are creating a new Distributed DDNS Data Node cluster. Once you have specified this in the installation, subsequent node installations can connect to the existing cluster.



  1. Log in to the UI of the Distributed DDNS Application Node.
  2. Select the DDNS Deployment tab.
  3. Select the name of a server. If there are no BDDS names populated in the list, ensure that you have correctly configured the settings outlined in the Prerequisites section.
  4. In the Service Type section, select Database Node.
  5. In the General section, enter the following information:
    • SSH Username—enter the username that will be used to SSH to the BDDS.
    • SSH Password—enter the password that will be used to SSH to the BDDS.
    • Database Cluster—enter the name of the database cluster. This information is used during the deployment of other nodes in the database cluster.
    • Database Password—enter the password for the default user of the database cluster. By default, the password is ddns_admin. This information is used during the deployment of other nodes in the database cluster.
  6. In the Repository section, enter the following information:
    • Image—enter quay.io/bluecat/distributed_ddns_database:21.2
    • Username—enter your Quay username.
    • Password—enter your Quay password.
  7. Click Deploy.

Installing the additional nodes in the cluster

Once you have configured the first node in the cluster, you can add the additional two nodes to the cluster using a similar process as to what was done to create the first node.

  1. Log in to the UI of the Distributed DDNS Application Node.
  2. Select the DDNS Deployment tab.
  3. Select the name of a server. If there are no BDDS names populated in the list, ensure that you have correctly configured the settings outlined in the Prerequisites section.
  4. In the Service Type section, select Database Node.
  5. In the General section, enter the following information:
    • SSH Username—enter the username that will be used to SSH to the BDDS.
    • SSH Password—enter the password that will be used to SSH to the BDDS.
    • Database Cluster—select the name of the database cluster. This information is populated with the name of the cluster created for the first node.
    • Database Password—enter the password for the default user of the database cluster. By default, the password is ddns_admin. This information must be the same for all nodes within the database cluster.
  6. In the Repository section, enter the following information:
    • Image—enter quay.io/bluecat/distributed_ddns_database:21.2
    • Username—enter your Quay username.
    • Password—enter your Quay password.
  7. Click Deploy.
Attention:
  • If you reboot your BDDS, the Distributed DDNS Data Node containers are not automatically started after the BDDS comes back up. You must manually start the Distributed DDNS Data Node containers in the correct order. For more information, refer to Recovering the Distributed DDNS Data Node database cluster.
  • Once you've installed the Distributed DDNS Data Nodes, you must change the root password of the database service cluster.
  • If the nodes do you appear in the Distributed DDNS Application Node UI after you have added them, you must disable caching in Gateway. For more information on disabling caching, refer to the 'Configuring caching policies' section of the BlueCat Gateway Administration Guide.