Configuring OBIEE 11g To use Hyperion SSO Tokens For Essbase, HFM,EPM Fails With Error '[nQSError: 43119] Query Failed: [nQSError: 96002] Essbase Error: Login fails due to invalid login credentials (HY000)'

(Doc ID 1940079.1)

Last updated on MARCH 06, 2018

Applies to:

Business Intelligence Reporting and Publishing Option - Version and later
Information in this document applies to any platform.


Please see: Document 1993210.1 - OBIEE To Essbase Supported and Recommended Authentication Method and Release notes: Section 44.4.14, "Configuring SSO for Essbase and Hyperion Financial Management Data Sources With Oracle Business Intelligence,, and"


You are trying to setup shared SSO token between OBIEE ( Essbase (  by following steps outlined in the System Administrators Guide:

11.6 Configuring Oracle Business Intelligence to Use Hyperion SSO Tokens when Communicating with Essbase, Hyperion Financial Management, and EPM Workspace


Steps followed : Enabling Oracle Business Intelligence to Generate or Accept a Hyperion SSO Token when Connecting to Essbase, HFM, and EPM Workspace Release or Later

Before enabling to generate or accept a token, see Section 11.6.1, "Prerequisites for Configuring to Use Tokens."

To configure Oracle Business Intelligence for shared token generation when connecting to Essbase and Hyperion Financial Management and to accept tokens when integrated into EPM Workspace Release or later (installed with the EPM System Installer), you first run the runRegSyncUtil utility, then you run an epmsys_registry command.

To enable Oracle Business Intelligence to generate or accept a Hyperion SSO token:

  1. Locate the file in the BI_ORACLE_HOME/common/CSS/ directory and extract it to the same location.

  2. Copy the file from the system where Essbase or Hyperion Financial Management is installed:


    to the following location on the system where Oracle Business Intelligence is installed:

  3. On Linux systems, make executable using the following command:

    chmod +x
  4. Open (or runRegSyncEditUtil.bat on Windows systems) for editing. You can find the runRegSyncEditUtil file in the BI_ORACLE_HOME/common/CSS/ directory.

  5. In the file, update the ORACLE_HOME and ORACLE_INSTANCE environment variables as appropriate for the given Oracle Business Intelligence environment. Note that ORACLE_HOME should be equivalent to MW_HOME/Oracle_BI1 and ORACLE_INSTANCE should be equivalent to MW_HOME/instances/instancen.

  6. Save and close the file.

  7. Run the utility. The following example shows how to run the utility on Linux:

  8. Run the following command:

    BI_ORACLE_INSTANCE/config/foundation/ removeproperty 
  9. Restart the BI Domain, including the Administration and Managed Servers.

  10. Restart all OPMN processes.

  11. If the BI Domain has the "virtualize" property set to "true," then perform the following steps to set a system property that enables the CSS to use the appropriate attribute for GUIDs:

    1. In the MW_HOME/user_projects/domains/bifoundation_domain/bin directory, edit the file on UNIX or .cmd on Windows using the syntax appropriate for your operating system and shell.

      Add a Java system property after the EXTRA_JAVA_PROPERTIES line, as shown in the following example for the Windows platform:

      When you integrate with EPM System Release, add the Java system property as follows:

      set JAVA_PROPERTIES=%JAVA_PROPERTIES% -Didstore.identityAttribute=<name of the GUID attribute used by the identity store>

      When you integrate with EPM System Release or later, add the Java system property as follows:

      set JAVA_PROPERTIES=%JAVA_PROPERTIES% -Doracle.epm.css.identity.type=fusion
    2. Restart the Oracle WebLogic Server Administration Server and Managed Servers.

    3. After restarting the Managed Servers, confirm that the Java system property has been applied by reviewing the standard out file (typically bi_server1.out or the console) and looking for the Java system property that you have added.

When these steps are complete, you can select SSO in the data source connection pool in the Oracle BI Repository to designate an SSO connection. In the case of Workspace integration, you can continue to configure Oracle Business Intelligence for SSO using the Hyperion SSO token.


However after following these steps and running a report in OBIEE based off Essbase gave the following error : (Note that Shared Services and OBIEE were using the same OID for authentication. The OID users were provisioned in Shared Services prior to testing this setup.

  View Display Error
Odbc driver returned an error (SQLExecDirectW).
  Error Details
State: HY000. Code: 10058. [NQODBC] [SQL_STATE: HY000] [nQSError: 10058] A
general error has occurred. [nQSError: 43113] Message returned from OBIS.
  [nQSError: 43119] Query Failed: [nQSError: 96002] Essbase Error: Login fails   due to invalid login credentials (HY000)

When admin/password was used in the Connection Pool for essbase in rpd and unchecked SSO in connection pool settings, then the report ran fine


Sign In with your My Oracle Support account

Don't have a My Oracle Support account? Click to get started

My Oracle Support provides customers with access to over a
Million Knowledge Articles and hundreds of Community platforms