Setting the Primary Service IP address - BlueCat Address Manager - 9.1.0

VM Installation Guide

prodname
BlueCat Address Manager
version_custom
9.1.0

DNS/DHCP Server v8.2.0 or greater employs a Primary Service IP address to support VLAN tagging, multiple service IP addresses, and bonding interfaces. The Primary Service IP is the principal address for DNS service regardless of the number of IP addresses configured on the Services Interface (by default, eth0).

Running the set address command from the Administration Console automatically configures the Primary Service IPv4 or IPv6 address, respectively. However, customers configuring VLAN interfaces or bonding interfaces (or both) can run the set primary command from the DNS/DHCP Server Administration Console to change the Primary Service IP address manually.

Note:
  • The Primary Service IP can only be configured on DNS/DHCP Server appliances and VMs.
  • There can be only one primary IPv4 address and one primary IPv6 address on a managed DNS/DHCP Server.
  • The Primary Service IPv6 address must be configured on the same services interface as the Primary IPv4 address.
Note: Upgrading to DNS/DHCP Server v8.2.0 or greater
  • Customers upgrading their managed DNS/DHCP Server to software version 8.2.0 or greater will have the Primary Service IP address automatically set to the IPv4 address configured on the Services interface (by default, eth0)
  • If there is a single IPv6 address configured on the Services Interface (eth0) of a managed DNS/DHCP Server when upgrading to software version 8.2.0 or greater, this IPv6 address will be automatically set as the Primary Service IPv6 address. Services running on the configured IPv6 address will continue to run as normal. Use caution if modifying this IPv6 address. Deleting the Primary IPv6 address can result in loss of service.
  • If there is more than one IPv6 address configured on the DNS/DHCP Server when upgrading to software version v8.2.0 or greater, then none of the IPv6 addresses will be automatically set as the Primary. Services running on the configured IPv6 address will continue to run as normal.
Warning: Changing the Primary Service IP address

The Primary Service IP address cannot be removed. However, it can be configured on a different Service interface (for example, if the Primary IP is currently set on eth0 and you want to set it on VLAN eth0.100). BlueCat advises extreme caution if attempting to change the Primary Service IP address. Changing the Primary Service IP address may result in a restart of all running services associated with that Services interface (such as services running on additional IP addresses, loopback addresses, and VLAN interfaces) and/or loss of connectivity with Address Manager.

Warning: Changing the Services interface configured with the Primary IP

BlueCat advises extreme caution if attempting to change the Services interface associated with the Primary IP address (for example, if the Service interface and Primary IP are configured on eth0, but you want to configure the Service interface on VLAN eth0.100). Changing the Services Interface may result in a restart of all running services. That is, changing the Services interface may result in a restart of services running on additional IP addresses, loopback addresses, and VLAN interfaces.

To set the Primary Service IP address:

  1. From Main Session mode, type configure interfaces and press ENTER.
  2. Type modify <interface> and press ENTER.
  3. Type set primary <ipv4address|ipv6address> and press ENTER.
  4. Type save and press ENTER. The Administration Console saves your settings.
  5. Type exit and press ENTER until you return to Main Session mode.
Adonis> configure interfaces
Adonis:configure:interfaces> modify eth0
Adonis:configure:interface:eth0> set primary 192.0.2.20
Adonis:configure:interface:eth0> save
Saved interface successfully