Technote (troubleshooting)
Problem(Abstract)
Attempts to assign user licenses results in only the first 250 users being shown in IBM Rational Team Concert.
Symptom
When assigning licenses to users in bulk, a wildcard search can be used to display all users.
The wildcard search only shows the first 250 users, and the additional users cannot be assigned licenses.
Cause
Only the first 250 users are shown because the wildcard search limit is hardcoded for this amount.
Resolving the problem
Assigning users in bulk can be completed by using repotools to export the user list and re-import the updated usernames.
- Run repotools -exportUsers to export the user list.
repotools-jts.sh -exportUsers toFile=users.csv adminUserId=<userid> adminPassword=<password> logFile=repotools-jts_exportUsers.log
The exact parameters for this command can be found in the Information Center under Repotools -exportUsers.
- The exported user list will look similar to the following:
image
- Manually update the file to allow the users to have the required license.
For example, in the above screenshot, the dev_user and contrib_user do not have a license type associated with username. To assign the users a developer license, [com.ibm.team.rtc.developer] should be added into the fourth column within the username row, as shown below.
image
- Import the users.csv file using repotools -importUsers.
repotools-jts.sh -importUsers fromFile=users.csv adminUserId=<userid> adminPassword=<password> logFile=repotools-jts_exportUsers.log
The exact parameters for this command can be found in the Information Center under Repotools -importUsers.
- Verify that the import was successful in the log file similar to the excerpt below.
Creating the user 'dev_user'...
The user 'dev_user' already exists. Updating the user...
Successfully updated the user 'dev_user'.
Assigning the license 'com.ibm.team.rtc.developer' to the user 'dev_user'...
Changes made in the Jazz Repository 'https://localhost:9443/jts'.
Number of users created in the Jazz repository: 0
Number of users updated in the Jazz repository: 298
Error creating 0 users, updating 0 users...
Jazz and Rational Team Concert have an active community that can provide you with additional resources. Browse and contribute to the User forums, contribute to the Team Blog and review the Team wiki. |
|---|
Rate this page:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.