OpenAM 11.x, 12.0.0, 12.0.1 or 12.0.2 install fails with emb.creatingfamsuffix.failure error when installing on Microsoft Windows
The purpose of this article is to provide assistance if the OpenAM 11.x, 12.0.0, 12.0.1 or 12.0.2 install fails with an "emb.creatingfamsuffix.failure" error when installing on Microsoft® Windows® with an embedded OpenDJ configuration store.
Archived
This article has been archived and is no longer maintained by ForgeRock.
Symptoms
The installation fails when attempting to create the OpenAM suffix after the embedded configuration store is installed.
You can see this failure in the browser if you are configuring OpenAM via the browser:
Installing OpenAM configuration store in /openam/conf/opends...Success. Creating OpenAM suffix You have provided options for scheduling this operation as a task but options provided for connecting to the server's tasks backend resulted in the following error: 'Connect Error' Error loading OpenAM suffix 1 emb.creatingfamsuffix.failure, refer to install.log under /openam/conf for more information.The install.log (located in $HOME directory) also shows the same error, with additional details:
Installing OpenAM configuration store in /openam/conf/opends...Success. Creating OpenAM suffix You have provided options for scheduling this operation as a task but options provided for connecting to the server's tasks backend resulted in the following error: 'Connect Error' Error loading OpenAM suffix 1 AMSetupServlet.processRequest: error com.sun.identity.setup.ConfiguratorException: emb.creatingfamsuffix.failure at com.sun.identity.setup.EmbeddedOpenDS.setup(EmbeddedOpenDS.java:266) at com.sun.identity.setup.AMSetupServlet.setupEmbeddedDS(AMSetupServlet.java:964) at com.sun.identity.setup.AMSetupServlet.setupSMDatastore(AMSetupServlet.java:1020) at com.sun.identity.setup.AMSetupServlet.configure(AMSetupServlet.java:1092) at com.sun.identity.setup.AMSetupServlet.processRequest(AMSetupServlet.java:692) at com.sun.identity.config.DefaultSummary.createDefaultConfig(DefaultSummary.java:131) ...Similarly, the same error is also shown in the web application container log (for example, catalina.out for Apache Tomcat™):
amSetupServlet:02/01/2016 10:22:56:912 PM CET: Thread[pool-2-thread-1,5,main] ERROR: You have provided options for scheduling this operation as a task but options provided for connecting to the server's tasks backend resulted in the following error: 'Connect Error'Recent Changes
Installed a fresh build of OpenAM 11.x, 12.0.0, 12.0.1 or 12.0.2 on Microsoft Windows.
Causes
You have previously installed an external version of OpenDJ on the same server as the one you are now attempting to install OpenAM. The external OpenDJ installation created a $HOME/.opendj/tools.properties file with its own configuration, which is overriding the connection details (hostname, port etc) for the embedded configuration data store.
Solution
This issue can be resolved by upgrading to OpenAM 12.0.3 or later; you can download this from BackStage. Alternatively, you can remove the $HOME/.opendj/tools.properties file prior to re-installing OpenAM.
See Also
OpenAM Installation Guide › Preparing For Installation
OpenAM Installation Guide › Preparing For Installation › Preparing a Fully-Qualified Domain Name
Related Training
N/A
Related Issue Tracker IDs
OPENAM-4983 (Commands for embedded DJ should use --noPropertiesFile switch)