Configuring TrueSight Infrastructure Management cells


Configuring TrueSight Infrastructure Management cells for event and impact reporting

This procedure configures the Report Engine gateway, enables the event propagation policy, and subscribes the cells in the Report Engine. You can configure TrueSight Infrastructure Management cells for event and impact reporting if:

  • You are working with TrueSight Infrastructure Management Server v10.7, or later.
  • The Enable Event and Impact reporting option was not selected when you installed the Report Engine.
  1. At the command line, change the current directory path:
    • For Windows: <ReportEngineInstallDirectory>\ReportEngine\bin\reportsCLI
    • For Linux: <ReportEngineInstallDirectory>/ReportEngine/bin/reportsCLI
  2. Run the following command:

    cell_config register -tsimHost <hostname> -tsimProtocol <protocol> -tsimPort <port> -tsimUser <username>
    Example
    cell_config register -tsimHost <hostname> -tsimProtocol https -tsimPort 443 -tsimUser admin
  3. Enter the BMC TrueSight Infrastructure Management user password and the following message is displayed.

    Report engine gateway registered successfully with cell: <cell_name>
  4. Enter the Report Engine database credentials:

    • Database login
    • Database password

The following message is displayed:

cell <cell_name>  registered successfully.

Configuring TrueSight Infrastructure Management cells for event reporting

If you are working with a BMC TrueSight Infrastructure Management Server that is earlier than v10.7, you must complete the following procedure to configure BMC TrueSight Infrastructure Management cells for event reporting:

  1. Specify the location and port number of BMC TrueSight Operations Management Report Engine in the BMC TrueSight Infrastructure Management cell's mcell.dir file. 
    1. Open the mcell.dir file on the BMC TrueSight Infrastructure Management Server host computer. The file is located in the BMCTrueSightIMServerInstallDir\pw\server\etc directory.
    2. Add the following entry to the mcell.dir file.

      gateway.reportengine bpre.<fullyQualifiedHostName> <encryptionKey> <fullyQualifiedHostName>:<3783>
      Example
      gateway.reportengine bpre.vs-pun-tsim-bp03.bmc.com mc vs-pun-tsim-bp03.bmc.com:3783

      Note

      If you have installed BMC TrueSight Infrastructure Management Server with non-default encryption key, you must use that key instead of default key (mc).

    3. Save and close the mcell.dir file.
    4. Reload the mcell.dir file by entering the following command from a command line:
      mcontrol -n cellName reload dir
      For examplemcontrol -n  pncell_vm-w23-rds1016 reload dir
      where pncell_vm-w23-rds1016 is the name of the cell. 
  2. Edit the propagation policy that is created when you install the cell. This enables you to specify the name of the host server for BMC TrueSight Operations Management Report Engine to which you want to propagate events. 

    Note

    You must specify the name of the host server for BMC TrueSight Operations Management Report Engine in the propagation policy that is created when you install the cell.


    1. Launch BMC TrueSight Infrastructure Management Administrator Console.
    2. From the Event Management Policies tab of the Administration View, expand My Production > pncell_cellname > By Policy Type folder.
    3. Under the By Policy Type folder, select Propagation Policy. The different propagation policies are displayed in the details pane of the Administration View.
    4. Under the Selector column, right-click All_Events, and select Edit Policy. The Propagation Policy Details tab is displayed.
    5. In the Propagate to One Of list, select the name of the computer on which you have installed BMC TrueSight Operations Management Report Engine.
    6. Click OK. The changes are saved to the policy.

Best Practice

Ensure that the entries for fullyQualifiedHostName of BMC TrueSight Operations Management Report Engine and BMC TrueSight Infrastructure Management Server are added in the hosts file on BMC TrueSight Operations Management Report Engine and BMC TrueSight Infrastructure Management Server respectively. The fullyQualifiedHostName is the full name of the computer in which you have installed the Report Engine or BMC TrueSight Infrastructure Management Server. The hosts file is located at /etc on Linux, and at WINDOWS\SYSTEM32\drivers\etc on Microsoft Windows. If the entry for the host name is not made in this file, the cell registration fails.

Configuring TrueSight Infrastructure Management cells for impact reporting

If you are working with a BMC TrueSight Infrastructure Management Server that is earlier than v10.7, you must subscribe the BMC TrueSight Infrastructure Management cell for the impact events to be propagated.

  1. At the command line, change the current directory path:
    • For Windows: <ReportEngineInstallDirectory>\ReportEngine\bin\reportsCLI
    • For Linux: <ReportEngineInstallDirectory>/ReportEngine/bin/reportsCLI
  2. Run the following command:

    cell_config add -name <cellName> -hn <hostName> -p <portNumber> -k <encryptionKey> -e production

    cell_config add -name <cellName> -hn <hostName> -p 1828 -k mc -e production
    A confirmation message is displayed.

  3. Type Y, and press Enter.
  4. Enter the Report Engine database credentials:

    • Database login
    • Database password

The following message is displayed:

cell registered successfully.

Configuring TrueSight Infrastructure Management cells to get BMC Atrium CMDB data

The BMC Atrium CMDB attributes and their values are retrieved from the BMC TrueSight Infrastructure Management cell. You must configure the BMC TrueSight Infrastructure Management cell to get the BMC Atrium CMDB attributes of configuration items (CIs) from the BMC TrueSight Infrastructure Management cell. Perform the following steps to get the BMC Atrium CMDB CIs from BMC TrueSight Infrastructure Management cell.

Note

Perform the following procedure in either of the situations:

  • If you have not configured BMC TrueSight Infrastructure Management cell for Event and Impact reporting in your environment.
  • If you do not want to use Event and Impact reporting in the future.
Warning

By default, configuration items are getting populated from BMC TrueSight Infrastructure Management cell to Report Engine if users have configured BMC TrueSight Infrastructure Management cell for event and Impact Reporting. Do not perform the following steps if you have configured the cell for event and Impact reporting.

These steps stop the impact and event propagation and summarization. Perform these steps if you want only information from CIs for performance reporting.

  1. Specify the location and port number of BMC TrueSight Operations Management Reporting Engine in the mcell.dir file. For more information, see To add the BMC TrueSight Operations Management Report Engine gateway entry in the mcell.dir file.
  2. You must subscribe the BMC TrueSight Infrastructure Management cell for CIs to get propagated to Report Engine. For more information on subscribing the BMC TrueSight Infrastructure Management cell, see Configuring the BMC TrueSight Infrastructure Management cell for impact reporting.
  3. Stop the Report Engine service.
  4. In Administration view, Dynamic Editor tab, expand the cell_name folder. For example, pncell_clm-pun-000733.
  5. In the cell_name folder, select all data > Notification registry internal > Notification registry, and delete the notification registry for that Report Engine.
  6. Log on to the computer that has Report Engine installed and navigate to one of the following directories:
    • For Windows: <ReportEngineInstallDir>\ReportEngine\bin\reportsCLI
    • For Linux: <ReportEngineInstallDir>/ReportEngine/bin/reportsCLI
  7. To disable the summarization of Availability, MTTR, MTBF, MTBSI, and Losses, run the summarize_flag CLI command.

    summarize_flag - disableFor more information, see summarize_flag-command.

  8. Start the Report Engine service.

 

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