Project Assignment to Users using CLI

Use the Command Line Interface (CLI) for project assignment to the users.

The Project Assignments feature enables administrators to manually assign project metadata to users whose license checkout records lack native project association. This is especially useful when dealing with license servers that do not provide project details in their checkout logs.

Many license servers do not include project information in the license usage data. This creates a gap in reporting, making it difficult to track usage by project. The Project Assignments feature fills this gap by allowing administrators to explicitly associate users with projects for specific time periods.

Administrators can create these assignments through User Interface or Command Line Tool, specifying the user, host, project name, and a validity period. During this period, any license checkouts by the user are automatically tagged with the assigned project, enhancing project-level reporting accuracy. This feature ensures consistent attribution even when upstream data is incomplete.

  1. Navigate to <SERVER INSTALLATION>/exec/bin/project_assignments_commandline_tool.
  2. Run the following command to view the help of the project assignment CLI tool script: 
    ./project_assignments_commandline_tool --help


    The project_assignments_commandline_tool script requires the following arguments:
    • -user: Mandatory field
    • -host: Optional field
    • -project: Mandatory field
    • -expiry: Mandatory field
    Note: The arguments are case sensitive and the expiry should be provided in minutes.
  3. Enter the following command to assign the project to a user: 
    ./project_assignments_commandline_tool -user <User Name> -project <Project Name> -expiry <Time>
    For example: 
    ./project_assignments_commandline_tool -user amarch -project IPLA -expiry 60


  4. Click Administration > Project Assignment in the InsightPro for License Analytics portal.
    The project assignment to the user will be displayed. This ensures that the checkout made by this user for the coming 60 minutes will be directed under the project of InsightPro for License Analytics. Checkouts made during this project assignment period will have the project as assigned.


  5. Verify that checkouts made after the creating of the Project for the user amarch are now having the value InsightPro for License Analytics whereas the ones before that have Project as N/A.