Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Using the manage_cognos_capabilities utility


The manage_cognos_capabilities assigns BDSSA licenses to named BDSSA users and should be used after installing the BDSSA license hotfix.

Creating a fetch file using the manage_cognos_capabilities utility

Note

If you have applied the BDSSA license hotfix, the hotfix installer generated a new fetch file, and you can skip to Creating a sync file.

  1. Locate the manage_cognos_capabilities utility at the following location on the BDSSA server:

    Windows

    %BDS_HOME%\shared\odi\bin

    Linux

    $BDS_HOME/shared/odi/bin
  2. Execute the manage_cognos_capabilities.nsh script using the following command in cmd or shell terminal:

    Windows (Command Prompt window as Administrator)

    nsh manage_cognos_capabilities.nsh -f

    Linux (Shell terminal as root)

    nsh manage_cognos_capabilities.nsh -f

    The script may take 15-20 minutes to complete, depending on the number of users present in BDSSA.

    A cognos_reference_license_fetch.csv fetch file is created at the following location:

    Windows

    %BDS_HOME%\shared\ConfigurationManagement

    Linux

    $BDS_HOME/shared/ConfigurationManagement

    See a sample fetch file below:
    cognos_reference_license_fetch.png

Creating a sync file

  1. Create a new file named cognos_reference_license_sync.csv in the same location as the cognos_reference_license_fetch.csv file. The new file should have the same format as the cognos_reference_license_fetch.csv file but should only contain the list of users that will be granted licenses. For example:

    cognos_reference_license_sync.png

  • Ensure that the Username, Site Name, and Authorization are correct in the cognos_reference_license_sync.csv file. You can refer to the cognos_reference_license_fetch.csv file for syntax.
  • Ensure that the reporting capability listed for each user in the cognos_reference_license_sync.csv file match what is assigned by RBAC in TrueSight Server Automation.
  • Ensure that you have added only those users and capabilities to the cognos_reference_license_sync.csv file for whom you have licenses.
  • Do not include the BLAdmin or RBACAdmin users in this file as you cannot assign licenses to those users.

Executing the manage_cognos_capabilities utility

  1. Locate the manage_cognos_capabilities utility at the following location:

    Windows

    %BDS_HOME%\shared\odi\bin

    Linux

    $BDS_HOME/shared/odi/bin
  2. Execute the manage_cognos_capabilities.nsh script using the following command:

    Windows (Command Prompt window as Administrator)

    nsh manage_cognos_capabilities.nsh -s

    Linux (Shell terminal as root)

    nsh manage_cognos_capabilities.nsh -s
  3. Log on to BDSSA using any of the user accounts that are present in the cognos_reference_license_sync.csv file.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*