Modifying Service Point v4 network configurations - BlueCat DNS Edge

DNS Edge User Guide (Service Point v4)
Locale
English
Product name
BlueCat DNS Edge

Once you have provisioned a Service Point v4 instance, you can continue to deploy services to the service point. If required, you can modify the existing IP address, netmask, default gateway, and configured DNS servers of the service point. The following sections outline steps to modify the service point configurations depending on the platform that the service point is provisioned on.

Updating Service Point v4 configurations when provisioned on VMware ESXi

  1. If you have deployed DNS resolver service to the Service Point v4 instance, you must first delete DNS resolver service before modifying the IP address.
  2. Log in to the Service Point v4 instance using the operations user and the VM console password through a console session.
    Attention: BlueCat recommends connecting to the Service Point v4 instance using a console session, as the change in network configuration can result in the Service Point v4 instance becoming unreachable using an SSH connection.
  3. Elevate your user permissions by running the following command:
    sudo su
  4. Modify the IP address, netmask, and default gateway of the eth0 interface within /etc/network/interfaces.d/50-cloud-init.
    Note: A warning appears at the top of the file stating that the contents of the file will be overwritten upon reboot. This message can be safely ignored, as the VMware network configuration only runs once for each Service Point v4 instance and not upon each reboot.
  5. Save the changes to the file.
  6. Run the following command to reconfigure the eth0 interface with the new settings and restart the platform services:
    fleet newIP

    All services will restart and listen on the new IP address of the Service Point v4 instance.

  7. If you had previously deployed DNS resolver service to the Service Point v4 instance, redeploy DNS resolver service to the Service Point v4 instance.

While the platform services restart, the Service Point v4 instance will be in an Unhealthy state for a few minutes. During this time, DNS clients will experience a brief downtime.

Updating Service Point v4 configurations when provisioned on Azure

  1. If you have deployed DNS resolver service to the Service Point v4 instance, you must first delete DNS resolver service before modifying the IP address.
  2. Log in to the Azure portal.
  3. Click Virtual machines.
  4. Click the name of the Service Point v4 instance virtual machine that you are reconfiguring the IP address on.
  5. Click Networking in the side bar and click the name of the network interface attached to the VM.
  6. Click IP configurations in the side bar and click the private IP address of the VM.
  7. Change the IP address configuration of the VM.
  8. Click Save.

    Once you have clicked saved, the VM reboots. After the VM has completed rebooting and its core services have restarted, all services will restart and listen on the new IP address of the Service Point v4 instance.

  9. If you had previously deployed DNS resolver service to the Service Point v4 instance, redeploy DNS resolver service to the Service Point v4 instance.

The Service Point v4 instance takes at least 5 minutes to reboot on Azure and services take an additional two minutes to restart after the reboot has completed. While the platform services restart, the Service Point v4 instance will be in an Unhealthy state for a few minutes. During this time, DNS clients will experience a brief downtime.

Note: During the restart process, you might see similar messages to the following within the serial console of the VM followed by no logging output for several minutes:
SMBus base address unitialized - upgrade BIOS or use force_addr=0xaddr
This is expected behaviour and does not indicate that an error has occurred during the reboot process.

Updating Service Point v4 configurations when provisioned on AWS or GCP

Due to limitations with the Cloud provider, you cannot modify the private IP address settings of the Service Point v4 instance on AWS and GCP. To modify the IP address settings, you must provision a new Service Point v4 instance with the updated configurations. With this approach, DNS clients would experience a brief downtime during the Service Point v4 instance provisioning and DNS resolver service deployment process.