updateBPMAliasesAndRunAsRolesPasswords command

When the password of the user defined in the file registry or external security provider is changed and the user ID is used by IBM Business Process Manager authentication aliases or RunAs roles of IBM BPM applications, the password must be synchronized. The updateBPMAliasesAndRunAsRolesPasswords command enables this synchronization in one step.

This command provides a command-line method to synchronize passwords for authentication aliases or application RunAs roles after a password has been changed for a user defined in the file registry or external security provider. Before running this command, you should review the task topic "Changing IBM Business Process Manager passwords after installation."

The updateBPMAliasesAndRunAsRolesPasswords command is run using the AdminTask object of the wsadmin scripting client.

Prerequisites

The following conditions must be met:

The command must be run on the deployment manager node.
If the deployment manager is stopped, use the wsadmin -conntype none option to run the command in disconnected mode.
If the deployment manager is running, you must connect with a user ID that has WebSphere Application Server configurator privileges. Do not use the wsadmin -conntype none option.

Location

Start the wsadmin scripting client from the deployment_manager_profile/bin directory. The updateBPMAliasesAndRunAsRolesPasswords command does not write to a log file, but the wsadmin scripting client always writes a profile_root/logs/wsadmin.traceout log file where you will find exception stack traces and other information.

Syntax

updateBPMAliasesAndRunAsRolesPasswords
-userName user_name
-password new_password

Required parameters

-userName user_name: Specifies the user name of the user defined in the file registry or external security provider.
-password new_password: Specifies the new password for the user name.

Examples

Note: The examples are for illustrative purposes only. They include variable values and are not meant to be reused as snippets of code.

The following Jython example shows how to use the updateBPMAliasesAndRunAsRolesPasswords command:

dmgr_profile_root/bin>wsadmin -conntype NONE -lang jython

wsadmin>AdminTask.updateBPMAliasesAndRunAsRolesPasswords( [ '-userName', user_name, '-password', new_password ] ) 

You should see the following:

Processing: IBM_BPM_PerformanceDW_SingleCluster
Processing: IBM_BPM_Teamworks_SingleCluster
Processing: BPEContainer_SingleCluster
Processing: TaskContainer_SingleCluster

wsadmin>AdminConfig.save()