Repository tools command to create a new user

Use the createUser command to create a new user and assign a license, or update an existing user.

Purpose

The createUser command creates a new user and assigns a license. If a user with the specified user ID exists, that user will be updated with the name, email address, and license provided.
Important: The server must be running when you run the command.

Parameters

Attribute Description Required Default
userId The ID of the user to be created or updated. Yes N/A
name The name of the user. The default value is the user ID. No user ID provided above
emailAddress The email address of the contributor. No unknown
jazzGroup The group that the user is the member of. Valid values are: JazzAdmins, JazzProjectAdmins, JazzUsers, JazzGuests No none
licenseId The ID of the license to be assigned to the user. The license must exist. No none
generatePassword Use this parameter to generate random passwords for newly created users, instead of using a password that matches the user ID. No N/A
repositoryURL The connection URL for the server where the users will be stored. No https://localhost:9443/application

where application is jts, ccm, rm, qm, gc, dcc, or relm.

adminUserId Administrator user ID to login to the repository. No ADMIN
adminPassword Administrator password to login to the repository. No ADMIN
credentialsFile The file containing the administrator user's login credentials. No credentials.properties
certificateFile The file containing the administrator user's login certificate. No none
smartCard The alias to login using a smart card, or ? to list available aliases. No none
logFile Path to the log file. No repotools-application_createUser.log

where application is jts, ccm, rm, qm, gc, dcc, or relm.

Example

The following example is for Jazz Team Server. To use this command for the Change and Configuration Management application run repotools-ccm, for the Requirements Management application run repotools-rm, for the Quality Management application run repotools-qm, for the Global Configuration Management application run repotools-gc, for the Data Collection Component application run repotools-dcc, and for the Rational Engineering Lifecycle Manager run repotools-relm from the server directory.

For Windows operating system Open a command prompt and enter this command:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-jts.bat -createUser userid=testID name="Test User1" emailAddress=test@companyABC.com

For Unix operating systems Open a command line and enter this command:

cd opt/IBM/JazzTeamServer/server/
./repotools-jts.sh -createUser userid=testID name="Test User1" emailAddress=test@companyABC.com

video icon Watch videos

CLM playlist
Jazz.net channel
User Education channel

learn icon Learn more

CLM learning circle
Agile learning circle
Learning circles

ask icon Ask questions

Jazz.net forum
developerWorks forums

support icon Get support

Support Portal
Deployment wiki
Support blog