emc networker km for patrol 2.8 - sentry software · overview 10 version 2.8.01 emc networker km...

User Documentation November 2013

EMC NetWorker KM forPATROLVersion 2.8.01

Contacting BMC SoftwareYou can access the BMC Software Web site at http://www.bmc.com/. From this Web site, you can obtaininformation about the company, its products, corporate offices, special events, and career opportunities.

United States and Canada Outside United States and Canada

Address BMC Software, Inc.2101 CityWest Blvd. Houston TX 77042-2827

Telephone (01) 713 918 8800

Telephone 713 918 8800 or 800 841 2031

Fax (01) 713 918 8000

Fax 713 918 8000

Copyright 2006 BMC Software, Inc. or licensors, as an unpublished work. All rights reserved.

BMC Software, the BMC Software logos, and all other BMC Software product or service names areregistered trademarks or trademarks of BMC Software, Inc.

IBM is a registered trademark of International Business Machines Corporation.

DB2 is a registered trademark of International Business Machines Corporation.

Oracle is a registered trademark, and the Oracle product names are registered trademarks ortrademarks of Oracle Corporation.

All other trademarks belong to their respective companies.

BMC Software considers information included in this documentation to be proprietary and confidential.Your use of this information is subject to the terms and conditions of the applicable End User LicenseAgreement for the product and the proprietary and restricted rights notices included in thisdocumentation.

Restricted Rights Legend

U.S. Government Restricted Rights to Computer Software. UNPUBLISHED -- RIGHTS RESERVED UNDERTHE COPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure of any data andcomputer software by the U.S. Government is subject to restrictions, as applicable, set forth in FARSection 52.227-14, DFARS 252.227-7013, DFARS 252.227-7014, DFARS 252.227-7015, and DFARS252.227-7025, as amended from time to time. Contractor/Manufacturer is BMC Software, Inc., 2101CityWest Blvd., Houston, TX 77042-2827, USA. Any contract notices should be sent to this address.

2

Version 2.8.01

EMC NetWorker KM for PATROL

You can obtain technical support by using the Support page on the BMC Software Web site or bycontacting Customer Support by telephone or e-mail. To expedite your inquiry, please see "BeforeContacting BMC Software."

Support Web Site

You can obtain technical support from BMC Software 24 hours a day, 7 days a week at http://www.bmc.com/support_home. From this Web site, you can

Read overviews about support services and programs that BMC Software offers:

Find the most current information about BMC Software products

Search a database for problems similar to yours and possible solutions

Order or download product documentation

Report a problem or ask a question

Subscribe to receive e-mail notices when new product versions are released

Find worldwide BMC Software support center locations and contact information, including e-mailaddresses, fax numbers, and telephone numbers

Support by Telephone or E-mail

In the United States and Canada, if you need technical support and do not have access to the Web, call800 537 1813. Outside the United States and Canada, please contact your local support center forassistance. To find telephone and email contact information for the BMC Software support center thatservices your location, refer to the Contact Customer Support section of the Support page on the BMCSoftware Web site at http://www.bmc.com/support_home.

Before Contacting BMC Software

Before you contact BMC Software, have the following information available so that Customer Support canbegin working on your problem immediately:

Product information

product name

product version (release number)

license number and password (trial or permanent)

Operating system and environment information machine type operating system type, version, andservice pack or other maintenance level such as:

PUT or PTF

system hardware configuration

serial numbers

related software (database, application, and communication) including type, version, and service

pack or maintenance

level

Sequence of events leading to the problem

Commands and options that you used

Messages received (and the time and date that you received them)

product error messages

messages from the operating system, such as "file system full"

3

Version 2.8.01


Table of Contents 4

Version 2.8.01


Table of Contents...........................................................................................................................9Release Notes for v2.8.01

...........................................................................................................................10Overview

...........................................................................................................................10Preparing for Installation

...........................................................................................................................10Requirements

..................................................................................................................10System Requirements

..................................................................................................................11Software Requirements

..................................................................................................................13Security Requirements

..................................................................................................................16Disk Space Requirements

...........................................................................................................................17Getting the BMC Software Installation Utility

...........................................................................................................................17Packages

...........................................................................................................................17Extracting the Setup Files

...........................................................................................................................18Installing the KM

...........................................................................................................................18Installing EMC NetWorker KM for PATROL

...........................................................................................................................30Uninstalling EMC NetWorker KM for PATROL

...........................................................................................................................36Loading/Unloading the KM

..................................................................................................................36Loading the KM

..............................................................................................................37Preparing to Load the KM

..............................................................................................................37Loading the KM on PATROL Console

..............................................................................................................37Loading the KM on PATROL Central

..............................................................................................................38Configuring PATROL Agent to Preload the KM

..................................................................................................................38Unloading the KM

..............................................................................................................38Unloading the KM from the PATROL Agent

..............................................................................................................38Unloading the KM from the PATROL Console

..............................................................................................................39Unloading the KM from the PATROL Central Console

...........................................................................................................................40Performing Post-Installation Operations

..................................................................................................................40Configuring the KM User Account

..................................................................................................................42Verifying Application Discovery

..................................................................................................................42Checking the Instance Limits

..................................................................................................................44Checking the Initial Setup of the KM

..................................................................................................................44Restarting PATROL Agent and PATROL Console

...........................................................................................................................45Integrating the KM

...........................................................................................................................45Integrating with BMC Portal

Table of Contents 5

Version 2.8.01


...........................................................................................................................45Integrating with BMC ProactiveNet Performance Management 8.5.x and 8.6.x

..................................................................................................................45Creating and Importing an Adapter for a BMC PATROL KM

..................................................................................................................46Updating an Adapter for a BMC PATROL KM

..................................................................................................................46Importing and Customizing Thresholds

..................................................................................................................47Managing Baselines and Key Performance Indicators

...........................................................................................................................49Monitoring your environment

...........................................................................................................................49Administering EMC Networker

..................................................................................................................49Starting Server/Storage Node

..................................................................................................................49Stopping Server/Storage Node

..................................................................................................................49Administering Pending Requests

..................................................................................................................50Administering Standalone Drives

..................................................................................................................50Administering Jukebox Devices

...........................................................................................................................50Configuring the KM

..................................................................................................................50Configuring Paths

..................................................................................................................51Specifying the Node Type

..................................................................................................................51Configuring the Multi-Node Monitoring Mode

..................................................................................................................52Filtering Elements to Monitor

..................................................................................................................54Configuring Monitoring Periods

..................................................................................................................56Configuring the Save Clients Monitoring

..................................................................................................................57Configuring the Node Status

..................................................................................................................58Configuring the Elements Status

..................................................................................................................59Configuring the Log Filter

..................................................................................................................61Configuring the Log Scan Limit

..................................................................................................................61Configuring Group Backup Restriction

..................................................................................................................62Configuring Alert Acknowledgement

..................................................................................................................64Configuring Date/Time Formats

..................................................................................................................67Enabling the Debug Mode

...........................................................................................................................7 0Using the KM

..................................................................................................................7 0Acknowledging Alerts

..................................................................................................................7 1Generating Reports

..................................................................................................................7 1Reloading Commands

..................................................................................................................7 1Refreshing Parameters

...........................................................................................................................7 2Reference Guide

...........................................................................................................................7 3Classes and Parameters

..................................................................................................................7 4NSR_SERVER

..................................................................................................................7 9NSR_CLIENT_CONTAINER

Table of Contents 6

Version 2.8.01


..................................................................................................................81NSR_CLIENT

..................................................................................................................83NSR_DAEMON_CONTAINER

..................................................................................................................85NSR_DAEMON

..................................................................................................................87NSR_DATABASE_CONTAINER

..................................................................................................................90NSR_DATABASE

..................................................................................................................92NSR_LOG_CONTAINER

..................................................................................................................94NSR_LOG

..................................................................................................................98NSR_POLICY_CONTAINER

..................................................................................................................99NSR_POLICY

..................................................................................................................103NSR_PCLIENT

..................................................................................................................105NSR_JOB_CONTAINER

..................................................................................................................108NSR_JOB

..................................................................................................................111NSR_JCLIENT

..................................................................................................................112NSR_MOUNT_CONTAINER

..................................................................................................................114NSR_MOUNT

..................................................................................................................115NSR_LIBRARY_CONTAINER

..................................................................................................................117NSR_LIBRARY

..................................................................................................................120NSR_LDEVICE

..................................................................................................................123NSR_DEVICE_CONTAINER

..................................................................................................................124NSR_DEVICE

..................................................................................................................126NSR_POOL_CONTAINER

..................................................................................................................128NSR_POOL

...........................................................................................................................130Additional Information and Support

...........................................................................................................................130Troubleshooting

...........................................................................................................................133Where to Find Additional Help

EMC Networker KM for PATROL v.2.8.01

9Release Notes for v2.8.01

Version 2.8.01


Release Notes for v2.8.01

What's NewThis version of EMC Networker KM for PATROL is now fully compatible with NetWorker v8.x.

New parameters available:

NSRClientExecTime was added to the NSR_CLIENT_CONTAINER application class.

NSRDaemonExecTime was added to the NSR_DAEMON_CONTAINER application class.

NSRDatabaseExecTime was added to the NSR_DATABASE_CONTAINER class.

NSRLogExecTime was added to the NSR_LOG_CONTAINER class.

NSRGroupExecTime was added to the NSR_POLICY_CONTAINER class.

NSRSaveGrpExecTime was added to the NSR_JOB_CONTAINER class.

NSRRequestExecTime was added to the NSR_MOUNT_CONTAINER class.

NSRJukeboxExecTime was added to the NSR_LIBRARY_CONTAINER class.

NSRDeviceExecTime was added to the NSR_DEVICE_CONTAINER class.

NSRPoolExecTime was added to the NSR_POOL_CONTAINER class.

Changes and ImprovementsAll configuration menus (KM commands) support regular expressions. For example, the Groupconfiguration menu can be used for disabling all "test" groups, which will also stop monitoringtheir save groups.

Fixed IssuesA compatibility issue prevented the KM to operate when the Agent was run with the PATROL ConfigCache support.

On Windows platforms, a warning occurred due to a command error in the login status parameter (NSRLoginStatus). The problem is solved now and the commands are executed to set thefollowing parameters correctly: NSRServerSummary, NSRMonitorRAP &NSRAdministratorChange.

An error in setting the parameters for Process Count, Memory Size, CPU Utilization & CPUDuration is now corrected. On UNIX platforms, daemon collector command & arguments weremodified to return only the relevant daemon lines from the process list.

10Overview

Version 2.8.01


Overview

EMC NetWorker KM for PATROL monitors your EMC Networker application within a centralizedmanagement console to ensure its runs efficiently 24 hours a day.

The KM more especially monitors the:

Server availability: status of all the processes.

Log files: monitoring of the daemon.log and messages files, size, etc.

Pending Media Events: monitoring of the media mount requests

Bootstrap Messages: bootstrap settings verification, recommendations, etc.

Client Indexes: number of entries, utilization as a percentage and index size.

Devices: status of mounted volumes and history of volume mounts.

Save Groups and Save Sets: status, progress, size and duration

All the information collected is grouped into application classes and displayed in the PATROL Console.Alarms and warnings inform you when a suspicious behavior is detected; thus allowing you to quicklyand clearly identify peaks, troughs and trends in the performance of your backup resources.

Refer to the Reference Guide for more information about the application classes.

Preparing for Installation

This chapter provides information about the tasks that must be performed before you start installingEMC NetWorker KM for PATROL. Make sure to carefully read the following sections requirements:

Review the requirements

Get the BMC Software Installation Utility

Download the Installation Packages

Extract the Setup Files

RequirementsPrior to install EMC NetWorker KM for PATROL, make sure that the following elements are installed andproperly configured:

PATROL Agent, version 3.4.11 or higher (see BMC PATROL documentation)

PATROL Console (see BMC PATROL documentation)

System RequirementsOperating System Operating System Version

Oracle SolarisTM 8, 9, 10

HP-UX 11.00, 11.11, 11iv2, 11iv3

11Preparing for Installation

Version 2.8.01


IBM® AIXTM 5.1, 5.2, 5.3, 6.1

Red Hat® Linux® 7.2

Microsoft® Windows® 2003, 2008, 2008 R2

If the operating system is upgraded (or downgraded) at a later date, you will need to reload commands for the EMCNetWorker KM for PATROL.

Software RequirementsSoftware Version

EMC NetWorker 6.1.x, 6.2, 7.0, 7.1.x, 7.2.x, 7.3.x, 7.4.x, 7.5.x, 7.6.x,8.0.x, 8.1.x

BMC PATROL Agent 3.4.20, 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 9.x

BMC PATROL Console 3.4.x, 3.5.x, 7.x

BMC Portal 2.3.x, 2.4.x, 2.5.x, 2.6.x, 2.7.x, 2.8.x

BMC ProactiveNet Performance Manager 8.x, 8.5.x, 8.6.x, 9.x

If the version of EMC NetWorker is upgraded (or downgraded) at a later date, you will need to reload commands forthe EMC NetWorker KM for PATROL.

Changes to EMC NetWorker

It is required to set-up a save group log file on all managed systems on Unix platforms. This file can beused by the NSR KM to collect save group information efficiently. The save group log file can beconfigured in EMC NetWorker using the steps below.

1. Open the EMC NetWorker Administrator GUI, and select Customize > Notifications

2. Select View > Details to see all details of a notification

3. Click Create and fill out the form as below:Name: NSR KM savegroup logging

Comment: Required notification for NSR KM

Action: cat >> /nsr/logs/savegrp.log

Event: Savegroup

Priority: Info, Warning, Critical, Emergency,

Notice, Waiting, Alert

4. Click Apply.

The NSR KM will process the contents of EMC NetWorker messages file (/nsr/logs/messages) in the absence of abovesave group log file (/nsr/logs/savegrp.log).

The above save group log file set-up is not required on W indows managed nodes because it is one of the standardEMC NetWorker log files.


Version 2.8.01


The NSR KM will not maintain or recycle this save group log file. It is recommended to recycle the save group log fileregularly .

Changes to BMC PATROL

To improve the performance of the NSR KM, the PATROL Agent tuning variable /AgentSetup/AgentTuning/pslInstructionMax should be increased to at least 5,000,000. This applies for all EMCNetWorker servers and storage nodes where the KM is installed. This adjustment will allow the KM datacollectors to execute without incurring an internal scheduling delay.

This PATROL Agent tuning variable can be updated using wpconfig (on Microsoft Windows) or xpconfig(on Unix). Alternatively, you can use the following single line PSL command through the PATROLConsole OS> prompt to update this tuning variable.

%PSL v="/AgentSetup/AgentTuning/pslInstructionMax";

if(get(v)<5000000){pconfig("REPLACE",v,5000000);}

In large EMC NetWorker systems, the value of 5,000,000 for the tuning variable pslInstructionMax may still beinsufficient. In such situations, error messages will appear on the PATROL Console System Output W indow (SOW)reporting that some NSR KM data collectors are in an infinite loop. In this case you can set the tuning variable to zeroto disable this functionality .

The KM stores all configuration information in the PATROL Agent configuration database (pconfig),under paths /NSR and /Runtime/NSR. PATROL Agent user (default: patrol) should be able to read andwrite to these pconfig variables at anytime. If Access Control List (ACL) is used to control which usersare authorized to connect to a PATROL Agent, please ensure that the mode for PATROL Agent userincludes “C” in the PATROL Agent variable /AgentSetup/accessControlList. Please refer thePATROL Agent Reference Manual for more details.

You cannot copy or distribute these KM configuration variables between managed nodes, because they may nothave the same value for each managed node. For example, the KM user login details may not be the same for allmanaged nodes. A lso some of these variables, like installation paths, are set automatically during the initialdiscovery .

Additional Software Requirements

Purpose Software Version

When running NSR KM with sudo user account onSolaris, HP-UX, AIX or Linux managed nodes

Sudo (superuser do) 1.6.7 or later

When running NSR KM on Linux managed nodes Korn shell binary (/bin/ksh) Any

When running NSR KM on Microsoft Windows x64managed nodes

