Repository tools command to import 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.
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.
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
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
|
Jazz.net channel User Education channel |
Agile learning circle Learning circles |
developerWorks forums |
Deployment wiki Support blog |
