Repository tools command to import users from a file

Edit online

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.
kerberos Authenticate with Windows user credentials using Kerberos/SPNEGO by setting to true. Or authenticate with Windows Integrated Authentication by setting to windows. No None

Sample

The following example is for Jazz® Team Server. To use this command for other applications, run these options from the server directory:
  • IBM® Engineering Workflow Management (Change and Configuration Management application): repotools-ccm
  • IBM Engineering Requirements Management DOORS® Next (Requirements Management application): repotools-rm
  • IBM Engineering Test Management (Quality Management application): repotools-qm
  • Global Configuration Management: repotools-gc
  • Data Collection Component: repotools-dcc
  • IBM Engineering Lifecycle Optimization - Engineering Insights: repotools-relm

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 kerberos=true

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