For each Kea DHCP server, it's possible to add one DHCPv4 and one DHCPv6 failover relationship. Micetro supports two failover server types in a relationship: one primary and one secondary. Therefore, creating failover relationships with backup servers is not supported.
Before adding a failover relationship, you need to enable failover by having two hook libraries exist on the file system. For more information, refer to High Availability hooks library
You can add a failover relationship either in the Web Application or through the API.
Adding a failover relationship in Micetro
To create a failover relationship in Micetro:
- On the Admin page, select the Service management tab.
- In the left sidebar, under DHCP services, select Kea.
- Select the Kea DHCP server housing the scope for which you want to establish failover configuration, and then use the Action or Row ... menu to select Manage failover.
- In the dialog, select + Add relationship.
- Enter the necessary information in the provided form:
- Failover name: Specify the name of the failover peer.
- Failover mode: Select the DHCP failover mode to use, e.g., load balance or hot standby.
- Partner server: Select the partner server for the failover configuration.
- Specify the DHCP version by selecting either DHCPv4 or DHCPv6. The default setting is DHCPv4.
Then select Next.
- Review the failover relationship configuration in the Summary step, and then select Add.
- Select Save.
Adding a failover relationship through API
To create a failover relationship through the API:
The API supports the creation of a failover relationship with the
AddDHCPFailoverRelationship command, which uses the following
parameters:
- Name: The name of the DHCP failover relationship to be created.
- PrimaryServer: The name of the primary DHCP server as it appears in Micetro.
- SecondaryServer: The name of the secondary DHCP server as it appears in Micetro.
- FailoverMode: The DHCP failover mode to use.
- ServiceType: DHCPv4 or DHCPv6. Defaults to DHCPv4.