Upgrading a read-only replica to be a peer replica of the master server

It might be necessary for you to upgrade a read-only replica for a backend to a peer of its master, for example, if a peer of the master failed or further failover support is needed.

You should do the following to change a read-only replica for a backend to a peer replica:
  1. Stop both the master server and the read-only replica.
  2. Remove the masterServer, masterServerDN, and masterServerPW options from the backend section of the LDAP server configuration file of the read-only replica.
  3. Add a peerServerDN and peerServerPW option to the backend section of each server's configuration file. The two servers are now peer servers. See Establishing the root administrator DN and basic replication replica server DN and passwords for alternatives to specifying the password in the configuration file
  4. Start both servers in maintenance mode.
  5. In this backend, on the read-only replica being upgraded:
    • Add a replica entry for each replica that this backend on the master server points to (except the entry that previously pointed to the read-only replica that is being upgraded). This can include both peer servers and read-only replicas. Note that the master server might have other peer servers.
    • Add a replica entry to point to the master.
  6. On the master, ensure that the credentials are valid in the replica entry for the read-only replica being upgraded.
  7. Turn off maintenance mode on both servers.

The read-only replica and the master server are now peer read/write replicas for the backend.