DNS/DHCP Server v8.3.1 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 Service 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.
- 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 Service interface as the Primary IPv4 address.
- The configured primary address on DNS/DHCP servers is
not the same as the Linux kernel primary address. When
multiple IP addresses are configured on a single
interface, the address set as primary on DNS/DHCP
servers may not match the primary address listed when
retrieving interface details with the Linux
ip
command.
- Customers upgrading their managed DNS/DHCP Server to software version 8.3.1 or greater will have the Primary Service IP address automatically set to the IPv4 address configured on the Service interface (by default, eth0)
- If there's a single IPv6 address configured on the Service interface (eth0) of a managed DNS/DHCP Server when upgrading to software version 8.3.1 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's more than one IPv6 address configured on the DNS/DHCP Server when upgrading to software version v8.3.1 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.
The Primary Service IP address can't 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 Service interface (such as services running on additional IP addresses, loopback addresses, and VLAN interfaces) and loss of connectivity with Address Manager.
BlueCat advises extreme caution if attempting to change the Service 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 Service interface may result in a restart of all running services. That is, changing the Service 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:
- From Main Session mode, type configure interfaces and press ENTER.
- Type modify <interface> and press ENTER.
- Type set primary <ipv4address|ipv6address> and press ENTER.
- Type save and press ENTER. The Administration Console saves your settings.
- 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