IBM Support

Unable to assign licenses in Bulk to more than 250 users

Troubleshooting


Problem

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.

  1. 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.


  2. The exported user list will look similar to the following:

    image



  3. 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



  4. 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.


  5. 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...


Leverage the Jazz Community

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.
Refer to technote 1319600 for details and links.

[{"Product":{"code":"SSUC3U","label":"IBM Engineering Workflow Management"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Team Server","Platform":[{"code":"PF033","label":"Windows"},{"code":"PF016","label":"Linux"}],"Version":"3.0","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Rational Team Concert

Document Information

Modified date:
16 June 2018

UID

swg21496206