PUT /v1/replaceServer - BlueCat Address Manager - 9.1.0

Address Manager API Guide

prodname
BlueCat Address Manager
version_custom
9.1.0

Description

Replaces a server.

Parameters

Name Description
defaultInterface

Location: query

Type: string

Management interface address for the server.
hostName

Location: query

Type: string

The DNS FQDN by which the server is referenced.
name

Location: query

Type: string

Name of the server to be replaced.
password

Location: query

Type: string

The server password by default. For more information on the default server password, refer to BlueCat default login credentials (you must be authenticated to view this topic).
properties

Location: query

Type: string

A string containing the following options:
  • servicesIPv4Address —IPv4 address used only for services traffic such as DNS, DHCP, DHCPv6 and TFTP. If dedicated management is enabled, this option must be specified. If dedicated management is disabled, this address must be the same as defaultInterfaceAddress which is management interface address.
  • servicesIPv4Netmask —IPv4 netmask used only for services traffic such as DNS, DHCP, DHCPv6 and TFTP. If dedicated management is enabled, this option must be specified. If dedicated management is disabled, this netmask address must be the same as the management interface netmask address.
  • servicesIPv6Address —IPv6 address used only for services traffic such as DNS, DHCP, DHCPv6 and TFTP. This is optional.
  • servicesIPv6Subnet —IPv6 subnet used only for services traffic such as DNS, DHCP, DHCPv6 and TFTP. This is optional.
  • xhaIPv4Address —IPv4 address used for XHA. This is optional.
  • xhaIPv4Netmask —IPv4 netmask used for XHA. This is optional.
  • redundancyScenario —networking redundancy scenarios. The possible values are ACTIVE_BACKUP Failover and IEEE_802_3AD Load Balancing.
  • resetServices —allows you to replace the DNS/DHCP Server while maintaining existing configurations for DNS, DHCP, and TFTP services. Define this option only if you have modified the IPv4 or IPv6 addresses of the Services interface or wish to reset configurations for DNS, DHCP, and TFTP services on the DNS/DHCP Server. The value is either true or false by default, false.
Note: For DNS/DHCP Servers without multi-port support, the interface-related property options will be ignored.
Note: Resetting DNS/DHCP Servers will result in a service outage. This service outage will last until you have deployed services to the replacement system. Only reset DNS/DHCP Server services if you are replacing the DNS/DHCP Server with a new appliance of a different type and/or reconfiguring the IPv4 or IPv6 addresses of the Services interface on the appliance. BlueCat recommends that you schedule a maintenance window before performing a reset of DNS/DHCP Server services.
serverId

Location: query

Type: integer (int64)

The object ID of the server that needs to be replaced.
upgrade

Location: query

Type: boolean

Flag indicating that server needs to be upgraded or not. True means server needs to be upgraded.

Responses

Code Description
204

Type: file

Replaces the server using the existing server ID.