Repository tools command to import users from a file

Use the importUsers command to create or update a batch of users from a file.

Purpose

The importUsers command can be used to create or update a batch of users from a CSV file. The CSV file is comma separated value that lists:
userid,name,email@example.org,[com.ibm.team.foundation.user],[JazzUser],0
  • userid is the user ID of the user.
  • name is the name of the user.
  • email@example.org is the email address of the user.
  • [com.ibm.team.foundation.user] is the list of licenses.
  • [JazzUser] is the list of repository groups.
  • 0 means that the user is not archived. If the user is archived, this value is 1.
Important: The server must be running when you run the command.

Parameters

Attribute Description Required Default
fromFile The path to the file containing the users to be created or updated. The format of the file is a comma separated list of userid, name, email address, license id(s), and repository group name(s). Yes users.csv
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. No https://localhost:9443/application

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

adminUserId Administrator user ID to login to the Jazz repository. No ADMIN
adminPassword Administrator password to login to the Jazz 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_importUsers.log

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

Sample

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 -importUsers fromFile=C:\users.csv repositoryURL=https://hostname.example.com:9443/jts

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

cd opt/IBM/JazzTeamServer/server/
./repotools-jts.sh -importUsers fromFile=opt/users.csv repositoryURL=https://hostname.example.com:9443/jts

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