Creating a User with the Command Service MBean

Provisioning Users With Sash 7-9

7.4.3 Creating a User with the Identity Add Command

The identity add command enables you to create a user with one command string. This command, which is an alias to the privateIdentity, publicIdentity, account, role and credentials commands, enables you to quickly create a basic user account that contains the minimum information needed for users to connect to OWLCS through a SIP client. For example, to create a basic account for user alice using this command, enter the following from either the command line or through the Command Service Mbean’s execute operation: identity add privateId=alice publicId=sip:sip.alicecompany.com role=Location Service realm=company.com password=welcome1 The identity add command only enables you to create a basic user account. Accounts that require more complex construction, such as those that associate multiple publicIds with a single privateId, must be created using multiple Sash commands as illustrated in Example 7–3 .

7.4.3.1 Deleting a User Account with the identity delete Command

The identity delete command enables you to delete all of a user’s roles, credentials, account information, public and private identities using a single command string. For example, to delete an account for user alice using this command, enter the following from either the command line or through the Command Service Mbean’s execute operation: identity delete privateId=alice

7.5 Provisioning the XDMS Using Sash

The commands for provisioning the XDMS are included in the xcap group. Each of these commands is preceded by xcap. The XDMS commands within the xcap group that support user provisioning are included in the user and applicationUsage subgroups. You can provision XDMS from the Sash prompt or by using the CommandService MBean that is provided with the Presence application.

7.5.1 Provisioning XDMS User Accounts Using the CommandService MBean

You can provision XDMS using the execute command provided by the CommandService MBean that is registered to the Presence application. Use the CommandService MBean’s execute operation as described in Creating a User with the Command Service MBean to provision accounts to the XDMS. For more information on the MBean itself, see Command Service XDMS Provisioning . Note: For applications configured to authenticate users against a RADIUS system the applications with the RADIUS Login Module as the security provider, the command to create a user account is as follows: identity add privateId=alice publicId=sip:sip.alicecompany.com role=Location Service 7-10 Oracle WebLogic Communications Server Administration Guide

7.5.2 Provisioning XDMS User Accounts from the Sash Prompt

To use XDMS commands to provision users and application usages from the Sash prompt, you must first connect to an application that consumes XDMS, such as Presence. For Windows systems, enter the following from the command prompt: launch_sash.bat -a application name On Linux, enter the following: launch_sash.sh -a application name For example, to connect to the Presence application on a Windows system: 1. From the command prompt, navigate to the sbin directory that contains the Sash executable. This file is located at MIDDLEWARE_ HOMEas11gr1wlcscommunicationssashsbin. 2. Enter the name of the Presence application using sash.bat -a presenceapplication. 3. When prompted, login to Sash using your OWLCS administrator name and password. 4. From the Sash command prompt, enter an XDMS command, such as xcap user list.

7.5.3 Using xcap Commands

This section describes how to manage user accounts and application usages using the xcap group of commands.

7.5.3.1 Provisioning XDMS User Accounts

The add, delete and list commands enable you to manage user accounts on the XDMS.

7.5.3.2 Adding XDMS Users

The xcap user add command adds an XDMS user with the given user name and application usage. For example, to add a user from the Sash prompt, enter: sash xcap user add userName=string appusage=string

7.5.3.3 Removing an XDMS User

The xcap user delete command removes an XDMS user with the given user name and all existing documents from the application usage. For example, to delete a user from the Sash prompt, enter: sash xcap user delete userName=string [ appusages=string ] The application usage parameter appusages is optional. If no application usage is specified, then the user is removed from all application usages. Note: Do not use the add command if the XDMS is configured to automatically create users. For more information on configuring XCAP, see Section 9.2.9, XCapConfigManager .