The ProvisionUsers utility—run by administrators through a command line interface—synchronizes Planning users, groups, and roles in Shared Services Console with a Planning application and with Essbase.
To use the utility:
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 24. 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 |
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.