6.12. Adjusting the replication release timeout
An IdM replica is exclusively locked during a replication session with another replica. In some environments, a replica is locked for a long time due to large updates or network congestion, which increases replication latency.
You can release a replica after a fixed amount of time by adjusting the repl-release-timeout
parameter. Red Hat recommends setting this value between 30
and 120
:
- If the value is set too low, replicas are constantly reacquiring one another and replicas are not able to send larger updates.
-
A longer timeout can improve high-traffic situations where it is best if a server exclusively accesses a replica for longer amounts of time, but a value higher than
120
seconds slows down replication.
Default value |
|
Valid range |
|
Recommended range |
|
Conditions préalables
- Le mot de passe du gestionnaire de répertoire LDAP
Procédure
Display the database suffixes and their corresponding back ends.
dsconf -D "cn=Directory Manager" ldap://server.example.com backend suffix list
[root@server ~]# dsconf -D "cn=Directory Manager" ldap://server.example.com backend suffix list cn=changelog (changelog) dc=example,dc=com (userroot) o=ipaca (ipaca)
Copy to Clipboard Copied! This command displays the names of the back end databases next to their suffix. Use the suffix name in the next step.
Modify the value of the
repl-release-timeout
attribute for the main userroot database. This example increases the value to90
seconds.dsconf -D "cn=Directory Manager" ldap://server.example.com replication set --suffix="dc=example,dc=com" --repl-release-timeout=90
[root@server ~]# dsconf -D "cn=Directory Manager" ldap://server.example.com replication set --suffix="dc=example,dc=com" --repl-release-timeout=90
Copy to Clipboard Copied! Authenticate as the Directory Manager to make the configuration change.
Enter password for cn=Directory Manager on ldap://server.example.com: Successfully replaced "repl-release-timeout"
Enter password for cn=Directory Manager on ldap://server.example.com: Successfully replaced "repl-release-timeout"
Copy to Clipboard Copied! (Optional) If your IdM environment uses the IdM Certificate Authority (CA), you can modify the value of the
repl-release-timeout
attribute for the CA database. This example increases the value to90
seconds.dsconf -D "cn=Directory Manager" ldap://server.example.com replication set --suffix="o=ipaca" --repl-release-timeout=90
[root@server ~]# dsconf -D "cn=Directory Manager" ldap://server.example.com replication set --suffix="o=ipaca" --repl-release-timeout=90 Enter password for cn=Directory Manager on ldap://server.example.com: Successfully replaced "repl-release-timeout"
Copy to Clipboard Copied! Restart the Directory Server.
systemctl restart dirsrv.target
[root@server ~]# systemctl restart dirsrv.target
Copy to Clipboard Copied! -
Monitor the IdM directory server’s performance. If it does not change in a desirable way, repeat this procedure and adjust
repl-release-timeout
to a different value, or back to the default of60
seconds.
Verification steps
Display the value of the
nsds5ReplicaReleaseTimeout
attribute and verify it has been set to your desired value.ldapsearch -D "cn=directory manager" -w DirectoryManagerPassword -b "cn=replica,cn=dc\3Dexample\2Cdc\3Dcom,cn=mapping tree,cn=config" | grep nsds5ReplicaReleaseTimeout
[root@server ~]# ldapsearch -D "cn=directory manager" -w DirectoryManagerPassword -b "cn=replica,cn=dc\3Dexample\2Cdc\3Dcom,cn=mapping tree,cn=config" | grep nsds5ReplicaReleaseTimeout nsds5ReplicaReleaseTimeout: 90
Copy to Clipboard Copied!
The Distinguished Name of the suffix in this example is dc=example,dc=com
, but the equals sign (=
) and comma (,
) must be escaped in the ldapsearch
command.
Convert the suffix DN to cn=dc\3Dexample\2Cdc\3Dcom
with the following escape characters:
-
\3D
replacing=
-
\2C
replacing,