Upgrading, Installing, or uninstalling Hardware Sentry KM for PATROL

This section outlines the procedure to follow if you are upgrading Hardware Sentry KM for PATROL from a previous version or installing it for the first time. You will also learn how to uninstall the KM.

Upgrading 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 reinitialize() PSL command:

    requires MS_HW_q; reinitialize(1);

The reinitialize() is set to 1 to have Hardware Sentry use the default reinitialize settings (resetThresholds, resetRemovedPausedObjectList and resetPreselectedConnectors).

Installing 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 will be able to connect to the monitored platforms and gather the required information, refer to the Supported Platforms and Requirements page.

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

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

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

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