Install EMC NetWorker KM

Follow this installation procedure to install EMC NetWorker KM directly on the PATROL Agent or PATROL Console system. To install EMC NetWorker KM from the TrueSight Console, refer to Install in TrueSight.

To be able to use EMC NetWorker KM for PATROL, you will have to:

Getting the Installation Packages

The EMC NetWorker KM installation packages are designed for use with the BMC Software Installation Utility. They need to be merged with the latest available version of the BMC Software Installation Utility.

Getting the BMC Utility Package

The latest version of the BMC Software Installation utility is required to install EMC NetWorker KM. It can be downloaded from the Sentry Software Web site.

Choose the appropriate package depending on the platform you plan to install EMC NetWorker KM on:

  • For UNIX/Linux systems: ins_ALL_<version>.tar
  • For Windows systems: ins_WINDOWS_<version>.zip

The packages are valid for all the PATROL components: Agent, Console, Console Server, etc.

Getting the EMC NetWorker KM Packages

Two packages are available to download on the Sentry Software Web site. They can be used to install the KM on every PATROL component (Agent, Console, etc.) according to the platform you are using.

  • For UNIX/Linux systems: emc-networker-<version>-thorium.tar
  • For Windows systems: emc-networker-<version>-thorium.zip

Getting the JRE Package

Java Runtime Environment version 1.8.00 or higher is required for the KM to operate properly.

A package with a suitable Java Runtime Environment, designed for use with the BMC Software Installation Utility, is available to download on the Sentry Software Web site.

You can optionally install this package along with the EMC NetWorker KM package. The KM will be able to leverage either this instance of the Java Runtime Environment or another installed separately on the system.

Installing EMC NetWorker KM

Like most Knowledge Modules for PATROL, you need to install EMC NetWorker KM on the following components of your PATROL architecture:

  • Every managed system with a PATROL Agent
  • Every PATROL Console (Classic) that will show information and alerts
  • The Console Server
  • PATROL Central Web Edition

To install EMC NetWorker KM

  1. Extract the setup files:

    • On Windows:

      1. Unzip the BMC Installation Utility: ins_WINDOWS_<version>.zip.
      2. Unzip the emc-networker-<version>-thorium.zip package in the same folder.
      3. (Optional) If you need to install the latest Java Runtime Environment program, unzip the adoptopenjre-windows-x64-<version>-thorium.zip package in the same folder. The content of the packages merges into a subfolder named bmc_products. Windows may ask for your confirmation to overwrite files and folders. This is normal behavior and you can accept all overwrite confirmation requests.
    • On UNIX/Linux:

      1. Untar the BMC Installation Utility: tar xvf ins_ALL_<version>.tar.
      2. Untar the EMC NetWorker KM package named: emc-networker-<version>-thorium.tar.
      3. (Optional) If you need to install the latest Java Runtime Environment program, unzip the adoptopenjre-<platform>-<version>-thorium.tar package.
  2. Navigate to the bmc_products folder where the files have been extracted

  3. Launch the setup.exe program (Windows) or setup.sh script (UNIX/Linux)

  4. The welcome screen of the installer appears. Click Next to continue

    Installation Wizard - Welcome

  5. Read the license agreement, click the Accept option and then click Next to continue

    Installation Wizard - License Agreement

  6. Select Install products on this computer now and click Next to continue

    Installation Wizard - Selecting Installation Options

  7. Specify the BMC Software Products installation directory. Click Next to continue

    Installation Wizard - Selecting the Installation Directory

  8. Installing EMC NetWorker KM does not require any customization. Select Default and click Next to continue

    Installation Wizard - Selecting an Installation Type

  9. Select one or several of the following options:

    • Managed System to install EMC NetWorker KM on a PATROL Agent
    • Console Systems to install EMC NetWorker KM on a PATROL Classic Console
    • Common services to install EMC NetWorker KM on the Console Server or on PATROL Central Web Edition

    Installation Wizard - Selecting Roles

  10. Click Next to continue

  11. Install the KM:

    • Check the EMC NetWorker KM for PATROL box (it should be selected by default)
    • Select the Java Runtime Environment program if you want to install it along with the KM (this option is only provided when you have previously downloaded and merged the package with the BMC Installation Utility)
    • Click Next to continue

    Installation Wizard - Selecting Products and Components

  12. Review the installation parameters and click Start Install to launch the installation procedure

    Installation Wizard - Reviewing Installation Options

  13. The setup program displays the actions performed and indicates the percentage of completion. Once the installation is complete, click Next to view the installation results

    Installation Wizard - Installation Status

  14. The wizard displays the installation results. Click View Log to display a detailed log of the installation procedure. Click Next and then Finish to exit the setup program

    Installation Wizard - Installation Results

  15. Click the Finish button to complete and close the installation wizard.

    Installation Wizard - Completing and closing the Installation Wizard

Loading EMC NetWorker KM

To monitor your EMC NetWorker environment within your PATROL Console, EMC NetWorker KM must be loaded on the appropriate managed system. Loading a Knowledge Module in PATROL Central Operator both loads the Knowledge Module on the managed system and adds the name of the Knowledge Module to your management profile.

Before loading the EMC NetWorker KM:

  1. Make sure you correctly installed the KM on the PATROL Console and the PATROL Agent systems
  2. Start the PATROL Console and update the connection to all PATROL Agent systems where the EMC NetWorker KM is installed
  3. Check the value of the PATROL Agent tuning variable, /AgentSetup/AgentTuning/pslInstructionMax, and if necessary, increase it.

