Access Multiple Essbase Servers Using a Centralized Smart View URL

You can configure a single point of end-user access from Smart View to multiple Essbase Server instances.

For independently deployed Essbase instances not registered with EPM Shared Services, you can use Provider Services to configure all the Essbase Servers to be accessible as nodes under one centralized Smart View URL.

After you do so, Smart View users will be able to access all the Essbase Servers using just one URL in their connection panel.

To set up the centralized URL access,

  1. On your current Essbase Server machine, navigate to the location of the clone scripts.

    • Linux

      <Essbase Product Home>/modules/oracle.essbase.sysman/scripts/copyclusterkey
    • Windows

      <Essbase Product Home>\modules\oracle.essbase.sysman\scripts\copyclusterkey

    If you do not know where <Essbase Product Home> is in your environment, refer to Environment Locations in the Essbase Platform for an explanation.

  2. Copy the cloneTokenManagerKeys (.sh or .cmd) script and the updatedClusterId.py file into the bin directory of <Domain Home> on your current Essbase Server machine. If you do not know where <Domain Home> is in your environment, refer to Environment Locations in the Essbase Platform for an explanation.

    For Linux,

    1. Copy cloneTokenManagerKeys.sh and updatedClusterId.py into $DOMAIN_HOME/bin. For example:

      /scratch/<home dir>/Oracle/Middleware/Oracle_Home/user_projects/domains/essbase_domain/bin
    2. Open a command prompt in the $DOMAIN_HOME/bin directory, and grant execute permission to cloneTokenManagerKeys.sh. For example,

      chmod +x cloneTokenManagerKeys.sh
    3. Run the script, providing a secondary Admin Server URL to synchronize it (for single sign-on using Provider Services) with the current server.

      The syntax is:

      ./cloneTokenManagerKeys.sh t3://<ADMIN-SERVER-NAME>:<ADMIN-PORT>

      For example:

      ./cloneTokenManagerKeys.sh t3://AdminServer2:7001

      If there are multiple environments to synchronize, enter the Admin Server URLs for each environment, delimited by spaces. For example:

      ./cloneTokenManagerKeys.sh t3://AdminServer2:7001 t3://AdminServer3:7001

      If TLS (SSL) is enabled, use the t3s protocol to specify the URL. For example:

      ./cloneTokenManagerKeys.sh t3s://AdminServer2:7002

    For Windows,

    1. Copy cloneTokenManagerKeys.cmd and updatedClusterId.py into %DOMAIN_HOME%\bin. For example:

      C:\Oracle\Middleware\Oracle_Home\user_projects\domains\essbase_domain\bin
    2. Open a command prompt in the %DOMAIN_HOME%\bin directory.

    3. Run the script, providing a secondary Admin Server URL to synchronize it (for single sign-on) with the current server using Provider Services.

      The syntax is:

      .\cloneTokenManagerKeys.cmd t3://<ADMIN-SERVER-NAME>:<ADMIN-PORT>

      For example:

      .\cloneTokenManagerKeys.cmd t3://AdminServer2:7001

      If there are multiple environments to synchronize, enter the Admin Server URLs for each environment, delimited by spaces. For example:

      .\cloneTokenManagerKeys.cmd t3://AdminServer2:7001 t3://AdminServer3:7001

      If TLS (SSL) is enabled, use the t3s protocol to specify the URL. For example:

      .\cloneTokenManagerKeys.cmd t3s://AdminServer2:7002
  3. After you are finished with the synchronizing process, restart all Essbase Servers that you synchronized with the current Essbase Server. Refer to Start, Stop, and Check Servers.

  4. Configure your Essbase Servers by adding them to Provider Services management using the Essbase web interface.

    1. In the Essbase web interface, navigate to the Console and click Configuration.

    2. Go to the Centralized URL tab and click Add.

    3. In the Add Host dialog, enter information about one of the Essbase Servers. Provide an Alias and an Agent URL.


      Add Host dialog. Alias entered is PHX250. Essbase URL entered is https://phx250.example.com:9001/essbase/agent.

    4. Click Submit, and click Add again to add more Essbase Servers that you want to make accessible from a single Smart View URL.


      Two centralized URLs configured in the Essbase web interface Console. The Essbase discovery URL https://iad150.example.com:9001/essbase/agent is associated with an alias of LocalMachine. Another Essbase discovery URL, https://phx250.example.com:9001/essbase/agent, is associated with an alias of PHX250.

    5. From Smart View, log in to the Essbase Server you just configured. You should be able to connect to all instances that you configured for centralized URL.


      Smart View private connection with two server instance nodes, PHX250 and LocalMachine under a single URL (the local machine URL).

    6. If you additionally want to set up high availability (failover) access to an application hosted on one or more of the Essbase Servers you configured using a centralized URL, proceed to Configure and Manage Active-Active (Read-Only) Essbase Clusters.