PingDirectory

Configuring a single listener-address for the replication server

Configure a single listener-address for the replication server to change the default setting of listening on all addresses.

About this task

By default, the replication server binds the listening ports to all available interfaces of the machine. To bind the listener to a specific address, change the address to the host name provided when replication is enabled and set the listen-on-all-addresses property to FALSE.

The replication server’s configuration entry stores a host name for itself so that it can resolve the address and specify it during the socket bind. If the server information is missing from the system, an error message generates with instructions on specific address binding. You can use the dsconfig tool to change the value of the listen-on-all-addresses property from TRUE (default) to FALSE.

To configure a replication server to listen on a single address:

Steps

  1. Create a new PingDirectory server instance and enable replication on port 8989.

  2. To see the ports bound for listening on port 8989, run netstat.

    A port of *.8989 means that it is listening on all addresses.

    Example:

    $ netstat -an | grep LISTEN | grep 8989
  3. To disable listening on all addresses for the replication server, run the dsconfig tool.

    Example:

    $ bin/dsconfig set-replication-server-prop \
      --provider-name "Multimaster Synchronization" \
      --set listen-on-all-addresses:false
  4. To see the ports bound for listening on port 8989, run netstat again.

    A port of <address>.8989, such as 10.8.1.211.8989, means that it is listening on the one address.