Default language.

Configuring environment settings

The following instructions describe how to configure BMC product servers to prepare for adding deployments to connect to the license utility.

Note

Configuration is not required for:

  • BMC Digital Workplace (MyIT) 3.1 to 3.3
  • BMC Network Automation (BNA)
  • BMC Release Package and Deployment (RPD)

Configuring BMC Digital Workplace (MyIT) 3.4 to 18.08 

  • Specify the user for the BMC Digital Workplace application with the administrator / super administrator role.

Configuring BMC Discovery (Discovery)

Detailed instructions...
  • Ensure that the BMC Discovery environment is configured with HTTPS.
  • Ensure that the BMC Discovery credentials have administrative rights to collect the BMC Discovery license information.
  • For BMC Discovery version 11.1, users need to have API access permission to query and get data.
  • For BMC Discovery versions 11.2x and later, enter the user with Rest API and license data permission over HTTPS.  Do not use the system user.

Configuring BMC Database Automation (BDA) 

Detailed instructions...

UNIX

  1. Ensure that the SSHD process is running on the respective port.
Note

BDA license gathering is supported only for the root user.

Configuring BMC Server Automation (BSA 8.2 to 8.6)

  • Beginning with BMC License Usage Collection Utility 4.0.00, we are using the JDBC approach.
  • The database user should be the normal user with Read/Write permissions to the Database schema. 

Configuring BMC Server Automation (BSA 8.7 to 8.9.02) / TrueSight Server Automation 8.9.03  

Detailed instructions...
Note
  • For BSA 8.7 Windows and UNIX: The “Profile User” must be assigned to the “BLAdmins” role.
  • For version 8.9.03, the product name has been changed to TrueSight Server Automation.

Windows and UNIX

Identify the servers where BMC Server Automation (BSA) Appserver is installed. 

Windows

Ensure that the NSH folder is in the system path. 

UNIX

Ensure that the SSHD process is running on the respective port.

Configuring BMC Client Management (BCM) 

Ensure that the BCM credentials have administrative rights to collect the BCM License information.

Configuring BMC Performance Manager Portal (BPM Portal v2.11) 

Detailed instructions...

Windows and UNIX

  1. For UNIX, ensure that the SSHD process is running on the respective port.
  2. Identify the servers where the BMC Performance Manager Portal database is installed.
  3. Ensure that, on the Oracle database server, either the ORACLE_BASE or the DATASTORE_HOME environment variable is set.
    The License Utility will check for these two environment variables.
  4. For Windows, ensure that %ORACLE_BASE%\utility\BPM_Datastore_Utility or %DATASTORE_HOME%\utility\BPM_Datastore_Utility exists and is accessible.For Unix, ensure that $ORACLE_BASE/utility/BPM_Datastore_Utility or $DATASTORE_HOME/utility/BPM_Datastore_Utility exists and is accessible.

While configuring the BMC Performance Manager Portal, ensure that the following tasks as complete:

  • SQL Plus is invoked and running with the database user that is provided on the BMC License Usage Collection Utility.
    To verify that SQL Plus is invoked, ensure that the tnsnames.ora file is present with correct instance names of the BMC Performance Manager Portal database configured.
  • For UNIX, you have Bash shell installed on the machine where you have the BMC Performance Manager Portal database.

Notes

  • In Windows the user should belong to the group ora_dba. In Unix it is group dba.
  • Ensure that the BPM_Datastore_Utility folder is present on the BMC Performance Manager Portal database server.
    To add the BPM_Datastore_Utility folder to the BMC Performance Manager Portal database server, copy the folder from the BMC Performance Manager Portal application server to the BMC Performance Manager Portal database server.
  • Ensure that the BMC_PM_Portal_Licensing_Report SQL file is present in the Scripts folder that is required to generate the BMC Performance Manager Portal license information.
    For example, C:\BMCSoftware\Datastore\ora10g\utility\BPM_Datastore_Utility\Scripts
    You can download the BMC_PM_Portal_Licensing_Report SQL file from BMC Performance Manager Portal License Usage Utility 1.0 link on Electronic Product Download.
  • If you have your own Oracle license, to use ORACLE_BASE as an equivalent to DATASTORE_HOME perform the following steps:
    1. Create a utility folder with ORACLE_BASE as the parent folder.
    2. Copy the BPM_Datastore_Utility folder to ORACLE_BASE\<Utility folder name>.

Windows

Ensure that the "ORACLE_BASE or DATASTORE_HOME " environment variable is set for the logged-in user (Server user field value) on that server.

UNIX

  1. Ensure that the "ORACLE_BASE or DATASTORE_HOME " environment variable is set in the “. profile” file for the logged-in user (Server user field value) on that server.
  2. Make sure one of the following files has the execute permission:
    1. $ORACLE_BASE/utility/BPM_Datastore_Utility/DatastoreCliBMCPDS.sh
    2. $DATASTORE_HOME/utility/BPM_Datastore_Utility/DatastoreCliBMCPDS.sh 
  3. If not, assign the permission using the following command: chmod +x DatastoreCliBMCPDS.sh.

Configuring BMC Release Process Management (RPM)

The user must be in the "Root" group to have access to the v1 API.

Configuring Remedy AR System Server (ARS) based products

Detailed instructions...

Windows

  1. Identify the server where Remedy AR System Server (ARS) is installed.
  2. Ensure that the "BMC_AR_SYSTEM_HOME" environment variable is set on that server.

UNIX

  1. Ensure that the SSHD process is running on the respective port.
  2. Ensure that the user whose credentials are being used by the License Utility to connect to this server has BMC_AR_SYSTEM_HOME mapped to the correct directory and exported in the .profile file. For example:  Export BMC_AR_SYSTEM_HOME=/<dir1>/<dir2>/ARSystem
  3. Ensure that the non-root user as read access permission for the $BMC_AR_SYSTEM_HOME/db/LicenseReport.txt file.
  4. If the BMC_AR_SYSTEM_HOME variable is not set:
    1. Log in to the Unix machine with the user name and credentials used in the "Server User" and "Server password" fields on the License Utility UI while adding the deployment.
    2. Copy the script from location:"<LU_Install_Directory>/licenseusagecollector/EnvVariableScripts" to the Unix machine.
    3. Give execute permission to the script using chmod +x <scriptname>.

    4. Execute the script.

      Sample run...

      Sample run.png

Configuring TrueSight Operations Management (TSOM) 10.7 to 11.3.01

Only super and tenant administrator credentials are required to collect the TSOM license information.

Configuring TrueSight Capacity Optimization (TSCO) 10.7 to 11.3.01

  1. Log in to the TSCO console. 
  2. Enter the server name from Administration >COMPONENTS > Backend Services > API Providers - Data service.
    1.  Alternatively you can obtain your server name from the following path: Administration >COMPONENTS > Backend Services > API Providers - Data service).

For example: The API is exposed through a REST interface available at the following address:
https://xyz-tdr-abc.efg.com:8280/dh-services/data

 

 

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