Deploy Hardware Sentry KM for PATROL

This section details the procedure to follow to install and deploy Hardware Sentry KM for PATROL on your PATROL Agents. It also explains how to upgrade from a previous version and provides a step-by-step procedure to uninstall the KM.

Install Hardware Sentry KM for PATROL

To be able to use Hardware Sentry, you will have to:

  • Ensure that requirements are met
  • Import Hardware Sentry into TrueSight
  • Create the installation package
  • Install the package

Prerequisites

To ensure that Hardware Connectors can connect to the monitored platforms and gather the required information, refer to the Supported Platforms and Requirements page.

Import the Monitoring Solution into TrueSight

The TrueSight Central Monitoring Repository may include the current versions of Hardware Sentry that you can use with BMC TrueSight. If the version available in the repository does not correspond to the latest one, you will have to manually import it:

  1. Log on to the TrueSight Console.
  2. From the navigation pane, select Administration > Repository.
  3. Click the Installation Components tab.

    Installation Components

  4. Check that the version of Hardware Sentry is actually the latest one. If not, download the latest version corresponding to your operating system (Windows or UNIX/Linux) available on Sentry’s Website.

  5. Click Import.
  6. Select Single solution.
  7. Browse to the .zip source file.

    Importing Hardware Sentry

  8. Click Import.

  9. When the selected archive file is imported to the repository, click Close.

Create the Installation Package

The installation package to deploy to managed systems can be created directly from TrueSight Presentation Server:

  1. Log on to the TrueSight Console.
  2. From the navigation pane, select Administration > Repository.
  3. Click the Deployable Packages tab.
  4. Click Create Deployable Package.
  5. Select the operating system and platform for which you want to create a package. The components available in the repository for the selected operating system and platform are displayed.

    Selecting the Operation System and Platform

  6. Select the Hardware solution to be included in the package, specify its version, and click Next.

    Selecting the Hardware Sentry Solution

  7. Specify the Installation Directory and click Next.

    Specifying the Installation Directory

  8. Provide the PATROL 3.x Product Directory and click Next.

    Specifying the PATROL 3.x Product Directory

  9. Specify the BMC Product Startup Information and click Next.

    Specifying the BMC Product Startup Information

  10. Provide the following information:

    • Name: Enter a unique name for the package.
    • (Optional) Description: Enter a description of the package.
    • Format: Select a file compression format for the package.

    Providing the Installation Package Details

  11. Click Save.

  12. Click Close. The package is now available in the Deployable Packages list.

Install the Package

This chapter provides a step by step procedure to install a monitoring solution package:

  1. Log on to the TrueSight Console.
  2. From the navigation pane, select Configuration > Managed Devices.

    Installing the Package - Managed Devices

  3. Locate the managed device on which you wish to install Hardware Sentry, click its action button inline and select Deploy and Install Packages.

    Installing the Package - Locating the Managed Device

  4. Select the Hardware Sentry package and click Deploy and Install.

    Installing the Package - Selecting the Hardware Sentry Package

  5. Wait for the installation to complete. You can click the inline button to refresh the page and check the installation progress in the Deploy Status column.

Uninstall Hardware Sentry KM for PATROL

To uninstall Hardware Sentry:

  1. Log on to the TrueSight Console.
  2. From the navigation pane, select Configuration > Managed Devices.

    Uninstalling Hardware Sentry - Managed Devices

  3. Locate the managed device on which Hardware Sentry should be uninstalled, click its action button inline and select Uninstall Monitoring Solutions.

    Uninstalling Hardware Sentry - Locating the Managed Device

  4. Check the Hardware Sentry box and click Uninstall.

  5. Wait for Hardware Sentry to be uninstalled. You can click the inline button to refresh the page and check the uninstall progress in the Deploy Status column.

Upgrade From Previous Versions

After upgrading Hardware Sentry, the monitoring solution must be reinitialized. Hardware Sentry will then run a full discovery, preselect the appropriate connectors, and restart the monitoring of existing and new devices.

To reinitialize the monitoring solution (policy)

  1. Log on to the TrueSight Console.
  2. Click the Configuration Variables tab.
  3. Click Add Configuration Variable to set the required configuration variable. The Add Configuration Variable pane is displayed.

    Upgrading from Previous Versions - Adding Configuration Variable

  4. Provide the following information:

    • Variable: type /SENTRY/HARDWARE/automaticReinitialization
    • Operation: select REPLACE from the drop-down list
    • Value: type 1
  5. Click OK.

A reinitialization of Hardware Sentry is performed. The discovery checks the automaticReinitialization variable every minute and deletes it in the PATROL agent configuration before performing the re-initialization.

To prevent further unexpected reinitializations, it is recommended to later remove the automaticReinitialization variable from the policy.

To reinitialize the monitoring solution (Agent Query)

  1. In the navigation pane of the TrueSight console, click Configuration and select Managed Devices.
  2. Click a PATROL Agent menu inline and select Query PATROL Agent. The Agent Query Tool opens in a new browser window.
  3. In the Command box, specify the query and click Execute.
  4. Enter the following PSL command:

    requires MS_HW_q; reinitialize(1);

To reinitialize the monitoring solution (Monitoring Studio)

  1. In the navigation pane of the TrueSight console, click Configuration and select Managed Devices.
  2. Click a PATROL Agent menu inline and select Query PATROL Agent/Monitoring Studio X. You will be automatically redirected to the Monitoring Studio X console.

    Reinitialize Hardware Sentry with Monitoring Studio

  3. From the Monitoring Studio console, select KM > Hardware Sentry.

  4. Click the KM Settings button and scroll down to the Reinitialize section (use the shortcut button at the top of the page).
  5. Select the options as per your specific needs:

    Reset KM Settings:

    • Reset All: Enables/disables the reset of all the listed settings except for Reset Alert Thresholds.
    • Reset Discovery and Polling Intervals: Removes all user-defined frequencies for discovery and polling processes to their default values (respectively 1 hour and 2 minutes).
    • Reset Alert Delay: Resets the number of times thresholds can be breached before triggering an alert to their default values (1 time) for numeric, discrete, connector status and present parameters.
    • Reset Alert Actions: Removes all manually set Alert Actions and reverts to basic default actions i.e. Trigger a PATROL event and Annotate a parameter graph.
    • Reset Alerts Settings: Reverts any manually performed configuration changes to the default Hardware Sentry values.
    • Reset Debug Mode: Deactivates the debug mode when it was manually enabled.
    • Restore Removed Objects and Resume Paused Objects: Reactivates the monitoring of all paused or removed objects.
    • Reset Health Reporting: Clears the report schedule.
    • Reset Java Settings: Removes the custom Java settings (path and credentials). The KM will try to automatically find a suitable JRE.

    Reset Alert Thresholds:

    • Reset Alert Thresholds: Removes all predetermined and dynamic thresholds from the PATROL Agent configuration.

      Hardware Sentry hierarchy

Keywords:
hardware km patrol