Synchronizing Users With the Provision Users Utility

The ProvisionUsers utility—run by administrators through a command line interface—synchronizes Oracle Hyperion Planning users, groups, and roles in Oracle Hyperion Shared Services Console with a Planning application and with Oracle Essbase.

To use the utility:

  1. Launch the ProvisionUsers.cmd file from the planning1 directory, using the following syntax:

    ProvisionUsers [-f:passwordFile] /ADMIN:adminName /A:appName [/U:user1[;user2;user3]] [/R:n]

    For the full path to planning1, see About EPM Oracle Instance.

    Table 3-5 ProvisionUsers Syntax

    Parameter Description Required?

    [-f:passwordFile]

    Optional: If an encrypted password file is set up, use as the first parameter in the command line to read the password from the full file path and name specified in passwordFile. See Suppressing Password Prompts in Planning Utilities.

    No
    /ADMIN:adminName The administrator's name for logging on to the Planning application. Yes

    /A:appName

    The Planning application to synchronize (must be on the server on which the utility is run).

    Yes

    [/U:user1[;user2;user3]]

    Specifies users to synchronize. For example, to synchronize users Planner1 and Planner2, use /U:Planner1;Planner2. Omitting this argument synchronizes all users.

    No

    [/R:n]

    Specifies an interval, in minutes, in which synchronization is run. For example, to synchronize every 30 minutes, use /R:30. Omitting this argument performs the synchronization once.

    No

    /?

    Specified by itself, prints the syntax and options for ProvisionUsers.

    No
  2. If prompted, enter your password.

Example 1

Entering:

ProvisionUsers /ADMIN:admin /A:App1

Synchronizes all users in the App1 application.

Example 2

Entering:

ProvisionUsers /ADMIN:admin /A:App2 /U:Planner1 /R:60

Synchronizes user Planner1 in the App2 application every 60 minutes.