EMC Networker KM for PATROL 2.8 - Sentry Software · Overview 10 Version 2.8.01 EMC NetWorker KM...
Transcript of EMC Networker KM for PATROL 2.8 - Sentry Software · Overview 10 Version 2.8.01 EMC NetWorker KM...
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
EMC NetWorker KM for PATROL
Table of Contents 4
Version 2.8.01
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
...........................................................................................................................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
EMC NetWorker KM for PATROL
..................................................................................................................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
9Release Notes for v2.8.01
Version 2.8.01
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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.
12Preparing for Installation
Version 2.8.01
EMC NetWorker KM for PATROL
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.
13Preparing for Installation
Version 2.8.01
EMC NetWorker KM for PATROL
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:
14Preparing for Installation
Version 2.8.01
EMC NetWorker KM for PATROL
/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
15Preparing for Installation
Version 2.8.01
EMC NetWorker KM for PATROL
/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:
User_Alias NSRKMUSERS = user1, user2, user3
Defaults:NSRKMUSERS !lecture,!authenticate,\
env_keep+="SHLIB_PATH INSTALL_PATH KM_HOME KM_TEMP",env_reset
16Preparing for Installation
Version 2.8.01
EMC NetWorker KM for PATROL
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 AIX and Linux :
User_Alias NSRKMUSERS = user1, user2, user3
Defaults:NSRKMUSERS !lecture,!authenticate,\
env_keep+="LIBPATH 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.
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
17Preparing for Installation
Version 2.8.01
EMC NetWorker KM for PATROL
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
18Preparing for Installation
Version 2.8.01
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
Installation Wizard - Step 7: Selecting Roles
Select as many options as required.
26Installing the KM
Version 2.8.01
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
32Installing the KM
Version 2.8.01
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
47Integrating the KM
Version 2.8.01
EMC NetWorker KM for PATROL
-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.
48Integrating the KM
Version 2.8.01
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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.
50Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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,
51Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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
52Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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
53Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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.
54Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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.
55Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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
56Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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.
57Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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
58Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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
59Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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:
60Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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.
61Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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
62Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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.
63Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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.
64Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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.
65Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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.
66Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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.
67Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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
68Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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
69Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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.
70Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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.
71Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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.
72Monitoring your environment
Version 2.8.01
EMC NetWorker KM for PATROL
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...
Select the required data collector.
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
Select the required data collector.
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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.
Polling Interval: 60 seconds
n/a n/a n/a
NSRDaemonCollector Collects EMC NetWorker daemonrelated information. It sets allconsumer parameters inNSR_DAEMON_CONTAINER andNSR_DAEMON application classes.
Polling Interval: 300 seconds
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
EMC NetWorker KM for PATROL
Polling Interval: 1800 seconds
NSRDeviceCollector Collects EMC NetWorker standalonedevice related information. It setsall consumer parameters inNSR_DEVICE_CONTAINER andNSR_DEVICE application classes.
Polling Interval: 600 seconds
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.
Polling Interval: 900 seconds
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.
Polling Interval: 600 seconds
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.
Polling Interval: 1800 seconds
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
EMC NetWorker KM for PATROL
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.
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
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.
Polling Interval: 1800 seconds
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.
Polling Interval: 300 seconds
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
Parameters
Name Description Units Default AlertConditions
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
Function Description
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
EMC NetWorker KM for PATROL
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.
0 = Ok1 = Suspicious2 = Failure
Warning= 1Alarm =2
Availability
82Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
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.
* Parameters marked with an asterisk are used by default when v isualizing the corresponding monitor instance in BPPM.
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.
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
83Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
Function Description
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
Name Description Units Default AlertConditions
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);
seconds Warning> presetvalue orobservedmaximum(default)
CollectionStatus
InfoBox
84Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
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
Function Description
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.
Type [default] to reset to the default configuration.
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
EMC NetWorker KM for PATROL
NSR_DAEMON
Icon
Parameters
Name Description Units DefaultAlertConditions
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.
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
Availability
86Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
NSRDaemonSummary Set by NSRDaemonCollector.Summarizes the daemon informationas reported by commands executedby the 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.
* Parameters marked with an asterisk are used by default when v isualizing the corresponding monitor instance in BPPM.
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.
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
Function Description
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
EMC NetWorker KM for PATROL
NSR_DATABASE_CONTAINER
Icon
Parameters
Name Description Units DefaultAlertConditions
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);
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/
NSRDatabaseCollectorWarn"
, 3600);
seconds Warning> presetvalue orobservedmaximum(default)
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
EMC NetWorker KM for PATROL
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.
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
Function Description
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
EMC NetWorker KM for PATROL
Type [default] to reset to the default configuration.
90Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
NSR_DATABASE
Icon
Parameters
Name Description Units Default AlertConditions
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
For detailed information about B a se lining and KP I, see Managing Baselines and Key Performance Indicators.
91Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
* Parameters marked with an asterisk are used by default when v isualizing the corresponding monitor instance in BPPM.
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.
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
Function Description
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
EMC NetWorker KM for PATROL
NSR_LOG_CONTAINER
Icon
Parameters
Name Description Units DefaultAlertConditions
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);
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/
NSRLogCollectorWarn",
3600);
seconds Warning> presetvalue orobservedmaximum(default)
Collection Status
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).
93Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
Menu Commands
Function Description
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.
Type [default] to reset to the default configuration.
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.
Type [default] to reset to the default configuration.
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
EMC NetWorker KM for PATROL
NSR_LOG
Icon
Parameters
Name Description Units DefaultAlertConditions
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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.
For detailed information about B a se lining and KP I, see Managing Baselines and Key Performance Indicators.
* Parameters marked with an asterisk are used by default when v isualizing the corresponding monitor instance in BPPM.
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.
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).
97Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
Menu Commands
Function Description
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
EMC NetWorker KM for PATROL
NSR_POLICY_CONTAINER
Icon
Parameters
Name Description Units DefaultAlertConditions
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);
seconds Warning> presetvalue orobservedmaximum(default)
Collection Status
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).
99Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
Menu Commands
Function Description
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
Name Description Units Default AlertConditions
BPPMType
100Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
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.
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
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.
seconds None Statistics
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.
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
NSRGroupFullBackupFileCount Set by NSRGroupCollector.Displays the number of files backedup in the last successful full backupfor this group.
count None Statistics
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.
seconds None Statistics
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.
hours None Statistics
101Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
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.
NSRGroupIncrBackupFileCount Set by NSRGroupCollector.Displays the number of files backedup in the last successful incrementalbackup for this group.
count None Statistics
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.
0 = Ok1 = Suspicious2 = Failure
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.
hours None Statistics
NSRGroupSummary Set by NSRGroupCollector.Summarizes the group information asreported by commands executed bythe data collector.
n/a None n/a
For detailed information about B a se lining and KP I, see Managing Baselines and Key Performance Indicators.
* Parameters marked with an asterisk are used by default when v isualizing the corresponding monitor instance in BPPM.
InfoBox
Name Description
102Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
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.
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
Function Description
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
EMC NetWorker KM for PATROL
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
Name Description Units DefaultAlertConditions
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.
MB/s None Statistics
NSRGClientFullBackupDuration Set by NSRGroupCollector.Displays the duration of the lastsuccessful full backup for this groupclient.
seconds None Statistics
NSRGClientFullBackupFileCount Set by NSRGroupCollector.Displays the number of files backedup in the last successful full backupfor this group client.
count None Statistics
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.
seconds None Statistics
104Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
NSRGClientIncrBackupFileCount Set by NSRGroupCollector.Displays the number of files backedup in the last successful incrementalbackup for this group client.
count None Statistics
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
For detailed information about B a se lining and KP I, see Managing Baselines and Key Performance Indicators.
* Parameters marked with an asterisk are used by default when v isualizing the corresponding monitor instance in BPPM.
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
EMC NetWorker KM for PATROL
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.
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
Function Description
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
Name Description Units DefaultAlertConditions
BPPMType
NSRSaveGrpActiveBackupCount* Set by NSRSaveGrpCollector.Displays the number of active jobscurrently discovered and monitored.
count None Statistics
NSRSaveGrpActiveCount* Set by NSRSaveGrpCollector.Displays the number of active jobscurrently discovered and monitored.
count None Statistics
NSRSaveGrpActiveNonBackupCount*
Set by NSRSaveGrpCollector.Displays the number of active jobscurrently discovered and monitored.
count None Statistics
106Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
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);
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/
NSRSaveGrpCollectorWarn",
3600);
seconds Warning> presetvalue orobservedmaximum(default)
Collection Status
NSRSaveGrpManualSaves Set by NSRSaveGrpCollector.Displays whether the manual savesare enabled or disabled.
0 = Enabled1 = Disabled-1 = Unknown
None Availability
For detailed information about B a se lining and KP I, see Managing Baselines and Key Performance Indicators.
* Parameters marked with an asterisk are used by default when v isualizing the corresponding monitor instance in BPPM.
107Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
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
Function Description
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
EMC NetWorker KM for PATROL
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
Name Description Units DefaultAlertConditions
BPPMType
NSRSaveGrpDuration Set by NSRSaveGrpCollector.Displays the duration of the savegroup from the start.
seconds None Statistics
NSRSaveGrpFileCount Set by NSRSaveGrpCollector.Displays the number of files backedup for this save group.
count None Statistics
109Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
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.
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
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.
MB/s None Statistics
NSRSaveSetCount Set by NSRSaveGrpCollector.Displays total number of save setsin this save group.
count None Statistics
NSRSaveSetFailedCount Set by NSRSaveGrpCollector.Displays number of failed save setsin this save group.
count None Statistics
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.
count None Statistics
NSRSaveSetSucceededCount Set by NSRSaveGrpCollector.Displays number of succeeded savesets in this save group.
count None Statistics
For detailed information about B a se lining and KP I, see Managing Baselines and Key Performance Indicators.
* Parameters marked with an asterisk are used by default when v isualizing the corresponding monitor instance in BPPM.
InfoBox
110Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
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.
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
111Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
Function Description
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
Name Description Units DefaultAlertConditions
BPPMType
NSRSaveClientState Displays the state of the save client. 0 = Succeeded1 = Failed-1 = Unknown
None Availability
NSRSaveClientStatus Monitors the status of the saveclient.
0 = Ok1 = Suspicious2 = Failure
Warning= 1Alarm =2
Availability
NSRSaveClientText Displays all reported messagesrelated to this save client.
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
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.
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.
112Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
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
There are no KM commands for this application class.
NSR_MOUNT_CONTAINER
Icon
Parameters
Name Description Units DefaultAlertConditions
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);
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/
NSRRequestCollectorWarn",
3600);
seconds Warning> presetvalue orobservedmaximum(default)
Collection Status
113Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
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
Function Description
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
EMC NetWorker KM for PATROL
NSR_MOUNT
Icon
Parameters
Name Description Units DefaultAlertConditions
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.
If this status parameter changes towarning or alarm state, the recoveryaction will trigger an event andannotate the last data point.
0 = Ok1 = Suspicious2 = Failure
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
For detailed information about B a se lining and KP I, see Managing Baselines and Key Performance Indicators.
* Parameters marked with an asterisk are used by default when v isualizing the corresponding monitor instance in BPPM.
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
EMC NetWorker KM for PATROL
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.
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
There are no KM commands for this application class.
NSR_LIBRARY_CONTAINER
Icon
Parameters
Name Description Units DefaultAlertConditions
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
EMC NetWorker KM for PATROL
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);
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/
NSRJukeboxCollectorWarn",
3600);
Warning > presetvalue or observedmaximum (default)
seconds Collection Status
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
Function Description
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
EMC NetWorker KM for PATROL
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
Name Description Units DefaultAlertConditions
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.
If this status parameter changes towarning or alarm state, the recoveryaction will trigger an event andannotate the last data point.
0 = Ok1 = Suspicious2 = Failure
Warning= 1Alarm =2
Availability
118Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
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.
If this status parameter changes towarning or alarm state, the recoveryaction will trigger an event andannotate the last data point.
0 = Ok1 = Suspicious2 = Failure
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.
MB/s None Statistics
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.
count None Statistics
NSRJukeboxVolumeAssignedCount
Set by NSRJukeboxCollector.Displays the number of assignedvolume loaded in this jukebox.(Assigned volumes are registeredtape volumes assigned to a volumepool.)
count None Statistics
NSRJukeboxVolumeCount Set by NSRJukeboxCollector.Displays the total number of volumesloaded in this jukebox.
count None Statistics
NSRJukeboxVolumeEmptyCount Set by NSRJukeboxCollector.Displays the number of emptyvolumes loaded in this jukebox.(Empty volume are tape volumeswith 0% used space.)
count None Statistics
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
EMC NetWorker KM for PATROL
Alarm: 0-2
For detailed information about B a se lining and KP I, see Managing Baselines and Key Performance Indicators.
* Parameters marked with an asterisk are used by default when v isualizing the corresponding monitor instance in BPPM.
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.
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
Function Description
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
EMC NetWorker KM for PATROL
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
Name Description Units DefaultAlertConditions
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.
sessions None Statistics
NSRJDeviceSessionTarget* Set by NSRJukeboxCollector.Displays the number of targetsessions configured for thejukebox device.
sessions None Statistics
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
EMC NetWorker KM for PATROL
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.
MB/s None Statistics
For detailed information about B a se lining and KP I, see Managing Baselines and Key Performance Indicators.
* Parameters marked with an asterisk are used by default when v isualizing the corresponding monitor instance in BPPM.
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
EMC NetWorker KM for PATROL
Date Last Cleaned Date & time when the last cleaning was performed on the device.
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
Function Description
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
EMC NetWorker KM for PATROL
NSR_DEVICE_CONTAINER
Icon
Parameters
Name Description Units DefaultAlertConditions
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);
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/
NSRDeviceCollectorWarn",
3600);
seconds Warning >presetvalue orobservedmaximum(default)
Collection Status
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).
124Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
Menu Commands
Function Description
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
Name Description Units DefaultAlertConditions
BPPMType
NSRDeviceSessionCount* Set by NSRDeviceCollector.Displays the number of sessionsconfigured for the device.
sessions None Statistics
NSRDeviceSessionMax* Set by NSRDeviceCollector.Displays the maximum number ofsessions configured for the device.
sessions None Statistics
NSRDeviceSessionTarget* Set by NSRDeviceCollector.Displays the number of targetsessions configured for the device.
sessions None Statistics
125Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
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.
If this status parameter changes towarning or alarm state, the recoveryaction will trigger an event andannotate the last data point.
0 = Ok1 = Suspicious2 = Failure
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.
MB/s None Statistics
For detailed information about B a se lining and KP I, see Managing Baselines and Key Performance Indicators.
* Parameters marked with an asterisk are used by default when v isualizing the corresponding monitor instance in BPPM.
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
EMC NetWorker KM for PATROL
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.
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
Function Description
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
EMC NetWorker KM for PATROL
Parameters
Name Description Units DefaultAlertConditions
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);
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/
NSRPoolCollectorWarn",
3600);
seconds Warning> presetvalue orobservedmaximum(default)
Collection Status
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
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
EMC NetWorker KM for PATROL
NSR_POOL
Icon
Parameters
Name Description Units DefaultAlertConditions
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.)
count None Statistics
NSRVolumeActivePercent* Set by NSRPoolCollector. Monitorsthe percentage of active volumesagainst the total number of volumesin this volume pool.
% Alarm ifout of [0-100] rangeWarning:2-5Alarm: 0-2
Statistics
129Reference Guide
Version 2.8.01
EMC NetWorker KM for PATROL
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.
count None Statistics
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.
% Alarm ifout of [0-100] rangeWarning:2-5Alarm: 0-2
Statistics
NSRVolumeCount Set by NSRPoolCollector. Displaysthe total number of volumes in thisvolume pool.
count None Statistics
NSRVolumeEmptyCount Set by NSRPoolCollector. Displaysthe number of empty volumes in thisvolume pool. (Empty volumes areavailable tape volumes with no datastored on them.)
count None Statistics
NSRVolumeFullCount Set by NSRPoolCollector. Displaysthe number of full volumes in thisvolume pool. ("Full" is a possiblestatus for a tape volume.)
count None Statistics
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.
% Alarm ifout of [0-100] rangeWarning:95-98Alarm: 98-100
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.)
count None Statistics
NSRVolumeReadOnlyCount Set by NSRPoolCollector. Displaysthe number of read only volumes inthis volume pool. ("Read Only" is apossible volume flag set on tapevolumes.)
count None Statistics
For detailed information about B a se lining and KP I, see Managing Baselines and Key Performance Indicators.
* Parameters marked with an asterisk are used by default when v isualizing the corresponding monitor instance in BPPM.
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
EMC NetWorker KM for PATROL
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.
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
Function Description
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
EMC NetWorker KM for PATROL
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,
132Additional Information and Support
Version 2.8.01
EMC NetWorker KM for PATROL
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
133Additional Information and Support
Version 2.8.01
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
Standalone Devices 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
Standalone Devices 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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
Jukeboxes
Delete 52
Disable 52
Enable 52
- K -Key Performance Indicators
BMC ProactiveNet Performance Management 47
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
BMC ProactiveNet Performance Management 47
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
EMC NetWorker KM for PATROL
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 123
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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
EMC NetWorker KM for PATROL
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.