IBMSLAPD_REPL_UPDATE_EXTRA_SECS environment variable

Edit online

You can use the IBMSLAPD_REPL_UPDATE_EXTRA_SECS environment variable to extend the time duration for update operations in replication.

The default timeout for any change to be completed through replication is 60 seconds. The replication updates might involve many changes, such as adding a large group entry or adding or modifying entries that contains large objects such as credentials. In such cases, the update operation might require more than 60 seconds to finish. Update operations include add, delete, modify, or modifydn operations. If any such single update operation through replication takes more than 60 seconds, the supplier server times out that update operation. It tries again to send the same update through replication. To extend the timeout duration for update operations in replication, you can use the IBMSLAPD_REPL_UPDATE_EXTRA_SECS environment variable.

The IBMSLAPD_REPL_UPDATE_EXTRA_SECS environment variable must be added to the supplier servers in a replication topology. A valid value must be provided for the environment variable to extend the timeout value. This value is added to the default timeout value of 60 seconds. The valid values for this variable are as follows:
  • Minimum: 1
  • Maximum: 2147483647
Note: For optimal result, a value of 180 is preferred for the variable. Setting the variable with a value greater than 600 is not preferred. Test the same update from a direct client against the consumer server from the supplier server. In this way, you can determine a value that is best suited for your environment.

The IBMSLAPD_REPL_UPDATE_EXTRA_SECS environment variable can be set either be adding the variable to the configuration file or by using the command prompt.

Adding the variable to configuration file
Using the LDAP client utility:
  1. Issue the ldapmodify command of the following format against the supplier server: 
    idsldapmodify -p port -D adminDN -w adminPW
dn: cn=Front End, cn=Configuration
changetype: modify
add: ibm-slapdSetenv
ibm-slapdSetenv: IBMSLAPD_REPL_UPDATE_EXTRA_SECS=180
  2. Restart the directory server instance.
Using the Web Administration Tool:
  1. Ensure that ibmslapd and ibmdiradm processes are running for the directory server instance.
  2. Log on to the directory server instance by using the Web Administration Tool.
  3. From the left navigation area, expand Directory management and then click Manage entries.
  4. On the Manage entries panel, expand cn=configuration, and then select cn=Front End and click Edit attributes.
  5. On the Edit and entry panel, click Next to open the Optional attributes panel.
  6. Click Multiple values next to the ibm-slapdSetenv field.
  7. In the resulting panel, enter IBMSLAPD_REPL_UPDATE_EXTRA_SECS=180 in the ibm-slapdSetenv field and then click Add.
  8. To save, click OK.
  9. To effect the changes that are made, restart the directory server instance.
From command prompt
Set the environment variable IBMSLAPD_REPL_UPDATE_EXTRA_SECS.
On AIX® and Linux™ systems (ksh shell):
export IBMSLAPD_REPL_UPDATE_EXTRA_SECS=180
On Windows™ systems:
set IBMSLAPD_REPL_UPDATE_EXTRA_SECS=180

For the set value of the environment variable to be effective, restart the directory server instance from the same shell where the IBMSLAPD_REPL_UPDATE_EXTRA_SECS environment variable was set.