Configuring additional system lane users

Edit online

Traditional:
You can update your configuration settings to add, replace, or remove additional system lane users in the IBM® Business Automation Workflow environment.

About this task

By default, the only system lane user is the deployment environment administrator (which is defined during installation). A system lane user runs system tasks in system lanes. If the team that is associated with the system lane has multiple members, the first system lane user who is a member of the team is selected for running the task. You can configure additional system lane users by using the AdminConfig object commands in the wsadmin tool. This enables you to:

Use a unique system lane user for each application.
Use an LDAP user for system lane activities.

Important: The user name in the authentication alias is case-sensitive. Ensure that the authentication alias user name has the same capitalization as the user repository or LDAP account user name.

Procedure

To configure additional system lane users, complete the following steps. Run the commands in the wsadmin scripting tool as shown in the examples:

Specify the deployment environment name, and get the configuration ID for the deployment environment object.
```
deName = "De1"
de = AdminConfig.getid("/Cell:/BPMCellConfigExtension:/BPMDeploymentEnvironment:%s/" %deName)
```
where De1 must be replaced by the actual deployment environment name (can be an empty string if there is exactly one deployment environment in the WebSphere® Application Server cell).
Follow the appropriate option to add, replace, or remove a user.
- To add a system lane user:
  1. Ensure that the system lane user you want is a local security user or a user that is accessible from LDAP through the federated repository configuration.
  2. Create a new authentication alias for the system lane user.
  3. Add the new system lane user:
```
AdminConfig.modify(de, [ [ "SystemLaneUserAuthAliasNames", "NewSysLaneUserAlias" ] ] )
```
    where NewSysLaneUserAlias is the authentication alias of the new system lane user from step b.
    You can add one or more aliases by setting a string that contains a semicolon-separated list of aliases, for example:
```
additionalSystemLaneUserAliases = ";".join( [ 'NewAlias1', 'NewAlias2', 'NewAlias3' ] )
AdminConfig.modify(de, [ [ "SystemLaneUserAuthAliasNames", additionalSystemLaneUserAliases ] ] )
```
- To replace the existing system lane user aliases with a new list:
  1. Delete the existing list.
```
AdminConfig.modify(de, [ [ "SystemLaneUserAuthAliasNames", '' ] ] )
```
  2. Add the replacement list to the now empty list as described in step c of the section To add a system lane user.
- To remove a system lane user alias from the existing list:
  1. Get the list first, and then remove the unwanted entry.
```
systemLaneUserAliases = AdminConfig.showAttribute(de, "SystemLaneUserAuthAliasNames").split(";")
systemLaneUserAliases.remove( "OldAlias" )
```
  2. Replace the existing list with the modified list as described in the section "To replace the existing system lane user aliases with a new list".
Save the changes.
```
AdminConfig.save()
```
Synchronize the nodes, and restart the system to enable the changes to take effect.