Configuring the Adapter for Essbase

In this section:

x

Configuring the adapter consists of specifying connection and authentication information for each of the connections you want to establish.


Top of page

x
Declaring Connection Attributes

How to:

Reference:

When connecting to an Essbase Analytical Server, you must use Explicit authentication or Password passthru. This method requires that user IDs and passwords be explicitly stated in the SET CONNECTION_ATTRIBUTES command. You can include these commands in the server global profile, edasprof.prf, for all users. You can also issue the SET DEFAULT_CONNECTION command in the edasprof.prf file to select one of these connections as the default connection to use if the Access File does not include a server or connection name.

When you access an Essbase Analytical Server using the Reporting Server, you are identified by a user ID and password. The Database Administrator can assign management privileges to a specific user, where privileges:

For more information on security, see the Hyperion Essbase documentation.



x
Procedure: How to Declare Connection Attributes

You can configure the adapter from either the Web Console or the Data Management Console.

  1. From the Web Console menu bar, click Adapters.

    or

    From the Data Management Console, expand the Adapters folder.

    The Adapters folder opens.

  2. Expand the Available folder, if it is not already expanded.
  3. Expand the appropriate group folder and the specific adapter folder. The group folder is described in the connection attributes reference.
  4. Right-click the adapter name and/or version and select Configure.

    The Add Adapter to Configuration pane opens.

  5. Enter values for the parameters required by the adapter, as described in the connection attributes reference.
  6. Click Configure. The configured adapter is added to the Adapters list in the navigation pane.


x
Reference: Connection Attributes for Essbase

The Essbase adapter in under the OLAP group folder.

The following list describes the connection attributes for which you can supply values. To complete the attribute declaration, click the Configure button.

Connection name

Logical name used to identify this particular set of connection attributes. The default is CON01.

Server

Machine name where Essbase is running.

Security

There are two methods by which a user can be authenticated when connecting to a database server:

  • Explicit. The user ID and password are explicitly specified for each connection and passed to the database, at connection time, for authentication.
  • Password Passthru. The user ID and password received from the client application are passed to the database, at connection time, for authentication.

The Password Passthru option requires that the server be started with DBMS security for Essbase Server authentication. See the Server Administration manual for information about configuring DBMS security.

User

User name by which you are known to the database.

Password

Password associated with the user name.

Outline Access

Existing connection name which is assumed to have Essbase Database Outline access and will be referenced by users having no Database Outline access privileges.

Select profile

Select a profile from the drop-down menu to indicate the level of profile in which to store the CONNECTION_ATTRIBUTES command. The global profile, edasprof.prf, is the default.

If you wish to create a new profile, either a user profile (user.prf) or a group profile if available on your platform (using the appropriate naming convention), choose New Profile from the drop-down menu and enter a name in the Profile Name field (the extension is added automatically).

Store the connection attributes in the server profile (edasprof).



x
Syntax: How to Declare Connection Attributes Manually

Explicit authentication. The user ID and password are explicitly specified for each connection and passed to Essbase, at connection time, for authentication.

ENGINE ESSBASE SET CONNECTION_ATTRIBUTES [connection]server							user/pwd						

Password passthru authentication. The user ID and password are explicitly specified for each connection and passed to Essbase, at connection time, for authentication. This option requires that the server be started with security set to DBMS.

ENGINE ESSBASE SET CONNECTION_ATTRIBUTES [connection]server 

where:

ESSBASE

Indicates the adapter. You can omit this value if you previously issued the SET SQLENGINE command.

connection

Is the server name used as a connect descriptor to the Essbase Server across the network.

server

Is the machine where Essbase is running.

userid

Is the primary authorization ID by which you are known to Essbase.

password

Is the password associated with the primary authorization ID.


Top of page

x
Testing an Essbase Connection

How to:

Once connections have been defined in the edasprof.prf server global profile, the connection named in the first SET CONNECTION_ATTRIBUTES command serves as the default connection, which is used if the Access File does not specify connection name or server. You can override this default using the SET DEFAULT_CONNECTION command.



x
Procedure: How to Test an Essbase Connection

There are two ways to access the Test function:

Right-click a connection and select Test from the pop-up menu.

or

  1. Right-click a connection and select Properties from the pop-up menu.

    The Change Connect Parameters pane opens.

  2. Click the Test button.

WebFOCUS