How To
ForgeRock Identity Platform
Does not apply to Identity Cloud

How do I add a second configuration store or edit an existing configuration store in AM (All versions)?

Last updated May 10, 2022

The purpose of this article is to provide information on adding a second configuration store to AM. You may want to do this in a high availability (HA) environment where you have multiple servers in a site. This information can also be used to update an existing directory configuration and includes a way of doing it via ssoadm.


3 readers recommend this article

Maintaining configuration store details

You can add a second configuration store or update details for an existing configuration store using either the console or ssoadm:

Console

  1. Navigate to: Deployment > Servers > [Server Name] > Directory Configuration > Server, and add a new server or edit the existing server details as needed.
  2. Restart the web application container in which AM runs.

ssoadm

  1. Output the current server configuration details to an XML file using the following command: $ ./ssoadm get-svrcfg-xml -u [adminID] -f [passwordfile] -s [serverName] -o [XMLfile]replacing [adminID], [passwordfile], [serverName] and [XMLfile] with appropriate values.
  2. Locate the following section in the XML file you output in step 1 (ServerGroup name="sms"): <ServerGroup name="sms" minConnPool="1" maxConnPool="10">    <Server name="Server1" host="localhost" port="18080" type="SIMPLE" />
  3. Update these server details if you want to make amendments; otherwise add a new line if you want to add a second configuration store. For example: <ServerGroup name="sms" minConnPool="1" maxConnPool="10">    <Server name="Server1" host="localhost" port="18080" type="SIMPLE" />     <Server name="Server2" host="localhost" port="28080" type="SIMPLE" />
  4. Upload the updated server configuration XML file to AM using the following command: $ ./ssoadm set-svrcfg-xml -u [adminID] -f [passwordfile] -s [serverName] -X [XMLfile]replacing [adminID], [passwordfile], [serverName] and [XMLfile] with appropriate values.
  5. Restart the web application container in which AM runs.

See Also

How do I change the password for the configuration store in AM (All versions)?

How do I migrate from an embedded to external DS in AM 5.x or 6.x?

ssoadm

Related Training

N/A

Related Issue Tracker IDs

N/A


Copyright and Trademarks Copyright © 2022 ForgeRock, all rights reserved.