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
  • Creating a sync file
  • Executing the manage_cognos_capabilities utility

Creating a fetch file using the manage_cognos_capabilities utility

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:
   

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:

   

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