Solutions
Archived

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

Last updated Jan 5, 2021

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

AM 6.x install fails with emb.creatingfamsuffix.failure error when installing on a Unix or Linux system

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)


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