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)?
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
- Navigate to: Deployment > Servers > [Server Name] > Directory Configuration > Server, and add a new server or edit the existing server details as needed.
- Restart the web application container in which AM runs.
ssoadm
- 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.
- 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" />
- 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" />
- 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.
- 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?
Related Training
N/A
Related Issue Tracker IDs
N/A