Mapping Essbase Server Host Names to Cluster Names

To simplify the rehosting process for products that use Essbase as a data source, perform this task to map the server host name to the cluster name. This allows other EPM System products to connect to Essbase by cluster name.

You must perform this step before you update references for other products. This step adds search-and-replace host pairs to the Shared Services Registry that other products use to update their Essbase host environments.

Note:

Performance Management Architect requires this step even if the Essbase Server has not been rehosted.

  To map Essbase Server host names to cluster names:

  1. Add the ApsResolver property to essbase.cfg and essbase.properties.

    See Enabling Client Lookup by Cluster Name.

  2. From a command prompt on the machine hosting Shared Services, navigate to the following directory: EPM_ORACLE_INSTANCE/bin/upgrades.

  3. Run the following script:

    updateEssbaseServer oldEssbaseServerHost ClusterNameForNewHost

    where oldEssbaseServerHost is a fully qualified server name:port.

    Tip:

    The default cluster name is EssbaseCluster-1. The cluster name is case sensitive.

    The utility stores the mapping information between the earlier release of Essbase Server and the new logical cluster name in the Shared Services Registry.

  4. Repeat for each Essbase Server instance.