Book
ForgeRock Identity Platform
Does not apply to Identity Cloud

Installing and configuring AM

This book provides information on installing and configuring AM, including frequently asked questions and known issues.


Printer friendly view

Table of Contents

  • 1 General
    • 1.1 What automation tools are available for installing, upgrading and configuring AM deployments (All versions)?
    • 1.2 What versions of DS are compatible with AM?
    • 1.3 What versions of Agents are compatible with AM?
    • 1.4 What versions of IG are compatible with AM?
    • 1.5 What versions of AM are compatible with IDM?
    • 1.6 How do I check if a particular AM (All versions) instance is running?
    • 1.7 How do I check what version of AM (All versions) I have installed?
    • 1.8 How do I upgrade Apache Tomcat for an existing AM (All versions) install?
  • 2 Configuration
    • 2.1 Best practice for configuring sessions in AM (All versions) to reduce the impact on the CTS store
    • 2.2 How do I export and import Service configurations for AM (All versions)?
    • 2.3 How do I make a backup of configuration data in AM 5.x or 6.x?
    • 2.4 How do I make AM 5.x and 6.x communicate with a secured LDAP server?
    • 2.5 How do I enable SSL in AM (All versions) post-install?
    • 2.6 How do I enable SSL in AM (All versions) for an existing installation?
    • 2.7 How do I configure the heartbeat timeout in AM (All versions)?
    • 2.8 How do I register or re-register a custom authentication module in AM 5.5.x, 6.x and 7.x?
    • 2.9 How do I delete an AM 5.x or 6.x instance from a site along with the replicated embedded DS server?
    • 2.10 How do I remove console access in AM (All versions)?
    • 2.11 Best practice for blocking the top level realm in a proxy for AM (All versions)
    • 2.12 How do I safely enable the org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH setting in AM (All versions)?
    • 2.13 How do I update the certificate alias for the signing key in the AM (All versions) keystore?
    • 2.14 How do I update the authentication signing secret in AM (All versions)?
    • 2.15 How do I configure AM (All versions) to check the HTTP header for the user certificate?
    • 2.16 How do I set up Realm DNS Aliases in AM (All versions) when CDSSO is configured?
    • 2.17 How do I configure which pages are displayed upon successful and failed logins in AM (All versions)?
    • 2.18 How do I configure a list of valid goto URL resources in AM 5.x, 6.0.0.x, 6.5.0.x, 6.5.1 and 6.5.2.x?
    • 2.19 How do I create a script in AM (All versions) using Amster?
  • 3 Frequently Asked Questions
    • 3.1 FAQ: Installing AM
    • 3.2 FAQ: Configuring AM
    • 3.3 FAQ: Patches in AM
    • 3.4 FAQ: General AM
    • 3.5 FAQ: AM compatibility with third-party products
    • 3.6 How do I count the number of users in my ForgeRock deployment?
  • 4 Known Issues
    • 4.1 AWS web application firewall blocks traffic from AM (All versions) causing authentication flows to fail
    • 4.2 High thread count seen in AM (All versions) with many RUNNABLE I/O dispatcher threads
    • 4.3 Unable to parse product versions for comparison error after restarting AM (All versions)
    • 4.4 An illegal reflective access operation has occurred when using Java 11 with ForgeRock products
    • 4.5 Duplicate key [cot_name] after importing SAML2 metadata in AM 6.5.x or upgrading
    • 4.6 Install
      • 4.6.1 AM 6.x install fails with Encrypt Private Key failed: unrecognized algorithm name: PBEWithSHA1AndDESede error
      • 4.6.2 AM 5.x or 6.x install fails with emb.creatingfamsuffix.failure error when installing on a Unix or Linux system
      • 4.6.3 javax.naming.AuthenticationException: [LDAP: error code 49 - Invalid Credentials] error when reinstalling an AM 5.x or 6.x instance
    • 4.7 Startup and Shutdown
      • 4.7.1 Error during shutdown message when stopping an AM 6 instance running on Apache Tomcat
      • 4.7.2 AM (All versions) fails to start due to SEVERE: ContainerBase.addChild: start: error on Apache Tomcat
      • 4.7.3 Memory leak messages when shutting down Apache Tomcat web container running AM (All versions)
    • 4.8 Login Page
      • 4.8.1 Login page fails to load with HTTP 500 response in AM (All versions)
      • 4.8.2 Default Configuration page shown instead of Login page in AM (All versions)
      • 4.8.3 Attempting to access AM (All versions) fails with ConfigurationException: Configuration store is not available
      • 4.8.4 Login page in AM (All versions) hangs on Loading when CORS is enabled
      • 4.8.5 Multiple mappings found for organization identifier error when logging into AM (All versions)
      • 4.8.6 Login page does not load when using authentication trees with custom or Marketplace nodes in AM 6.5.x or 7.x
      • 4.8.7 Login page does not load or ssoadm fails in AM (All versions) running on Apache Tomcat 8.5 or 9
    • 4.9 Configuration
      • 4.9.1 No secret with id storepass for purpose storepass errors after upgrading to AM 6.5.x or 7.x
      • 4.9.2 Unable to read secret/private key error in AM 6.5.x or 7.x
      • 4.9.3 Secret store fails to start with Label must match regex exception in AM 6.5.0.x, 6.5.1 and 6.5.2.x
      • 4.9.4 Cannot recover key error shown when renewing expired certificates or changing the password for the keystore or truststore in AM (All versions)
      • 4.9.5 Unable to retrieve certificate with alias 'test' from keystore after making changes to the keystore in AM (All versions)
      • 4.9.6 AM (All versions) Login flow fails with java.lang.IllegalArgumentException: Request header too large
      • 4.9.7 Federation related pages do not display in the console with a java.lang.NoClassDefFoundError: sun/misc/CharacterEncoder error in AM 6.5.x
      • 4.9.8 Unidentified properties or Invalid properties message when adding custom advanced server properties in AM (All versions)
      • 4.9.9 Error when flushing the writer message when AM (All versions) is under high load with audit logging enabled
  • 5 Patches
    • 5.1 How do I check what patches are installed for ForgeRock products?
    • 5.2 How do I install an AM patch (All versions) supplied by ForgeRock support?