On PATROL Classic

  1. In the Console menu bar, click File > Load KM
  2. In the Files of Type list, select KM Files
  3. Select EMC NetWorker KM (NSR_LOAD.kml)
  4. Click Open.

The EMC NetWorker KM will be loaded to the PATROL Console, and all connected PATROL Agents. The EMC NetWorker container instance will be created. Any previous EMC NetWorker KM configuration will be upgraded and their instances will be created.

If you want to save the new list of loaded files as the PATROL Console user preference:

  1. From the PATROL Console menu bar, choose File > Save Configuration
  2. Load the NSR_LOAD.kml file on each PATROL Console
  3. Configure the KM.

On PATROL Central

  1. In the Common Tasks tab of the PATROL Central Operator Taskpad, click the Load Knowledge Modules icon

  2. To start the wizard, click Next

  3. Select the check boxes for the managed systems that you want to load EMC NetWorker KM on. Click Next

  4. Select the check box for EMC NetWorker KM (NSR_LOAD.kml)

  5. Click Finish

    The EMC NetWorker KM will be loaded to the PATROL Central Console Server, and all connected selected managed systems. The EMC NetWorker container instance will be created. Any previous EMC NetWorker KM configuration will be upgraded and their instances will be created.

  6. Configure the KM.

Configuring the PATROL Agent to Preload the KM

If you want EMC NetWorker KM to operate all the time, without a PATROL Console connection, you will have to add it to the PATROL Agent configuration variable /AgentSetup/preloadedKMs.

To configure the PATROL Agent to preload the KM:

  1. In the Console, right-click the EMC NetWorker icon > Configuration > Preloading
  2. Click Add to add the KM files to the list of preloaded KMs.

The same menu is used to remove the KM files from the preloaded KMs list.

Unloading EMC NetWorker KM

This section describes the procedures for unloading (not uninstalling) the EMC NetWorker KM from the PATROL Agent, PATROL Console or PATROL Central Console. Read this section if you no longer want to use some parts of the KM; if you want to completely uninstall the KM, refer to the uninstall procedure.

When the KM is unloaded:

  • from a PATROL Agent: PATROL stops monitoring the EMC NetWorker application on that system when there is no connection to a PATROL Console with EMC NetWorker KM KM loaded

  • from a PATROL Console: the PATROL Console stops displaying and monitoring the EMC NetWorker application on any PATROL Console connected system.

From the PATROL Agent

To unload the KM from the PATROL Agent:

  1. In the Console, right-click the EMC NetWorker icon and select KM Commands > Configuration > Preloading…
  2. Click Remove
  3. Restart the PATROL Agent
  4. Repeat these steps on every PATROL Agent system (managed node) where the EMC NetWorker KM is to be unloaded.
Note: You can also use the utility wpconfig (on Microsoft Windows) or xpconfig to unload the KM. You will then have to remove NSR_LOAD.kml from the PATROL Agent configuration variable /AgentSetup/preloadedKMs.

The KM cannot be partially unloaded from the PATROL Agent using the above steps. If you need to unload some parts of the KM from the PATROL Agent, set their instance limits to 0 (zero).

From the PATROL Console

Application classes are unloaded individually. This allows for partial unloading of the KM to enable it to run as a reduced installation.

To unload the EMC NetWorker KM completely or partially:

  1. Remove the unwanted application classes that start with NSR_ in the list of loaded application classes as described below:

    With the PATROL Console for Unix:

    • From the PATROL Console main window, select Attributes> Application Classes…
    • Select an EMC NetWorker KM application class to be removed and select Edit > Delete
    • Repeat for all classes to be removed

    With the PATROL Console for Windows:

    • From the PATROL Console tree view, choose the KM tab and expand the folder Application Classes
    • Right-click on an EMC NetWorker KM application class to be removed and select Delete
    • Repeat for all classes to be removed
  2. Select File > Save Configuration to save the modified list of loaded application classes as the PATROL Console user preference

  3. Repeat these steps on every PATROL Console system where the EMC NetWorker KM is to be unloaded.

From the PATROL Central Console

A KM can be unloaded from particular managed systems or for all systems across the monitored environment. Application classes may be unloaded individually or by selecting all classes at once. This allows for a partial unloading of the KM to enable it to run as a reduced installation on some or all of the managed systems.

To completely or partially unload the EMC NetWorker KM from some or all of the managed systems:

  1. Right-click the PATROL Main Map and choose Unload Knowledge Modules…

  2. Select the managed systems where the EMC NetWorker KM is to be unloaded and click Next>

  3. Select the application classes to be removed that starts with NSR_ for the appropriate managed systems, click Next> and Finish

  4. Repeat the above steps for each PATROL Central Management Profile where the EMC NetWorker KM is to be unloaded.

Uninstalling EMC NetWorker KM

To uninstall EMC NetWorker KM:

  1. Go to BMC_ROOT/Uninstall

  2. Launch the uninstall.exe program (Windows) or the uninstall.sh script (UNIX)

  3. The welcome screen appears. Click Next to continue

    Wizard - Welcome Step

  4. Specify the BMC Software Products folder

    Uninstall Wizard - Specifying folder

  5. To uninstall the KM, select EMC NetWorker KM

    Uninstall Wizard - Selecting Products and Components Directory

  6. Click Start Uninstall to run the uninstall program

    Uninstall Wizard - Reviewing Selected Products & Components and Start Uninstalling

  7. A page displays the list of products/components processed and the percentage of completion. Click Next to continue

    Uninstall Wizard - Status

  8. A page displaying SUCCESS indicates that EMC NetWorker KM is now uninstalled.

    Uninstall Wizard - Uninstall Results

No results.