Running the Consent Service setup script requires special consideration in an environment that includes replicated PingDirectory Servers. If possible, setup the Consent Service after replication is enabled for the PingDirectory Servers. See the PingDirectory Server Administration Guide for details about server replication.

Set up Consent Service after replication is enabled

Complete the following steps if replication is already enabled for PingDirectory Servers.

  1. If needed, configure the PingDirectory Servers to use a configuration group called "all-servers." This will ensure that configuration changes are applied to all servers in a topology.
    $ bin/dsconfig set-global-configuration-prop \
      --set configuration-server-group:all-servers
         
  2. Run the Consent Service setup script.
    $ bin/dsconfig --no-prompt \
      --batch-file resource/consent/consent-service-cfg.dsconfig
      --applyChangeTo server-group
         

Set up Consent Service before replication is enabled

If you have already set up the Consent Service on a standalone PingDirectory Server, perform the following the steps before enabling replication. In this example, "DS1" is the original PingDirectory Server, and "DS2" is the second server that will be added as a replica.

  1. Run the config-diff command without arguments on DS1 to produce a batch file that contains configuration changes that will be applied to DS2.
    $ bin/config-diff > config-changes.dsconfig
  2. Apply the config-changes.dsconfig file to DS2.
    $ bin/dsconfig --no-prompt \
      --batch-file config-changes.dsconfig \
      --applyChangeTo single-server
         
  3. Restart DS2.
  4. Enable replication between the two servers.