Reg.exe patch KB948698(http://support.microsoft.com/kb/948698)

Any

The Microsoft Windows x64 Reg.exe patch, KB948698 is required to allow access to 64-bit registrykeys from PATROL Agent. Access the above patch site from the managed node to obtain the correctpatch for that platform.


Version 2.8.01


Security RequirementsBy default, EMC NetWorker is installed and run as the root user (on Unix) or as administrator user (onMicrosoft Windows). EMC NetWorker KM for PATROL needs to be run as a user account withadministrative privileges to read and execute EMC NetWorker application programs and file systems.Login details of this user are configured in the NSR KM during the KM configuration. The password isstored in the PATROL Agent in a DES encrypted format.

The encrypted password can be viewed by any user who has access to the PATROL Agentconfiguration variables (pconfig). This user could then execute PSL statements using the encryptedpassword through the PATROL Console. This can be prevented by setting up an appropriate AccessControl List (ACL) for users. Please refer to the PATROL Agent Reference Manual for details on howto set up an ACL.

One of the following user accounts can be used for configuring the login details of the KM:

1. root user (Unix) or administrator user (Microsoft Windows)

2. a non-root user, such as patrol, with sudo privileges on EMC NetWorker to execute applicationprograms and access the file systems (Unix only)

3. a non-root (Unix) or non-administrator (Microsoft Windows) account, such as patrol, configured inEMC NetWorker application to administer the EMC NetWorker application

Refer to the EMC NetWorker System Administrator’s Guide for details on how to set up this type of account.

Access Permissions

The NSR KM user needs “read & execute” permission to executable and library files under the pathslisted below. The EMC NetWorker installation path INSTALL_PATH is normally /nsr or /opt/networker (on Unix) or C:\Program Files\nsr (on MS Windows).

Unix Microsoft Windows

INSTALL_PATH/bin INSTALL_PATH\bin

INSTALL_PATH/lib

/usr/bin

/usr/sbin

/usr/sbin/nsr

/usr/lib/nsr

/etc/LGTOuscsi

If the KM is enabled to failover in a clustered environment, the login user needs execute permissions tothe following cluster commands:


Version 2.8.01


/opt/VRTSvcs/bin/hagrp (in Veritas Cluster Server)

vxdctl (in Veritas Cluster File System)

/usr/cluster/bin/clrg (in Oracle Solaris Cluster)

C:\Windows\sysnative\cluster (in Microsoft Cluster)

The EMC NetWorker KM includes some scripts which should be executable by the PATROL Agent userand the NetWorker KM user. These scripts are stored under KM_HOME path, normally PATROL_HOME/lib/NSR.

To list all OS commands used by the NSR KM, execute the following PSL code from the PATROLConsole, using PSL Task menu, after installing and loading the KM.

i=0; sudoers="";

foreach var (grep("^/Runtime/NSR/CommandControls/",pconfig("LIST")))

{

ctl=get(var);

opt=ntharg(grep("Option",ctl),"2-"," =");

nsa=ntharg(grep("NoSudoAttempt",ctl),"2-"," =");

sua=ntharg(grep("SingleUserAttempt",ctl),"2-"," =");

typ=ntharg(grep("CommandType",ctl),"2-"," =");

cmd=nthargf(grep("CommandText",ctl),"2-","=","=");

if((typ == "")||(typ == "OS"))

{

met="";

if(opt == "NoLogin") { met = "(run as patrol user)"; }

elsif(nsa == "YES") { met = "(run as configured user without sudo)"; }

elsif(sua == "YES") { met = "(run as supplied user - used in menu)"; }

else

{

scmd=cmd;

s=index(scmd,"%sudo");

if(s) { scmd=replace(substr(scmd,s,length(scmd)),"%sudo",""); }

sudoers=union(sudoers,ntharg(ntharg(scmd,1,"|"),"1-"," "," "));

}

printf("(%2d) %-30s %-40s: %s\n",i++,ntharg(var,"5","/"),met,cmd);

}

}

printf("\n\nCommands used with sudo:\n%s",sort(sudoers));

The PATROL Agent user (normally patrol) needs “read & execute” permission to following paths andfiles:

Unix Microsoft Windows

INSTALL_PATH/res INSTALL_PATH\res

INSTALL_PATH/index INSTALL_PATH\index

INSTALL_PATH/mm INSTALL_PATH\mm

INSTALL_PATH/logs/daemon.log INSTALL_PATH\logs\daemon.log

INSTALL_PATH/logs/messages INSTALL_PATH\logs\messages

INSTALL_PATH/logs/summary INSTALL_PATH\logs\summary

INSTALL_PATH\logs\savegrp.log


Version 2.8.01


/var/adm/messages (on Solaris)

/var/adm/syslog/syslog.log (on HP-UX)

To access files under above paths the relevant user needs “read & execute” permission to all parent directories.

If a monitored log file cannot be read by the PATROL Agent user, it will be copied to KM_TEMP pathusing the configured KM login account, and processed by the PATROL Agent user. On completion, thecopied log file will be removed. This may increase the file system usage under KM_TEMP temporarilyduring this activity.

On Windows platforms the EMC NetWorker installation is identified by checking the Windows Registry.Depending on whether you are using a 32/64-bit OS and/or 32/64-bit Application, the Registry entriesare stored in different locations:

“HKEY_LOCAL_MACHINE\SOFTWARE\Legato\NetWorker\” and “HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Legato\NetWorker\”.

Sudo User for Operating System Access

If a non-root user with sudo privileges is preferred as the NSR KM user, configure the account as asudoer through the visudo utility using code appropriate for your platform as detailed below. This usershould be able to execute NetWorker commands and OS commands.

The code below also applies to all non-root users who may execute NSR KM administration and reportmenu commands using their sudo privileges. The NSR KM accepts any non-root user with the followingsudo configuration in the sudoers file. Please replace user1, user2, user3 with appropriate KM username. The EMC NetWorker installation path INSTALL_PATH, referenced below is normally /nsr or /opt/networker and PATROL_HOME is the path where the PATROL Agent is installed (including thetarget, like /opt/bmc/Patrol3/Solaris29-sun4/).

On Solaris:

User_Alias NSRKMUSERS = user1, user2, user3

Defaults:NSRKMUSERS !lecture,!authenticate,\

env_keep+="LD_LIBRARY_PATH INSTALL_PATH KM_HOME KM_TEMP",env_reset

NSRKMUSERS ALL=/bin/*,/sbin/*,/usr/bin/*,/usr/sbin/*,\

/usr/sbin/nsr/*,/etc/LGTOuscsi/*\

INSTALL_PATH/bin/*,\

PATROL_HOME/lib/NSR/*,PATROL_HOME/bin/*

user1, user2, user3 must be replaced with username(s) used by the KM; INSTALL_PATH and PATROL_HOME with therelevant paths.

On HP-UX:



env_keep+="SHLIB_PATH INSTALL_PATH KM_HOME KM_TEMP",env_reset


Version 2.8.01







On AIX and Linux :



env_keep+="LIBPATH INSTALL_PATH KM_HOME KM_TEMP",env_reset






This non-root sudo user configured in the KM will be able to execute root equivalent commands byopening a shell window. To prevent this, ensure this user is only used within the KM and not madepublic for general use.

Entering the non-root sudo user with ‘Use Sudo’ option selected in to the KM login configurationdialog, before updating the sudoers file, will generate sudo errors. Also if the sudo user is configureddifferently, the KM may run sudo commands using incorrect sudo settings, which will expose thesudo user password.

Disk Space RequirementsEMC NetWorker KM for PATROL requires approximately:

3 MBytes disk space on each monitored PATROL Agent system

5 MBytes disk space on each PATROL Console system

400 KBytes disk space on each PATROL Central Console Server system

1 MBytes disk space on each PATROL Central Web Server system

The NSR KM is installed under the PATROL installation path.

When monitoring a standard installation of EMC NetWorker using NSR KM, the PATROL Agent willgenerate approximately 250 KBytes of history data per day. An enterprise installation of EMC NetWorkeron a server with multiple storage nodes, clients, jukeboxes, and standalone devices will generate morehistory data (as per other KMs used by the PATROL Agent). These history data files are recycled byPATROL depending on the PATROL Agent history retention period.

During NSR KM data collection, it will use a temporary folder (KM_HOME/tmp) to store some temporaryfiles. These temporary files are removed at the end of the data collection cycle. Required space under


Version 2.8.01


this file system depends on the complexity of the EMC NetWorker environment. If the available space forthis folder is less than 10 MBytes, it can be changed to a different file system, which has sufficient diskspace. This can be achieved by replacing the temporary folder, KM_HOME/tmp, with a soft linkpointing to a different file system, like /tmp. This new temporary folder should have read, write andexecute permissions for both PATROL Agent user and the NSR KM login user.

Getting the BMC Software Installation UtilityIn order to install EMC NetWorker KM for PATROL, you need the latest version of the BMC SoftwareInstallation Utility. You can download the latest Installation Utility from the BMC Software EPD (electronicproduct download) from: http://webapps.bmc.com/signon/content/logon.jsp on the BMC SoftwareWebsite, or from the EMC Networkers KM for PATROL page on the Sentry Software Website

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

For UNIX/Linux systems: ins_ALL_<version>.tar

For Windows systems: ins_WINDOWS_<version>.exe

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

Place the Installation Utility package in the same folder as the EMC NetWorker KM for PATROL packages.

PackagesThe EMC NetWorker KM for PATROL packages are available on the Sentry Software Web site.

There are two packages, each of which can be used to install the KM on every PATROL component(Agent, Console, etc.) according to the platform you are using.

Downloading from Sentry Software Web site

For Windows systems: nsr_ALL_<version>.zip

For UNIX and Linux systems: nsr_ALL_<version>.tar

The EMC NetWorker KM for PATROL packages are designed for use with the BMC Software

Installation Utility (formerly known as Thorium). They need to be merged with the latest availableversion of the BMC Software Installation Utility. Please see instructions.

Extracting the Setup FilesLike most Knowledge Modules for PATROL, you need to install EMC NetWorker KM for PATROL on thefollowing components of your PATROL architecture:

Every managed system with a PATROL Agent

Every PATROL Console (Classic) that will show EMC NetWorker performance-related informationand alerts


Version 2.8.01


The Console Server

PATROL Central – Web Edition

Installing the KM

Introduction

This section describes the installation procedure for EMC NetWorker KM for PATROL on any PATROLcomponent (Agents, Consoles, Console Server, etc.). As the setup is based on the BMC SoftwareInstallation Utility, this procedure applies to all operating systems supported by EMC NetWorker KM forPATROL.

Installing EMC NetWorker KM for PATROLInstalling EMC NetWorker KM for PATROL is an automated process managed by a wizard. The wizardgoes through the necessary steps to install EMC NetWorker KM for PATROL and all files associated withit. You are simply prompt for the product's folder location and the product/components to install.

Browse to the bmc_products folder where the files have been extracted (both EMC NetWorker KM forPATROL and the Common Installer).

19Installing the KM

Version 2.8.01


On Windows: Launch the setup.exe program

On UNIX: Launch the setup.sh script

To install EMC NetWorker KM for PATROL1. Allow the perl.exe program to listen on this port: Click Allow access.

Installation Wizard - Step 1: Windows Security A lert

20Installing the KM

Version 2.8.01


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

Installation Wizard - Step 2: Welcom e

21Installing the KM

Version 2.8.01


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

Installation Wizard - Step 3: Rev iewing License A greem ent

22Installing the KM

Version 2.8.01


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

Installation Wizard - Step 4: Selecting Installation Options

23Installing the KM

Version 2.8.01


5. Specify the BMC Software products folder. See the BMC Software documentation for moreinformation about the BMC Software products folder. Click Next to continue.

Installation Wizard - Step 5: Selecting the Installation Directory

24Installing the KM

Version 2.8.01


6. Select Default. Installing EMC NetWorker KM for PATROL does not require any customization. ClickNext to continue.

Installation Wizard - Step 6: Selecting an Installation Ty pe

7. Select one or several of the following options:

Managed System to install EMC NetWorker KM for PATROL on a PATROL Agent.

Console Systems role to install EMC NetWorker KM for PATROL on a PATROL Classic Console.

Common services to install EMC NetWorker KM for PATROL on the Console Server or onPATROL Central – Web Edition.

Click Next to continue.

25Installing the KM

Version 2.8.01


Installation Wizard - Step 7: Selecting Roles

Select as many options as required.

26Installing the KM

Version 2.8.01


8. Check the EMC NetWorker KM for PATROL box to install the KM (it should be selected bydefault). Click Next to continue.

Installation Wizard - Step 8: Selecting Products and Com ponents

27Installing the KM

Version 2.8.01


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

Installation Wizard - Step 9: Rev iewing Installation Options

28Installing the KM

Version 2.8.01


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

Installation Wizard - Step 10: Installation Status

29Installing the KM

Version 2.8.01


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

Installation Wizard - Step 11: Installation Results

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

30Installing the KM

Version 2.8.01


Installation Wizard - Step 12: Com pleting and closing the Installation Wizard

A Help button is available at each step of the procedure. Click to display the installation online help. The Exit buttonallows you to stop the installation procedure.

Uninstalling EMC NetWorker KM for PATROLUninstalling EMC NetWorker KM for PATROL is an automated process managed by a wizard. The wizardgoes through the necessary steps to remove EMC NetWorker KM for PATROL and all files associatedwith it. You are simply prompt for the product's folder location and the product/components to uninstall.

To uninstall EMC NetWorker KM for PATROL1. Locate the Uninstall folder under the BMC products directory (typically under C:\Program Files\BMC

Software, or /opt/bmc):

On Windows systems, launch uninstall.exe

On UNIX, launch uninstall.sh

31Installing the KM

Version 2.8.01


Un-install Wizard — Welcom e Step

32Installing the KM

Version 2.8.01


2. Specify the BMC Software products folder. See the BMC Software documentation for moreinformation about the BMC Software products folder.

Un-install Wizard — Specify ing folder

33Installing the KM

Version 2.8.01


3. To uninstall the KM, select EMC NetWorker KM for PATROL.

Un-install Wizard — Selecting Products and Com ponents Directory

34Installing the KM

Version 2.8.01


4. Click Start Uninstall to run the un-installation program.

Un-install Wizard — Rev iewing Selected Products & com ponents and start uninstalling

35Installing the KM

Version 2.8.01


5. A page displays the list of products/components processed and the percentage of completion. ClickNext to continue.

Un-install Wizard — Status

36Installing the KM

Version 2.8.01


6. A page displaying SUCCESS indicates that EMC NetWorker KM for PATROL is now uninstalled.

Un-installation Wizard — Uninstall Results

Loading/Unloading the KMOnce installed the KM will have to be preloaded on one of the following PATROL consoles:

PATROL Console

PATROL Central

The PATROL Agent can also be configured to automatically preload the KM.

Loading the KM

This section provides instructions to load EMC NetWorker KM for PATROL on Microsoft Windows andUnix platforms.

Before you load the NSR KM, you must install the KM on PATROL Console and PATROL Agent systems.

37Installing the KM

Version 2.8.01


Preparing to Load the KM

1. Start the PATROL Console and update the connection to all PATROL Agent systems where the NSRKM is installed.

2. Check the value of the PATROL Agent tuning variable, /AgentSetup/AgentTuning/pslInstructionMax, and if necessary, increase it

Loading the KM on PATROL Console

1. From the PATROL Console menu bar, choose File>Load KM...

2. Select the NSR_LOAD.kml file, and click Open or OK. The NSR KM will be loaded to the PATROLConsole, and all connected PATROL Agents will start discovering the EMC NetWorker environment.If the automatic discovery successfully finds the EMC NetWorker server/storage node installation, NSR_SETUP instance will be instantiated,

This automatic discovery may take up to 5 minutes to instantiate the NSR_SETUP instance. Look for anyerror messages on the PATROL Console System Output Window (SOW) during the initial discovery.

3. Select File>Save Configuration to save the new list of loaded KM files as the PATROL Consoleuser preference.

4. Repeat the above steps on each PATROL Console.

Loading the KM on PATROL Central

1. Right click on the PATROL Main Map, and choose Load Knowledge Modules... A wizard box willdisplay a list of all managed systems.

2. Select the managed systems where the NSR KM is to be loaded, and click Next>. The wizard willdisplay a list of all available .kml files for the managed systems you selected.

3. Select the NSR_LOAD.kml file for each managed system, click Next> and Finish.

If you cannot find the NSR_LOAD.kml file in the wizard list for any system you selected, then the KM has not beeninstalled on that system.

The NSR KM will be loaded to the PATROL Central Console Server, and all connected selected managedsystems will start discovering the EMC NetWorker environment. If the automatic discovery successfullyfinds the EMC Networker installation, the NSR_SETUP instance will be instantiated.

This automatic discovery may take up to 5 minutes to instantiate the NSR_SETUP instance. Look for any errormessages on the PATROL Central System Output W indow (SOW) during the initial discovery .

4. Repeat the above steps for each PATROL Central Management Profile where NSR KM is to beunloaded.

38Installing the KM

Version 2.8.01


Configuring PATROL Agent to Preload the KM

To configure PATROL Agent to preload the KM:

1. In order to enable EMC NetWorker KM for PATROL to operate all the time, without a PATROLConsole connection, the KM should be added to the PATROL Agent configuration variable /AgentSetup/preloadedKMs. This can be achieved on the EMC NetWorker instance by using themenu Configuration>Preloading.

2. Select Add to add the KM files to the list of preloaded KMs. If the NSR KM is successfully added tothe list, an acknowledgement will be displayed.

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

Unloading the KMThis section describes the procedures for unloading (not uninstalling) the NSR KM from the PATROLAgent, PATROL Console or PATROL Central Console. The intention is that this section is only used if youno longer want to use some parts of the KM, though there may be circumstances where you may wishto fully unload the KM without uninstalling the files.

When the NSR KM is unloaded from a PATROL Agent, PATROL stops monitoring the EMC NetWorkerapplication on that system when there is no connection to a PATROL Console with NSR KM loaded.

When the NSR KM is unloaded from PATROL Console, the PATROL Console stops displaying andmonitoring the EMC NetWorker application on any PATROL Console connected system.

Unloading the KM from the PATROL Agent

To unload the KM from the PATROL Agent:

1. Remove the NSR KM from the list of preloaded KMs using the menu Configuration>Preloadingfrom the EMC NetWorker instance. Alternatively, using the utility wpconfig (on MicrosoftWindows) or xpconfig (on Unix), remove NSR_LOAD.kml from the PATROL Agent configurationvariable /AgentSetup/preloadedKMs.

2. Restart the PATROL Agent.

3. Repeat these steps on every PATROL Agent system (managed node) where the NSR KM is to beunloaded.

The NSR KM cannot be partially unloaded from the PATROL Agent using the above steps. If you need to unload someparts of the KM from the PATROL Agent, refer to the PATROL Agent Reference Manual.

Unloading the KM from the PATROL Console

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

To unload the NSR KM completely or partially:

39Installing the KM

Version 2.8.01


1. Remove the unwanted NSR KM application classes from the list of loaded application classes, asrequired. All NSR KM application classes start with NSR_.

With the PATROL Console for Unix:

From the PATROL Console main window choose Attributes> Application Classes...

Select a NSR KM application class to be removed and choose Edit>Delete.

Repeat for all classes to be removed.

With the PATROL Console for MS Windows:

From the PATROL Console tree view choose the KM tab and expand the folder ApplicationClasses.

Right-click on a NSR KM application class to be removed and choose Delete.

Repeat for all classes to be removed.

2. Select File>Save Configuration to save the modified list of loaded application classes as thePATROL Console user preference.

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

Unloading the KM from the PATROL Central Console

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

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

1. Right click on the PATROL Main Map, and choose Unload Knowledge Modules...

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

A list is displayed showing all the loaded application classes on each of the selected managed systems.All NetWorker KM application classes start with “NSR_”.

3. Select the NetWorker KM application classes to be removed for the appropriate managed systems,click Next> and Finish.

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

40Installing the KM

Version 2.8.01


Performing Post-Installation OperationsIt is recommended to perform post installation checks once the KM is installed and loaded on thePATROL Console to ensure it properly operates. Post-installation operations include:

Configuring the KM user account

Verifying:

the application discovery

the instance limits

the initial setup

Restarting the PATROL Agent and PATROL Console.

Configuring the KM User AccountA user account with administrative privileges must be configured in BMC PATROL to read and executeEMC Networker application programs and file systems. Depending on the operating systems used,several options will be available.

On Unix platforms, you can use the following user accounts:

a root user

a non-root user, such as patrol, that has sudo privileges on EMC Networker to execute applicationprograms and access file systems

a non-root account, such as patrol, configured in the EMC Networker application to administer theEMC Networker application.

On Windows platforms, you can use the following user accounts:

an administrator user

a non-administrator account, such as patrol, configured in the EMC Networker application toadminister the EMC Networker application.

41Installing the KM

Version 2.8.01


To configure the KM User Account:1. In the Console, right-click the EMC Networker instance > Configuration > Login. The Login

Configuration dialog box is displayed:

Login Configuration dialog

2. To use:

the default PATROL Agent Account, check the Use Agent Default Account box. The logindetails entered in the Username and Password fields will then be ignored.

a different user account, enter the login details in the Username and Password fields

3. If a sudo user account is used:

check the Use Sudo box

click SUDO Binary File to verify the sudo binary file path

4. Click OK.

If the credentials are not valid, the NSRLoginStatus parameter will appear in “suspicious state” afterthe next data collection.

42Installing the KM

Version 2.8.01


Verifying Application DiscoveryTo verify the application discovery:

1. Check that the NSR_SETUP instance is actually named EMC NetWorker. If not, force a fulldiscovery by right-clicking the EMC NetWorker instance > KM Commands > Force Discovery

2. Check that the application class instances are actually instantiated. The initial data collection maytake some time depending on the complexity of your environment (up to one hour). If needed, forcea data collection by right-clicking the EMC NetWorker instance > KM Commands > RefreshParameters.

If EMC NetWorker is configured in a configured in a clustered environment, you'll have to enable Multi-node Mode monitoring.

Checking the Instance LimitsBy default, there is no limitation set for the available instances in EMC NetWorker KM for PATROL. Tooffer better performance, it is possible to limit the number of instances that will be displayed in theConsole for each monitored elements.

Because increasing the number of instances may impact the performance of the KM, it isrecommended to only monitor critical elements in large environments.

43Installing the KM

Version 2.8.01


To modify the default configuration1. In the Console, right-click the KM main icon > KM Commands > Configuration> Instance

Limits

Configuring the Default Instance Lim its

2. Enter the number of instances to be displayed in the console for each monitored element

3. To disable the monitoring of a specific application class, enter 0 in the relevant field

4. Click OK.

44Installing the KM

Version 2.8.01


Checking the Initial Setup of the KMTo check the initial setup of the KM:

1. Check whether the discovered files and directory paths are correct, using the menu Configuration> Paths from the EMC NetWorker instance.

2. Check whether the discovered Node Type is correct using the menu Configuration > Node Typefrom the EMC NetWorker instance.

3. Check the InfoBoxes and Parameters of all the NSR KM instances and verify that they are setcorrectly.

4. Under each container instance, open all detail parameters (text parameters with names in theformat NSR<Object>Details), and check for error messages.

5. Check the new value of parameter NSRLoginStatus set after completion of all data collection. Ifeither is not in OK state, open the annotation point to determine the cause of the error.

6. After the KM has been running for at least an hour:

Right-click the KM main icon > KM commands > KM Status from the EMC Storage Managerinstance. A report is displayed, detailing information on the managed system. Check through thereport for any warnings or alarms. If any errors are found during any of the above steps(including any incorrect data in Infoboxes or any warnings or alarms in the KM Status report),determine the cause(s) and take steps to resolve these errors. You may need to refer to the UserGuide, or contact Technical Support, attaching the KM Status report.

If needed, click Save As Task to open the report in a task window. You could later save it as atext file or print it.

7. The KM installed on the storage node may monitor the same elements which are already monitoredthrough the server node. This may be unnecessary and can trigger duplicate alerts. You can disablethese components on either server or storage node by setting their instance limit to 0 (zero), usingthe menu Configuration> Instance Limits.

Restarting PATROL Agent and PATROL ConsoleRestarting the PATROL Agent and PATROL Console is optional but often a good practice to confirm thatthe NSR KM operates correctly after restarting the PATROL Agent and/or PATROL Console.

In addition, the PATROL Agent restart will force all KM discoveries and data collections to startimmediately.

45Installing the KM

Version 2.8.01


Integrating the KM

Introduction

This section provides detailed information about the integration of EMC NetWorker KM for PATROL withBMC ProactiveNet Performance Management.

Integrating with BMC Portal1. Log on to BMC Portal with appropriate credentials to add infrastructure elements.

2. Click on Configure tab.

3. Under Tasks, select Elements to open the Elements page.

4. Click Add.

5. Select Infrastructure Element, and click Next.

6. Select appropriate RSM, and click Next.

7. Enter the label for the element, select PATROL Integration, and click Next.

8. Select/create a group name, and click Next.

9. Select appropriate method to discover the PATROL Agent hosts, and click Next.

10. Fill the required details for discovering the PATROL Agents, and click Commit.

Integrating with BMC ProactiveNet PerformanceManagement 8.5.x and 8.6.x

OverviewTo integrate a BMC PATROL KM into BMC ProactiveNet Performance Management 8.5.x or 8.6.x, youneed to create a specific adapter. An adapter for BMC PATROL facilitates pulling of performance datafrom existing BMC PATROL solutions into BMC ProactiveNet. Using an Adapter, you can import BMCPATROL application classes (provided in a Knowledge Module –KM) into BMC ProactiveNet. The Adapterperiodically synchronizes the performance data collected by these application classes into BMCProactiveNet.

Creating and Importing an Adapter for a BMC PATROL KM

Creating an Adapter for a BMC PATROL KM1. Open the BMC ProactiveNet Administration Console. The BMC ProactiveNet Administration Console

is displayed as shown in the following figure:

2. Right-click the Adapters folder and select Import Monitor Type and Add Adapter > BMCPATROL.

3. In the Configuration tab, enter the required information:

In the Instance Name field, enter a name for this instance of the Adapter that will perform theintegration of the ‘targeted KM’ into BMC ProactiveNet.

Select the Agent where this instance of the Adapter will be executed

46Integrating the KM

Version 2.8.01


Enter the Integration Service Agent hostname or IP address

Enter the Integration Service Agent Port. The default port is 3182.

Enter the required credential to connect to the Integration Service Agent

4. Click Next to continue

5. Click Next to let the system load the BMC PATROL application classes.

6. Select the application classes to import

Unselecting will delete the application classes that have already been imported during a previousoperation. Application classes ready to be deleted are marked with a red x.

7. Click Next to start the import process. The system displays a summary of the application classimport, click Next to continue.

8. Select the application classes you wish to auto-synchronize with the Integration Service Agent.

9. Click Next to continue

10. Set the Filter details if need.

11. Click Next to continue.

12. Set the Auto-sync poll scheduling, if needed.

13. Click Next to continue. The system displays a summary of your settings, click Finish to confirm. TheAdapter has been added to the Adapters folder of the Administration Console.

14. To see the class instances that have been imported by the Adapter, expand the Adapters folder,right-click the Adapter and select Details.

We strongly recommend that you create a specific adapter for each KM you need to integrate intoBMC ProactiveNet to enable the update of a single KM independently.

Updating an Adapter for a BMC PATROL KM

Updating an Adapter1. Delete the Adapter instance

2. Go through the Add an Adapter wizard to actually delete the monitor types that had been createdbased on the previous version of the KM

3. Close

4. Resume the entire Creating an Adapter for a BMC PATROL KM procedure

For complete and detailed information on these procedures, please refer to the BMC ProactiveNet documentationavailable from BMC Web site.

Importing and Customizing Thresholds1. Launch the BMC ProactiveNet PW Commands. On Windows 2008, you need to run the PW

Commands as Administrator.

2. Execute the following command line:pw adapter -type patrol -get_thresholds <file name> -pproxy_host <hostname|ipaddress>

-pproxy_port <port_number>] [-pproxy_user <username>] [-pproxy_passwd <password>] -i -v

where

-get_thresholds <file name> = File name with absolute path at which thresholds

will be imported

-pproxy_host <hostname|ipaddress> = Host name or IP Address of Patrol Proxy Server


Version 2.8.01


-pproxy_port <port_number> = Port at which Patrol Proxy Agent communicates with Patrol

Proxy Server

-pproxy_user <username> = User name of Patrol Proxy user

-pproxy_passwd <password> = Password to authenticate Patrol Proxy user

-i = import Instance level thresholds

-v = run in "verbose" mode, producing extra lines of output during extraction and

conversion processes

The command has produced a text file with all the parameter threshold settings.

3. Open the file in a text editor. Check that the global thresholds have been properly interpreted.

4. Then go to the # INSTANCE LEVEL THRESHOLDS section of the file.

5. Uncomment all instance level thresholds for the _PATROL__NSR_ prefixed instances.

Search the file for the 'NOT_IMPLEMENTED' occurrences to detect thresholds that were not properlyconverted by the PATROL Adapter.

6. Save the file.

7. Execute the following command:pw threshold loadpatrolthreshold [<thresholdfilename> [-v]]

where:

<thresholdfilename> is a thresholds file name. If no file path is specified

then the default '<Installation Directory>/pw/tmp/' is used

-v enables the Verbose mode

Class-level thresholds can be displayed using the Absolute Global Thresholds panel in the BMCProactiveNet Operator Console, while instance-level thresholds are displayed in the Absolute InstanceThresholds panel.

Managing Baselines and Key Performance IndicatorsIn order to facilitate the detection of abnormalities on your monitored environment, BMC ProactiveNetcalculates baselines per parameter (metrics or attributes) based on values collected over a specifiedperiod of time to determine a normal operating range. When the collected values for these parametersare out of range, an alert is triggered.

Some parameters are identified by default as Key Performance Indicators and therefore automaticallyincluded in the base lining calculation.

Managing baselines

The baseline is the expected normal operating range for a metric or attribute of a monitor.

The baseline is calculated by collecting the values for a monitor’s attributes and metrics over a specifiedtime period and establishing a low baseline value (consisting of the 10th percentile of all the values for agiven time period) and a high baseline value (consisting of the 90th percentile of all the values for agiven time period), taking a weighted average of these values over time. A higher weight is given to thelatest data being factored into the baseline average. The accuracy of the baseline improves over time.


Version 2.8.01


Requirements for baseline generation

For baselines to be generated for an attribute, that abnormality threshold means that the thresholdexists and is not suppressed. Additionally, if the Key Performance Indicator (KPI) mode is active, only those attributes that have anactive abnormality threshold and are also KPI attributes will have baselines generated for them.

Absolute thresholds (with "outside baseline") or signature thresholds do not satisfy these requirements.

Managing Key Performance Indicators

The KPI attribute of a parameter can be activated or deactivated manually through the BMC ProactiveNetAdministration Console. In this KM, some parameters or attributes have been designated as importantindicators of performance (KPIs). We do not recommend that these default settings are modified.

However, advanced users may activate or deactivate KPIs from the BMC ProactiveNet AdministrationConsole.

To add or remove Key Performance Indicator (KPI) attributes for amonitor type

1. In the Administration Console, from the menu bar, choose Tools > KPI Administration. TheKPI Administration dialog box is displayed.

2. From the Monitor Type list, choose the monitor type for which you want to add or remove KPIattributes. A list of attributes for the selected monitor type is displayed.

3. In the KPI column for the attributes that you want to add or remove as Key Performance Indicators:

select the KPI check box to add the corresponding attribute as a KPI

deselect the KPI check box to remove the corresponding attribute from the KPIs for that monitortype

For complete and detailed information on this procedure, please refer to the BMC ProactiveNet documentation availablefrom BMC Web site.

Parameters for which the system by default calculates baselines as well as parameters considered asKPIs are respectively identified by the following icons:

Baselining

KPI

49Monitoring your environment

Version 2.8.01


Monitoring your environment

EMC NetWorker KM for PATROL helps ensure the availability, maximum performance, and integrity ofyour backup servers, thereby protecting associated data sets.

Administering EMC NetworkerEMC NetWorker KM for PATROL provides secure server administration menus, which can be executed byPATROL Console users, if they have appropriate privileges. They can more especially:

Start or stop the server/storage node

Administer:

pending requests

standalone drives

jukebox drives.

Starting Server/Storage NodeIn the Console, right-click the EMC Networker instance > KM Commands>Administration andselect Start Server / Storage Node.

Stopping Server/Storage NodeIn the Console, right-click the EMC Networker instance > KM Commands>Administration andselect Stop Server / Storage Node.

Administering Pending RequestsWhen a pending request appears, its parameter NSRRequestStatus is immediately set to alert(Warning or Alarm depending on the elapsed time). When a pending request appears on a standalonedevice, requested tape needs to be loaded in to the standalone device, and mounted. To perform thismount operation, right-click the pending request instance and select KM commands > Administration> Mount Tape.


Version 2.8.01


Administering Standalone DrivesTo administer standalone drives, right-click the relevant drive instance and select one of the followingoptions:

Administration > Mount Tape

Administration > Unmount Tape

Administration > Enable Device

Administration > Disable Device

Administering Jukebox DevicesTo administer jukebox drives, right-click the Jukebox Device instance and select KM Commands >Administration > Enabled or Disabled.

Administration menus for mounting or unmounting tapes on jukebox dev ices are not available, where mounting orunmounting tapes on dev ices are automatic.

Configuring the KMThe configuration instructions provided in this section should be followed on all PATROL Agent Systemswhere EMC NetWorker KM for PATROL is installed.

Before configuring the KM, make sure:

the KM is loaded on the PATROL Console

the NSR_SETUP or EMC Networker instance is displayed in the Console.

Configuring PathsThe solution automatically discovers the installation, binary, and library paths. This information canhowever be overridden.

Altering these paths may impact the operation of the KM.

To configure paths:

1. In the Console, right-click the EMC Networker instance > KM commands > Configuration >Paths

2. In the KM section, verify and possibly modify the Home, Temp, and Debug Directory Paths

3. In the NSR section, verify and possibly modify the Installation Directory Path

4. In the Binary Paths and Library Paths sections:

From the list, select the paths to be removed

In the Path field, enter the new path(s) to be included. If several paths are to be entered,


Version 2.8.01


separate them with a colon (:).

5. Click OK.

If you want to rediscover the paths, empty all f ields, click OK, and restart the PATROL Agent.

Specifying the Node TypeYou may have to manually indicate the type of node monitored if the discovery fails to recognize it:

1. In the Console, right-click the EMC Networker instance > KM Commands > Configuration >Node Type

2. Select the node type

3. Click OK.

Configuring the Multi-Node Monitoring ModeIf the NSR KM environment is installed in a cluster using Veritas Cluster Server, Veritas Cluster FileSystem, Oracle Solaris Cluster, or Microsoft Cluster, the NSR KM must be installed on all the clusternodes to enable continuous monitoring and avoid single point of failure. To avoid duplicate alerts frommultiple nodes, it is recommended to configure the solution to operate in multi-node monitoring mode.

To configure the multi-node monitoring mode:

1. In the Console, right-click the EMC Networker instance > KM Commands Configuration >Monitoring Mode

Configuring the Multi-Node Monitoring Mode


Version 2.8.01


2. Select Multi-node Mode

3. Select the appropriate Cluster Application

4. Indicate the Failover Group Name. Leave this field blank if you previously selected Veritas ClusterFile System. The NSR KM will then monitor the entire cluster from the active master system, whichis identified by the vxdctl -c mode command. This method requires vxconfigd in enable mode withits clustered state active.

5. Enable remote PATROL Agent Checking to check the monitoring status of the other nodes andclick Ok

6. Indicate all the information required to communicate with the remote PATROL Agent (authenticationserver, protocol, port number, and credentials)

7. Click Ok.

EMC NetWorker server will then be monitored through the online cluster node. The KM on offline nodewill monitor in passive mode, until NetWorker is failed over. In the passive mode the KM will monitoronly the NetWorker components that requires monitoring.

If a managed node is unable to determine the system which should be in A ctive Multi-node Mode, it will change toTemporary Single-node Mode.

Filtering Elements to MonitorBy default, the solution monitors all the elements discovered, which may represent an importantworkload to the agents and servers. Because the monitoring of some elements may be irrelevant forvarious reasons, you can apply filters to indicate which elements will be monitored or not.

To filter elements to monitor:

1. In the Console, right-click one of the following instances depending on the elements that you wishto monitor:

Clients > KM Commands > Configuration> Clients to filter clients to be monitored

Daemons > KM Commands > Configuration > Daemons to filter daemons to be monitored

Databases > KM Commands > Configuration > Databases to filter databases to bemonitored

Logs > KM Commands > Configuration>Logs to filter logs to be monitored. Only the dailymessages file will be monitored on AIX and Microsoft Windows platforms since there is no ASCIIformat system log file to monitor.

Groups > KM Commands > Configuration > Groups to filter groups to be monitored. Bydefault, only save groups that belong to these groups will be instantiated and monitored. You canhowever disable this direct relationship between monitored groups configuration and monitoredsave groups instances by running the following PSL through PATROL Console: %PSL pconfig("REPLACE","/NSR/FilterJobByPolicy", false);

Group Client > KM Commands > Configuration > Group Client to filter group clients to bemonitored

Jukeboxes > KM Commands > Configuration > Jukeboxes to filter jukeboxes to bemonitored

Standalone Devices > KM Commands > Configuration > Standalone Devices to filterstandalone devices to be monitored

Volume Pools > KM Commands > Configuration > Volume Pools to filter volume pools tobe monitored


Version 2.8.01


These menus are also available from the child instances.

Client Configuration dialog

The [ALL] entry ensures that all the elements found during PATROL discovery are instantiated andmonitored. When installed on a Storage Node, the default configuration monitors only the discoveredlocal jukeboxes and local standalone devices. This is covered by the [LOCAL] entry in the defaultconfiguration on a Storage Node.

2. To enable elements for monitoring:

In the current configuration list, select the elements to enable

Select Enable

Click Update

A log filter will have to be configured if you enable log files for monitoring.


Version 2.8.01


3. To disable elements for monitoring:

In the current configuration list, select the elements to disable

Select Disable

Click Update

All jobs associated to disabled policies are not monitored.

Disabled instances will be instantiated in an OFFLINE state. Commands will not be executed, thus leav ing parametersnot set.

4. To delete elements for monitoring:

In the current configuration list, select the elements to delete

Select Delete

Click Update

5. To add a new element to monitor:

Type the name of the element (as it appears in the PATROL console) or a regular expression tobe monitored

If needed, enter a description

From the Status list, select Enable

Click Update.

To revert to the default monitoring configuration, type “[default]” as a new entry and click Update.

6. Resume the procedure for all the application classes for which you wish to apply monitoring filters.

Configuring Monitoring Periods

By default, EMC NetWorker KM for PATROL monitors all pending requests for 1day and all save groupsthat completed successfully for 1 day and any other save group for 3 days . You can however modifythese settings to better suit your requirements:

Increasing the monitoring period may affect the performance of the application.


Version 2.8.01


Configuring the Save Groups Monitoring Periods1. In the Console, right-click the Save Groups instance > KM Commands > Configuration > Save

Groups

Sav e Group Filter Configuration dialog

2. Indicate how long the save groups in OK, Suspicious, and Failure status will be monitored. If you:

decrease the monitoring period, older save groups will be destroyed on the next data collectioncycle

increase the monitoring period, you'll have to force a full data collection to ensure all save groupsare instantiated. To force data collection, right-click the Save Groups instance > KMCommands > Force Full Collection


Version 2.8.01


3. Click OK.

By default, all active save groups are exempted from ageing, i.e. save groups which are in one of the active states(In Progress, or In Progress/Errors) will always be monitored.

Configuring the Pending Requests Monitoring Period1. In the Console, right-click the Pending Requests instance > KM Commands > Configuration

> Pending Requests

Pending Request Filter Configuration dialog

2. Indicate how long the pending requests will be monitored. If you decrease the monitoring period,older pending requests will be destroyed on the next data collection cycle

3. Click OK.

Configuring the Save Clients MonitoringBy default, only the failed save clients are monitored. This setting can however be modified to includesuccessful save clients.

To configure the save clients monitoring:

1. Right-click the Save Groups icon > KM Commands > Configuration > Save Clients

2. In the Monitored Save Clients dialog box, select the desired level of monitoring:

None: to disable the save clients monitoring feature

Failed Only (default): to only monitor failed save clients

Succeed Only: to only monitor successful save clients

All: to monitor all the save clients.

3. Click OK.


Version 2.8.01


Configuring the Node StatusThe parameter NSRNodeStatus monitors the availability of all the configured daemons. If anyconfigured daemon is not running, this parameter will be set to “failure” (Alarm) state and severalrecovery actions will be initiated. If any command run by EMC NetWorker KM for PATROL returns aserver/storage node error message, this parameter will be set to “suspicious” (Warning) state.

To indicate which daemons will set the NSRNodeStatus parameter:

1. In the Console, right-click the EMC NetWorker instance > KM commands > Configuration >Node Status

Node Status Configuration dialog


Version 2.8.01


2. In the Monitored daemons list, select the daemons to be removed from the node status filter

3. In the Daemon field, enter the daemons to be added to the node status filter. Multiple daemonsmay be entered at the same time, using a comma (,) as a separator.

4. Click Update.

To revert to the shipped default list of monitored daemons (as shown above), type “[default]” as a new daemon forthe list and click Update.

Configuring the Elements StatusThe status of an element is determined by the State parameter and by the status mapping rule. Thismapping rule indicates which states will trigger a warning or an alarm on the Status parameter. It canbe configured as follows:

1. In the Console, right-click the instance for which you want to configure status and select > KMcommands > Configuration > Instance Status

Client Status Configuration dialog


Version 2.8.01


2. In the Warning Filter State Rules list, select the states that will not trigger a warning

3. If needed, apply a time condition to a specific state. For example, if you want to trigger a warningwhen the Unknown state of the Client instance lasts more than 120 minutes:

From the State list, select -1 (Unknown)

From the Condition list, select >

In the Minutes field, enter 120

4. In the Alarm Filter State Rules list, select the states that will not trigger an alarm

5. If needed, apply a time condition to a specific state. For example, if you want to trigger an alarmwhen the Never Communicated state of the Clients instance lasts more than 240 minutes:

From the State list, select 2 (Never Communicated)

From the Condition list, select >

In the Minutes field, enter 240

6. Click Update.

To revert to the default status mapping rule for either filter, select [default] from the list of states and clickUpdate .

7. Resume the procedure for all the application classes for which you wish to apply monitoring filters.

Configuring the Log FilterA log error filter can be configured to specify the regular expressions that will generate a warning or analarm. Each time the KM will find these expressions in a log file or in NSRLogText, the error messagewill be written to the NSRLogAlarmText or NSRLogWarningText parameter.

By default, the default log filter is configured to only monitor the EMC NetWorker progress andcompletion messages files and the system log file. If you enabled additional log files for monitoring, youwill have to customize the log filter by adding appropriate expressions for those log files.

For more information about the possible error messages in the log files, refer to the EMC NetWorker SystemAdministrator’s Guide and the EMC NetWorker Error Message Guide.

To configure the log error filter:


Version 2.8.01


1. In the Console, right-click the Logs instance > KM Commands > Configuration > Logs Filter

Log Filter Configuration dialog

2. In the Warning Filter Expressions list, select the expressions that will not trigger a warning

3. In the Alarm Filter Expressions list, select the expressions that will not trigger an alarm

4. To add a new regular expression to the warning or alarm filter:

In the Expression field, indicate the regular expression to be included (e.g.: skipping)

Select Include

Regular expressions are case-sensitive.

5. To exclude a regular expression from the warning or alarm filter:

In the Expression field, indicate the regular expression to be excluded (e.g.: otlsol01). You canalso limit the exclusion to a particular expression already listed by using standard wildcard syntax,such as “warning . otlsol01”.

Select Exclude

6. Click Update.

To revert to the default settings for either filter, type [default] as a new error expression for that filter, and clickUpdate. If you revert to the default settings when accessed from the log instance level, the settings will revert tothe parent or container instance level. To revert to the shipped default settings (as shown above), access this dialogfrom the log container instance. From this level you will also have the option to reset the configuration of anymodified child instances.


Version 2.8.01


Configuring the Log Scan LimitThe NSR KM scans log files by reading the new log entries since the last data collection cycle. Bydefault, only 500 Kbytes of data is scanned for each log file during each data collection cycle. This logscan limit can however be modified to better suit your requirements.

Increasing the Log Scan Limit may impact the performance of the data collector (NSRLogCollector),the KM, and the PATROL Agent.

To customize the log scan limit:

1. In the Console, right-click the Log(s) instance > KM Commands > Configuration > Log(s)Scan Limit

2. Indicate the amount of data that will be read by the KM during each data collection cycle

3. Click OK.

Configuring Group Backup RestrictionNSR KM can be configured to trigger a warning when a group backup is started during a specific periodof time:

1. In the Console, right-click:

the Groups instance > KM Commands > Configuration> Groups Backup Restriction toapply this customization to all group backups

a Group instance > KM Commands > Configuration> Group Backup Restriction to applythis customization to a specific group


Version 2.8.01


Group Backup Restriction Window dialog

2. Select Enabled

3. Indicate the Restriction Start and End Time. The restriction window must at least last 5 minutes.

4. Click OK.

Configuring Alert AcknowledgementBy default, alerts will automatically be acknowledged unless you modified the following settings to allowmanual acknowledgement.

Manual acknowledgement may impact the performance of the application and of the PATROL Agentif the number of alerts waiting to be acknowledged constantly increases.


Version 2.8.01


Configuring Log Alert Acknowledgement

By default, log alerts are automatically acknowledged when new ones are detected. To change thedefault behavior:

1. In the Console, right-click the Log(s) instance > KM Commands > Configuration> Log(s)Alert Acknowledgement

Configuring Log A lert A cknowledgem ent

2. Indicate whether the warning and alarm messages will be manually or automatically acknowledged

3. Click Ok.


Version 2.8.01


Configuring Save Groups Alert Acknowledgment

To configure the save groups alert acknowledgement:

1. In the Console, right-click the Save Groups instance > KM Commands > Configuration > JobAlert Acknowledgement

Configuring Job A lert A cknowledgem ent

2. Indicate whether the warning and alarm messages will be manually or automatically acknowledged

3. Click Ok.

Configuring Date/Time FormatsThe EMC NetWorker KM for PATROL uses EMC NetWorker commands to determine the date and time ofeach save group and of each pending request (used for calculating the elapsed time since the savegroup and the pending request were initiated). Depending on your local system time zone and date/timeformat, the application may return a different date/time format. If so, you'll have to customize the savegroup and pending request date/time format.


Version 2.8.01


Customizing the Save Group Date/Time Format1. In the Console, right-click the Save Groups instance > KM Commands > Configuration > Save

Group Date/Time Format

Sav e Group Date/Tim e Form at Configuration dialog

2. Indicate the expected Date/Time Format.

3. Indicate a PSL-compatible Time Zone String (e.g.: NZDT, NZST, EDT, EST, GMT-1200, etc.)

4. Click OK.

The new date/time format is then applied to all save groups.

To revert to the default settings, blank out the Date/Time field and/or the Time Zone field and click OK. The Timezone field used will be the local time zone on the managed node.


Version 2.8.01


Customizing the Pending Request Date/Time Format1. In the Console, right-click the Pending Requests instance > KM Commands > Configuration >

Pending Requests Date/Time Format

Pending Request Date/Tim e Form at Configuration dialog

2. Indicate the expected Date/Time Format.

3. Indicate a PSL-compatible Time Zone String (e.g.: NZDT, NZST, EDT, EST, GMT-1200, etc.)

4. Click OK.

The new date/time format is then applied to all save groups.

To revert to the default settings, blank out the Date/Time field and/or the Time Zone field and click OK. The Timezone field used will be the local time zone on the managed node.


Version 2.8.01


Enabling the Debug ModeWhen you encounter an issue and wish to report it to Sentry Software, you will be asked to enable theDebug Mode and provide the debug output to the Sentry Software support team:

Enabling the Debug Mode

1. In the Console, right-click the EMC NetWorker instance > KM Commands > Configuration >Debug.

Enabling the Debug Mode


Version 2.8.01


2. Select On for the debug switch(es) you want to enable. The table below shows the applicationclasses and collector parameters included in the debug switch for each object:

Object DebugSwitch

Application Classes Collector Parameters

Server NSR_SERVER NSRCreateDistributionNSRUpdateAgent

Database NSR_DATABASE_CONTAINERNSR_DATABASE

NSRDatabaseCollector

Log NSR_LOG_CONTAINERNSR_LOG

NSRLogCollector

Client NSR_CLIENT_CONTAINERNSR_CLIENT

NSRClientCollector

Jukebox/Device NSR_LIBRARY_CONTAINERNSR_LIBRARYNSR_LDEVICENSR_DEVICE_CONTAINERNSR_DEVICE

NSRJukeboxCollectorNSRDeviceCollector

Daemon NSR_DAEMON_CONTAINERNSR_DAEMON

NSRDaemonCollector

Volume Pool NSR_POOL_CONTAINERNSR_POOL

NSRPoolCollector

Group/SaveGroup/PendingRequest

NSR_POLICY_CONTAINERNSR_POLICYNSR_PCLIENTNSR_JOB_CONTAINERNSR_JOBNSR_JCLIENTNSR_MOUNT_CONTAINERNSR_MOUNT

NSRGroupCollectorNSRSaveGrpCollectorNSRRequestCollector

3. Set the Debug Options:

In the Debug End Time field, indicate the date and time after which debug information will nolonger be logged.

In the Debug Path field, indicate where the debug file will be stored (by default:<PATROL_HOME>/lib/NSR/debug on Unix systems; %PATROL_HOME%\lib\NSR\debug onMicrosoft Windows systems). The debug folder must have at least 10MB of available disk spaceand read, write and execute permissions for both PATROL Agent user and the NSR KM login user

Select Send to File(s) to write all debug messages in a file or set of files.

Select Send to Task Window to view the debug messages as they occur in the NSR DebugOutput window. Before selecting this option, make sure the PATROL Console is connected to thePATROL Agent.

Select Both (Recommended) to send the debug messages both to a file and task window.

4. Select OK to start NSR KM debugging.

5. Click Yes to reload the KM and capture debug from the initial collection cycle.

Disabling the Debug Mode

The debug switches will be turned off automatically when the debug duration is over. A tar/zip file isthen automatically created under <PATROL_HOME>/lib/NSR/ and can be sent to the BMC Support forhelp. It is also recommended to check the SOW or NSR.log file, stored in <PATROL_HOME>/log, for any


Version 2.8.01


error. If you want to manually stop debugging:

1. Access the NSR KM Debug Configuration dialog

2. Select Off for the debug switch(es) you want to disable

3. Click OK.

Preparing the Debug Files for Sending to Sentry Software

If you chose to only send the output to a task window, you can save the debug output as follows:

Right-click in the NSR KM Debug Output window.

Select Save As and specify a location to save data.

If you chose to send debug information to file(s), you will be asked to prepare the debug files forsending to Sentry Software:

Click Yes to compress the files into a:

nsr_km_debug_<date>_<time>.tar.Z file (Unix systems). This file could later be found in$PATROL_HOME/lib/NSR/

nsr_km_debug_<date>_<time>.zip file (Windows systems). This file could later be found in%PATROL_HOME%\lib\NSR\

Click No if you do not want to compress the files. You will then be asked if you want to retain ordelete them.

If the compressed file is not created successfully , you can create it manually by including all f iles and sub-directoriesunder $PATROL_HOME/lib/NSR/ (on Unix ) or %PATROL_HOME%\lib\NSR\ (on Microsoft W indows).

Appending Output Data to Existing Files

If you want to gather output from several debug sessions:

1. Disable the debug mode

2. Click No when asked to prepare the files for sending

3. Choose to Retain the debug files.

4. Start the next debug session.

5. Choose to append the output data to existing files.


Version 2.8.01


Using the KMThis section describes all the features available for EMC NetWorker KM for PATROL.

Acknowledging AlertsBy default, alerts are acknowledged automatically. They can however be acknowledged manually if youdo not want to wait for the automatic cycle. Manual acknowledgement will also be required if youmodified the alert acknowledgement default settings.

Manually Acknowledging Log Alerts

When an error is detected in a monitored log file, it will appear under one of the text parameters NSRLogAlarmText or NSRLogWarningText. This will trigger an Alarm or a Warning on parameterNSRLogAlarmCount or NSRLogWarningCount, respectively.

To acknowledge log alerts:

1. In the Console, right-click the Log instance > KM Commands > Acknowledgement

2. Select:

Warning to view, select, and individually acknowledge errors in the NSRLogWarningTextparameter

Alarms to view, select, and individually acknowledge errors in the NSRLogAlarmTextparameter

All to acknowledge all alerts (Warnings and Alarms) at once without viewing

Manually Acknowledging Save Group Alerts

For a particular save group instance, if the NSRSaveGrpStatus has a value of 1=Suspicious or2=Failure, it will be set to alert with a status of Warning or Alarm respectively. These alerts can beacknowledged using the KM command Acknowledgement > Alert from the relevant save groupinstance.

To acknowledge save group alerts:

1. In the Console, right-click the Save Groups instance > KM Commands > Acknowledgement

2. Select:

Acknowledgement > Warnings to view and acknowledge alerts for all save groups with astatus of Warning.

Acknowledgement > Alarms to view and acknowledge alerts for all save groups with a statusof Alarm.

Acknowledgement > All to view and acknowledge all save group alerts (Warnings and Alarms)at once.


Version 2.8.01


Generating ReportsFollowing is a list of reports available in the EMC NetWorker KM for PATROL.

Daemons > Reports > Daemon List - lists all running EMC NetWorker daemons

Databases > Reports > Database Backup Information - reports information about theprevious index database backups

Logs > Reports > Messages List - reports all recent messages logged

Pending Requests > Reports > Pending Requests - reports a list of all pending requests

<Jukebox instance> > Reports > Jukebox Contents - reports the contents of the selectedjukebox instance

<Volume Pool instance> > Reports > Volumes List - reports information on all volumes inthe selected volume pool instance

To save the report as a task window click Save A s Task. This task window can then be printed or saved as a tex t file.

Reloading CommandsAll new commands are reloaded automatically but some situations, such as the operating systemupgrade or downgrade, may require to a manual commands reload. To do so, in the Console, right-clickthe EMC NetWorker instance > KM Commands > Reload Commands.

Refreshing ParametersThis section describes how to manually refresh parameters of the EMC NetWorker KM for PATROL,without waiting for an automatic polling cycle.

Forcing All Discoveries1. Refresh the PATROL Agent process cache using the KM command Refresh Process Cache from the

main NSR KM container instance (labeled EMC NetWorker).

2. Force the discovery by selecting KM command Force Discovery from the main NSR KM containerinstance.

These steps will also force discovery on application classes for any other KM loaded on the PATROL Agent as well asall application classes of the NSR KM.

Forcing All Data Collectors1. Refresh the PATROL Agent process cache using the KM command Refresh Process Cache from

the main NSR KM container instance (labeled EMC NetWorker).

2. All data collectors can be forced at the same time by using the KM command Refresh Parametersfrom the main NSR KM container instance.

These steps will refresh all other data collectors defined under the various application classes loaded on the PATROLAgent as well as refreshing the NSR KM data collectors.


Version 2.8.01


Forcing Selected Data Collectors

This option is only available from a PATROL Developer Console.

1. Refresh the PATROL Agent process cache using the KM command Refresh Process Cache fromthe main NSR KM container instance (labeled EMC NetWorker).

2. Force a data collector to execute immediately as follows:

On PATROL Console for MS Windows

Right-click on the NSR KM container instance and choose Parameters without Icons...

Select the required data collector.

Click Update.

On PATROL Console for Unix

Right-click on the NSR KM container instance and choose Customize > Parameters...


Click on Options > Update.

With the PATROL Central Operator Console

Right-click on the NSR KM instance and choose Properties

Click on the Parameter List tab


Click Update.

Forcing Full Data Collection for Save Groups

By default, the NSRSave GroupCollector only searches for new save groups started since the lastcollection cycle. However, it can be forced to search for all save groups within the monitored timeperiod during the next collection cycle. Use the KM command Force Full Collection from the savegroups container instance (labeled Save Groups).

If the Save Groups container instance is not instantiated, this menu command cannot be accessed. The PATROLAgent needs to be restarted to force a full data collection for save groups.

Reference Guide

Introduction

This chapter provides statistical information about resources, operating status, and performancesmanaged by EMC NetWorker KM for PATROL. It contains tables describing the parameters used in theKM, grouped by Application Classes, and provides a brief description of each parameter and its defaultsettings.

73Reference Guide

Version 2.8.01


Classes and ParametersThis section lists the application classes of NSR KM. It gives you details on the icons that represent theclass, Infobox, parameters and the menu commands available for each application class. There are 13main application classes and 10 “container” classes.

NSR_SERVER

NSR_CLIENT_CONTAINER

NSR_CLIENT

NSR_DAEMON_CONTAINER

NSR_DAEMON

NSR_DATABASE_CONTAINER

NSR_DATABASE

NSR_LOG_CONTAINER

NSR_LOG

NSR_POLICY_CONTAINER

NSR_POLICY

NSR_PCLIENT

NSR_JOB_CONTAINER

NSR_JOB

NSR_JCLIENT

NSR_MOUNT_CONTAINER

NSR_MOUNT

NSR_LIBRARY_CONTAINER

NSR_LIBRARY

NSR_LDEVICE

NSR_DEVICE_CONTAINER

NSR_DEVICE

NSR_POOL_CONTAINER

NSR_POOL

Baselines and Key Performance Indicators

Some parameters are identified by default as Key Performance Indicators (KPIs) and thereforeautomatically included in the base lining calculation. To learn more about auto baselining and KPIs,please refer to the Managing Baselines and Key Performance Indicators chapter.

In this guide, parameters flagged as KPIs and included by default in the baseline calculation process arerespectively identified by the following icons:

Baselining

KPI

74Reference Guide

Version 2.8.01


NSR_SERVER

Icon

Parameters

Name Description Units Default AlertConditions

BPPMType

ExtraFilesList Is used for pushing NSR KM libraryfiles to the PATROL Agent duringthe "Commit" operation.

n/a n/a n/a

NSRAdministratorChange Monitors any change in NetWorkeradministrator configuration betweendiscovery cycles. It is set byNSR_SERVER application classdiscovery.

0 = No Change1 = Changed-1 = Unknown

Warning= 1

Availability

NSRClientCollector Collects EMC NetWorker clientrelated information. It sets allconsumer parameters inNSR_CLIENT_CONTAINER andNSR_CLIENT application classes.By default, this collector is executedonly on the server.

Polling Interval: 600 seconds

n/a n/a n/a

NSRCreateDistribution Is automatically activated at theend of NSR KM debugging if thecustomer chooses to "preparedebug files for sending to SentrySoftware". It is deactivated oncompletion.


n/a n/a n/a

NSRDaemonCollector Collects EMC NetWorker daemonrelated information. It sets allconsumer parameters inNSR_DAEMON_CONTAINER andNSR_DAEMON application classes.


n/a n/a n/a

NSRDatabaseCollector Collects EMC NetWorker indexdatabase related information. Itsets all consumer parameters inNSR_DATABASE_CONTAINER andNSR_DATABASE application classes.By default, this collector is executedonly on the server.

n/a n/a n/a

75Reference Guide

Version 2.8.01



NSRDeviceCollector Collects EMC NetWorker standalonedevice related information. It setsall consumer parameters inNSR_DEVICE_CONTAINER andNSR_DEVICE application classes.


n/a n/a n/a

NSRGroupCollector Collects EMC NetWorker KM forPATROL group and group clientrelated information. It sets allconsumer parameters inNSR_POLICY_CONTAINER,NSR_POLICY, and NSR_PCLIENTapplication classes.By default, this collector is executedonly on the server.


n/a n/a n/a

NSRJukeboxCollector Collects EMC NetWorker jukeboxand jukebox device relatedinformation. It sets all consumerparameters inNSR_LIBRARY_CONTAINER,NSR_LIBRARY, and NSR_LDEVICEapplication classes.


n/a n/a n/a

NSRLogCollector Collects information about the EMCNetWorker log file. It sets allconsumer parameters inNSR_LOG_CONTAINER andNSR_LOG application classes.


n/a n/a n/a

NSRLoginStatus* Monitors the status of the NSR KMlogin details (username/password)for the operating system. It is setby NSR_SERVER application classdiscovery.If no valid username/password isdetected for the operating system,this parameter will be set to Failurestate. If there are any suspiciouscommand exits, this parameter willbe set to Suspicious state.

If this status parameter changes towarning or alarm state, therecovery action will trigger an eventand annotate the last data point.

0 = Ok1 = Suspicious2 = Failure

Warning= 1Alarm =2

Collection Status

NSRMonitoringMode* Monitors failover mode of EMCNetWorker KM for PATROL. It is setby NSR_SERVER application classdiscovery.

0 = PermanentSingle-node Mode 1 = TemporarySingle-node Mode2 = Active Multi-node Mode3 = Passive Multi-node Mode-1 = Unknown

None Collection Status

76Reference Guide

Version 2.8.01


By default EMC NetWorker KM forPATROL runs in Permanent Single-node Mode. Multi-node monitoringcan be configured using the KMcommand Configuration>MonitoringMode from the EMC NetWorkericon.

NSRMonitorRAP Collects the status of theNetWorker RAP (ResourceAllocation Protocol)monitorconfiguration. It is set byNSR_SERVER application classdiscovery.

0 = Enabled1 = Disabled-1 = Unknown

None Availability

NSRNodeStatus* Monitors error messages for theEMC NetWorker application on thismanaged system. It is set byNSR_SERVER application classdiscovery.If any of the EMC NetWorkerapplication daemons is not running,this parameter will be set to Failurestate. The list of critical EMCNetWorker daemons can becustomized using the KM command Configuration > Node Statusfrom the EMC NetWorker icon. Ifthere are any suspicious commandexits due to an error from theserver/storage node, thisparameter will be set to Suspiciousstate.



Warning= 1Alarm =2

Availability

NSRPoolCollector Collects information about the EMCNetWorker volume pools. It sets allconsumer parameters inNSR_POOL_CONTAINER andNSR_POOL application classes. Bydefault, this collector is executedonly on the server.


n/a n/a n/a

NSRRequestCollector Collects information about the EMCNetWorker pending requests. Itsets all consumer parameters inNSR_MOUNT_CONTAINER andNSR_MOUNT application classes.By default, this collector is executedonly on the server.


n/a n/a n/a

NSRSaveGrpCollector Collects information about EMCNetWorker backup/restore savegroups and save clients. It sets allconsumer parameters inNSR_JOB_CONTAINER, NSR_JOB,and NSR_JCLIENT applicationclasses.

n/a n/a n/a

77Reference Guide

Version 2.8.01


By default, this collector is executedonly on the server. Polling Interval: 300 seconds

NSRServerSummary Set by NSR_SERVER Discovery,summarizes the server informationas reported in commands executedby the discovery.

n/a n/a n/a

NSRUpdateAgent Is used by the NSR KM to set thePATROL Agent KM variables whenthe PATROL Console user is notauthorized to update (ACL) anyPATROL Agent variables. It isactivated automatically when theKM fails to update the PATROLAgent. Polling Interval: 300 seconds

n/a n/a n/a

* Parameters marked with an asterisk are used by default when v isualizing the corresponding monitor instance in BPPM.

InfoBox

Name Description

Product Name Name of the Knowledge Module.

Product Version Version number of the Knowledge Module.

Product Release Date Release date of the Knowledge Module.

PATROL Agent Version Version number of the PATROL Agent installed on the managed system.

Application Name Name of the application monitored by this Knowledge Module.

Application Version Monitored application version number.

Server(s) Names of the discovered Servers.

Storage Node(s) Names of the discovered Storage Nodes.

Node Name(s) Name of the current managed system (node) as defined in EMC NetWorker.

Node Type Type of the node (Server or Storage Node).

Host Name Name of the host as configured on the PATROL Agent.

Platform Operating system platform as reported by PATROL Agent (HP, SOLARIS, AIX, orNT).

Operating System Operating system description as reported by PATROL Agent.

Installation Path EMC NetWorker software installation path.

Binary Path EMC NetWorker software binary paths used by NSR KM.

Library Path EMC NetWorker software library paths used by NSR KM.

Monitoring Mode Monitoring mode of the Knowledge Module.

Monitoring Node Node currently monitoring EMC NetWorker.

Copyright Copyright (C) Sentry Software

Web Site www.bmc.com

78Reference Guide

Version 2.8.01


Support [email protected]

Menu Commands

Function Description

Refresh Process Cache Forces the PATROL Agent to reload its process cache from the kernel processlist.

Force Discovery Forces application discovery.

Refresh Parameters Forces an update of the application parameter values.

Reload Commands Forces a reload of commands used by NSR KM during the next full discoverycycle. By default, all new commands are reloaded automatically.

Administration > Start Server/Storage Node

Starts server/storage node daemons.

Administration > Stop Server/StorageNode

Stops server/storage node daemons.

Configuration > Login Accesses the Login Configuration dialog for viewing and entering NSR KM logindetails for the operating system.This user account should have privileges to execute EMC NetWorkeradministration commands and can use sudo privileges on Unix PATROL Agents.This user account will be used by NSR KM pre-discoveries, discoveries, datacollectors, recovery actions, and InfoBoxes to execute operating systemcommands. It will not be used by any KM commands.The password is encrypted and stored on the PATROL Agent using the BMCPATROL encryption function.

Configuration > Preloading Accesses Preloading Configuration dialog, which adds or removes the KM fromPATROL Agent variable /AgentSetup/preloadedKMs.By preloading the NSR KM, the PATROL Agent will monitor the EMC NetWorkerapplication without any PATROL Console connection.

Configuration > Monitoring Mode Accesses the Monitoring Mode Configuration dialog, which is used forenabling or disabling KM failover, when monitoring VCS clustered EMC NetWorkerenvironment.

Configuration > Paths Accesses the Path Configuration dialog, which displays and sets all pathsused by NSR KM.Paths are automatically discovered by the NSR KM server discovery. They areused as environment variables for executing various EMC NetWorker applicationcommands. Altering these paths may impact the operation of the KM.

Binary paths are used as environment variables:

$PATH (on Unix)

%PATH% (on MS Windows)

Library paths are used as environment variables:

$LD_LIBRARY_PATH (on Solaris)

$SHLIB_PATH (on HP-UX)

$LIBPATH (on AIX)

For details about other EMC NetWorker related paths, refer to the EMCNetWorker Administrator’s Guide.

79Reference Guide

Version 2.8.01


Configuration > Node Type Accesses the Node Type dialog, which displays and sets the type of the EMCNetWorker application node.The NSR KM server/storage node discovery detects the type of the nodeautomatically; the type can either be Server or Storage Node. The operation ofthe KM depends on this node type.

Configuration > Node Status Accesses the Node Status Configuration dialog for viewing and modifyingthe daemon names monitored for node status.The NSR KM checks for the existence of these daemons to determine the statusof the node (parameter NSRNodeStatus). By default, the following daemonsare sought:

Type [default] to reset to the default configuration.

Configuration > Instance Limits Accesses the Instance Limits Configuration dialog to view and modify themaximum number of NSR KM application instances allowed for each applicationclass.

Configuration > Debug Accesses the Debug Configuration dialog for enabling/disabling the NSR KMdebug switches.By default, all KM debug messages are sent to a set of files and a task window.

KM Status Generates a summary report containing information on the managed system.

About Displays information about the product and manufacturer.

NSR_CLIENT_CONTAINER

Icon

80Reference Guide

Version 2.8.01


Parameters


BPPMType

NSRClientDetails Set by NSRClientCollector.Displays all data returned to thestandard out from commandsexecuted by the data collector.

n/a n/a n/a

NSRClientExecTime Inactive standard parametermonitors the collector executiontime. To activate this parameter, usethe PSL below, and restart the PatrolAgent: %PSL pconfig("REPLACE",

"/Runtime/NSR/

NSRClientCollectorExecTim

e", 1);

When activated it will run everyminute and trigger a warning whenthe collector runs for more than theobserved maximum time. Thismaximum time can be overridden bya preset value (example: 3600seconds), using the PSL below:

%PSL pconfig("REPLACE",

"/Runtime/NSR/

NSRClientCollectorWarn",

3600);

seconds Warning> presetvalue orobservedmaximum(default)

CollectionStatus

InfoBox

Name Description

Collector Name Name of the data collector that sets variables and parameters under thisapplication instance.

Collector Last Start Date & time when the last data collection cycle started.

Collector Last End Date & time at the completion of the last data collection cycle.

Collector Next Start Date & time when the next data collection cycle is expected to start.

Collector Status Data collector execution status (Idle or Running).

Menu Commands


Configuration > Clients Accesses the dialog for specifying which clients are to be monitored by the NSRKM.By default, all clients configured on the server are monitored.Type [default] to reset to the default configuration.

81Reference Guide

Version 2.8.01


Configuration > Clients Status Accesses the global configuration for determining the client status for monitoredclient instances.By default, following NSRClientState to NSRClientStatus mapping rule isused:

Select [default] to reset to the default client status mapping rule.

NSR_CLIENT

Icon

Parameters

Name Description Units DefaultAlertConditions

BPPMType

NSRClientIndexRecordCount* Set by NSRClientCollector.Displays the number of recordsfound in the index database for thisclient.

count None Statistics

NSRClientIndexSpaceUsed Set by NSRClientCollector.Displays the index space used bythis client.

KB None Statistics

NSRClientIndexSpaceUsedPercent*

Set by NSRClientCollector.Displays the percentage of indexspace used by the client.

% None Statistics

NSRClientState Set by NSRClientCollector.Displays the state of the client asreported in the command executedby the data collector.

0 = Running1 = Not Running2 = Client Down-1 = Unknown

None Availability

NSRClientStatus Set by NSRClientCollector.Monitors the status of the client.This status is determined by theclient status mapping rule defined inthe KM command Configuration >Client(s) Status.

If this status parameter changes towarning or alarm state, the recoveryaction will trigger an event andannotate the last data point.


Warning= 1Alarm =2

Availability

82Reference Guide

Version 2.8.01


NSRClientSummary Set by NSRClientCollector.Summarizes the client information asreported in commands executed bythe data collector.

n/a n/a n/a

For detailed information about B a se lining and KP I, see Managing Baselines and Key Performance Indicators.


InfoBox

Name Description

Name Name of the EMC NetWorker client.

Description Description of the EMC NetWorker client.

Platform Hardware platform of the client.

Operating System Operating system of the client.

Architecture Platform architecture of the client.

CPU Type CPU Type of the client.

CPUs Number of CPUs in the client system.

Servers EMC NetWorker Servers, which can connect to the client.

Enabler in Use Displays whether the EMC NetWorker enabler code is configured for the client.

Status Status of client connectivity from the current node.

Application Name of the application installed on the client, which responds to the connectionrequest.

Version Version number of the application installed on the client.

Aliases Aliases for the client.

IP Address IP address of this client.

ONC Program Number ONC program number of this client.

ONC Version Number ONC version number of this client.

ONC Transport ONC transport of this client.






Menu Commands

83Reference Guide

Version 2.8.01



Configuration > Client Accesses the individual configuration for monitoring the selected client instance.This dialog allows the selected client instance to be enabled or disabled formonitoring by the NSR KM.

Configuration >Client Status Accesses the individual configuration for determining client status for theselected client instance.By default, the global NSRClientState to NSRClientStatus mapping rule isused, as configured at the container level. Select [default] to revert to theclient status mapping rule configured at the global/container level.

NSR_DAEMON_CONTAINER

Icon

Parameters


BPPMType

NSRDaemonDetails Set by NSRDaemonCollector.Displays all data returned to thestandard out from commandsexecuted by the data collector.

n/a n/a n/a

NSRDaemonExecTime Inactive standard parametermonitors the collector executiontime. To activate this parameter, usethe PSL below, and restart the PatrolAgent:%PSL pconfig("REPLACE",

"/Runtime/NSR/

NSRDaemonCollectorExecTim

e", 1);

When activated it will run everyminute and trigger a warning whenthe collector runs for more than theobserved maximum time. Thismaximum time can be overridden bya preset value (example: 3600seconds), using the PSL below:%PSL pconfig("REPLACE",

"/Runtime/NSR/

NSRDaemonCollectorWarn",

3600);


CollectionStatus

InfoBox

84Reference Guide

Version 2.8.01


Name Description






Menu Commands


Reports > Daemon List Lists all running EMC NetWorker daemons.

Configuration > Daemons Accesses the dialog for specifying which daemons are to be monitored by theNSR KM.By default following daemons are monitored.


Configuration > Daemons Status Accesses the global configuration for determining the daemon status formonitored daemon instances.By default following NSRDaemonState to NSRDaemonStatus mapping ruleis used:

Select [default] to reset to the default mapping rule.

85Reference Guide

Version 2.8.01


NSR_DAEMON

Icon

Parameters


BPPMType

NSRDaemonCPUDuration Set by NSRDaemonCollector.Displays the CPU seconds consumedby the daemon.

seconds None Statistics

NSRDaemonCPUUtilization* Set by NSRDaemonCollector.Displays the percentage of CPUused by the daemon.

% None Statistics

NSRDaemonMemorySize* Set by NSRDaemonCollector.Displays the core image size of thedaemon in the virtual memory.

KB None Statistics

NSRDaemonProcessCount Set by NSRDaemonCollector.Displays the number of daemonprocesses/threads found.

processes None Statistics

NSRDaemonState Set by NSRDaemonCollector.Displays the state of the daemon asreported in the command executedby the data collector.

0 = Running1 = Sleeping2 = Waiting3 = Queued4 = Intermediate5 = Terminated6 = Stopped/Disabled7 = Growing8 = Nonexistent/Not Responding9 = Not Running-1 = Unknown

None Availability

NSRDaemonStatus Set by NSRDaemonCollector.Monitors the status of the daemon.This status is determined by thedaemon status mapping rule definedin the KM command Configuration> Daemon(s) Status.



Warning= 1Alarm = 2

Availability

86Reference Guide

Version 2.8.01


NSRDaemonSummary Set by NSRDaemonCollector.Summarizes the daemon informationas reported by commands executedby the data collector.

n/a n/a n/a



InfoBox

Name Description

Name Name of the EMC NetWorker daemon.

Description Description of the EMC NetWorker daemon.

PID Process ID of the daemon.

PPID Parent process ID of the daemon.

Owner Owner of the daemon.

Status Status of the daemon as reported in the PATROL Agent process cache.

Command Command that started the daemon.






Menu Commands


Configuration > Daemon Accesses the individual configuration for monitoring the selected daemoninstance.This dialog allows the selected daemon instance to be enabled or disabled formonitoring by the NSR KM.

Configuration > Daemon Status Accesses the individual configuration for determining daemon status for theselected the daemon instance.By default, the global NSRDaemonState to NSRDaemonStatus mappingrule is used, as configured at the container level. Select [default] to revert tothe daemon status mapping rule configured at the global/container level.

87Reference Guide

Version 2.8.01


NSR_DATABASE_CONTAINER

Icon

Parameters


BPPMType

NSRDatabaseBackupElapsed* Set by NSRDatabaseCollector.Displays the elapsed time since thelast successful database backup.

The specified alarm ranges can beenabled to allow the output of theparameter to be actively monitored.Then, if this parameter changes towarning or alarm state, the recoveryaction will trigger an event.

hours None Statistics

NSRDatabaseDetails Set by NSRDatabaseCollector.Displays all data returned to thestandard out from commandsexecuted by the data collector.

n/a n/a n/a

NSRDatabaseExecTime Inactive standard parametermonitors the collector executiontime. To activate this parameter, usethe PSL below, and restart the PatrolAgent:%PSL pconfig("REPLACE",

"/Runtime/NSR/

NSRDatabaseCollectorExecT

ime", 1);


"/Runtime/NSR/

NSRDatabaseCollectorWarn"

, 3600);


Collection Status

NSRDatabaseRetention Set by NSRDatabaseCollector.Displays the number of days data willbe retained by the database.

days n/a Statistics

88Reference Guide

Version 2.8.01


InfoBox

Name Description

Last Backup Date & time when the index database was last backed up.

Last Backup Mode Backup mode of the last backup of the index database.

Last Backup Save Set ID Identifier of the last index database backup save set.

Last Backup Volume Label of the last index database backup volume.






Menu Commands


Reports > Database BackupInformation

Reports information about the previous index database backups.

Configuration > Databases Accesses the dialog for specifying which index databases are to be monitored bythe NSR KM.By default, the following database paths are monitored. These database pathsare relative to the EMC NetWorker installation directory (for example /NSR onUnix and C:\Program Files\NSR on MS Windows).

89Reference Guide

Version 2.8.01



90Reference Guide

Version 2.8.01


NSR_DATABASE

Icon

Parameters


BPPMType

NSRDatabaseFSSpaceUsedPercent*

Set by NSRDatabaseCollector.Monitors the percentage of spaceused by the file system where thedatabase resides.If this parameter changes to warningor alarm state, the recovery actionwill trigger an event.

% Alarm ifout of[0-100]rangeWarning:95-98Alarm:98-100

Statistics

NSRDatabaseSpaceAvailable Set by NSRDatabaseCollector.Monitors the amount of assignedspace remaining available for use bythe index database.If this parameter changes to warningor alarm state, the recovery actionwill trigger an event.

MB Warning:2-5Alarm ≤2

Availability

NSRDatabaseSpaceGrowthRate Set by NSRDatabaseCollector.Displays the growth rate of thespace used by the index database.

MB/s None Statistics

NSRDatabaseSpaceUsed Set by NSRDatabaseCollector.Displays the amount of assignedspace used by the index database.

MB None Statistics

NSRDatabaseSpaceUsedPercent* Set by NSRDatabaseCollector.Monitors the percentage of assignedspace used by the index database.If this parameter changes to warningor alarm state, the recovery actionwill trigger an event.Note that the total assigned space isthe used space(NSRDatabaseSpaceUsed) plus theavailable space(NSRDatabaseSpaceAvailable).

% Alarm ifout of[0-100]rangeWarning:95-98Alarm:98-100

Statistics

NSRDatabaseSummary Set by NSRDatabaseCollector.Summarizes the databaseinformation as reported bycommands executed by the datacollector.

n/a None n/a


91Reference Guide

Version 2.8.01



InfoBox

Name Description

Name Name of the EMC NetWorker index database.

Description Description of the EMC NetWorker index database.

Path Full file or directory path of the index database.

Last Purge Date & time when the index database was purged last.






Menu Commands


Configuration > Database Accesses the individual configuration for monitoring the selected index databaseinstance.This dialog allows the selected database instance to be enabled or disabled formonitoring by the NSR KM.

92Reference Guide

Version 2.8.01


NSR_LOG_CONTAINER

Icon

Parameters


BPPMType

NSRLogDetails Set by NSRLogCollector. Displaysall data returned to the standardout from commands executed bythe data collector.

n/a n/a n/a

NSRLogExecTime Inactive standard parametermonitors the collector executiontime. To activate this parameter,use the PSL below, and restart thePatrol Agent:%PSL pconfig("REPLACE",

"/Runtime/NSR/

NSRLogCollectorExecTime"

, 1);


"/Runtime/NSR/

NSRLogCollectorWarn",

3600);


Collection Status

InfoBox

Name Description






93Reference Guide

Version 2.8.01


Menu Commands


Reports > Messages List Reports all recent EMC NetWorker messages.

Configuration > Logs Accesses the dialog for specifying which log files are to be monitored by the NSR KM.By default, the following log files are monitored. These log file paths are relative tothe EMC NetWorker installation directory (for example /nsr on Unix and C:\ProgramFiles\nsr on MS Windows), unless the path is fully qualified as for the system log onSolaris and HP-UX.


Configuration > Logs Filter Accesses the global configuration of the filter for expressions used for detecting errormessages in the monitored log file instances.By default, the following Included expressions are looked for in each log file. Ifdetected, the message containing the expression is added to the appropriate textparameter, unless the message also contains an Excluded expression for the samefilter.


Configuration > Logs Scan Limit Accesses the global configuration of the data scanning limit for monitored log fileinstances.By default, the log collector only scans 500 KB of new log data for each monitored logfile during each data collection cycle.

Configuration > Logs AlertAcknowledgement

Accesses the global configuration of the method of acknowledgement for alerts onmonitored log file instances.By default, the log collector automatically acknowledges previous log alerts (warningsand alarms) when it detects new errors.

94Reference Guide

Version 2.8.01


NSR_LOG

Icon

Parameters


BPPMType

NSRLogAlarmCount* Set by NSRLogCollector. Monitorsthe number of alarm messages setin the parameter NSRLogAlarmText.

If this parameter changes to alarmstate, the recovery action willtrigger an event.

count Alarm ifout of [0-100]rangeAlarm: 1-100

Statistics

NSRLogAlarmText Set by NSRLogCollector. Displaysall alarm messages in the log filewhich have not beenacknowledged. The filter used bythe data collector to determinealarm messages can be customizedusing the KM commandConfiguration > Log(s) Filter.

These alarm messages can beacknowledged automatically(default) or manually, depending onthe configuration in the KMcommand Configuration > Log(s) Alert Acknowledgement.Manual acknowledgement isavailable under the KM sub-menuAcknowledgement.

n/a None n/a

NSRLogFSSpaceUsedPercent* Set by NSRLogCollector. Monitorsthe percentage of space used bythe file system (where the log fileresides).

If this parameter changes towarning or alarm state, therecovery action will trigger anevent.

% Alarm ifout of [0-100]rangeWarning= 95-98Alarm =98-100

Statistics

NSRLogRendered This parameter, set by NSRLogCollector, monitorswhether raw log files are renderedin runtime.

0 = Yes1 = No-1 = Unknown

Warningif out of[0-1]range

Availability

95Reference Guide

Version 2.8.01


This parameter is onlyavailable for NetWorker rawlog files.

Warning= 1

NSRLogSpaceAvailable Set by NSRLogCollector. Monitorsthe available space for the log fileto use (this is also the availablespace on the file system).If this parameter changes towarning or alarm state, therecovery action will trigger anevent.

MB Warning= 2 - 5Alarm ≤ 2

Availability

NSRLogSpaceGrowthRate Set by NSRLogCollector. Displaysthe growth rate of the amount ofspace used by the log file.

KB/s Warning= 2 to 5Alarm ≤ 2

Statistics

NSRLogSpaceUsed Set by NSRLogCollector. Displaysthe amount of space used by thelog file.

KB/s None Statistics

NSRLogSpaceUsedPercent* Set by NSRLogCollector. Monitorsthe percentage of capacity used bythe log file.If this parameter changes towarning or alarm state, therecovery action will trigger anevent.Note that the total capacity is theused space (NSRLogSpaceUsed)plus available space(NSRLogSpaceAvailable).

% Alarm ifout of [0-100]rangeWarning= 95-98 Alarm =98-100

Statistics

NSRLogSummary Set by NSRLogCollector.Summarizes the log file informationas reported by commands executedby the data collector.

n/a n/a n/a

NSRLogText Set by NSRLogCollector. Displaysall log text scanned by the datacollector during the last collectioncycle. The size of the data scannedby the data collector is configured inthe KM command Configuration >Log(s) Scan Limit.

n/a n/a n/a

NSRLogWarningCount* Set by NSRLogCollector. Monitorsthe number warning messages setin the parameterNSRLogWarningText.If this parameter changes to awarning state, the recovery actionwill trigger an event.

count Alarm ifout of [0-100]rangeWarning:1-100

Statistics

NSRLogWarningText Set by NSRLogCollector. Displaysall warning messages in the log filewhich have not beenacknowledged. The filter used bythe data collector to determinewarning messages can becustomized using the KM command Configuration > Log(s) Filter.

n/a n/a n/a

96Reference Guide

Version 2.8.01


These warning messages can beacknowledged automatically(default) or manually, depending onthe configuration in the KMcommand Configuration > Log(s) Alert Acknowledgement.Manual acknowledgement isavailable under the KM sub-menu

Acknowledgement.



InfoBox

Name Description

Name Name of the EMC NetWorker log file.

Description Description of the EMC NetWorker log file.

Path Full file path of the log file.

Log File Modification Time Date & time when the log file was last modified.

Log File Size File size of the log file.

Total FS Space Total space used by the file system.

Available FS Space Space available for use by the file system.

FS Percent Used Percentage of the total file system space used.

Last Purge Date & time when the log file was last purged.






97Reference Guide

Version 2.8.01


Menu Commands


Acknowledgement > Warnings Allows acknowledgement of warning messages detected on the selected log fileinstance.This dialog allows selective acknowledgement of "suspicious" error messagesdetected in the log file and sent to the text parameter NSRLogWarningText.

Acknowledgement > Alarms Allows acknowledgement of alarm messages detected on the selected log fileinstance.This dialog allows selective acknowledgement of "failure" error messagesdetected in the log file and sent to the text parameter NSRLogAlarmText.

Acknowledgement > All Allows acknowledgement of all alarm and warning messages detected on theselected log file instance.This dialog allows acknowledgement of all error messages detected in the log fileand sent to the text parameter NSRLogWarningText or NSRLogAlarmText.

Configuration > Log Accesses the individual configuration for monitoring the selected log file instance.This dialog allows the selected log file instance to enabled or disabled formonitoring by the NSR KM.

Configuration > Log Filter Accesses the individual configuration of the log error filter for the selected log fileinstance.By default, the global log filter is used, as configured at the container level.Type [default] to reset to the log filter configured at the global/container level.

Configuration > Log Scan Limit Accesses the individual configuration of the data scanning limit for the selectedlog file instance.By default, the global log file scanning limit is used, as configured at thecontainer level.

Configuration > Log AlertAcknowledgement

Accesses the individual configuration of the method of acknowledgement foralerts on the selected log file instance.By default, the global method of log error acknowledgement is used, asconfigured at the container level.

98Reference Guide

Version 2.8.01


NSR_POLICY_CONTAINER

Icon

Parameters


BPPMType

NSRGroupDetails Set by NSRGroupCollector.Displays all data returned to thestandard out from commandsexecuted by the data collector.

n/a n/a n/a

NSRGroupExecTime Inactive standard parametermonitors the collector executiontime. To activate this parameter,use the PSL below, and restart thePatrol Agent: %PSL pconfig

("REPLACE", "/Runtime/

NSR/

NSRGroupCollectorExecTim

e", 1);

When activated it will run everyminute and trigger a warning whenthe collector runs for more than theobserved maximum time. Thismaximum time can be overridden bya preset value (example: 3600seconds), using the PSL below: %

PSL pconfig("REPLACE",

"/Runtime/NSR/

NSRGroupCollectorWarn",

3600);


Collection Status

InfoBox

Name Description






99Reference Guide

Version 2.8.01


Menu Commands


Configuration > Groups Accesses the dialog for specifying which groups are to be monitored by the NSRKM.By default, all groups configured on the server are monitored.Type [default] to reset to the default configuration.

Configuration > Groups BackupRestriction

Accesses the global configuration to set a backup restriction window for allmonitored group instances.By default, backup restriction is disabled.When the backup restriction window is defined and enabled using this dialog,and if the group status mapping rule is configured appropriately, an alert will betriggered if any backup activity is detected during this restriction window.

Configuration > Groups Status Accesses the global configuration for determining the group status for monitoredgroup instances.By default, the following NSRGroupState to NSRGroupStatus mapping ruleis used:

Select [default] to reset to the default group status mapping rule.

NSR_POLICY

Icon

Parameters


BPPMType

100Reference Guide

Version 2.8.01


NSRGroupBackupElapsed* Set by NSRGroupCollector.Displays the elapsed time since thelast backup for this group, regardlessof completion status of the backup.This last backup is determined fromthe monitored save groups asconfigured in the KM command Configuration > Save Groupsfrom the Save Groups icon.



NSRGroupBackupSummary Set by NSRGroupCollector.Summarizes the last backup for thisgroup.

n/a None n/a

NSRGroupBackupThroughput* Set by NSRGroupCollector.Displays the throughput of the lastbackup for this group.

GB/s None Statistics

NSRGroupFullBackupDuration Set by NSRGroupCollector.Displays the duration of the lastsuccessful full backup for this group.


NSRGroupFullBackupElapsed* Set by NSRGroupCollector.Displays the elapsed time since thelast successful full backup for thisgroup. This last backup is determinedfrom the monitored save groups asconfigured in the KM command Configuration > Save Groupsfrom the Save Groups icon.



NSRGroupFullBackupFileCount Set by NSRGroupCollector.Displays the number of files backedup in the last successful full backupfor this group.


NSRGroupFullBackupSize Set by NSRGroupCollector.Displays the size of the lastsuccessful full backup for this group.

GB None Statistics

NSRGroupIncrBackupDuration Set by NSRGroupCollector.Displays the duration of the lastsuccessful incremental backup forthis group.


NSRGroupIncrBackupElapsed* Set by NSRGroupCollector.Displays the elapsed time since thelast successful incremental backupfor this group. This last backup isdetermined from the monitored savegroups as configured in the KMcommand Configuration > SaveGroups from the Save Groups icon.


101Reference Guide

Version 2.8.01



NSRGroupIncrBackupFileCount Set by NSRGroupCollector.Displays the number of files backedup in the last successful incrementalbackup for this group.


NSRGroupIncrBackupSize Set by NSRGroupCollector.Displays the size of the lastsuccessful incremental backup forthis group.

GB None Statistics

NSRGroupState Set by NSRGroupCollector.Displays the state of the group.If a backup restriction window isdefined in the KM command Configuration > Group (Groups)Backup Restriction, thisparameter will be set to Running inRestricted Window if there is anyactivity during the specified period.

0 = Idle1 = Running2 = Running inRestricted Window3 = Cloning-1 = Unknown

None Availability

NSRGroupStatus Set by NSRGroupCollector.Monitors the status of the group.This status is determined by thegroup status mapping rule defined inthe KM command Configuration >Group (Groups) Status.If this status parameter changes towarning or alarm state, the recoveryaction will trigger an event andannotate the last data point.


Warning= 1Alarm =2

Availability

NSRGroupSuccBackupElapsed* Set by NSRGroupCollector.Displays the elapsed time since thelast successful backup for this group.This last backup is determined fromthe monitored save groups asconfigured in the KM command Configuration > Save Groupsfrom the Save Groups icon.The specified alarm ranges can beenabled to allow the output of theparameter to be actively monitored.Then, if this parameter changes towarning or alarm state, the recoveryaction will trigger an event.


NSRGroupSummary Set by NSRGroupCollector.Summarizes the group information asreported by commands executed bythe data collector.

n/a None n/a



InfoBox

Name Description

102Reference Guide

Version 2.8.01


Name Name of the EMC NetWorker group.

Description Description of the EMC NetWorker group.

Autostart Auto start state of the group.

Start Time Start time of the group.

Interval Interval between save groups of this group in HH:MM format.

Parallelism Maximum number of concurrent sessions allowed for this group.

Client Retries Number of times failed clients of this group should be retried.

Clones Cloning setup for this group.

Clone Pool Volume pool name used for clone sessions.

Printer Printer on which the bootstrap save set information will be printed.

Status Current execution status of the group (Idle, Running, or Running in RestrictedWindow).

Last Backup Start Date & time when the last backup started for the group.

Last Backup End Date & time at the completion of the last backup for the group.

Last Backup Status Status of the last backup for the group.

Last Backup Save Group Name of the last backup for the group.

Last Full Backup Start Date & time when the last successful full backup started for the group.

Last Full Backup End Date & time at the completion of the last successful full backup for the group.

Last Full Backup Save Group Name of the last successful full backup for the group.

Last Incr Backup Start Date & time when the last successful incremental backup started for the group.

Last Incr Backup End Date & time at the completion of the last successful incremental backup for thegroup.

Last Incr Backup Save Group Name of the last successful incremental backup for the group.

Next Backup Date & time that the next backup will start for this group.






Menu Commands


Configuration > Group Accesses the individual configuration for monitoring the selected group instance.This dialog allows the selected group instance to be enabled or disabled formonitoring by the NSR KM.

103Reference Guide

Version 2.8.01


Configuration > Groups BackupRestriction

Accesses the individual configuration for the backup restriction window for theselected group instance.By default, the global backup restriction rule is used, as configured at thecontainer level.

Configuration > Groups Status Accesses the individual configuration for determining group status for theselected group instance.By default, the global NSRGroupState to NSRGroupStatus mapping rule isused, as configured at the container level. Select [default] to revert to thegroup status mapping rule configured at the global/container level.

Configuration > Group Clients Accesses the dialog for specifying which group clients of the selected group areto be monitored by the NSR KM.By default, all group clients of enabled groups are monitored. Type "[default]"to reset to the default configuration.

NSR_PCLIENT

Icon

Parameters


BPPMType

NSRGClientBackupSummary Set by NSRGroupCollector.Summarizes the last backup for thisgroup client.

n/a n/a n/a

NSRGClientBackupThroughput* Set by NSRGroupCollector.Displays the throughput of the lastbackup for this group client.


NSRGClientFullBackupDuration Set by NSRGroupCollector.Displays the duration of the lastsuccessful full backup for this groupclient.


NSRGClientFullBackupFileCount Set by NSRGroupCollector.Displays the number of files backedup in the last successful full backupfor this group client.


NSRGClientFullBackupSize* Set by NSRGroupCollector.Displays the size of the lastsuccessful full backup for this groupclient.

MB None Statistics

NSRGClientIncrBackupDuration Set by NSRGroupCollector.Displays the duration of the lastsuccessful incremental backup forthis group client.


104Reference Guide

Version 2.8.01


NSRGClientIncrBackupFileCount Set by NSRGroupCollector.Displays the number of files backedup in the last successful incrementalbackup for this group client.


NSRGClientIncrBackupSize* Set by NSRGroupCollector.Displays the size of the lastsuccessful incremental backup forthis group client.

MB None Statistics

NSRGClientSummary Set by NSRGroupCollector.Summarizes the group clientinformation as reported bycommands executed by the datacollector.

n/a n/a n/a

NSRSaveSetIncludeList Set by NSRGroupCollector. Listsall files and file systems included forbackup for this group client.

n/a n/a n/a



InfoBox

Name Description

Name Host name of the EMC NetWorker group client.

Description Description of the EMC NetWorker group client.

Group Names Names of the groups that the group client belongs to.

Schedule Name of the schedule used by the group client.

Browse Policy Browse policy of the group client.

Retention Policy Retention policy of the group client.

Directive Directive used by the group client.

Priority Backup priority of the group client.

Parallelism Maximum number of concurrent sessions allowed for this group client.

Storage Nodes Storage nodes used by this group client for backup sessions.

Clone Storage Nodes Storage nodes used by this group client for clone sessions.

Last Backup Start Date & time when the last backup started for the group client.

Last Backup End Date & time at the completion of the last backup for the group client.

Last Backup Status Status of the last backup for the group client.

Last Full Backup Save Group Name of the last successful full backup of the group client.

Last Full Backup Start Date & time when the last successful full backup started for the group client.

Last Full Backup End Date & time at the completion of the last successful full backup for the groupclient.

Last Incr Backup Start Date & time when the last successful incremental backup started for the groupclient.

105Reference Guide

Version 2.8.01


Last Incr Backup End Date & time at the completion of the last successful incremental backup for thegroup client.

Last Backup Save Group Name of the last backup for the group client.

Last Incr Backup Save Group Name of the last successful incremental backup of the group client.






Menu Commands


Configuration > Group Client Accesses the individual configuration for monitoring the selected group clientinstance.This dialog allows the selected group client instance to be enabled or disabled formonitoring by the NSR KM.

NSR_JOB_CONTAINER

Icon

Parameters


BPPMType

NSRSaveGrpActiveBackupCount* Set by NSRSaveGrpCollector.Displays the number of active jobscurrently discovered and monitored.


NSRSaveGrpActiveCount* Set by NSRSaveGrpCollector.Displays the number of active jobscurrently discovered and monitored.


NSRSaveGrpActiveNonBackupCount*

Set by NSRSaveGrpCollector.Displays the number of active jobscurrently discovered and monitored.


106Reference Guide

Version 2.8.01


NSRSaveGrpDetails Set by NSRSaveGrpCollector.Displays all data returned to thestandard out from commandsexecuted by the data collector.

n/a n/a n/a

NSRSaveGrpExecTime Inactive standard parametermonitors the collector executiontime. To activate this parameter, usethe PSL below, and restart the PatrolAgent:%PSL pconfig("REPLACE",

"/Runtime/NSR/

NSRSaveGrpCollectorExecTi

me", 1);


"/Runtime/NSR/

NSRSaveGrpCollectorWarn",

3600);


Collection Status

NSRSaveGrpManualSaves Set by NSRSaveGrpCollector.Displays whether the manual savesare enabled or disabled.

0 = Enabled1 = Disabled-1 = Unknown

None Availability



107Reference Guide

Version 2.8.01


InfoBox

Name Description






Menu Commands


Force Full Collection Allows the user to force the data collector for save groups to perform a fulldiscovery during the next collection cycle.

Acknowledgement > Warnings Allows acknowledgement of warning alerts occurring on any monitored savegroup instance.This dialog allows acknowledgement of any save group in a "suspicious" state(which sets the parameter NSRSaveGrpStatus to Warning).

Acknowledgement > Alarms Allows acknowledgement of alarms occurring on any monitored save groupinstance.This dialog allows acknowledgement of any save group in a "failure" state (whichsets the parameter NSRSaveGrpStatus to Alarm).

Acknowledgement > All Allows acknowledgement of all warnings and alarms occurring on any monitoredsave group instance.This dialog allows acknowledgement of any save group in a "suspicious" or"failure" state (which sets the parameter NSRSaveGrpStatus to Warning orAlarm, respectively.

Configuration > Save Groups Accesses the dialog for specifying which save groups are to be monitored by theNSR KM.By default, all scheduled save groups on the server are monitored according tothe following conditions:

The age of a save group is calculated from the save group start time. The statusof a save group is determined by the state of the save group (from theparameter NSRSaveGrpState) and the save group status mapping rule,described below.

Configuration > Save Groups Status Accesses the configuration dialog for determining the status for all monitored jobinstances.By default following NSRSaveGrpState to NSRSaveGrpStatus mapping ruleis used:

108Reference Guide

Version 2.8.01


Select [default] to reset to the default save group status mapping rule.

Configuration > Save Groups AlertAcknowledgement

Accesses the configuration dialog for specifying the method used toacknowledge alerts triggered for NSRSaveGrpStatus. Alerts can either bemanually (default configuration) or automatically acknowledged.

Configuration > Save Groups Date/Time Format

Accesses the configuration of date/time format and time zone for monitoredsave group instances.By default, the format used by EMC NetWorker for the date/time of a pendingrequest is set to DAY MON DD HH:MM:SS YYYY. The date/time is thenconverted by the NSR KM using the system time zone on the PATROL Agent(system time zone is indicated by an empty field).To reset to the default date/time format, blank out the date/time field. To resetto the default time zone, blank out the time zone field.

Configuration > Save Clients Sets which save clients will be monitored. The possible values are:NoneFailed OnlySucceeded OnlyAll

By default, only the failed save clients are monitored.

Configuration > Save Clients Status Indicates which states will trigger a warning or an alarm on the Statusparameter.

NSR_JOB

Icon

Parameters


BPPMType

NSRSaveGrpDuration Set by NSRSaveGrpCollector.Displays the duration of the savegroup from the start.


NSRSaveGrpFileCount Set by NSRSaveGrpCollector.Displays the number of files backedup for this save group.


109Reference Guide

Version 2.8.01


NSRSaveGrpSize Set by NSRSaveGrpCollector.Displays the amount of data backedup for the save group.

MB None Statistics

NSRSaveGrpState Set by NSRSaveGrpCollector.Displays the state of the savegroup. This is determined using thesave group completion state andnumber of pending, succeeded &failed save sets.

0 = Completed1 = In Progress2 = Completed/Errors3 = In Progress/Errors4 = Aborted5 = Failed-1 = Unknown

None Availability

NSRSaveGrpStatus Set by NSRSaveGrpCollector.Monitors the status of the savegroup. This status is determined bythe save group status mapping ruledefined in the KM commandConfiguration > Save GroupsStatus.



Warning= 1Alarm = 2

Availability

NSRSaveGrpSummary Set by NSRSaveGrpCollector.Summarizes the save groupinformation as reported bycommands executed by the datacollector.

n/a n/a n/a

NSRSaveGrpText Set by NSRSaveGrpCollector.Displays all reported messagesrelated to this save group.

n/a n/a n/a

NSRSaveGrpThroughput* Set by NSRSaveGrpCollector.Displays the throughput of this savegroup.


NSRSaveSetCount Set by NSRSaveGrpCollector.Displays total number of save setsin this save group.


NSRSaveSetFailedCount Set by NSRSaveGrpCollector.Displays number of failed save setsin this save group.


NSRSaveSetList Set by NSRSaveGrpCollector.Lists all savesets for this savegroup.

n/a n/a n/a

NSRSaveSetPendingCount Set by NSRSaveGrpCollector.Displays number of pending savesets in this save group.


NSRSaveSetSucceededCount Set by NSRSaveGrpCollector.Displays number of succeeded savesets in this save group.




InfoBox

110Reference Guide

Version 2.8.01


Name Description

Save Group Save group details (<Group Name> @ <Save Group Start Time>).

Type Type of the save group (Backup, Restore, etc.).

Level Backup level of the save group (Full, Incr, etc.).

Status Status of the save group.

Completion Status Completion status of the save group.

Group Name Name of the group the save group belongs to.

Start Date & time when the save group was initiated. This is interpreted using theSave Group Date/Time Format defined in the KM menu command.

End Date & time at the completion of the save group. This is interpreted using theSave Group Date/Time Format defined in the KM menu command.

Duration Duration of the save group.

Size Size of the data that has been written.

Files Number of files that have been written.

Pending Save Sets Number of pending savesets.

Succeeded Save Sets Number of succeeded savesets.

Failed Save Sets Number of failed savesets.

Clients Details Saveset(s) client(s) details for the save group.

Percent Completed Estimated percentage of the save group that has been completed in comparisonwith the last similar successful save group for the same group, group client, andlevel.

Time Remaining Remaining time of the save group in comparison with the last similar successfulsave group.

Last Backup Start Date & time when the last similar successful backup started.

Last Backup End Date & time at the completion of the last similar successful backup.

Last Backup Save Group Name of the last similar successful backup.

Last Backup Duration Duration of the last similar successful backup.

Last Backup Size Amount of data written by the last similar successful backup.

Last Backup Files Number of files written by the last similar successful backup.






Menu Commands

111Reference Guide

Version 2.8.01



Acknowledgement > Alert Allows acknowledgement of all warnings and alarms occurring on the selectedsave group instance.This dialog allows acknowledgement if the selected save group instance is in a"suspicious" or "failure" state (which sets the parameter NSRSaveGrpStatusto Warning or Alarm, respectively).

NSR_JCLIENT

Icon

Parameters


BPPMType

NSRSaveClientState Displays the state of the save client. 0 = Succeeded1 = Failed-1 = Unknown

None Availability

NSRSaveClientStatus Monitors the status of the saveclient.


Warning= 1Alarm =2

Availability

NSRSaveClientText Displays all reported messagesrelated to this save client.

n/a n/a n/a


InfoBox

Name Description

Client Name Name of the client.

Group Name Name of the group the save group belongs to.

Start Date & time when the save group was initiated. This is interpreted using theSave Group Date/Time Format defined in the KM menu command.

End Date & time at the completion of the save group. This is interpreted using theSave Group Date/Time Format defined in the KM menu command.

Status Status of the save group.



112Reference Guide

Version 2.8.01





Menu Commands

There are no KM commands for this application class.

NSR_MOUNT_CONTAINER

Icon

Parameters


BPPMType

NSRRequestDetails Set by NSRRequestCollector.Displays all data returned to thestandard out from commandsexecuted by the data collector.

n/a n/a n/a

NSRRequestExecTime Inactive standard parametermonitors the collector executiontime. To activate this parameter,use the PSL below, and restart thePatrol Agent:%PSL pconfig("REPLACE",

"/Runtime/NSR/

NSRRequestCollectorExecTi

me", 1);


"/Runtime/NSR/

NSRRequestCollectorWarn",

3600);


Collection Status

113Reference Guide

Version 2.8.01


InfoBox

Name Description






Menu Commands


Reports > Pending Requests Reports a list of all pending requests.

Configuration > Pending Requests Accesses the dialog for specifying which pending requests are to be monitoredby the NSR KM.By default, all pending requests are monitored for 1 day. Theage of a pending request is calculated from the pending request time. The statusof a pending request is determined by the state of the pending request (fromthe parameter NSRRequestState) and the pending request status mappingrule, described below.

Configuration > Pending RequestsStatus

Accesses the configuration for determining the status for all monitored pendingrequest instances.By default, the following NSRRequestState to NSRRequestStatus mappingrule is used:

Select [default] to reset to the default pending request status mapping rule.

Configuration > Pending RequestsDate/Time Format

Accesses the configuration of the date/time format and time zone for allinstantiated pending requests.By default, the format used by EMC NetWorker for the date/time of a pendingrequest is set to DAY MON DD HH:MM:SS YYYY. The date/time is thenconverted by the NSR KM using the system time zone on the PATROL Agent(system time zone is indicated by an empty field).To reset to the default date/time format, blank out the date/time field. To resetto the default time zone, blank out the time zone field.

114Reference Guide

Version 2.8.01


NSR_MOUNT

Icon

Parameters


BPPMType

NSRRequestElapsed* Set by NSRRequestCollector.Displays the elapsed time since thepending request was issued.

minutes None Statistics

NSRRequestState Set by NSRRequestCollector.Displays the state of the pendingrequest as reported in the commandexecuted by the data collector.

0 = Completed1 = Pending-1 = Unknown

None Availability

NSRRequestStatus Set by NSRRequestCollector.Monitors the status of the pendingrequest. This status is determined bythe pending request status mappingrule defined in the KM command Configuration > PendingRequest(s) Status.



Warning= 1Alarm =2

Availability

NSRRequestSummary Set by NSRRequestCollector.Summarizes the pending requestinformation as reported bycommands executed by the datacollector.

n/a n/a n/a



InfoBox

Name Description

Request Identifier assigned to the pending request by NSR KM (<Volume Pool/Volume>on <Server/Storage Node Name>.

Description Description of the pending request.

Purpose Purpose of the pending request.

115Reference Guide

Version 2.8.01


Volume Requested volume label.

Volume Pool Volume pool of the requested media.

Volume Type Volume type of the requested media.

Mode Mode of the pending request (Write or Read).

Storage Node Host name of the storage node that issued the pending request.

Priority Priority of the pending request.

Number of Media Number of media required for the pending request.

Request Time Date & time that the pending request was issued. This is interpreted using thePending Request Date/Time Format defined in the KM menu command.

Suggestion Last suggestion issued for the pending request.






Menu Commands

There are no KM commands for this application class.

NSR_LIBRARY_CONTAINER

Icon

Parameters


BPPMType

NSRJukeboxDetails Set by NSRJukeboxCollector.Displays all data returned to thestandard out from commandsexecuted by the data collector.

n/a n/a n/a

116Reference Guide

Version 2.8.01


NSRJukeboxExecTime Inactive standard parametermonitors the collector execution time.To activate this parameter, use thePSL below, and restart the PatrolAgent:%PSL pconfig("REPLACE",

"/Runtime/NSR/

NSRJukeboxCollectorExecTi

me", 1);


"/Runtime/NSR/

NSRJukeboxCollectorWarn",

3600);

Warning > presetvalue or observedmaximum (default)

seconds Collection Status

InfoBox

Name Description






Menu Commands


Configuration > Jukeboxes Accesses the dialog for specifying which jukeboxes are to be monitored by theNSR KM.By default, all local and remote jukeboxes are monitored for a server and all localjukeboxes are monitored for a storage node.Type [default] to reset to the default configuration.

Configuration > Jukeboxes Status Accesses the global configuration for determining the status for monitoredjukebox instances.By default, the following NSRJukeboxState to NSRJukeboxStatus mappingrule is used:

Select [default] to reset to the default status mapping rule.

Configuration > Jukeboxes AutoMedia Mgmt Status

Accesses the dialog for determining the status mapping rule.

117Reference Guide

Version 2.8.01


Configuration > Jukebox DevicesStatus

Accesses the global configuration for determining the status for monitoredjukebox device instances (configured under monitored jukebox instances).By default, the following NSRJDeviceState to NSRJDeviceStatus mappingrule is used:

Select [default] to reset to the default drive status mapping rule.

NSR_LIBRARY

Icon

Parameters


BPPMType

NSRJukeboxAutoMediaMgmtState Set by NSRJukeboxCollector.Displays the state of the jukeboxauto media managementconfiguration.

0 = Yes1 = No-1 = Unknown

None Availability

NSRJukeboxAutoMediaMgmtStatus Set by NSRJukeboxCollector.Monitors the status of the jukeboxauto media managementconfiguration. This status isdetermined by the status mappingrule defined in the KM command Configuration > Jukebox(Jukeboxes) Auto Media MgmtStatus.



Warning= 1Alarm =2

Availability

118Reference Guide

Version 2.8.01


NSRJukeboxCleaningLeftCount Set by NSRJukeboxCollector.Displays the number of uses left onthe cleaning tape loaded in thisjukebox.

count Warning= - 1

Statistics

NSRJukeboxState Set by NSRJukeboxCollector.Displays the jukebox state, which isderived from the jukebox resource.It will not perform any remotejukebox test command on thestorage node.

0 = Running1 = Event Found2 = Service Mode3 = No EnabledJukebox Devices4 = Error-1 = Unknown

None Availability

NSRJukeboxStatus Set by NSRJukeboxCollector.Monitors the status of the jukebox.This status is determined by thejukebox status mapping rule definedin the KM command Configuration> Jukebox (Jukeboxes)Status.



Warning= 1Alarm =2

Availability

NSRJukeboxSummary Set by NSRJukeboxCollector.Summarizes the jukebox informationas reported by commands executedby the data collector.

n/a n/a n/a

NSRJukeboxThroughput* Set by NSRJukeboxCollector.Displays the total throughput ofeach jukebox device during the lastbackup save groups.


NSRJukeboxUpDriveCount Set by NSRJukeboxCollector.Displays the number up / onlinestate drives in this robotic library.

If this parameter changes towarning or alarm state, the recoveryaction will trigger an event.


NSRJukeboxVolumeAssignedCount

Set by NSRJukeboxCollector.Displays the number of assignedvolume loaded in this jukebox.(Assigned volumes are registeredtape volumes assigned to a volumepool.)


NSRJukeboxVolumeCount Set by NSRJukeboxCollector.Displays the total number of volumesloaded in this jukebox.


NSRJukeboxVolumeEmptyCount Set by NSRJukeboxCollector.Displays the number of emptyvolumes loaded in this jukebox.(Empty volume are tape volumeswith 0% used space.)


NSRJukeboxVolumeEmptyPercent*

Set by NSRJukeboxCollector.Monitors the percentage of emptyvolumes against the total number ofvolumes loaded in this jukebox.If this parameter changes towarning or alarm state, the recoveryaction will trigger an event.

% Alarm ifout of [0-100]rangeWarning:2-5

Statistics

119Reference Guide

Version 2.8.01


Alarm: 0-2



InfoBox

Name Description

Name Name of the jukebox.

Description Description of the jukebox.

Model Model of the jukebox.

Storage Node Name of the remote host where the jukebox is connected.

Control Port Control port of the jukebox on the remote host.

Enabled Enabled state of the jukebox.

Status Status of the jukebox which is determined by the NSR KM.

Last Operation Last operation performed by EMC NetWorker on this jukebox.

Last Operation Message Message from the last operation on this jukebox.

Event Message Pending event message on this jukebox.

Number of Devices Number of jukebox devices configured on this jukebox.

Devices Devices configured on this jukebox.






Menu Commands


Reports > Jukebox Contents Reports the contents of the selected jukebox.

Configuration > Jukebox Accesses the individual configuration for monitoring the selected jukeboxinstance.This dialog allows the selected jukebox instance to be enabled or disabled formonitoring by the NSR KM.

Configuration > Jukebox Status Accesses the individual configuration for determining the status for the selectedjukebox instance.

120Reference Guide

Version 2.8.01


By default, the global NSRJukeboxState to NSRJukeboxStatus mappingrule is used, as configured at the container level. Select [default] to revert tothe jukebox status mapping rule configured at the global/container level.

Configuration > Jukebox Auto MediaMgmt Status

Accesses the dialog for determining the status mapping rule.

Configuration > Jukebox Devices Accesses the dialog for specifying which devices of the selected jukebox are tobe monitored by the NSR KM.By default, all jukebox devices of the selected jukebox are monitored.Type [default] to reset to the default configuration.

Configuration > Jukebox DevicesStatus

Accesses the configuration for determining status for the monitored deviceinstances on the selected jukebox instance.By default, the global NSRJDeviceState to NSRJDeviceeStatus mappingrule is used, as configured at the container level. Select [default] to revert tothe device status mapping rule configured at the global/container level.

NSR_LDEVICE

Icon

Parameters


BPPMType

NSRJDeviceSessionCount* Set by NSRJukeboxCollector.Displays the number of sessionsconfigured for the jukebox device.

sessions None Statistics

NSRJDeviceSessionMax* Set by NSRJukeboxCollector.Displays the maximum number ofsessions configured for thejukebox device.


NSRJDeviceSessionTarget* Set by NSRJukeboxCollector.Displays the number of targetsessions configured for thejukebox device.


NSRJDeviceState Set by NSRJukeboxCollector.Displays the state of the jukeboxdevice. This is determined fromthe jukebox device controlinformation.

0 = Idle1 = Mounted2 = Verify Label3 = Label4 = Eject5 = Read6 = Setting Up forWriting7 = Write 8 = CleaningRequired

None Availability

121Reference Guide

Version 2.8.01


9 = Service Mode10 = Error11 = Disabled12 = Failure-1 = Unknown

NSRJDeviceStatus Set by NSRJukeboxCollector.Monitors the status of the jukeboxdevice. This status is determinedby the jukebox device statusmapping rule defined in the KMcommand Configuration >Jukebox Device(s) Status.

If this status parameter changesto warning or alarm state, therecovery action will trigger anevent and annotate the last datapoint.

0 = Ok1 = Suspicious 2 = Failure

Warning =1Alarm = 2

Availability

NSRJDeviceSummary Set by NSRJukeboxCollector.Summarizes the jukebox deviceinformation as reported bycommands executed by the datacollector.

n/a n/a n/a

NSRJDeviceThroughput* Set by NSRJukeboxCollector.Displays the throughput of thejukebox device during the lastsave group.




InfoBox

Name Description

Name Name of the jukebox device.

Description Description of the device.

Path Device path of the device.

Type Volume type used in the device.

Storage Node Name of the remote host where the device is connected.

Enabled Enable state of the device.

Status Status of the device as determined by the NSR KM.

Read Only Displays whether the device is reserved only for read operations.

Jukebox Name Name of the jukebox where the device is located.

Operation Current operation performed by EMC NetWorker on this device.

Message Current message on the device.

Volume Name Name of the volume mounted on the device.

Cleaning Required Displays whether the device requires cleaning.

122Reference Guide

Version 2.8.01


Date Last Cleaned Date & time when the last cleaning was performed on the device.






Menu Commands


Administration > Enable Device Allows the selected jukebox device to be enabled.

Administration > Disable Device Allows the selected jukebox device to be disabled.

Configuration > Jukebox Device Accesses the individual configuration for monitoring the selected jukebox deviceinstance.This dialog allows the selected device instance to be enabled or disabled formonitoring by the NSR KM.

Configuration > Jukebox DeviceStatus

Accesses the individual configuration for determining the jukebox device statusfor the selected jukebox device instance.By default, the NSRJDeviceState to NSRJDeviceStatus mapping ruleconfigured at the parent level is used. (Note that if the mapping rule has notbeen modified for the parent jukebox, then the default is the global mapping ruleconfigured at the container level.) Select [default] to revert to the jukeboxdevice status mapping rule configured at the parent instance level.

123Reference Guide

Version 2.8.01


NSR_DEVICE_CONTAINER

Icon

Parameters


BPPMType

NSRDeviceDetails Set by NSRDeviceCollector.Displays all data returned tostandard out from commandsexecuted by the data collector.

n/a n/a n/a

NSRDeviceExecTime Inactive standard parametermonitors the collector executiontime. To activate this parameter, usethe PSL below, and restart the PatrolAgent:%PSL pconfig("REPLACE",

"/Runtime/NSR/

NSRDeviceCollectorExecTim

e", 1);


"/Runtime/NSR/

NSRDeviceCollectorWarn",

3600);

seconds Warning >presetvalue orobservedmaximum(default)

Collection Status

InfoBox

Name Description






124Reference Guide

Version 2.8.01


Menu Commands


Configuration > Standalone Devices Accesses the dialog for specifying which standalone devices are to be monitoredby the NSR KM.By default, all local and remote standalone devices are monitored for a serverand all local standalone devices are monitored for a storage node. Type [default] to reset to the default configuration.

Configuration > Standalone DevicesStatus

Accesses the global configuration for determining the status for all monitoredstandalone device instances.By default, the following NSRDeviceState to NSRDeviceStatus mapping ruleis used:

Select [default] to reset to the default drive status mapping rule.

NSR_DEVICE

Icon

Parameters


BPPMType

NSRDeviceSessionCount* Set by NSRDeviceCollector.Displays the number of sessionsconfigured for the device.


NSRDeviceSessionMax* Set by NSRDeviceCollector.Displays the maximum number ofsessions configured for the device.


NSRDeviceSessionTarget* Set by NSRDeviceCollector.Displays the number of targetsessions configured for the device.


125Reference Guide

Version 2.8.01


NSRDeviceState Set by NSRDeviceCollector.Displays the state of the standalonedevice.

0 = Idle1 = Mounted2 = Verify Label3 = Label4 = Eject5 = Read6 = Setting Up forWriting7 = Write8 = CleaningRequired9 = Service Mode10 = Error11 = Disabled12 = Failure-1 = Unknown

None Availability

NSRDeviceStatus Set by NSRDeviceCollector.Monitors the status of thestandalone device. This status isdetermined by the standalone devicestatus mapping rule defined in theKM command Configuration >Standalone Device(s) Status.



Warning =1Alarm = 2

Availability

NSRDeviceSummary Set by NSRDeviceCollector.Summarizes the standalone deviceinformation as reported bycommands executed by the datacollector.

n/a n/a n/a

NSRDeviceThroughput* Set by NSRDeviceCollector.Displays the throughput of thestandalone device during the lastsave group.




InfoBox

Name Description

Name Name of the standalone device.

Description Description of the device.

Path Device path of the device.

Type Volume type used in the device.

Storage Node Name of the device host where the device is connected.

Enabled Enable state of the device.

Status Status of the device.

Read Only Displays whether the device is reserved only for read operations.

126Reference Guide

Version 2.8.01


Operation Current operation performed by EMC NetWorker on this device.

Message Current message on the device.

Volume Name Name of the volume mounted on the device.

Cleaning Required Displays whether the device requires cleaning.

Date Last Cleaned Date & time when the last cleaning was performed on the device.






Menu Commands


Administration > Mount Tape Mounts the tape on the selected standalone device.

Administration > Unmount Tape Unmounts the tape on the selected standalone device.

Administration > Enable Device Allows the selected standalone device to be enabled.

Administration > Disable Device Allows the selected standalone device to be disabled.

Configuration > Standalone Device Accesses the individual configuration for monitoring the selected standalonedevice instance.This dialog allows the selected standalone device instance to be enabled ordisabled for monitoring by the NSR KM.

Configuration > Standalone DeviceStatus

Accesses the individual configuration for determining device status for theselected standalone device instance.By default, the global NSRDeviceState to NSRDeviceStatus mapping rule isused, as configured at the container level. Select [default] to resume to thestandalone device status mapping rule configured at the global/container level.

NSR_POOL_CONTAINER

Icon

127Reference Guide

Version 2.8.01


Parameters


BPPMType

NSRPoolDetails Set by NSRPoolCollector. Displaysall data returned to the standard outfrom commands executed by thedata collector.

n/a n/a n/a

NSRPoolExecTime Inactive standard parametermonitors the collector executiontime. To activate this parameter, usethe PSL below, and restart the PatrolAgent:%PSL pconfig("REPLACE",

"/Runtime/NSR/

NSRPoolCollectorExecTime"

, 1);


"/Runtime/NSR/

NSRPoolCollectorWarn",

3600);


Collection Status

InfoBox

Name Description






Menu Commands

KM Command Action

Configuration > Volume Pools Accesses the dialog for specifying which volume pools are to be monitored by theNSR KM.By default, all volume pools configured on the server/storage node aremonitored, except for "NonFull" and "Offsite".Type [default] to reset to the default configuration.

128Reference Guide

Version 2.8.01


NSR_POOL

Icon

Parameters


BPPMType

NSRPoolSpaceAvailable* Set by NSRPoolCollector. Monitorsthe available volume space for thebackup data to use in this volumepool.If this parameter changes to warningor alarm state, the recovery actionwill trigger an event.

GB None Availability

NSRPoolSpaceGrowthRate Set by NSRPoolCollector. Displaysthe growth rate of the total volumespace used by the backup data inthis volume pool.

GB/s None Statistics

NSRPoolSpaceUsed* Set by NSRPoolCollector. Displaysthe total volume space occupied bythe backup data in this volume pool.

GB None Statistics

NSRPoolSpaceUsedPercent* Set by NSRPoolCollector. Monitorsthe percentage of total occupiedvolume space against the totalvolume capacity of this volume pool(not including any scratch volume).If this parameter changes to warningor alarm state, the recovery actionwill trigger an event.

% Alarm ifout of [0-100] rangeWarning:95-98Alarm: 98-100

Statistics

NSRPoolSummary Set by NSRPoolCollector.Summarizes the volume poolinformation as reported bycommands executed by the datacollector.

n/a n/a n/a

NSRVolumeActiveCount Set by NSRPoolCollector. Displaysthe number of active volumes in thisvolume pool. (Active volumes areavailable tape volumes where datacan be written without anyintervention.)


NSRVolumeActivePercent* Set by NSRPoolCollector. Monitorsthe percentage of active volumesagainst the total number of volumesin this volume pool.


Statistics

129Reference Guide

Version 2.8.01


If this parameter changes to warningor alarm state, the recovery actionwill trigger an event.

NSRVolumeAvailableCount Set by NSRPoolCollector. Displaysthe number of volumes assigned tothis volume pool.


NSRVolumeAvailablePercent* Set by NSRPoolCollector. Monitorsthe percentage of available volumesagainst the total number of volumesin this volume pool.If this parameter changes to warningor alarm state, the recovery actionwill trigger an event.


Statistics

NSRVolumeCount Set by NSRPoolCollector. Displaysthe total number of volumes in thisvolume pool.


NSRVolumeEmptyCount Set by NSRPoolCollector. Displaysthe number of empty volumes in thisvolume pool. (Empty volumes areavailable tape volumes with no datastored on them.)


NSRVolumeFullCount Set by NSRPoolCollector. Displaysthe number of full volumes in thisvolume pool. ("Full" is a possiblestatus for a tape volume.)


NSRVolumeFullPercent* Set by NSRPoolCollector. Monitorsthe percentage of full volumesagainst the total number of volumesin this volume pool.If this parameter changes to warningor alarm state, the recovery actionwill trigger an event.


Statistics

NSRVolumeManualRecycleCount Set by NSRPoolCollector. Displaysthe number of volumes in this volumepool, which require manual recycling.("Manually-recyclable" volume is apossible volume state set on tapevolumes.)


NSRVolumeReadOnlyCount Set by NSRPoolCollector. Displaysthe number of read only volumes inthis volume pool. ("Read Only" is apossible volume flag set on tapevolumes.)




InfoBox

Name Description

Name Name of the volume pool.

Description Description of the pool.

Type Type of the pool.

130Reference Guide

Version 2.8.01


Server Name of the EMC NetWorker server where the pool is defined.

Enabled Enable state of the pool.

Archive Only Displays whether the pool is reserved only for archive operations.

Groups Groups that are allowed to use the pool.

Clients Clients that are allowed to use the pool.

Save Sets Save sets that are allowed to use the pool.

Levels Backup levels that are allowed to use the pool.

Devices Devices that are allowed to use the pool.

Volume Type Preferred volume type for the pool.






Menu Commands


Reports > Volumes List Reports all volumes in the volume pool.

Configuration > Volume Pool Accesses the configuration for monitoring the selected volume pool instance.This dialog allows the selected volume pool instance to be enabled or disabled formonitoring by the NSR KM.

Additional Information and Support

TroubleshootingRefer to the table below to diagnose any problems you may encounter when installing or running theEMC NetWorker KM for PATROL.

For any problem, look for error messages on the PATROL Console System Output W indow (SOW). Most errormessages are self-explanatory .

Most KM problems are reported in the KM Status Report, which can be v iewed by selecting the KM command KMStatus from the Legato NetWorker or NSR_SETUP icon. Run this report to diagnose any problems.

131Additional Information and Support

Version 2.8.01


The NSR KM triggers PEM events for most severe problems. Each event triggered from the KM includes an ExpertAdv ice, which prov ides details about the problem and some suggestions to resolve it.

Problem Possible Resolution

Unable to find NSR_LOAD.kml

Check that the Load KM browser is looking for *.kml files under PATROL_HOME/lib/knowledge folder.

EMC NetWorker KM for PATROL files have not been installed correctly under the PATROLinstallation directory on the PATROL Console.

NSR_SETUP icon does not appear after loading

Check whether this managed node is a supported EMC NetWorker node (server orstorage node), and it is configured properly.

Check that the version of EMC NetWorker is supported by EMC NetWorker KM forPATROL.

Check that there is no KM version mismatch between the PATROL Console and thePATROL Agent. Check the messages in the PATROL Console SOW to verify this.

Check whether the PATROL Agent tuning variable, /AgentSetup/AgentTuning/pslInstructionMax has been increased as suggested in Changes to BMC PATROL. Check the messages in the PATROL Console SOW.

Check whether the PATROL Agent user has necessary privileges added in the Agent’sAccess Control List (/AgentSetup/accessControlList) in order to read and writeto the Agent Configuration Database.

Parameter NSRLoginStatus is in suspicious (warning) status

This parameter will also show a “suspicious” state if any command executed by NSR KMfails.

Check the annotation point on the first state change data point of this parameter tolook for any failing commands. If an annotation point cannot be found, or if it is notup-to-date, check the KM Status Report, which can be viewed by selecting the KMcommand KM Status from the EMC NetWorker icon. These errors are produced fromthe EMC NetWorker commands executed by the NSR KM.

Check that the operating system user configured in the KM command Configuration> Login can execute all EMC NetWorker commands and access the EMC NetWorkerfiles.

All/some KM objects disappear from the Console

Check whether there is a KM version mismatch between the PATROL Console and thePATROL Agent, possibly after an improper upgrade of the KM. Check the messages inthe PATROL Console SOW to verify this.

Check that the NSR KM login details are still valid. Has the password changed on thesystem? Look for any error messages on the SOW, and check for additionalinformation in the last annotation point for parameter NSRLoginStatus.

Behavior of the NSR KM has notchanged in accordancewith theRelease Notes aftera KM upgrade

Check the version of the KM from the main InfoBox. If it has not changed, then theinstallation is not complete. Make sure both the PATROL Console and the PATROLAgent are uninstalled and installed correctly during the KM upgrade.

NSR KM takes a longtime to refreshthe parameters and application classes on the PATROL Console

Data collectors run according to their scheduling interval (polling cycle) defined in the KM.These intervals are defined for a standard environment with minimal resource impact.These intervals can be customized from the PATROL Developer Console to suit yourenvironment. Refer to the PATROL Console User Guide for more details.

Poor performance of the EMC

This happens if the NSR KM is installed on a heavily used system. Depending on the complexity of your EMC NetWorker environment,


Version 2.8.01


NetWorker server/storage node after installing the KM

the NSR KM may consume more resources to interrogate the application and process the data. In such a complex environment, the NSR KM may require some fine tuning to optimize the available resources. Consider the following options:

Disable monitoring of unnecessary application instances. This can be achieved byusing the appropriate KM command Configuration > <Component(s)>.

Increase the scheduling interval (polling cycle) for data collectors.

Deactivate unnecessary data collectors and associated application classes.

Deactivate unnecessary data collectors during selected time intervals, where thereare no EMC NetWorker activity. For example, if the save group monitoring can bedisabled between 9 am and 4 pm everyday, except weekends, then disable savegroup data collector (NSRSaveGrpCollector) during this period, using following PSLthrough PATROL Console:

%PSL pconfig("REPLACE","/NSR/NSRSaveGrpCollectorMode",

"0|32400|57600|0|0|||||||||||0|0");

Here the pconfig variable is named as: <collector name>Mode. The value containsfollowing details, delimited by pipe (|):enabled (1)/disabled (0) data collection, default start/end times in number of seconds since midnight, start/end times for non-default days starting fromSunday through to Saturday.

Purge unnecessary information in EMC NetWorker index databases and log files.

If there are too many clients configured in EMC NetWorker, the NSRClientCollectorand NSRGroupCollector may affect the overall performance. In such environmentdisable the NSRClientCollector, or set their instance limits to 0 (zero), using menuConfiguration > Instance Limits.

Defining a "no command execution window" for all collectors will pause runningcommands at peak times or during NetWorker maintenance windows. This can be setusing the PSL below:

%PSL pconfig("REPLACE", "/Runtime/NSR/noExecuteWindow",

"23:59:00|120"); %PSL unset("/NSR_SERVER/noExecuteEnd");

The value of this permanent configuration variable is in format “<start time inHH:MM:SS 24-hour clock>|<duration in seconds>”. The above “23:59:00|120” sets allcollectors to sleep between 23:59:00 and 00:01:00 (2 minutes) every day beforeexecuting commands.

Also this noExecutewindow supports multiple time windows:

%PSL pconfig("REPLACE", "/Runtime/NSR/noExecuteWindow",

["23:59:00|120","11:59:00|120"]);

Old active save groups are not removed from the console

By default, all active save groups are monitored, and they are exempted from ageing. It is possible to change this behaviour by using following PSL through PATROL Console:%PSL pconfig("REPLACE","/NSR/AgeActiveJobs", true);

Infinite Loop Errors(Error messages on the SOW reporting that some NSR KM datacollectors may be in an infinite loop)

Check the setting of the tuning variable /AgentSetup/AgentTuning/pslInstructionMax.

PATROL Agent uses the pre-configured tuning variable (/AgentSetup/AgentTuning/pslInstructionMax) to stop running PSL functions in an infinite loop. When a PSL functionreaches this maximum threshold, it reports this error, and puts the execution of thisfunction to the back of the process queue. This will not only delay the data collector, itwill also impact the performance of the system.

To resolve this situation, the maximum number of instructions should be increased to anoptimum value. This depends on the complexity of your environment. It is required thatthe default value of 500,000 should be increased to at least 5,000,000 on a standardEMC NetWorker environment to enable the NSR KM data collectors to execute withoutimpacting your system.

If this still does not resolve the problem, you can disable this


Version 2.8.01


functionality by setting the value of the tuning variable to zero.

Unable to turn onthe KM Debug

If you are unable to turn on the KM Debug following the method described in Debuggingthe KM, you turn the debug on by setting appropriate PATROL Agent configurationvariable with a timestamp value. This timestamp value determines when the debugshould be turned off. For example, to turn on the debug for 60 minutes from now, runthe following PSL through PATROL Console:

%PSL pconfig("REPLACE","/NSR/<component>Debug",

time()+3600);

Where <component> is either server for debugging the server discovery or name of thecollector component in lower case followed by Collector, like daemonCollector fordebugging daemon collector.

Old acknowledged save groups are still kept in the pconfig database.

By default the KM stores all acknowledged save groups. Use the following PSL through PATROL Console to keep only the last <Number> of save groups:

%PSL pconfig("REPLACE",

"/NSR/NSR_JOB/jobAcknowledgementCapacity",

<Number>);

Where to Find Additional HelpAdditional help for BMC PATROL can be found in the following locations:

PATROL Console User Guide

PATROL Console Online Help

Other PATROL Manuals and Guides

http://www.bmc.com/support_home

Additional help for EMC NetWorker can be found in the following locations:

EMC NetWorker Administrator’s Guide

EMC NetWorker Release Supplement

Other EMC NetWorker Documentation

http://www.emc.com/domains/legato/index.htm

Additional help for EMC NetWorker Knowledge Module for PATROL can be found on the Sentry Website: www.sentrysoftware.com

Index 134

Version 2.8.01


Index

- A -Abnormalities 47

Access

Operating System 13

Permissions 13Acknowledge

Log Alerts 70

Save Group Alerts 70Acknowledgement

Configure 62

Logs 62

Save Groups 62Adapter 45

Add 45, 46

Create 45

Update 46Administer

Pending Requests 49

Standalone Drives 50

Symantec NetBackup 49Agent

PATROL 40Alert Acknowledgement 62

Configure 62

Logs 62

Save Groups 62Application Class

NSR_CLIENT 81

NSR_CLIENT_CONTAINER 79

NSR_DAEMON 85

NSR_DAEMON_CONTAINER 83

NSR_DATABASE 90

NSR_DATABASE_CONTAINER 87

NSR_DEVICE 124

NSR_DEVICE_CONTAINER 123

NSR_JCLIENT 111

NSR_JOB 108

NSR_JOB_CONTAINER 105

NSR_LDEVICE 120

NSR_LIBRARY 117

NSR_LIBRARY_CONTAINER 115

NSR_LOG_CONTAINER 92

NSR_MOUNT 114

NSR_MOUNT_CONTAINER 112

NSR_PCLIENT 103

NSR_POLICY 99

NSR_POLICY_CONTAINER 98

NSR_POOL 128

NSR_POOL_CONTAINER 126

NSR_SERVER 74

- B -Baselines

BMC ProactiveNet Performance Management 47

Generation 47

Manage 47

Requirements 47BMC

BMC Portal 45BMC PATROL

Changes 11BMC ProactiveNet

Integration 45BMC ProactiveNet Performance Management

Abnormalities 47

Baselines 47

Key Performance Indicators 47

KPI 47

- C -Changes

BMC PATROL 11

EMC NetWorker 11Check

Instance Limits 42Classes 73

Clients

Delete 52

Disable 52

Enable 52Command

Reload Commands 71Configure

Alert Acknowledgement 62

Failover Mode 51

Group Backup Restriction 61

KM User Account 40

Index 135

Version 2.8.01


Configure

Log Error Filter 59

Log Scan Limit 61

Monitoring Period 54

Node Type 51

Paths 50

PATROL Agent 38Customize

Date/Time Format 64

Parameters 71

Pending Request Date/Time Format 64

Save Group Date/Time Format 64

- D -Daemons

Delete 52

Disable 52

Enable 52Data Collection

Force 71

Full 71Data Collectors

All 71

Force 71

Selected 71Databases

Delete 52

Disable 52

Enable 52Date/Time Format

Customize 64Debug

Mode 67Debugging

Disable 67

Enable 67Delete

Clients 52

Daemons 52

Databases 52

Group Client 52

Groups 52

Jukeboxes 52

Logs 52

Standalone Devices 52

Volume Pools 52Disable

Clients 52

Daemons 52

Databases 52

Debugging 67

Group Client 52

Groups 52

Jukeboxes 52

Logs 52


Volume Pools 52Discoveries

Force 71Discovery

Verify 42Disk Space

Requirements 16Display

Parameters 71

- E -EMC NetWorker

Changes 11Enable

Clients 52

Daemons 52

Databases 52

Debugging 67

Group Client 52

Groups 52

Jukeboxes 52

Logs 52


Volume Pools 52

- F -Failover Mode

Configure 51Files 17

ins_ALL_<version>.tar 17

ins_WINDOWS_<version>.exe 17

Setup 17

setup.exe 18

setup.sh 18

uninstall.exe 30

uninstall.sh 30Force

Index 136

Version 2.8.01


Force

Data Collectors 71

Discoveries 71

- G -Generate

Baselines 47

Reports 71Group Backup Restriction

Configure 61Group Client

Delete 52

Disable 52

Enable 52Groups

Delete 52

Disable 52

Enable 52

- H -help 133

- I -InfoBox

Aliases 81

Application 81

Application Name 74

Application Version 74

Architecture 81

Archive Only 128

Autostart 99

Available FS Space 94

Binary Path 74

Browse Policy 103

Cleaning Required 120, 124

Client Name 111

Client Retries 99

Clients 128

Clients Details 108

Clone Pool 99

Clone Storage Nodes 103

Clones 99

Collector Last End 79, 81, 83, 85, 87, 90,92, 94, 98, 99, 103, 105, 108, 111, 112, 114,115, 117, 120, 123, 124, 126, 128

Collector Last Start 81, 83, 85, 87, 90, 92,94, 98, 99, 103, 105, 108, 111, 112, 114, 115,117, 120, 123, 124, 126, 128

Collector Name 79, 81, 83, 85, 87, 90, 92,94, 98, 99, 103, 105, 108, 111, 112, 114, 115,117, 120, 123, 124, 126, 128

Collector Next Start 79, 81, 83, 85, 87, 90,92, 94, 98, 99, 103, 105, 108, 111, 112, 114,115, 117, 120, 123, 124, 126, 128

Collector Status 79, 81, 83, 85, 87, 90, 92,94, 98, 99, 103, 105, 108, 111, 112, 114, 115,117, 120, 123, 124, 126, 128

Command 85

Completion Status 108

Control Port 117

Copyright 74

CPU Type 81

CPUs 81

Date Last Cleaned 120, 124

Description 81, 85, 90, 94, 99, 103, 114,117, 120, 124, 128

Devices 128

Directive 103

Duration 108

Enabled 117, 120, 124, 128

Enabler in Use 81

End 108, 111

Event Message 117

Failed Save Sets 108

Files 108

FS Percent Used 94

Group Name 108, 111

Group Names 103

Groups 128

Host Name 74

Installation Path 74

Interval 99

IP Address 81

Jukebox Name 120

Last Backup 87

Last Backup Duration 108

Last Backup End 99, 103, 108

Last Backup Files 108

Last Backup Mode 87

Last Backup Save Group 99, 103, 108

Last Backup Save Set ID 87

Last Backup Size 108

Last Backup Start 99, 103, 108

Last Backup Status 99, 103

Last Backup Volume 87

Index 137

Version 2.8.01


InfoBox

Last Full Backup End 99, 103

Last Full Backup Save Group 99, 103

Last Full Backup Start 99, 103

Last Incr Backup End 99, 103

Last Incr Backup Save Group 99, 103

Last Incr Backup Start 99, 103

Last Operation 117

Last Operation Message 117

Last Purge 94

Level 108

Levels 128

Library Path 74

Log File Modification Time 94

Log File Size 94

Message 120, 124

Mode 114

Model 117

Monitoring Mode 74

Monitoring Node 74

Name 81, 83, 85, 87, 90, 94, 99, 103, 117,120, 124, 128

Next Backup 99

Node Name(s) 74

Node Type 74

Number of Devices 117

Number of Media 114

ONC Program Number 81

ONC Transport 81

ONC Version Number 81

Operating System 74, 81

Operation 120, 124

Owner 85

Parallelism 99, 103

Path 90, 94, 120, 124

PATROL Agent Version 74

Pending Save Sets 108

Percent Completed 108

PID 85

Platform 74, 81

PPID 85

Printer 99

Priority 103, 114

Product Name 74

Product Release Date 74

Product Version 74

Purpose 114

Read Only 120, 124

Request 114

Request Time 114

Retention Policy 103

Save Group 108

Save Sets 128

Schedule 103

Server 128

Server(s) 74

Servers 81

Size 108

Start 108, 111

Start Time 99

Status 81, 85, 99, 108, 111, 117, 120, 124

Storage Node 114, 117, 120, 124

Storage Node(s) 74

Storage Nodes 103

Succeeded Save Sets 108

Suggestion 114

Support 74

Time Remaining 108

Total FS Space 94

Type 108, 120, 124, 128

Version 81

Volume 114

Volume Name 120, 124

Volume Pool 114

Volume Type 114, 128

Web Site 74Install / Un-install 18, 30

BMC Software Installation Utility 17

Log 18

Packages 17

Procedure 18

Setup Files 17Installation Path

Unix 13

Windows 13Instance Limits

Check 42Instrumentation (WMI) Core

Requirements 11Integration

BMC ProactiveNet 45Integration Service Agent 45

Introduction 18

- J -Jukeboxes

Index 138

Version 2.8.01


Jukeboxes

Delete 52

Disable 52

Enable 52

- K -Key Performance Indicators


Manage 47KM

Configure 40

Initial Setup 44

Load 36, 37, 45

Preload 38

Preloaded 38, 39

Prepare to Load 37

Unload 38, 39

User Account 40KM command

Debug 67

Force Full Collection 71

Refresh Process Cache 71KM Debug

Troubleshooting 130KPI


Manage 47

- L -Load

KM 36, 37, 45

PATROL Central 37

Prepare 37Log Alerts

Acknowledge 70Log Error Filter

Configure 59Log Scan Limit

Configure 61Logs

Delete 52

Disable 52

Enable 52

- M -Manage

Baselines 47

Key Performance Indicators 47

KPI 47Master Server

Configure 51Media Server

Configure 51Menu Commands

About 74

Acknowledgement 94, 105, 108

Administration 74, 120, 124

Alarms 94, 105

Alert 108

All 94, 105

Client 81

Client Status 81

Clients 79

Clients Status 79

Configuration 74, 79, 81, 83, 85, 90, 92,94, 98, 103, 105, 112, 115, 123, 128

Daemon 85

Daemon List 83

Daemon Status 85

Daemons 83

Daemons Status 83

Database 90

Database Backup Information 87

Databases 87

Debug 74

Disable Device 120, 124

Enable Device 120, 124

Force Discovery 74

Force Full Collection 105

Group Client 103

Groups 98

Groups Backup Restriction 98

Groups Status 98

Instance Limits 74

Jukebox 117

Jukebox Auto Media Mgmt Status 117

Jukebox Contents 117

Jukebox Device 120

Jukebox Device Status 120

Jukebox Devices 117

Index 139

Version 2.8.01


Menu Commands

Jukebox Devices Status 115, 117

Jukebox Status 117

Jukeboxes 115

Jukeboxes Auto Media Mgmt Status 115

Jukeboxes Status 115

KM Status 74

Log 94

Log Alert Acknowledgement 94

Log Filter 94

Log Scan Limit 94

Login 74

Logs 92

Logs Alert Acknowledgement 92

Logs Filter 92

Logs Scan Limit 92

Messages List 92

Monitoring Mode 74

Mount Tape 124

Node Status 74

Node Type 74

Paths 74

Pending Request Date/Time Format 112

Pending Requests 112

Pending Requests Status 112

Preloading 74

Refresh Parameters 74

Refresh Process Cache 74

Reload Commands 74

Reports 83, 87, 92, 112, 117, 128

Save Groups 105

Save Groups Alert Acknowledgement 105

Save Groups Date/Time Format 105

Save Groups Status 105

SaveSet Error Event Contents 105

Standalone Device 124

Standalone Device Status 124


Standalone Devices Status 123

Start Server/Storage Node 74

Stop Server/Storage Node 74

Unmount Tape 124

Volume List 128

Volume Pool 128

Warnings 94, 105Monitor Type 45

Monitoring

Save Clients 56Monitoring Period

Configure 54

Pending Requests 54

Save Groups 54MS Windows Management

Requirements 11MS Windows Scripting Host

Requirements 11

- N -Node Type

Configure 51

Master Server 51

Media Server 51NSR_CLIENT

Application Class 81NSR_CLIENT_CONTAINER

Application Class 79NSR_DAEMON

Application Class 85NSR_DAEMON_CONTAINER

Application Class 83NSR_DATABASE

Application Class 90NSR_DATABASE_CONTAINER

Application Class 87NSR_DEVICE

Application Class 124NSR_DEVICE_CONTAINER

Application Class 123NSR_JCLIENT

Application Class 111NSR_JOB

Application Class 108NSR_JOB_CONTAINER

Application Class 105NSR_LDEVICE

Application Class 120NSR_LIBRARY

Application Class 117NSR_LIBRARY_CONTAINER

Application Class 115NSR_LOAD

Troubleshooting 130NSR_LOG_CONTAINER

Application Class 92NSR_MOUNT

Application Class 114

Index 140

Version 2.8.01


NSR_MOUNT_CONTAINER

Application Class 112NSR_PCLIENT

Application Class 103NSR_POLICY

Application Class 99NSR_POLICY_CONTAINER

Application Class 98NSR_POOL

Application Class 128NSR_POOL_CONTAINER

Application Class 126NSR_SERVER

Application Class 74NSR_SETUP

Troubleshooting 130NSRLoginStatus

Troubleshooting 130

- O -Operating System

Access 13

AIX 13

HP-UX 13

Solaris 13Operating Systems

Linux 17, 18, 30

Unix 17, 30

Windows 17, 18, 30Options

Common services 18

Console Systems role 18

Managed System 18

View Log 18

- P -Parameter

NSRLoginStatus 40Parameters 73

Customize 71

Display 71

ExtraFilesList 74

NSRAdministratorChange 74

NSRClientCollector 74

NSRClientDetails 79

NSRClientIndexRecordCount 81

NSRClientIndexSpaceUsed 81

NSRClientIndexSpaceUsedPercent 81

NSRClientState 81

NSRClientStatus 81

NSRClientSummary 81

NSRCreateDistribution 74

NSRDaemonCollector 74

NSRDaemonCPUDuration 85

NSRDaemonCPUUtilization 85

NSRDaemonDetails 83

NSRDaemonMemorySize 85

NSRDaemonProcessCount 85

NSRDaemonState 85

NSRDaemonStatus 85

NSRDaemonSummary 85

NSRDatabaseBackupElapsed 87

NSRDatabaseCollector 74

NSRDatabaseDetails 87

NSRDatabaseFSSpaceUsedPercent 90

NSRDatabaseRetention 87

NSRDatabaseSpaceAvailable 90

NSRDatabaseSpaceGrowthRate 90

NSRDatabaseSpaceUsed 90

NSRDatabaseSpaceUsedPercent 90

NSRDatabaseSummary 90

NSRDeviceCollector 74

NSRDeviceDetails 123

NSRDeviceSessionCount 124

NSRDeviceSessionMax 124

NSRDeviceSessionTarget 124

NSRDeviceState 124

NSRDeviceStatus 124

NSRDeviceSummary 124

NSRDeviceThroughput 124

NSRGClientBackupSummary 103

NSRGClientBackupThroughput 103

NSRGClientFullBackupDuration 103

NSRGClientFullBackupFileCount 103

NSRGClientFullBackupSize 103

NSRGClientIncrBackupDuration 103

NSRGClientIncrBackupFileCount 103

NSRGClientIncrBackupSize 103

NSRGClientSummary 103

NSRGroupBackupElapsed 99

NSRGroupBackupSummary 99

NSRGroupBackupThroughput 99

NSRGroupCollector 74

NSRGroupDetails 98

NSRGroupFullBackupDuration 99

Index 141

Version 2.8.01


Parameters 73

NSRGroupFullBackupElapsed 99

NSRGroupFullBackupFileCount 99

NSRGroupFullBackupSize 99

NSRGroupIncrBackupDuration 99

NSRGroupIncrBackupElapsed 99

NSRGroupIncrBackupFileCount 99

NSRGroupIncrBackupSize 99

NSRGroupState 99

NSRGroupStatus 99

NSRGroupSuccBackupElapsed 99

NSRGroupSummary 99

NSRJDeviceState 120

NSRJDeviceStatus 120

NSRJDeviceSummary 120

NSRJDeviceThroughput 120

NSRJukeboxAutoMediaMgmtState 117

NSRJukeboxAutoMediaMgmtStatus 117

NSRJukeboxCleaningLeftCount 117

NSRJukeboxCollector 74

NSRJukeboxDetails 115

NSRJukeboxState 117

NSRJukeboxStatus 117

NSRJukeboxSummary 117

NSRJukeboxThroughput 117

NSRJukeboxUpDriveCount 117

NSRJukeboxVolumeAssignedCount 117

NSRJukeboxVolumeCount 117

NSRJukeboxVolumeEmptyCount 117

NSRJukeboxVolumeEmptyPercent 117

NSRLogAlarmCount 94

NSRLogAlarmText 94

NSRLogCollector 74

NSRLogDetails 92

NSRLogFSSpaceUsedPercent 94

NSRLoginStatus 74

NSRLogRendered 94

NSRLogSpaceAvailable 94

NSRLogSpaceGrowthRate 94

NSRLogSpaceUsed 94

NSRLogSpaceUsedPercent 94

NSRLogSummary 94

NSRLogText 94

NSRLogWarningCount 94

NSRLogWarningText 94

NSRMonitoringMode 74

NSRMonitorRAP 74

NSRNodeStatus 74

NSRPoolCollector 74

NSRPoolDetails 126

NSRPoolSpaceAvailable 128

NSRPoolSpaceGrowthRate 128

NSRPoolSpaceUsed 128

NSRPoolSpaceUsedPercent 128

NSRPoolSummary 128

NSRRequestCollector 74

NSRRequestDetails 112

NSRRequestElapsed 114

NSRRequestState 114

NSRRequestStatus 114

NSRRequestSummary 114

NSRSaveClientState 111

NSRSaveClientStatus 111

NSRSaveClientText 111

NSRSaveGrpActiveBackupCount 105

NSRSaveGrpActiveCount 105

NSRSaveGrpActiveNonBackupCount 105

NSRSaveGrpCollector 74

NSRSaveGrpDetails 105

NSRSaveGrpDuration 108

NSRSaveGrpFileCount 108

NSRSaveGrpManualSaves 105

NSRSaveGrpSize 108

NSRSaveGrpState 108

NSRSaveGrpStatus 108

NSRSaveGrpSummary 108

NSRSaveGrpText 108

NSRSaveGrpThroughput 108

NSRSaveSetCount 108

NSRSaveSetFailedCount 108

NSRSaveSetIncludeList 103

NSRSaveSetList 108

NSRSaveSetPendingCount 108

NSRSaveSetSucceededCount 108

NSRServerSummary 74

NSRUpdateAgent 74

NSRVolumeActiveCount 128

NSRVolumeActivePercent 128

NSRVolumeAvailableCount 128

NSRVolumeAvailablePercent 128

NSRVolumeCount 128

NSRVolumeEmptyCount 128

NSRVolumeFullCount 128

NSRVolumeFullPercent 128

NSRVolumeManualRecycleCount 128

NSRVolumeReadOnlyCount 128

Refresh 71Paths

Index 142

Version 2.8.01


Paths

Binary 50

Configure 50

Debug Directory 50

Home Directory 50

Library 50

Netbackup Installation 50

NetBackup Log Directory 50

Temp Directory 50PATROL

Agent 40

PATROL Agent 11, 38

PATROL Agent system 16

PATROL Central Console 38, 39

PATROL Central Console Server system 16

PATROL Central Web Server system 16

PATROL Console 11, 38

PATROL Console system 16PATROL Agent

Configure 38

Requirements 10

Restart 44PATROL Console 37

Requirements 10

Restart 44Pending Request Date/Time Format

Customize 64Pending Requests

Administer 49

Configure 54

Monitoring Period 54Permissions

Access 13Platform

Upgrade 71Platforms

Unix 40Poor performance

Troubleshooting 130Portal 11

Preload

KM 38Preloaded

KM 38, 39ProactiveNet 45

PW Commands 46

- R -Refresh

Parameters 71Release Notes 9

Reports

Daemon List 71

Database Backup Information 71

Generate 71

Jukebox Contents 71

Messages List 71

Pending Requests 71

Volumes List 71Requirements

Disk Space 16

Instrumentation (WMI) Core 11

MS Windows Management 11

MS Windows Scripting Host 11

PATROL Agent 10

PATROL Console 10

Security 13

Software 10, 11

Sudo 11Restart

PATROL Agent 44

PATROL Console 44

- S -Save Clients 105

All 56

Failed 56

Monitoring 56

None 56

Succeeded 56Save Clients Status 105

Save Group Alerts

Acknowledge 70Save Group Date/Time Format

Customize 64Save Groups 71

Configure 54

Monitoring Period 54Security

Requirements 13Server/Storage Node

Start 49

Index 143

Version 2.8.01


Server/Storage Node

Stop 49Setup

Check 44

Initial 44

KM 44Software

Instrumentation (WMI) Core 11

MS Windows Management 11

MS Windows Scripting Host 11

Requirements 10, 11

Sudo 11Standalone Devices

Delete 52

Disable 52

Enable 52Standalone Drives

Administer 50Start

Server/Storage Node 49Stop

Server/Storage Node 49Sudo 40

Requirements 11

User 13Symantec NetBackup

Administer 49

- T -Thresholds

Customize 46

Import 46Troubleshooting

KM Debug 130

NSR_LOAD 130

NSR_SETUP 130

NSRLoginStatus 130

Poor performance 130

- U -Unix 40

Installation Path 13Unload

KM 38, 39Upgrade

Platform 71

- V -Verify

Application Discovery 42Volume Pools

Delete 52

Disable 52

Enable 52

- W -Windows

Installation Path 13

Registry 13

About BMC® SoftwareBMC Software, Inc. NYSE:BMC, is a leading provider of enterprise managementsolutions that empower companies to manage their IT infrastructure from abusiness perspective. Delivering Business Service Management, BMC Softwaresolutions span enterprise systems, applications, databases, and servicemanagement. Founded in 1980, BMC Software has offices worldwide and fiscal2004 revenues of more than $1.4 billion. For more information about BMC

Software, visit www.bmc.com.

About Sentry Software™Sentry Software, a strategic Technology Alliance Partner of BMC Software,provides key monitoring solutions specifically designed to expand thecapabilities of BMC Performance Manager, thus enabling up to 100% coverage ofany infrastructure. Sentry Software specializes in single solutions for multi-platform monitoring of hardware, custom applications or any IT component, andblackout windows. Sentry Software products are deployed in 45 countries acrossthe globe and lead the list of BMC Software’s third-party product sales. For more

information about Sentry Software, please visit www.sentrysoftware.net.

emc networker km for patrol 2.8 - sentry software · overview 10 version 2.8.01 emc networker km...

Documents