Tivoli Storage Manager KM for PATROL v3.0 · PDF filePerforming Post-Installation Operations...

191
Tivoli Storage Manager KM for PATROL STORAGE MONITORING USER DOCUMENTATION Version 3.0.00 July 2017

Transcript of Tivoli Storage Manager KM for PATROL v3.0 · PDF filePerforming Post-Installation Operations...

Tivoli Storage Manager KM forPATROL

STORAGE MONITORING

USER DOCUMENTATION

Version 3.0.00

July 2017

Contacting BMC Software

You can access the BMC Software Web site at http://www.bmc.com. From this Web site, you canobtain information about the company, its products, corporate offices, special events, and careeropportunities.

United States and Canada

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

Telephone 1 (713) 918 8800 or 1 (800) 841 2031 (Toll Free)

Copyright 2015 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.

All other trademarks belong to their respective companies.

BMC Software considers information included in this documentation to be proprietary andconfidential. Your use of this information is subject to the terms and conditions of the applicableEnd User License Agreement for the product and the proprietary and restricted rights noticesincluded in this documentation.

Restricted Rights Legend

U.S. Government Restricted Rights to Computer Software. UNPUBLISHED -- RIGHTS RESERVEDUNDER THE COPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure of any dataand computer software by the U.S. Government is subject to restrictions, as applicable, set forthin FAR Section 52.227-14, DFARS 252.227-7013, DFARS 252.227-7014, DFARS 252.227-7015, andDFARS 252.227-7025, as amended from time to time. Contractor/Manufacturer is BMC Software,Inc., 2101 CityWest Blvd., Houston, TX 77042-2827, USA. Any contract notices should be sent to thisaddress.

2

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Customer Support

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.

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-mail addresses, fax numbers, and telephone numbers

You can also access product documents and search the Knowledge Base for help with an issue at http://www.sentrysoftware.com

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,call 800 537 1813. Outside the United States and Canada, please contact your local support centerfor assistance. To find telephone and email contact information for the BMC Software supportcenter that services your location, refer to the Contact Customer Support section of the Supportpage on the BMC Software Web site at http://www.bmc.com/support_home.

3

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

4

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Table of Contents.....................................................................................................................................................................................12Requirements

.......................................................................................................................................................................................12System Requirements

.......................................................................................................................................................................................12Software Requirements

.......................................................................................................................................................................................15Security Requirements

.......................................................................................................................................................................................20Disk Space Requirements

.......................................................................................................................................................................................20Remote Monitoring Requirements

.....................................................................................................................................................................................22Getting the BMC Software Installation Utility

.....................................................................................................................................................................................23Packages

.....................................................................................................................................................................................23Extracting the Setup Files

.....................................................................................................................................................................................26Installing Tivoli Storage Manager KM for PATROL

.....................................................................................................................................................................................37Uninstalling Tivoli Storage Manager KM for PATROL

.....................................................................................................................................................................................43Loading and Unloading the KM

.......................................................................................................................................................................................44Loading the KM

......................................................................................................................................................................44Loading the KM on PATROL Console

......................................................................................................................................................................45Loading the KM on PATROL Central

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

.......................................................................................................................................................................................45Unloading the KM

......................................................................................................................................................................46Unloading the KM from the PATROL Agent

......................................................................................................................................................................46Unloading the KM from the PATROL Console

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

.....................................................................................................................................................................................47Performing Post-Installation Operations

.......................................................................................................................................................................................47Customizing Server Monitoring

.......................................................................................................................................................................................49Configuring the KM User Account

.......................................................................................................................................................................................53Verifying Application Discovery

.......................................................................................................................................................................................53Checking the Instance Limits

.......................................................................................................................................................................................54Checking the Initial Setup of the KM

.......................................................................................................................................................................................54Restarting PATROL Agent and PATROL Console

.....................................................................................................................................................................................56Integrating with BMC Portal

.....................................................................................................................................................................................57Integrating with BMC TrueSight Operations Management

.....................................................................................................................................................................................59Administering Tivoli Storage Manager

.......................................................................................................................................................................................59Starting/Stopping the Server

.......................................................................................................................................................................................59Starting/Stopping the Storage Agent

5

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

.......................................................................................................................................................................................60Administering Mount Requests

.......................................................................................................................................................................................60Administering Drives

.......................................................................................................................................................................................61Cancelling Processes

.....................................................................................................................................................................................62Configuring the KM

.......................................................................................................................................................................................63Configuring Paths

.......................................................................................................................................................................................64Configuring the Monitoring of Multiple Server Instances

.......................................................................................................................................................................................65Modifying the TSM Admin Client Path

.......................................................................................................................................................................................66Specifying the Node Type

.......................................................................................................................................................................................67Configuring the Node Status

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

.......................................................................................................................................................................................69Filtering Elements to Monitor

.......................................................................................................................................................................................72Blocking the Remote Monitoring of a TSM Server

.......................................................................................................................................................................................72Configuring Monitoring Periods

.......................................................................................................................................................................................76Configuring the Elements Status

.......................................................................................................................................................................................77Configuring the Log Filter

.......................................................................................................................................................................................80Configuring the Log Scan Limit

.......................................................................................................................................................................................82Configuring Domain Backup Restriction

.......................................................................................................................................................................................82Configuring Alert Acknowledgement

.......................................................................................................................................................................................85Forcing the Classic Mode

.......................................................................................................................................................................................87Refreshing Parameters

.......................................................................................................................................................................................89Enabling the Debug Mode

.......................................................................................................................................................................................92Reloading Commands

.....................................................................................................................................................................................92Acknowledging Alerts

.....................................................................................................................................................................................94Generating Reports

.....................................................................................................................................................................................97Classes and Parameters

.......................................................................................................................................................................................99TSM_MAIN

.......................................................................................................................................................................................100TSM_SERVER

.......................................................................................................................................................................................107TSM_CLIENT_CONTAINER

.......................................................................................................................................................................................109TSM_CLIENT

.......................................................................................................................................................................................111TSM_DAEMON_CONTAINER

.......................................................................................................................................................................................113TSM_DAEMON

.......................................................................................................................................................................................116TSM_DATABASE_CONTAINER

.......................................................................................................................................................................................118TSM_DATABASE

.......................................................................................................................................................................................123TSM_LOG_CONTAINER

.......................................................................................................................................................................................125TSM_LOG

.......................................................................................................................................................................................130TSM_POLICY_CONTAINER

6

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

.......................................................................................................................................................................................132TSM_POLICY

.......................................................................................................................................................................................137TSM_PCLIENT

.......................................................................................................................................................................................140TSM_JOB_CONTAINER

.......................................................................................................................................................................................143TSM_JOB

.......................................................................................................................................................................................148TSM_MOUNT_CONTAINER

.......................................................................................................................................................................................150TSM_MOUNT

.......................................................................................................................................................................................152TSM_LIBRARY_CONTAINER

.......................................................................................................................................................................................154TSM_LIBRARY

.......................................................................................................................................................................................157TSM_LDEVICE

.......................................................................................................................................................................................160TSM_DEVICE_CONTAINER

.......................................................................................................................................................................................162TSM_DEVICE

.......................................................................................................................................................................................165TSM_POOL_CONTAINER

.......................................................................................................................................................................................167TSM_POOL

.......................................................................................................................................................................................171TSM_PROCESS_CONTAINER

.......................................................................................................................................................................................173TSM_PROCESS

.......................................................................................................................................................................................175Managing Baselines and Key Performance Indicators

.....................................................................................................................................................................................177Impact on Resources

.....................................................................................................................................................................................179Where to Find Additional Help

Release Notes for v3.0.00

8

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

What's NewTSM-14: Tivoli Storage Manager KM for PATROL now supports multiple TSM servermonitoring on local and remote hosts.

Changes and ImprovementsTSM-14: The overall performance of the TSM KM has been significantly improved.

TSM-155: TSM KM now fully supports the monitoring of libraries controlled by ACSLS(StorageTek Automated Cartridge System Library Software).

TSM-371: TSM KM has been improved to support all PATROL Agent v10+ versions and preventfailures due to a compatibility error.

Fixed IssueTSM-380: The default actlog query limit has been modified to allow querying all actlogmessages since the last collection cycle (default: 300 minutes).

Overview

10

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Tivoli Storage Manager KM for PATROL monitors your Tivoli Storage Manager application within acentralized management console to ensure its runs efficiently 24 hours a day.

The KM more especially monitors the:

Jobs: size, duration, throughput, time elapsed since last backup, number of objects andstatus

Server and Storage Agent availability: status memory and CPU time consumption

Internal server processes: monitoring of database backups, data migration and spacereclamations

Server database and recovery logs: database and file system utilization, cache and bufferperformance, time elapsed since last backup and database reorganization, etc.

Storage pools: space utilization, status, capacity, logical occupancy, growth rates, etc.

Libraries and drives: number of available drives, status, and number of scratch volumesloaded, etc.

Client: working status

All the information collected is grouped into application classes and displayed in the PATROLConsole. Alarms and warnings inform you when a suspicious behavior is detected; thus allowingyou to quickly and clearly identify peaks, troughs and trends in the performance of your backupresources.

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

Preparing for Installation

12Requirements

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

RequirementsSystem Requirements

Operating System Operating System Version

Sun® microsystems SolarisTM 8, 9, 10, 11

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

IBM® AIXTM 5.1, 5.2, 5.3, 6.1

Red Hat® Linux® 7.2

Microsoft® Windows® 2003, 2008, 2008 R2, 2012

Software RequirementsSoftware Version

Tivoli Storage Manager Server 5.1.x, 5.2.x, 5.3.x, 5.4.x, 5.5.x, 6.1.x, 6.2.x, 6.3.x, 7.1.x

Tivoli Storage Manager Administrative Client 5.1.x, 5.2.x, 5.3.x, 5.4.x, 5.5.x, 6.1.x, 6.2.x, 6.3.x, 6.4.x,7.1.x

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

BMC Software 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

BMC TrueSight Operations Management 10.x

Java 1.6 or higher

Changes to Tivoli Storage Manager

Tivoli Storage Manager KM for PATROL requires that an administrator account be added to theTivoli Storage Manager server for use by PATROL and the TSM KM. Refer to Admin Interface UserAccess.

To allow this user to execute SQL SELECT queries, there should be at least 4Mbytes of temporarytable storage space all the time to avoid exhausting the temporary table storage.

13 Requirements

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Changes to BMC PATROL

To improve the performance of the TSM KM, the PATROL Agent tuning variable /AgentSetup/AgentTuning/pslInstructionMax should be disabled by setting it to 0 (zero) or increased to atleast 5,000,000. This applies for all Tivoli Storage Manager servers and storage agents where theKM is installed. This adjustment will allow the data collectors to execute without incurring aninternal scheduling delay.

This PATROL Agent tuning variable can be updated using wpconfig (on MicrosoftWindows),xpconfig (on Unix) or PATROL Configuration Manager (PCM). Alternatively, you canuse one of the following single line PSL command through the PATROL Console OS> prompt toupdate this tuning variable.

To disable:

%PSL pconfig("REPLACE",

"/AgentSetup/AgentTuning/pslInstructionMax",0);

To set to at least 5,000,000:

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

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

In large Tivoli Storage Manager systems, the value of 5,000,000 for the tuning variable “pslInstructionMax”may still be insuf f icient. In such situations, error messages will appear on the PATROL Console SystemOutput Window (SOW) reporting that some TSM KM data collectors are in an inf inite loop. In this case youcan set the tuning variable to zero to disable this functionality.

The KM stores all configuration information in the PATROL Agent configuration database(pconfig), under the /TSM/<node-id> and /Runtime/TSM/<node-id>paths. PATROL Agent user(default: patrol) should be able to read and write to these pconfig variables at anytime. If AccessControl List (ACL) is used to control which users are authorized to connect to a PATROL Agent,please ensure that the mode for PATROL Agent user includes “C” in the PATROL Agent variable /AgentSetup/accessControlList. Please refer the PATROL Agent Reference Manual for moredetails.

You cannot copy or distribute these KM conf iguration variables between managed nodes, because theymay not have the same value for each managed node. For example, the login user details may not be thesame for all managed nodes. Also some of these variables, like installation paths, are set automaticallyduring the initial discovery.

14Requirements

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Additional Software Requirements

Purpose Software Version

When running TSM KM with sudouser account on Solaris, HP-UX,AIX or Linux managed nodes

Sudo (superuser do)1.6.7 or later

When running TSM KM on AIXmanaged nodes

Default ncargs value forprocessing bpdbjobs output maynot be sufficient. Check this attribute using:lsattr -EH -l sys0 | grep ncargs If the value is below 16, increaseit using:chdev -l sys0 -a ncargs=16

Any

When running TSM KM on Linuxmanaged nodes

Korn shell binary (/bin/ksh)Alternatively a soft link from /bin/ksh to /bin/bash will be needed.

Any

When running TSM KM onMicrosoft Windows x64 managednodes

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 registry keysfrom PATROL Agent. Access the above patch site f rom the managed node to obtain the correct patch forthat platform.

To support bash shell platforms when ksh is not installed

To collect TSM stats when ksh was not installed on UNIX/Linux servers, you need to create a softlink for /bin/ksh to /bin/bash:

ln –s /bin/bash /bin/ksh

15 Requirements

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Security RequirementsA user account with administrative privileges must be configured in BMC PATROL to read andexecute Tivoli Storage Manager application programs and access file systems. Depending on theoperating systems used, several options will be available.

The following user accounts can be used:

On Unix platforms:

a root user

a non-root user, such as patrol, that has sudo privileges on Tivoli Storage Manager toexecute application programs and access file systems

a non-root account, such as patrol, configured in Tivoli Storage Manager application toadminister the Tivoli Storage Manager application.

On Windows platforms:

an administrator user

a non-administrator account, such as patrol, configured in Tivoli Storage Managerapplication to administer the Tivoli Storage Manager application.

The user login details are configured in the KM. The password is stored in the PATROL Agent in aDES encrypted format.

Access Permissions

The TSM KM user needs “read & execute” permission to executable and library files under thepaths listed below. The Tivoli Storage Manager installation path INSTALL_PATH, referencedbelow, is normally /usr/tivoli/tsm or /opt/tivoli/tsm (on Unix) or C:\Program Files\Tivoli\TSM(on Microsoft Windows).

Unix Microsoft Windows

INSTALL_PATH/client/ba/bin (or bin64) INSTALL_PATH\baclient

INSTALL_PATH/client/admin/bin INSTALL_PATH\Server

INSTALL_PATH/server/bin INSTALL_PATH\StorageAgent

INSTALL_PATH/StorageAgent/bin INSTALL_PATH\Server\tsmdiag

INSTALL_PATH/server/bin/tsmdiag INSTALL_PATH\StorageAgent\tsmdiag

INSTALL_PATH/StorageAgent/bin/tsmdiag/usr/lib C:\Windows\system32

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

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

16Requirements

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

vxdctl (in Veritas Cluster File System)/usr/cluster/bin/clrg (in Oracle Solaris Cluster)C:\Windows\sysnative\cluster (in Microsoft Cluster)

The TSM KM includes some scripts which should be executable by the PATROL Agent user and theTSM KM user. These scripts are stored under KM_HOME path, normally PATROL_HOME/lib/TSM.

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

foreach var (grep("^/Runtime/TSM/.*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(osp=="") { osp=trim(nthargf(grep("OSPlatform",ctl),"2-","=","="), " "); }

fields=lines(ntharg(var,"1-","/"));

old_host=host;

host=(fields == 5)? ntharg(var,"3","/") : "localhost";

if(host!=old_host)

{

if((osp!="WINDOWS") && sudoers) { printf("\n\nCommands used with sudo:\n%s",sort(sudoers)); }

printf("\n\nOn %s:\n\n", host);

i=0; sudoers=""; osp="";

}

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,fields,"/"),met,cmd);

}

}

if((osp!="WINDOWS") && sudoers) { printf("\n\nCommands used with sudo:\n%s",sort(sudoers)); }

17 Requirements

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

The PATROL Agent user (normally patrol) requires write permission to DSM_LOG directory anddsmerror.log file. For all other paths and files listed in the table below the PATROL Agent userneeds “read & execute” permission.

Unix Microsoft Windows

DSM_DIR (INSTALL_PATH/client/ba/bin or bin64) DSM_DIR (INSTALL_PATH\baclient)

DSM_LOG (KM_TEMP) DSM_LOG (KM_TEMP)

DSM_DIR/dsmadmc DSM_DIR\dsmadmc.exe

DSM_CONFIG (DSM_DIR/dsm.opt) DSM_CONFIG (DSM_DIR/dsm.opt)

If a monitored log file cannot be read by the PATROL Agent user, it will copied to KM_TEMP path usingthe configured KM login account, and processed by the PATROL Agent user. On completion the copiedlog file will be removed. This may increase the file system usage under KM_TEMP temporarily during thisactivity.

On Windows platforms the Tivoli Storage Manager installation is identified by checking theregistry sub-keys under HKEY_LOCAL_MACHINE\SOFTWARE\IBM\ADSM\.

The configured login user should have sufficient privileges to run regedit command on themanaged node.

Sudo User for Operating System Access

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

The code below also applies to all non-root users who may execute TSM KM administration andreport menu commands using their sudo privileges. The TSM KM accepts any non-root user withthe following sudo configuration in the sudoers file. Please replace user1, user2, user3 withappropriate KM user name. The Tivoli Storage Manager installation path INSTALL_PATH,referenced below is normally /usr/tivoli/tsm or /opt/tivoli/tsm and PATROL_HOME is the pathwhere the PATROL Agent is installed (including the target, like /opt/bmc/Patrol3/Solaris29-sun4/).

This non-root sudo user configured in the KM will be able to execute Tivoli Storage Manager commands.To prevent unauthorized access, ensure this user is only used within the KM and not made public forgeneral use.

18Requirements

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Entering the non-root sudo user with ‘Use Sudo’ option selected in to the login configuration dialog,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 may expose the sudouser password.

On Solaris:

User_Alias TSMKMUSERS = user1, user2, user3

Defaults:TSMKMUSERS !lecture,!authenticate,!requiretty,\

env_keep+="PATH LD_LIBRARY_PATH INSTALL_PATH KM_HOME KM_TEMP

\DSM_CONFIG DSM_DIR DSM_LOG",env_reset

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

INSTALL_PATH/server/bin/*,\

INSTALL_PATH/client/ba/bin/*,\

PATROL_HOME/lib/TSM/*,PATROL_HOME/bin/*

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

On HP-UX:

User_Alias TSMKMUSERS = user1, user2, user3

Defaults:TSMKMUSERS !lecture,!authenticate,!requiretty,\

env_keep+="PATH LD_LIBRARY_PATH INSTALL_PATH KM_HOME KM_TEMP

\DSM_CONFIG DSM_DIR DSM_LOG",env_reset

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

INSTALL_PATH/server/bin/*,\

INSTALL_PATH/client/ba/bin/*,\

PATROL_HOME/lib/TSM/*,PATROL_HOME/bin/*

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

On AIX & Linux:

User_Alias TSMKMUSERS = user1, user2, user3

Defaults:TSMKMUSERS !lecture,!authenticate,!requiretty,\

env_keep+="PATH LD_LIBRARY_PATH INSTALL_PATH KM_HOME KM_TEMP

\DSM_CONFIG DSM_DIR DSM_LOG",env_reset

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

INSTALL_PATH/server/bin/*,\

INSTALL_PATH/client/ba/bin/*,\

PATROL_HOME/lib/TSM/*,PATROL_HOME/bin/*

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

19 Requirements

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Admin Interface User Access

Tivoli Storage Manager KM for PATROL requires that an administrator account (standardadministrator with no other privileges) be added to the Tivoli Storage Manager server for use byPATROL and the TSM KM.

This account is used to query the configuration details and resource utilization of the serverthrough the Tivoli Storage Manager Administrative Client interface (DSMADMC). No changes aremade by this user on the Tivoli Storage Manager server - the TSM KM operates in “read-only”mode for normal operation.

The suggested name for this DSMADMC user account is patrol and it can be created as part of theconfiguration procedure described in Configuring the KM User Accounts. Alternatively, the useraccount can be set up directly in TSM Server, and the details simply entered during KMconfiguration in the same way that the OS login details are entered. The password is stored inthe PATROL Agent in an encrypted format.

DSMADMC command binary is executed using an OS user account matching the DSMADMC login.If this account does not exists, the PATROL Agent user account will be used. Therefore it isrecommended to create an operating system user account matching the DSMADMC usernamewith the same password to avoid invalid user login attempts and to improve the performance.This user should be able to access required paths and binaries of DSMADMC. This includes an'execute' permission to DSM_CONFIG path and dsmadmc (or dsmadmc.exe) file and a 'write'permission to DSM_LOG path and dsmerror.log file.

To list all DSMADMC commands used by the TSM KM, execute the following PSL code from thePATROL Console, using “PSL Task” menu, after installing and loading the KM.

i=0;

foreach var (grep("^/Runtime/TSM/.*CommandControls/",pconfig("LIST")))

{

ctl=pconfig("GET", var);

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

if(typ != "DSMADMC") { next; }

fields=lines(ntharg(var,"1-","/"));

old_host=host;

host=(fields == 5)? ntharg(var,"3","/") : "localhost";

if(host!=old_host)

{

printf("\n\nOn %s:\n\n", host);

i=0;

}

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

printf("(%2d) %-25s: %s\n",i++,ntharg(var,fields,"/"),cmd);

}

20Requirements

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Disk Space RequirementsTivoli Storage Manager KM for PATROL requires approximately:

1.5 MBytes disk space on each monitored PATROL Agent system

2.5 MBytes disk space on each PATROL Console system

600 KBytes disk space on each PATROL Central Console Server system

1.4 MBytes disk space on each PATROL Central Web Server system

The TSM KM is installed under the PATROL installation path.

When monitoring a standard installation of Tivoli Storage Manager, the PATROL Agent willgenerate approximately 500 KBytes of history data per day. An enterprise installation of TivoliStorage Manager on a server with multiple storage agents, clients, automated libraries, andmanual drives will generate more history data (as per other KMs used by the PATROL Agent).These history data files are recycled by PATROL depending on the PATROL Agent historyretention period.

During execution, the TSM KM creates and maintains temporary files under KM_HOME,KM_TEMP and KM_DEBUG paths. By default they are all under PATROL_HOME/lib/TSM, wherePATROL_HOME path is normally /opt/bmc/Patrol3/ (on Unix) or C:\Program Files (x86)\BMCSoftware\Patrol3\ (on Microsoft Windows). Please make sure you have sufficient space underKM_TEMP and KM_DEBUG paths.

If the location of the KM_TEMP or KM_DEBUG is not suitable, it can be changed using theConfiguration > Paths menu from the main instance. These folder should have read, write andexecute permissions for both the PATROL Agent user and the KM login user.

Remote Monitoring RequirementsTivoli Storage Manager KM for PATROL supports the monitoring of multiple Tivoli Storage

Manager Server and Storage Agent instances locally and remotely without the need to run

multiple PATROL Agents. The KM can be installed on any PATROL Agent node to monitor TSM

servers remotely. Therefore, the TSM Admin Client software needs to be installed on the

PATROL Agent node. Follow the TSM Admin Client installation procedure to install and configure

the API before installing the KM.

Upon the initial discovery, TSM KM will discover the TSM Admin Client installation on the PATROL

Agent node and search for the dsmadmc binary file path following the installation path in the

registry (Windows) and under the default paths. If the file is not detected, a message will be

displayed in the SOW (System Outpu Window) and in the TSM.log file. This path is shared

between all TSM server instances monitored from the PATROL Agent node. It is possible to

manually configure the path, if the TSM Admin Client is installed under a custom path, using the

KM Command Tivoli Storage Manager > KM Cmd > Configuration > TSM Admin Client Path.

21 Requirements

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Managing Remote Connection SettingsIn order to remotely access a TSM server, you need to configure a specific OS login account by

setting the Login Configuration options: Right-click a server instance TSM Setup: <server-id> > KM

Cmd > Configuration > Login.

Remote monitoring cannot be performed from UNIX/Linux PATROL Agent to Windows TSM server.

JAVA

Tivoli Storage Manager KM for PATROL requires Java 1.6 or higher and a Java RuntimeEnvironment (JRE) to be installed on the same system that runs the PATROL Agent.

The solution will automatically detect the JRE path if it has been installed in the default locationor under the BMC PATROL Agent installation path. If it has been installed in a different location,you will have to set JAVA_HOME for the PATROL Agent default account before starting thePATROL Agent.

You can download the Java Runtime Environment along with the KM on the Sentry Software Website.

SSH/WMI Connection

An SSH (UNIX/Linux platforms) or a WMI (Windows platforms) connection is required to monitorremote TSM servers. When using an SSH connection, the SSH host key authentication must bedisabled on the remote host.

Disabling the SSH Host Key Authentication

SSH host key authentication is enabled by default on most TSM servers. To disable it:

1. Open the global SSH configuration file (ssh_config) stored in the /etc/ssh/ directory on theremote host

2. Add the line StrictHostKeyChecking no

3. Save the file.

22Getting the BMC Software Installation Utility

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Getting the BMC Software InstallationUtilityIn order to install Tivoli Storage Manager KM for PATROL, you need the latest version of the BMCSoftware Installation Utility. You can download the latest Installation Utility from the BMCSoftware EPD (electronic product download) from: http://webapps.bmc.com/signon/content/logon.jsp on the BMC Software Website, or from the Tivoli Storage Manager KM for PATROL pageon the Sentry Software Website

Choose the appropriate package depending on the platform you plan to install Tivoli StorageManager KM for PATROL 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 Tivoli Storage Manager KM forPATROL packages.

23 Getting the BMC Software Installation Utility

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

PackagesThe Tivoli Storage Manager KM for PATROL packages are available on the Sentry Software Website.

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.

Extracting the Setup FilesLike most Knowledge Modules for PATROL, you need to install Tivoli Storage Manager KM forPATROL on the following components of your PATROL architecture:

Every managed system with a PATROL Agent

Every PATROL Console (Classic) that will show Tivoli Storage Manager performance-relatedinformation and alerts

The Console Server

PATROL Central – Web Edition

Installing the KM

25

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Introduction

This section describes the installation procedure for Tivoli Storage Manager KM for PATROL onany PATROL component (Agents, Consoles, Console Server, etc.). As the setup is based on theBMC Software Installation Utility, this procedure applies to all operating systems supported byTivoli Storage Manager KM for PATROL.

26

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Installing Tivoli Storage Manager KMfor PATROLInstalling Tivoli Storage Manager KM for PATROL is an automated process managed by a wizard.The wizard goes through the necessary steps to install Tivoli Storage Manager KM for PATROL andall files associated with it. You are simply prompt for the product's folder location and theproduct/components to install.

Browse to the bmc_products folder where the files have been extracted (both Tivoli StorageManager KM for PATROL and the Common Installer).

On Windows: Launch the setup.exe program

On UNIX: Launch the setup.sh script

27 Installing Tivoli Storage Manager KM for PATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

To install Tivoli Storage Manager KM for PATROL1. The welcome screen of the installer appears. Click Next to continue.

Installation Wizard - Welcome

28Installing Tivoli Storage Manager KM for PATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

Installation Wizard - Reviewing License Agreement

29 Installing Tivoli Storage Manager KM for PATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

Installation Wizard - Selecting Installation Options

30Installing Tivoli Storage Manager KM for PATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

4. 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 - Selecting the Installation Directory

31 Installing Tivoli Storage Manager KM for PATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

5. Select Default. Installing Tivoli Storage Manager KM for PATROL does not require anycustomization. Click Next to continue.

Installation Wizard - Selecting an Installation Type

32Installing Tivoli Storage Manager KM for PATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

6. Select one or several of the following options:

Managed System to install Tivoli Storage Manager KM for PATROL on a PATROL Agent.

Console Systems to install Tivoli Storage Manager KM for PATROL on a PATROL ClassicConsole.

Common services to install <%PRODUCT LONG NAME%> on the Console Server or onPATROL Central – Web Edition.

Click Next to continue.

Installation Wizard - Selecting Roles

33 Installing Tivoli Storage Manager KM for PATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

7. Check the Tivoli Storage Manager KM for PATROL box to install the KM (it should be selectedby default). Click Next to continue.Select the Java Runtime Environment program if you want to install it along with the KM (thisoption is only provided when you have previously downloaded the package).Click Next to continue.

Installation Wizard - Selecting Products and Components

34Installing Tivoli Storage Manager KM for PATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

Installation Wizard - Reviewing Installation Options

35 Installing Tivoli Storage Manager KM for PATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

Installation Wizard - Installation Status

36Installing Tivoli Storage Manager KM for PATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

Installation Wizard - Installation Results

37 Installing Tivoli Storage Manager KM for PATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

Installation Wizard - Completing and closing the Installation Wizard

Uninstalling Tivoli Storage ManagerKM for PATROLUninstalling Tivoli Storage Manager KM for PATROL is an automated process managed by awizard. The wizard goes through the necessary steps to remove Tivoli Storage Manager KM forPATROL and all files associated with it. You are simply prompt for the product's folder locationand the product/components to uninstall.

38Uninstalling Tivoli Storage Manager KM forPATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

To uninstall Tivoli Storage Manager 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

Un-install Wizard — Welcome Step

39 Uninstalling Tivoli Storage Manager KM forPATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

Un-install Wizard — Specifying folder

40Uninstalling Tivoli Storage Manager KM forPATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

3. To uninstall the KM, select Tivoli Storage Manager KM for PATROL.

Un-install Wizard — Selecting Products and Components Directory

41 Uninstalling Tivoli Storage Manager KM forPATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

4. Click Start Uninstall to run the program.

Un-install Wizard — Reviewing Selected Products & components and start uninstalling

42Uninstalling Tivoli Storage Manager KM forPATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

Un-install Wizard — Status

43 Uninstalling Tivoli Storage Manager KM forPATROL

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

6. A page displaying SUCCESS indicates that Tivoli Storage Manager KM for PATROL is nowuninstalled.

Un-install Wizard — Uninstall Results

Loading and 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.

44Loading and Unloading the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Loading the KM

Before loading the TSM KM:

1. Make sure you properly installed the KM on PATROL Console and PATROL Agent systems

2. Start the PATROL Console and update the connection to all PATROL Agent systems where theTSM KM is installed.

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

Loading the KM on PATROL ConsoleTo load the KM on a PATROL Console:

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

2. Select the TSM_LOAD.kml file,

3. Click Open or OK.

Tivoli Storage Manager KM for PATROL will be loaded to the PATROL Console, and all connectedPATROL Agents will start discovering the TSM environment. If the automatic discoverysuccessfully finds the TSM master/media server installation, the TSM_SETUP instance will beinstantiated.

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

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

1. From the PATROL Console menu bar, choose File > Save Configuration

2. Load the TSM_LOAD.kml file on each PATROL Console.

3. Configure the KM.

45 Loading and Unloading the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Loading the KM on PATROL CentralTo load the KM on PATROL Central:

1. In the Console, right-click the Managed System and select Load Knowledge Modules... TheLoad Knowledge Modules wizard is displayed

2. Click Next

3. Select the managed systems where the TSM KM is to be loaded, and click Next>. The wizardwill display a list of all available .kml files for the managed systems you selected.

4. Select the TSM_LOAD.kml file for each managed system, click Next> and Finish.

If you cannot f ind the TSM_LOAD.kml f ile in the wizard list for any system you selected, then the KM hasnot been installed on that system.

The TSM KM will be loaded to the PATROL Central Console Server, and all connected selectedmanaged systems will start discovering the Tivoli Storage Manager environment.

5. Load the TSM_LOAD.kml file on each PATROL Central Management Profile where TSM KM isto be loaded.

6. Configure the KM.

Configuring PATROL Agent to Preload the KMTo configure PATROL Agent to preload the KM:

1. In order to enable Tivoli Storage Manager KM for PATROL to operate all the time, without aPATROL Console connection, the KM should be added to the PATROL Agent configurationvariable /AgentSetup/preloadedKMs. This can be achieved on the Tivoli Storage Managerinstance by using the menu Configuration>Preloading. The KM Preloading dialog will bedisplayed.

2. Select Add to add the KM files to the list of preloaded KMs. If the TSM KM is successfullyadded to the list, an acknowledgement will be displayed.

The same menu is used to remove the TSM KM f iles f rom the preloaded KMs list.

Unloading the KMThis section describes the procedures for unloading (not uninstalling) the TSM KM from thePATROL Agent, PATROL Console or PATROL Central Console. The intention is that this section isonly used if you no longer want to use some parts of the KM, though there may be circumstanceswhere you may wish to fully unload the KM without uninstalling the files; if you want tocompletely uninstall the KM, refer to the uninstall procedure.

When the KM is unloaded:

46Loading and Unloading the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

from a PATROL Agent: PATROL stops monitoring the Tivoli Storage Manager application onthat system when there is no connection to a PATROL Console with TSM KM loaded.

from PATROL Console: the PATROL Console stops displaying and monitoring the TivoliStorage Manager application on any PATROL Console connected system.

Unloading the KM from the PATROL AgentTo unload the KM from the PATROL Agent:

1. Remove the TSM KM from the list of preloaded KMs using the menu Configuration>Preloading from the Tivoli Storage Manager instance. Alternatively, using theutility wpconfig (on Microsoft Windows) or xpconfig (on Unix), remove TSM_LOAD.kml fromthe PATROL Agent configuration variable /AgentSetup/preloadedKMs.

2. Restart the PATROL Agent.

3. Repeat these steps on every PATROL Agent system (managed node) where the TSM KM is tobe unloaded.

The TSM KM cannot be partially unloaded from the PATROL Agent using the above steps. If you need tounload some parts of the KM from the PATROL Agent, refer to the PATROL Agent Reference Manual.

Unloading the KM from the PATROL ConsoleApplication classes are unloaded individually. This allows for a partial unloading of the KM toenable it to run as a reduced installation.

To unload the TSM KM completely or partially:

1. Remove the unwanted TSM KM application classes from the list of loaded application classes,as required. All TSM KM application classes start with TSM_.

With the PATROL Console for Unix:

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

Select a TSM 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 TSM 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 TSM KM is to be unloaded.

47 Loading and Unloading the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Unloading the KM from the PATROL Central ConsoleA 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 atonce. This allows for a partial unloading of the KM to enable it to run as a reduced installation onsome or all of the managed systems.

To completely or partially unload the TSM 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 TSM KM is to be unloaded, and click Next>.

3. Select the TSM KM application classes to be removed that starts with TSM_ for theappropriate managed systems, click Next> and Finish.

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

Performing Post-InstallationOperationsIt is recommended to perform post installation checks once the KM is installed on the PATROLConsole to ensure it properly operates. Post-installation operations include:

Customizing Server Monitoring

Configuring the Monitoring of Multiple Server Instances

Configuring the KM user account

Verifying:

the application discovery

the instance limits

the initial setup

Restarting the PATROL Agent and PATROL Console.

Customizing Server MonitoringTivoli Storage Manager KM for PATROL monitors all discovered local or remote Tivoli StorageManager Servers. Their operational status is regularly verified and alerts are triggered when suspicious or critical circumstances occur.Server instances configuration can be customized to meet your specific needs or requirements.

To customize the monitoring settings of a server:

48Performing Post-Installation Operations

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

1. In the Console, right-click the Tivoli Storage Manager instance > KM Commands >Configuration > TSM Servers.

Configuring Servers Monitoring

2. Select the server(s) configuration you need to modify.

3. Select one of the available options:

Enable: to resume the selected configuration

Disable: to deactivate the selected configuration

Delete: to remove the selected configuration

4. To add a new configuration for the selected server, enter the following information:

Server ID: Enter the unique identifier of the selected server

Hostname/IP Address/FQDN: Identify the server with its hostname, IP Address or FullyQualified Domain Name (FQDN)

System Type: Select the type of operating system installed on the selected server

Status: Select one of the available options: Enable or Disable, to respectively activate ordeactivate the configuration settings

49 Performing Post-Installation Operations

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

5. Check the Create a separate device in TrueSight option if you wish to display the serverinstance as a separate device in the BMC TrueSight Operations Management console.

6. Click Update to save your changes.

Configuring the KM User AccountA user account with administrative privileges must be configured in BMC PATROL to read andexecute Tivoli Storage Manager application programs and file systems. Depending on theoperating 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 Tivoli Storage Manager to executeapplication programs and access file systems

a non-root account, such as patrol, configured in the Tivoli Storage Manager application toadminister the Tivoli Storage Manager application.

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

50Performing Post-Installation Operations

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

an administrator user

a non-administrator account, such as patrol, configured in the Tivoli Storage Managerapplication to administer the Tivoli Storage Manager application.

Step 1: Configure the KM User Account:1. In the Console, right-click the Tivoli Storage Manager instance > Configuration > Login. The

Login Configuration dialog 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. If you are monitoring a remote TSM server, click Remote Connection Settings:

51 Performing Post-Installation Operations

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Login Configuration - Remote Connection Settings dialog

Connection Timeout (in Seconds): Enter the number of seconds after which the connectionto the remote server will timeout

Maximum Connections: Enter the maximum number of simultaneous connections allowedto the remote server

5. Click OK.

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

52Performing Post-Installation Operations

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Step 2: Configure the Admin Interface Login1. In the Console, right-click the Tivoli Storage Manager instance > Configuration > Admin

Interface Login. The Admin Interface Login Configuration dialog is displayed:

Admin Interface Login Configuration dialog

2. Enter the login details for the KM user for DSMADMC (suggested name is patrol).

3. Select Create new account if you want the KM to create a new account if it has not alreadybeen set up. This operation requires a DSMADMC user account with administrativeprivileges. This new account will be created in the TSM server instances defined in theDSM_CONFIG file selected in the KM Paths menu (<link>Configuration > Paths<\link>).

4. Click DSMADMC Binary File to verify its location.

5. Click OK.

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

53 Performing Post-Installation Operations

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Verifying Application DiscoveryTo verify the application discovery:

1. Check that the TSM Setup instance changes to display the server type. If not, check themessage in the TSM Setup instance and in the PATROL Console System Output Window(SOW). You can force a full discovery by right-clicking the TSM Setup instance > KMCommands > Force Discovery.

2. Check that the application class instances are actually instantiated. The initial data collectionmay take some time depending on the complexity of your environment (up to one hour). Ifneeded, force a data collection by right-clicking the Tivoli Storage Instance instance > KMCommands > Refresh Parameters.

If the Tivoli Storage Manager server is configured in a clustered environment, you'll have toenable and enable Multi-node Mode monitoring.

Checking the Instance LimitsTivoli Storage Manager KM for PATROL automatically sets the number of instances that will bedisplayed in the Console for each monitored elements. This configuration, set to offer maximumperformance, can however be modified to better suit your environment.

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

To modify the default configuration1. In the Console, right-click the Tivoli Storage Manager instance > Configuration> Instance

Limits.

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.

54Performing Post-Installation Operations

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

1. Check for any errors on the PATROL Console System Output Window (SOW) or in the TSM.logfile available in PATROL_HOME/log

2. Check whether the discovered files and directory paths are correct, using the menu Configuration > Paths from the server instance.

3. Refer to the label of the server instance to check whether the discovered Node Type iscorrect using the menu Configuration > Node Type from the server instance.

4. Check the InfoBoxes and Parameters of all the TSM KM instances and verify that they areproperly set.

5. Under each container instance, open all detail parameters (text parameters with names inthe format NBU<Object>Details), and check for error messages.

6. Check the new value of TSMLoginStatus set after completion of all data collection. If either isnot in OK state, open the annotation point to determine the cause of the error.

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

Right-click the server instance > KM commands > KM Status from the TSM instance. Areport 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 Statusreport), determine the cause(s) and take steps to resolve these errors. You may need torefer to the User Guide, 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 asa text file or print it.

8. The KM installed on the master server may monitor the same storage, disk pools, diskvolumes, robotic libraries & drives which are already monitored through the media servers.This may be unnecessary and can trigger duplicate alerts. You can disable these componentson either master server or media server by setting their instance limit to 0 (zero), using themenu Configuration> Instance Limits.

Restarting PATROL Agent and PATROL ConsoleIt should not be necessary to re-start the PATROL Agent and/or PATROL Console. However, it is agood practice to confirm that Tivoli Storage Manager KM for PATROL operates correctly after arestart of PATROL Agent and/or PATROL Console. In addition, the PATROL Agent restart will forceall KM discoveries and data collections to start immediately.

Integrating the KM

56

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

This section provides detailed information about the integration of Tivoli Storage Manager KMfor PATROL into the BMC Framework.

Integrating with BMC PortalAn integration component for BMC Portal is released along with the Knowledge Module (KM) inthe form of a PAR file: BMC-PM-PATROL-TSM-solution-<version>.par. It enables visualization ofparameter data of all objects monitored by the KM, in the BMC Portal environment.

The .par file provided for Tivoli Storage Manager KM for PATROL Version 3.0.00 does not support theupgrade from TSM v2.x installation in BMC Portal integration. Therefore, any previous TSM solution for

BMC Portal integration must be uninstalled before installing the new one.� �

This integration component is valid on BMC portal v2.8 upwards.

To integrate Tivoli Storage Manager KM for PATROL with BMC Portal:1. Install the KM on top of a PATROL Agent as detailed in the Installation Guide. A PATROL

Console will be required to configure the KM.

2. In the PATROL Console, make sure the discovery is properly performed and data is collected.

3. Upload the PAR file in BMC Portal:

• Place the SentrySoftware-PM-PATROL-TSM-solution-<version>.par file in a knownlocation on your file system.

• Log in to BMC Portal with the superadmin credentials

• Click on Portal, then under Tasks click Performance Managers

• Click Upload and then click Browse to open a file selection dialog box

• Select SentrySoftware-PM-PATROL-TSM-solution-<version>.par and click Upload

4. Create a new managed element:

• Log in to BMC Portal with administrator credentials

• Click the Configure tab > Elements > Add

• Select Infrastructure Element and click Next

• Select an RSM to collect data about the infrastructure element and click Next

• Enter the name of the machine on which the PATROL Agent is running, the Host Nameand click Next

• Select the group to which your PM will belong and click Next

• Select the PATROL category, the Application Classes to add and click Next

• Set the Properties and Credentials that the RSM must have to access the specifiedelements and click Next. The list of thresholds is displayed. You can update these settingswithout impacting the values set in PATROL

5. Click Finish.

57 Integrating with BMC TrueSight OperationsManagement

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Integrating with BMC TrueSightOperations ManagementNo specific integration steps need to be performed. To know how to use EMC Disk Arrays KM forPATROL in BMC TrueSight Operations Management, please refer to the TrueSight OperationsManagement - Tivoli Storage Manager Monitoring documentation.

Monitoring your Environment

59

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Tivoli Storage Manager KM for PATROL helps ensure the availability, maximum performance, andintegrity of your backup servers, thereby protecting associated data sets.

Administering Tivoli Storage ManagerTivoli Storage Manager KM for PATROL provides secure server administration menus, which canbe executed by PATROL Console users, if they have appropriate privileges. They can moreespecially:

Starting/stopping the server

Starting/stopping the storage agent

Administering mount requests

Administering drives

Canceling processes

Starting/Stopping the ServerIn the Console, right-click the TSM Server instance > KM Commands and select:

Administration > Start Server

Administration > Stop Server

whether you want to start or stop the selected server.

Starting/Stopping the Storage AgentIn the Console, right-click the TSM Server instance > KM Commands and select:

Administration > Start Storage Agent

Administration > Stop Storage Agent

whether you want to start or stop the selected storage agent.

60Administering Tivoli Storage Manager

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Administering Mount RequestsEach time a mount request appears, an alert is triggered on the TSMRequestTimeout parameter.Some requests will automatically continue processing, others will require that you notify thatthe requested action was actually performed. To send the notification, right-click the relevantmount request instance > Administration > Reply.

To cancel:

a mount request, right-click the relevant mount request instance > Administration > Cancel

all mount requests at once request, right-click the Mount Requests instance >

A mount request can be canceled from the relevant mount request instance, using the menu Administration > Cancel, or you can cancel all mount requests at once from the containerinstance (labeled: Mount Requests) using the menu Administration > Cancel All.

Administering DrivesTo administer manual or automatic library drives, right-click the relevant drive instance andselect one of the following options:

Administration > Clean Drive

Administration > Online Drive

Administration > Offline Drive

61 Administering Tivoli Storage Manager

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Cancelling ProcessesTo administer processes, right-click the relevant process instance and select Administration >Cancel Process.

62Administering Tivoli Storage Manager

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Configuring the KMTivoli Storage Manager KM for PATROL can be customized and optimized to suit your TivoliStorage Manager application environment. This section describes all menus available forcustomizing the TSM KM. These customization menus are accessed from the knowledge modulecommand sub-menu Configuration> from each application instance. Most of these customizationmenus can be accessed either from the parent container level or from the child instance level.

If a customization menu is accessed from the container instance and you make a change, youthen have the option to apply this change to all child instances which appear under the selectedcontainer in PATROL Console instance topology. If a customization menu is accessed from thechild instance, it will only modify the configuration applicable for that instance.

In the absence of a child instance level conf iguration, the KM will search for any modif ied conf igurationthrough its topological parent path. If no customized conf igurations found, the KM will use the defaultconf iguration.

If a menu command is named Configuration > Client(s), it means that the menu command is available asConfiguration > Client f rom the parent container instance (client container instance) and Configuration >Clients f rom the child instance (individual client instance).

63 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

Altering these paths may impact the operation of the KM.

To configure paths:

1. In the Console, right-click a TSM Server instance > KM commands > Configuration > Paths.

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

3. In the TSM section, verify and possibly modify the Installation and the DSM_DIR Directory,the DSM_CONFIG File and DSM_LOG Directory, and finally the Remote Temp Directory(remote servers only) Paths.

The DSM_CONFIG f ile will contain the .opt f ile that specif ies the TSM server instance ID and the requiredconnection setting used by the TSM Admin Client to connect to the TSM server instance.

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,separate them with a colon (:) for Unix, with a semi-colon (;) for Microsoft Windows.

5. Click OK.

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

64Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Configuring the Monitoring of Multiple ServerInstancesTivoli Storage Manager KM for PATROL supports the monitoring of multiple Tivoli Storage

Manager Server and Storage Agent instances locally and remotely without the need to run

multiple PATROL Agents. The KM can be installed on any PATROL Agent node to monitor TSM

servers remotely. Therefore, the TSM Admin Client software needs to be installed on the

PATROL Agent node. Follow the TSM Admin Client installation procedure to install and configure

the API before installing the KM.

Upon the initial discovery, TSM KM will discover the TSM Admin Client installation on the PATROL

Agent node and search for the dsmadmc binary file path following the installation path in the

registry (Windows) and under the default paths. If the file is not detected, a message will be

displayed in the SOW (System Output Window) and in the TSM_<port>.log file in the PATROL log

folder. This TSM Admin Client path is shared between all TSM server instances monitored from

the PATROL Agent node. It is possible to manually configure the path, if the TSM Admin Client is

installed under a custom path, using the KM Command Tivoli Storage Manager > KM Cmd >

Configuration > TSM Admin Client Path.

65 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Modifying the TSM Admin Client PathThe path to the DSMADMC Binary File on the PATROL Agent system can be modified by right-clicking the Tivoli Storage Manager instance > Configuration > TSM Admin Client Path:

Modifying the TSM Admin Client Path

66Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

1. In the Console, right-click a TSM Server instance > KM Commands > Configuration > NodeType.

Specifying the Node Type

2. Select the node type (Server or Storage Agent).

3. Click OK.

67 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Configuring the Node StatusYou can manually customize the Node Status.

1. In the Console, right-click a TSM Server instance > KM Commands > Configuration > NodeStatus.

Specifying the Node Type

2. Provide the Node Status Alarms and Warnings: Enter the regular expressions to determinethe Node Status in Alarm or Warning status. This regular expression will be used on theresult from DSMADMC command: "query status" on the TSM server.

3. Click Update.

68Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Configuring the Multi-Node Monitoring ModeIf the Tivoli Storage Manager environment is installed in a cluster using Veritas Cluster Server,Veritas Cluster File System, Oracle Solaris Cluster or Microsoft Cluster, the TSM KM must beinstalled on all the cluster nodes to enable continuous monitoring and avoid single point offailure. To avoid duplicate alerts from multiple nodes, it is recommended to configure thesolution to operate in multi-node monitoring mode.

The Multi-node monitoring mode feature cannot be used if one or more cluster nodes are monitoredremotely.

To configure the multi-node monitoring mode:

1. In the Console, right-click a TSM Server instance > KM Commands > Configuration >Monitoring Mode.

Configuring the Multi-Node Monitoring Mode

69 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

2. Select Multi-node Mode.

3. Select the appropriate Cluster Application: Veritas Cluster Server, Veritas Cluster FileSystem, Oracle Solaris Cluster or Microsoft Cluster.

4. Indicate the Failover Group Name. Leave this field blank if you previously selected VeritasCluster File System. The TSM KM will then monitor the entire cluster from the active mastersystem, which is identified by the vxdctl -c mode command. This method requires vxconfigdin enable mode with its clustered state active.

5. Enable Remote PATROL Agent Checking to check the monitoring status of the other nodesand click OK. You'll then have to indicate all the information required to communicate withthe remote PATROL Agent (authentication server, protocol, port number, and credentials).

6. Click OK.

Tivoli Storage Manager will then be monitored through the active or online TSM Server node. Theother nodes, which are standing by for a failover, will be in passive multi-node mode and onlythe local Tivoli Storage Manager components will be monitored.

If a managed node is unable to determine the system which should be in Active Multi-node Mode, it willchange to Temporary 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 irrelevantfor various reasons, you can apply filters to indicate which elements will be monitored or not.

Some instances have specif ic monitoring rules:- Daemons: Only the Server Daemon or the Storage Agent Daemon is monitored- Jobs: Future jobs are not monitored by the TSM KM- Automated libraries and manual drives: On a Storage Agent, only the local automated libraries and localmanual drives discovered will be monitored

70Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

To filter the elements to be monitored:

1. In the Console, right-click the instance for which you want to filter the elements to bemonitored and select KM Commands > Configuration> The Elements to be f iltered.

Client Configuration dialog

71 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

The [ALL] entry ensures that all the elements found during PATROL discovery are instantiatedand monitored.

2. To enable elements for monitoring:

In the current configuration list, select the elements to enable

Select Enable

Click Update

A log f ilter will have to be conf igured if you enable log f iles for monitoring.

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 domains are not monitored.

Disabled instances will be instantiated in an OFFLINE state. Commands will not be executed, thusleaving parameters not 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 to be monitored

If needed, enter a description

From the Status list, select Enable

Click Update.

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

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

72Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Blocking the Remote Monitoring of a TSMServerThe server owner/administrator may want to stop the monitoring of a remote TSM server whenperforming maintenance work on this server. The monitoring can be blocked from the relevantTSM server and will not require making any changes from the monitoring PATROL Agentsystem(s). The administrator will just have to create a file named TSM_block under the RemoteTemp Directory Path. By default, this path is set to /var/tmp (on UNIX/Linux) or C:\Windows\Temp (on Windows).

The PATROL Agent monitoring this remote TSM server will detect the block file during the nextdiscovery cycle and turn all the TSM server instances monitored on this TSM server to TSM Setup(Monitoring Blocked).

To resume monitoring, the administrator will just have to delete the TSM_block file.

Configuring Monitoring PeriodsBy default, Tivoli Storage Manager KM for PATROL monitors all mount requests for 1 day, allscheduled jobs that completed successfully for 1 day and any other scheduled job for 3 days, andall executed TSM internal server processes for 3 days. You can however modify these settings tobetter suit your requirements:

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

73 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

Job Filter Configuration dialog

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

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

increase the monitoring period, you'll have to force a full data collection to ensure all jobsare instantiated. To force data collection, right-click the Jobs instance > KM Commands >Force Full Collection

74Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

3. Uncheck Keep Monitoring Active Jobs Indefinitely if you prefer not to monitor active jobsendlessly and remove them from console when they exceed the monitoring duration above.

4. Uncheck Ignore Inactive Jobs Initially if you don't want to discover and monitor completed/inactive jobs during initial discovery cycles.

5. Click OK.

All jobs associated to disabled domains are not monitored.

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

Mount Requests.

Mount Request Filter Configuration Dialog

75 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

3. Click OK.

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

Processes.

Process Filter Configuration Dialog

2. Indicate how long the processes will be monitored. If you:

decrease the monitoring period, older processes will be destroyed on the next datacollection cycle

increase the monitoring period, you'll have to force a full data collection to ensure allprocesses are instantiated. To force data collection, right-click the Processes instance > KMCommands > Force Full Collection.

3. Click OK.

76Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

1. In the Console, right-click the parent or child instance for which you want to configure statusand select > KM commands > Configuration > Instance Status.

Client Status Configuration dialog

77 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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 awarning when the Unknown state of the Client instance lasts more than 30 minutes:

From the State list, select -1 (Unknown)

From the Condition list, select >

In the Minutes field, enter 30

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 analarm when the Never Communicated state of the Clients instance lasts more than 60minutes:

From the State list, select 2 (Never Communicated)

From the Condition list, select >

In the Minutes field, enter 60

6. Click Update.

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

7. Click Close.

If this menu was accessed at a parent (container) level, the new mapping rule applies to allcomponents available under that parent instance. To modify the mapping rule for a selectedcomponent, access the menu at the child component instance level.

Configuring the Log FilterA log error filter can be configured to specify the regular expressions that will generate a warningor an alarm. Each time the KM will find these expressions in a log file or in TSMLogText, the errormessage will be written to the TSMLogAlarmText or TSMLogWarningText parameter. By default,the default log filter is configured for the Server Activity Log and the system log file. If youenabled additional log files for monitoring, you will have to customize the log filter by addingappropriate expressions for those log files.

For an explanation of the possible error messages in the log f iles, refer to the Tivoli Storage ManagerSystem Administrator’s Guide and the Tivoli Storage Manager Troubleshooting Guide.

78Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

To configure the log error filter:

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

Log Filer Configuration dialog

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

79 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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). Youcan also limit the exclusion to a particular expression already listed by using standardwildcard syntax, such as “ANR2121W” or “ANR21[0-9].W”.”.

Select Exclude

6. Click Update.

To revert to the default settings for either f ilter, type [default] as a new error expression for that f ilter, andclick Update. If you revert to the default settings when accessed from the log instance level, the settings willrevert to the parent or container instance level. To revert to the shipped default settings (as shown above),access this dialog from the log container instance. From this level you will also have the option to reset theconf iguration of any modif ied child instance.

80Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Configuring the Log Scan LimitThe TSM 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. Thislog scan limit can however be modified to better suit your requirements.

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

To customize the log scan limit:

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

Configuring Log Scan Limit

81 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

2. In the Scan Limit field, indicate the amount of data (in KBytes) that will be read by themonitoring solution during each data collection cycle (Default is 500 kBytes).

3. (TSM actolog only) In the Query Limit field, the maximum query limit (in minutes). Bydefault the solution queries up to 300 minutes (5 hours) of actlog data.

4. Click OK.

82Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Configuring Domain Backup RestrictionTSM KM can be configured to trigger a warning when a backup is started during a specific periodof time:

1. In the Console, right-click:

the Domains instance > KM Commands > Configuration> Domains Backup Restriction toapply this customization to all policies

a Domain instance > KM Commands > Configuration> Domain Backup Restriction to applythis customization to a specific policy

Domain Backup Restriction Window dialog

2. Select Enabled.

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

4. Click OK.

Configuring Alert AcknowledgementBy default, alerts will automatically be acknowledged unless you modified the following settingsto allow manual acknowledgment.

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

83 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Configuring Logs Alert Acknowledgment

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

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

Configuring Log Alert Acknowledgment

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

3. Click Ok.

Configuring Jobs Alert Acknowledgment

By default, the alerts triggered on the TSMJobStatus parameter for the completed jobs are notacknowledged. If you want these alerts to be automatically acknowledged, you'll have toconfigure the job alert acknowledgment as follows:

84Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

1. In the Console, right-click the Jobs instance > KM Commands > Configuration > Job AlertAcknowledgment.

Configuring Job Alert Acknowledgment

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

3. Click Ok.

85 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Configuring Process Alert AcknowledgmentIf you want alerts to be automatically acknowledged, you'll have to configure the process alertacknowledgment as follows:

1. In the Console, right-click the Processes instance > KM Commands > Configuration > ProcessAlert Acknowledgment.

Configuring Process Alert Acknowledgment

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

3. Click OK.

Forcing the Classic ModeTivoli Storage Manager KM for PATROL can either be configured from a BMC PATROL Console(Classic Mode) or BMC TrueSight Operations Management. When the KM is installed on a PATROLAgent, which is managed by Central Monitoring Administration (CMA), all the KM configurationmenus are disabled in the PATROL Console. To configure TSM KM from a PATROL Console, youneed to force the KM to run in Classic Mode. This will disconnect TSM KM from receiving configuration from Central MonitoringAdministration. Any monitoring that was configured in CMA and used by the PATROL Agent willbe removed and replaced by the configuration made from the PATROL Console. However, thiswill not delete the policies created in CMA from the configuration.

Any conf iguration for TSM KM received from Central Monitoring Administration will be ignored.

86Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

To force the KM to run in Classic Mode:1. In the PATROL Console, right-click the Tivoli Storage Manager icon > KM commands >

Configuration > Force Classic Configuration Mode.

Force Classic Configuration Mode

2. Check Force the KM to run in Classic mode and click OK.

3. TSM KM will now start running in Classic Mode, enabling you to use the KM Configurationmenus.

To conf igure the KM in TrueSight OM, follow the above procedure and uncheck Force the KM to run inClassic mode. All conf igurations made through the PATROL Console will then be ignored.

87 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Refreshing ParametersThis section describes how to manually refresh parameters without waiting for an automaticpolling cycle.

Forcing All Discoveries

To force all discoveries, right-click a TSM Server instance and select:

Refresh Process Cache to refresh the PATROL Agent process cache

Force Discovery.

The discovery will then be forced on all the KMs loaded on the PATROL Agent and on all the KMapplications classes.

Forcing All Data Collectors

To force all data collectors, right-click a TSM Server instance and select:

Refresh Process Cache to refresh the PATROL Agent process cache

Refresh parameters to force all data collectors at the same time.

The TSM KM data collectors and all the data collectors defined under the application classesloaded on the PATROL Agent will then be refreshed.

Forcing Selected Data Collectors

This option is only available from a PATROL Developer Console.

1. Right-click a TSM Server instance and select Refresh Process Cache to refresh the PATROLAgent process cache.

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

With the PATROL Central Console

Right-click the main Tivoli Storage Manager container instance

Select the Parameter List tab

Select the required data collector

Click Update.

With the PATROL Console for MS Windows

Right-click the main Tivoli Storage Manager container instance and choose Parameterswithout Icons...

Select the required data collector

88Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Click Update.

With the PATROL Console for Unix

Right-click the main Tivoli Storage Manager container instance and choose Customize >Parameters...

Select the required data collector

Click on Options > Update.

Forcing Full Data Collection for Jobs

By default, the TSMJobCollector only searches for new jobs started since the last collection cycle.However, it can be forced to search for all jobs within the monitored time period during the nextcollection cycle.

To force full data collection for jobs, right-click the Jobs instance and select Force Full Collection.

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

89 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

Enabling the Debug Mode1. In the Console, right-click a TSM Server instance > KM Commands > Configuration > Debug.

The TSM KM Debug Configuration dialog will be displayed:

Enabling the Debug Mode

90Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

2. Select On for the debug switch(es) you want to enable. Refer to the table below to know theapplication classes and collector parameters included in the debug switch:

Object Debug Switch

Application Classes Collector Parameters

Server TSM_SERVER TSMCreateDistributionTSMUpdateAgent

Database TSM_DATABASE_CONTAINERTSM_DATABASE

TSMDatabaseCollector

Log TSM_LOG_CONTAINERTSM_LOG

TSMLogCollector

Client TSM_CLIENT_CONTAINERTSM_CLIENT

TSMClientCollector

Device(Automated Library / Drive)

TSM_LIBRARY_CONTAINERTSM_LIBRARYTSM_LDEVICETSM_DEVICE_CONTAINERTSM_DEVICE

TSMLibraryCollectorTSMDriveCollector

Daemon TSM_DAEMON_CONTAINERTSM_DAEMON

TSMDaemonCollector

Pool TSM_POOL_CONTAINERTSM_POOL

TSMPoolCollector

Backup (Domain / Job / Mount Request)

TSM_POLICY_CONTAINERTSM_POLICYTSM_PCLIENTTSM_JOB_CONTAINERTSM_JOBTSM_MOUNT_CONTAINERTSM_MOUNT

TSMDomainCollectorTSMJobCollectorTSMRequestCollector

Process TSM_PROCESS_CONTAINERTSM_PROCESS

TSMProcessCollector

3. Set the Debug Options:

In the Debug End Time field, indicate the date and time after which debug information willno longer be logged

In the Debug Path field, indicate where the debug file will be stored (by default:<PATROL_HOME>/lib/TSM/debug on Unix systems; %PATROL_HOME%\lib\TSM\debug onMicrosoft Windows systems). The debug folder must have at least 10MB of available diskspace and read, write and execute permissions for both PATROL Agent user and the TSMKM 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 TSM DebugOutput window. Before selecting this option, make sure the PATROL Console is connectedto the PATROL Agent

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

91 Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

4. Click OK first to start TSM 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 end time is reached. A tar/zip file is then automatically created under <PATROL_HOME>/lib/TSM/ and can be sent to theBMC Support for help. It is also recommended to check the SOW or TSM.log file, stored in<PATROL_HOME>/log, for any error.

If you want to manually stop debugging:

1. Access the TSM 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 TSM 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:

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

tsm_km_debug_<date>_<time>.zip file (Windows systems). This file could later be foundin %PATROL_HOME%\lib\TSM\

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

If the compressed f ile is not created successfully, you can create it manually by including all f iles and sub-directories under $PATROL_HOME/lib/TSM/ (on Unix) or %PATROL_HOME%\lib\TSM\ (on Microsoft Windows).

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.

92Configuring the KM

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

Acknowledging AlertsBy default, alerts are acknowledged automatically. They can however be acknowledged manuallyif you do not want to wait for the automatic cycle. Manual acknowledgement will also berequired if you modified the alert acknowledgement default settings.

Manually Acknowledging Log Alerts

When an error is detected in a monitored log file, it will either appear in TSMLogAlarmText orTSMLogWarningText and will respectively trigger an Alarm or a Warning on TSMLogAlarmCountor TSMLogWarningCount.

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 TSMLogWarningTextparameter

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

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

93 Acknowledging Alerts

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Manually Acknowledging Job Alerts

For a particular job instance, if the TSMJobStatus has a value of 1=Suspicious or 2=Failure, it willbe set to alert with a status of Warning or Alarm respectively. These alerts can be acknowledgedusing the menu Acknowledgement > Alert from the relevant job instance.

To acknowledge job alerts:

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

2. Select:

Acknowledgement > Warnings to view and acknowledge alerts for all jobs with a status ofWarning

Acknowledgement > Alarms to view and acknowledge alerts for all jobs with a status ofAlarm

Acknowledgement > All to view and acknowledge all job alerts (Warnings and Alarms) atonce

Acknowledging Process Alerts

For a particular process instance, if the TSMProcessStatus has a value of 1=Suspicious or2=Failure, it will be set to alert with a status of Warning or Alarm respectively. These alerts canbe acknowledged using the menu Acknowledgement > Alert from the relevant process instance.

To acknowledge process alerts:

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

2. Select:

Acknowledgement > Warnings to view and acknowledge alerts for all processes with astatus of Warning

Acknowledgement > Alarms to view and acknowledge alerts for all processes with a statusof Alarm

Acknowledgement > All to view and acknowledge all process alerts (Warnings and Alarms)at once

94Generating Reports

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Generating ReportsThe following reports are available in Tivoli Storage Manager KM for PATROL:

<Automated Library instance> > Reports > Automated Library Contents - reports the libraryvolume contents of the automated library instance

Daemons > Reports > Daemon List - lists all running Tivoli Storage Manager daemons

Databases > Reports > Database Backup Volume History - reports server database backupvolume history for the last 7 days

<Database instance> > Reports > Database Volumes - reports information about serverdatabase volumes and volume copies

<Domain instance> > Reports > Domain Schedule - displays the schedule for the selecteddomain instance for the next 24 hours

Logs > Reports > Activity Log Messages - reports all messages logged today (since midnight)

Mount Requests > Reports > Mount Requests - reports a list of all pending mount requests

Processes > Reports > Active Processes - reports a list of all active processes on the managednode

<Storage Pool instance> > Reports > Volumes List - reports all volumes in the selected storagepool, and their states

To save the report as a task window click Save As Task. This task window can then be printed or saved as atext f ile.

Reference Guide

96

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Introduction

This chapter provides statistical information about resources, operating status, and performancesmanaged by Tivoli Storage Manager KM for PATROL. It contains tables describing the parametersused in the KM, grouped by Application Classes, and provides a brief description of eachparameter and its default settings.

97 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Classes and ParametersThis section lists the application classes of TSM KM. It gives you details on the icons thatrepresent the class, Infobox, parameters and the menu commands available for each applicationclass. There are 15 main application classes and 11 “container” classes.

TSM_MAIN

TSM_SERVER

TSM_CLIENT_CONTAINER

TSM_CLIENT

TSM_DAEMON_CONTAINER

TSM_DAEMON

TSM_DATABASE_CONTAINER

TSM_DATABASE

TSM_LOG_CONTAINER

TSM_LOG

TSM_POLICY_CONTAINER

TSM_POLICY

TSM_PCLIENT

TSM_JOB_CONTAINER

TSM_JOB

TSM_MOUNT_CONTAINER

TSM_MOUNT

TSM_LIBRARY_CONTAINER

TSM_LIBRARY

TSM_LDEVICE

TSM_DEVICE_CONTAINER

TSM_DEVICE

TSM_POOL_CONTAINER

TSM_POOL

TSM_PROCESS_CONTAINER

TSM_PROCESS

98Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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 andKPIs, 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 calculationprocess are respectively identified by the following icons:

Baselining

KPI

99 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_MAINIcon

Parameters

None.

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.

Copyright Copyright (C) Sentry Software.

Web Site www.bmc.com.

Support [email protected].

Menu Commands

Function Description

Configuration> TSMServers

Opens the Server Configuration dialog to configure the monitored TSM Serverinstances.

Configuration> TSMAdmin Client Path

Opens the TSM Admin Client Configuration dialog to configure the TSM AdminClient binary file path used by TSM KM.

Configuration> Preloading

Opens Preloading Configuration dialog, which adds or removes the KM fromPATROL Agent variable "/AgentSetup/preloadedKMs".By preloading the TSM KM, the PATROL Agent will monitor the Tivoli StorageManager application without any PATROL Console connection.

Configuration> ForceClassic ConfigurationMode

Forces the KM to "Classic Mode" and allows to configure TSM KMfrom PATROLConsoles.

About Displays information about the product and the manufacturer.

100Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_SERVERIcon

Parameters

Name Description Units Default AlertConditions

Type

ExtraFilesList Is used for pushing TSM KMlibrary files to the PATROL Agentduring the "Commit" operation.

n/a n/a n/a

TSMClientCollector Collects Tivoli Storage Managerclient related information. It setsall consumer parameters in TSM_CLIENT_CONTAINER andTSM_CLIENT application classes.By default, this collector isexecuted only on the server.

Polling Interval: 600 seconds

n/a n/a n/a

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

Polling Interval: 300 seconds

n/a n/a n/a

TSMDaemonCollector Collects Tivoli Storage Managerdaemon related information. Itsets all consumer parameters in TSM_DAEMON_CONTAINER andTSM_DAEMON applicationclasses.

Polling Interval: 300 seconds

n/a n/a n/a

TSMDatabaseCollector Collects Tivoli Storage Managerserver database relatedinformation. It sets all consumerparameters in TSM_DATABASE_CONTAINER andTSM_DATABASE applicationclasses.By default, this collector isexecuted only on the server.

n/a n/a n/a

101 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

Polling Interval: 1800 seconds

TSMDomainCollector Collects Tivoli Storage Managerdomain and client node relatedinformation. It sets all consumerparameters in TSM_POLICY_CONTAINER,TSM_POLICY, and TSM_PCLIENTapplication classes.By default, this collector isexecuted only on the server.

Polling Interval: 900 seconds

n/a n/a n/a

TSMDriveCollector Collects Tivoli Storage Managermanual drive related information.It sets all consumer parameters in TSM_DEVICE_CONTAINER andTSM_DEVICE application classes.

Polling Interval: 600 seconds

n/a n/a n/a

TSMJobCollector Collects Tivoli Storage Managerbackup/restore event relatedinformation. It sets all consumerparameters in TSM_JOB_CONTAINER andTSM_JOB application classes.By default, this collector isexecuted only on the server.

Polling Interval: 300 seconds

n/a n/a n/a

TSMLibraryCollector Collects Tivoli Storage Managerautomated library and automatedlibrary drive related information.It sets all consumer parameters in TSM_LIBRARY_CONTAINER,TSM_LIBRARY, and TSM_LDEVICEapplication classes.

Polling Interval: 600 seconds

n/a n/a n/a

TSMLogCollector Collects Tivoli Storage Managerlog file related information. It setsall consumer parameters inTSM_LOG_CONTAINER andTSM_LOG application classes.

Polling Interval: 1800 seconds

n/a n/a n/a

102Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

TSMLoginStatus* Monitors the status of the TSM KMlogin details (username/password) for the operatingsystem and DSMADMC. It is set byTSM_SERVER application classdiscovery.If no valid username/password isdetected for the operating systemor DSMADMC, this parameter willbe set to Failure state. If there areany suspicious command exits,this parameter will be set toSuspicious state.If this status parameter changes towarning or alarm state, therecovery action will trigger anevent and annotate the last datapoint.

0 = OK1 =Suspicious 2 = Failure

Warning = 1Alarm = 2

CollectionStatus

TSMMonitoringMode* Monitors failover mode of the TSMKM. It is set by TSM_SERVERapplication class discovery.By default TSM KM runs inPermanent Single-node Mode.Multi-node monitoring can beconfigured using the KMcommand Configuration >Monitoring Mode from the TivoliStorage Manager icon.

0 =PermanentSingle-nodeMode1 =TemporarySingle-nodeMode2 = ActiveMulti-nodeMode3 = PassiveMulti-nodeMode-1 =Unknown

n/a CollectionStatus

TSMNodeStatus* Monitors error messages for theTivoli Storage Managerapplication on this managedsystem. It is set by TSM_SERVERapplication class discovery.

The value of this parameter isdetermined by the node statusmapping rule defined in the KMcommand Configuration > NodeStatus from the Tivoli StorageManager icon.

If this status parameter changes towarning or alarm state, therecovery action will trigger anevent and annotate the last datapoint.

0 = OK1 =Suspicious2 = Failure

Warning = 1Alarm = 2

Availability

103 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

TSMPoolCollector Collects Tivoli Storage Managerstorage pool related information.It sets all consumer parameters inTSM_POOL_CONTAINER andTSM_POOL application classes.

By default, this collector isexecuted only on the server.

Polling Interval: 1800 seconds

n/a n/a n/a

TSMProcessCollector Collects Tivoli Storage Managerserver process relatedinformation. It sets all consumerparameters inTSM_PROCESS_CONTAINER andTSM_PROCESS application classes.By default, this collector isexecuted only on the server.

Polling Interval: 300 seconds

n/a n/a n/a

TSMRequestCollector Collects Tivoli Storage Managermount request relatedinformation. It sets all consumerparameters inTSM_MOUNT_CONTAINER andTSM_MOUNT application classes.By default, this collector isexecuted only on the server.

Polling Interval: 300 seconds

n/a n/a n/a

For detailed information about Baselining and KPI, see Managing Baselines and Key Performance Indicators.

* Parameters marked with an asterisk are used by default when visualizing the corresponding monitor instance inTrueSight OM.

104Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

InfoBox

Name Description

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

Application Version Monitored application version number.

Server(s) Name of the server(s) that the current managed system belongs to.

Storage Agent(s) Names of the discovered storage agents.

Node Name(s) Name of the current managed system (node) as defined in Tivoli StorageManager.

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

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

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

Operating System Operating system description as reported by PATROL Agent.

Installation Path Tivoli Storage Manager software installation path.

Binary Path Tivoli Storage Manager software binary paths used by TSM KM.

Library Path Tivoli Storage Manager software library paths used by TSM KM.

Monitoring Mode Monitoring mode of the Knowledge Module.

Monitoring Node Node currently monitoring Tivoli Storage Manager.

105 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Menu Commands

Function Description

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

Force Discovery Forces application discovery.

Refresh Parameters Forces an update of the application parameter values.

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

Administration > StartServer

Starts server daemons.

Administration > StopServer

Stops server daemons.

Administration > StopStorage Agent

Stops storage agent daemons.

Administration >StartStorage Agent

Starts storage agent daemons.

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

Configuration> AdminInterface Login

Accesses the Admin Interface Login Configuration dialog for entering and viewingDSMADMC login account details.This admin account (suggested name patrol) is used by the TSM KM to queryTivoli Storage Manager.This user account will be used by TSM KM pre-discoveries, discoveries, datacollectors, recovery actions, and InfoBoxes to execute DSMADMC queries. It willnot be used by any KM command.The password is encrypted and stored on the PATROL Agent using BMC PATROLencryption function.

Configuration> Preloading

Accesses Preloading Configuration dialog, which adds or removes the KM fromPATROL Agent variable "/AgentSetup/preloadedKMs".By preloading the TSM KM, the PATROL Agent will monitor the Tivoli StorageManager application without any PATROL Console connection.

Configuration> Monitoring Mode

Accesses the Monitoring Mode Configuration dialog, which is used for enablingor disabling TSM KM failover, when monitoring clustered Tivoli Storage Managerenvironment.

Configuration> Paths Accesses the Path Configuration dialog, which displays and sets all paths usedby the TSM KM.Paths are automatically discovered by the TSM KM server discovery. They areused as environment variables for executing various Tivoli Storage Managerapplication commands. Altering these paths may impact the operation of the KM.

106Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Function Description

KM paths are used as environment variables and internally:

KM_HOME keeps all KM scripts.

KM_TEMP is used for creating KM temporary files.

KM_DEBUG is used for creating KM debug files.

Installation Path is the application installation path discovered by the KM. This informationcan be overridden through the KM command.

Binary Paths are the Application and operating system binary path, which is used for settingPATH environment variable. The KM discovers and sets this automatically. This menu can beused, if the discovered paths are incorrect.

Library Paths are the Application and operating system library path, which is used for settingthe following environment variables:

LD_LIBRARY_PATH (on Solaris)

SHLIB_PATH (on HP-UX)

LIBPATH (on AIX)The KM discovers and sets this automatically. This menu can be used, if the discovered pathsare incorrect.

DSM_DIR Directory Path, DSM_DIR Directory Path, and DSM_DIR Directory Path are the TSM

application paths used while executing DSMADMC commands.

Configuration> NodeType

Accesses the Node Type Configuration dialog, which displays and sets the type ofthe Tivoli Storage Manager application node.The TSM KM server discovery detects the type of the node automatically; the typecan either be Server or Storage Agent. The operation of the KM depends on thisnode type.

Configuration> NodeStatus

Accesses the Node Status Configuration dialog for viewing and modifying theerror expression filters, which determine the status of the node (parameterTSMNodeStatus).By default, the following "Included" expressions are checked. If detected, they setthe parameter TSMNodeStatus to alert, unless the message also contains an"Excluded" expression.

Type "[default]" to reset to the default configuration.

Configuration> Instance Limits

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

Configuration> Debug Accesses the Debug Configuration dialog for enabling/disabling the TSM KMdebug switches.

KM Status Generates a summary report containing information about the monitored TSMserver instance.

107 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_CLIENT_CONTAINERIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMClientCollectorExecTime

Inactive standard parametermonitors the collector executiontime. To activate this parameter,use the PSL below, and restart thePATROL Agent:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMClientCollectorExecTi

me", 1);

When activated it will run everyminute and trigger a warningwhen the collector runs for morethan the observed maximumtime. This maximum time can beoverridden by a preset value(example: 3600 seconds), usingthe PSL below:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMClientCollectorWarn",

3600);

Seconds Warning > presetvalue orobservedmaximum(default)

CollectionStatus

TSMClientDetails Set by TSMClientCollector. Displaysall data returned to the standardout from commands executed by thedata collector.

n/a n/a n/a

108Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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 TSMKM.By default, all clients configured on the server are monitored.Type [default] to reset to the default configuration.

Configuration > ClientsStatus

Accesses the global configuration for determining the client status formonitored client instances.By default, following TSMClientState to TSMClientStatus mapping rule is used:

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

109 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_CLIENTIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMClientLastAccessElapsed*

Set by TSMClientCollector. Displaysthe time elapsed since the lastcommunication from the client.The specified alarm ranges can beenabled to allow the output of theparameter to be activelymonitored. Then, if this parameterchanges to warning or alarm state,the recovery action will trigger anevent.

Hours None Statistics

TSMClientSpaceUsed* Set by TSMClientCollector. Displaysthe amount of space used on theclient node.

Gigabytes(GB)

None Statistics

TSMClientState Set by TSMClientCollector. Displaysthe state of the client as reportedin the command executed by thedata collector.

0 = Running1 = Locked2 = NeverCommunicated-1 =Unknown

None Availability

TSMClientStatus Set by TSMClientCollector.Monitors the status of the client.This status is determined by theclient status mapping rule definedin the KM command Configuration> Client(s) Status.

If this status parameter changes towarning or alarm state, therecovery action will trigger anevent and annotate the last datapoint.

0 = OK1 =Suspicious 2 = Failure

Warning = 1Alarm =2

Availability

TSMClientSummary Set by TSMClientCollector.Summarizes the client informationas reported in commands executedby the data collector.

n/a None n/a

110Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

For detailed information about Baselining and KPI, see Managing Baselines and Key Performance Indicators.

* Parameters marked with an asterisk are used by default when visualizing the corresponding monitor instance inTrueSight OM.

InfoBox

Name Description

Name Name of the Tivoli Storage Manager client.

Description Description of the Tivoli Storage Manager client.

Operating System Operating system of the client.

Status Status of client connectivity from the current node.

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

Version Version number of the application installed on the client.

Time Since LastCommunication

Number of days, hours, minutes and seconds since the last connection from thecurrent node.

Last CommunicationMethod

Method of the last connection from the current node.

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> Client Accesses the individual configuration for monitoring the selected clientinstance.This dialog allows the selected client instance to be enabled or disabled formonitoring by the TSM KM

Configuration> ClientStatus

Accesses the individual configuration for determining client status for theselected client instance.By default, the global TSMClientState to TSMClientStatus mapping rule is used,as configured at the container level. Select [default] to revert to the client statusmapping rule configured at the global/container level.

111 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_DAEMON_CONTAINERIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMDaemonDetails Set by TSMDaemonCollector,displays all data returned to thestandard out from commandsexecuted by the data collector.

n/a None n/a

TSMDaemonCollectorExecTime

Inactive standard parametermonitors the collector executiontime. To activate this parameter,use the PSL below, and restart thePATROL Agent:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMDaemonsCollectorExecT

ime", 1);

When activated it will run everyminute and trigger a warningwhen the collector runs for morethan the observed maximumtime. This maximum time can beoverridden by a preset value(example: 3600 seconds), usingthe PSL below:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMDaemonCollectorWarn",

3600);

Seconds Warning > presetvalue orobservedmaximum(default)

CollectionStatus

112Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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 > Daemon List Lists all running Tivoli Storage Manager daemons.

Configuration > Daemons

Accesses the dialog for specifying which daemons are to be monitored by theTSM KM.By default, the following daemons are monitored.

Note that this default configuration is for a UNIX platform; the difference for aMicrosoft Windows platform is that the name of the TSM Server Daemon isshown as "dsmserv or dsmsvc" and the TSM Storage Agent Daemon is shown as"dsmsta or dstasvc".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, the following TSMDaemonState to TSMDaemonStatus mapping rule isused:

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

113 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_DAEMONIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMDaemonCPUDuration

Set by TSMDaemonCollector.Displays the CPU secondsconsumed by the daemon.

Seconds None Statistics

TSMDaemonCPUUtilization*

Set by TSMDaemonCollector.Displays the CPU seconds used bythe daemon.

Percentage (%)

None Statistics

TSMDaemonMemorySize*

Set by TSMDaemonCollector.Displays the core image size of thedaemon in the virtual memory.

Kilobytes(KB)

None Statistics

TSMDaemonProcessCount

Set by TSMDaemonCollector.Displays the number of daemonprocesses/threads found.

Processes None Statistics

TSMDaemonState Set by TSMDaemonCollector.Displays the state of the daemon asreported in the command executedby the data collector.

0 =Running1 =Sleeping2 =Waiting3 =Queued4 =Intermediate5 =Terminated6 =Stopped/Disabled

None Availability

114Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

7 =Growing8 =Nonexistent/NotResponding9 = NotRunning-1 =Unknown

TSMDaemonStatus Set by TSMDaemonCollector.Monitors the status of the daemon.This status is determined by thedaemon status mapping ruledefined in the KM command Configuration > Daemon(s) Status.

If this status parameter changes towarning or alarm state, therecovery action will trigger anevent and annotate the last datapoint.

0 = OK1 =Suspicious2 = Failure

None Availability

TSMDaemonSummary Set by TSMDaemonCollector.Summarizes the daemoninformation as reported bycommands executed by the datacollector.

n/a n/a n/a

For detailed information about Baselining and KPI, see Managing Baselines and Key Performance Indicators.

* Parameters marked with an asterisk are used by default when visualizing the corresponding monitor instance inTrueSight OM.

115 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

InfoBox

Name Description

Name Name of the Tivoli Storage Manager daemon.

Description Description of the Tivoli Storage Manager 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 TSM KM.

Configuration > Daemons Status

Accesses the individual configuration for determining daemon status for theselected the daemon instance.By default, the global TSMDaemonState to TSMDaemonStatus mapping rule isused. Select [default] to revert to the daemon status mapping rule configured atthe global/container level.

116Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_DATABASE_CONTAINERIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMDatabaseDetails Set by TSMDatabaseCollector.Displays all data returned to thestandard out from commandsexecuted by the data collector.

n/a n/a n/a

TSMDatabaseCollectorExecTime

Inactive standard parametermonitors the collector executiontime. To activate this parameter,use the PSL below, and restart thePATROL Agent:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMDatabaseCollectorExec

Time", 1);

When activated it will run everyminute and trigger a warningwhen the collector runs for morethan the observed maximumtime. This maximum time can beoverridden by a preset value(example: 3600 seconds), usingthe PSL below:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMDatabaseCollectorWarn

", 3600);

Seconds Warning > presetvalue orobservedmaximum(default)

CollectionStatus

117 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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 > DatabaseBackup Volume History

Reports server database backup volume history for the last 7 days.

Configuration > Databases

Accesses the dialog for specifying which server databases are monitored by theTSM KM.By default, following server databases are monitored.

Type [default] to reset to the default configuration.

118Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_DATABASEIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMDatabaseBackupElapsed*

Set by TSMDatabaseCollector.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.

This parameter is only availablefor the server database (db).

Hours None Statistics

TSMDatabaseBufferRequestCount

Set by TSMDatabaseCollector.Displays the cumulative number ofrequests for database pages sincethe buffer pool was last reset (orsince the server was last started).

This parameter is only availablefor the server database (db).

Count None Statistics

TSMDatabaseCacheHitPercent*

Set by TSMDatabaseCollector.Displays (as a percentage of thetotal number of requests) thenumber of requests for a databasepages that are already in the bufferpool.

This parameter is only availablefor the server database (db)

Percentage(%)

None Statistics

119 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

TSMDatabaseCacheWaitPercent*

Set by TSMDatabaseCollector.Displays (as a percentage of thetotal number of requests) thenumber of requests for databasebuffer pool pages where no pagesare available, because all pages arein use.

This parameter is only availablefor the server database (db).

Percentage(%)

None Statistics

TSMDatabaseFSSpaceUsedPercent*

Set by TSMDatabaseCollector.Monitors the percentage of spaceused by the file system where thedatabase resides.If this parameter changes towarning or alarm state, the recoveryaction will trigger an event.

This parameter is only availablefor the server database (db).

Percentage(%)

Warning =95-98 Alarm > 98

Statistics

TSMDatabaseLogConsumedSize

Set by TSMDatabaseCollector.Displays the cumulativeconsumption of log space used bythe server since the last reset of this

parameter.

This parameter is only availablefor the server database (db).

Megabytes(MB)

None Statistics

TSMDatabaseLogPoolUsedPercent*

Set by TSMDatabaseCollector.Displays (as a percentage of allrecovery log buffer pool pages) thenumber of buffer pool pages used towrite changes to the recovery logafter a transaction is committed.

This parameter is only availablefor the server database (db).

Percentage(%)

None Statistics

TSMDatabaseLogPoolWaitPercent*

Set by TSMDatabaseCollector.Displays (as a percentage of allrecovery log buffer pool requests)the number of requests for bufferpool pages where no pages areavailable because all pages are in

use.

Percentage(%)

None Statistics

120Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

This parameter is only availablefor the server database (db).

TSMDatabasePoolHitPercent*

Set by TSMDatabaseCollector.Displays (as a percentage of thetotal number of requests) thenumber of requests for databasepages that are already in the bufferpool.

This parameter is onlyavailable for the serverdatabase (db).

Percentage(%)

None

TSMDatabaseReorgElapsed*

Set by TSMDatabaseCollector.Displays the elapsed time since thelast database reorganization. Thespecified 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.

This parameter is only availablefor the server database (db).

Hours None Statistics

TSMDatabaseSpaceAvailable

Set by TSMDatabaseCollector.Monitors the amount of assignedspace remaining available for useby the server database.

If this parameter changes towarning or alarm state, the recoveryaction will trigger an event.

The name of this parametershould not be confused with theTSM terminology "AvailableSpace" reported in the InfoBox,which is the total volume spacemade available to the serverdatabase.

Megabytes(MB)

Warning =2-5Alarm < 2

Availability

TSMDatabaseSpaceChanged

Set by TSMDatabaseCollector.Displays the database pages (inmegabytes) that have changed sincethe last backup.

Megabytes(MB)

None Statistics

121 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

This parameter is only availablefor the server database (db).

TSMDatabaseSpaceChangedPercent*

Set by TSMDatabaseCollector.Displays the percentage of databasepages that have changed since thelast backup.

This parameter is only availablefor the server database (db).

Percentage(%)

None Statistics

TSMDatabaseSpaceGrowthRate

Set by TSMDatabaseCollector.Displays the growth rate of thespace used by the server database.

Megabytesper second(MB/s)

None Statistics

TSMDatabaseSpaceMaxExtension

Set by TSMDatabaseCollector.Displays the maximum amount thedatabase can be extended by.

Megabytes(MB)

None Statistics

TSMDatabaseSpaceMaxReduction

Set by TSMDatabaseCollector.Displays the maximum amount thedatabase can be reduced by.

Megabytes(MB)

Warning =4-8Alarm < 4

Statistics

TSMDatabaseSpaceUsed

Set by TSMDatabaseCollector.Displays the amount of assignedspace used by the server database.

Megabytes(MB)

None Statistics

TSMDatabaseSpaceUsedPercent*

Set by TSMDatabaseCollector.Monitors the percentage of assignedspace used by the server database.If this parameter changes towarning or alarm state, the recoveryaction will trigger an event.

The total assigned space is theused space(TSMDatabaseSpaceUsed) plusthe available space(TSMDatabaseSpaceAvailable).

Percentage(%)

None Statistics

TSMDatabaseSummary Set by TSMDatabaseCollector.Summarizes the databaseinformation as reported bycommands executed by the datacollector.

n/a n/a n/a

For detailed information about Baselining and KPI, see Managing Baselines and Key Performance Indicators.

* Parameters marked with an asterisk are used by default when visualizing the corresponding monitor instance inTrueSight OM.

122Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

InfoBox

Name Description

Name Name of the Tivoli Storage Manager server database.

Description Description of the Tivoli Storage Manager server database.

Available Space Amount of space made available as volumes for the server database, inmegabytes.

Used Space Amount of space used for the server database, in megabytes.

Assigned Space Amount of the Available Space assigned as the server database, in megabytes.

Total Usable Pages Total number of pages available. This will always be a multiple of the AssignedSpace value, by a factor of 256 (1megabyte /256 pages).

Used Pages Total number of pages currently being used.

Percent Utilized Current utilization as a percentage of the Assigned Space.

Physical Volumes Number of database volumes and copies.

Last Backup Date & time that the server database was last backed up.

Last Reorg Date & time of the last TSM database reorganization.

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 > DatabaseVolumes

Reports information about server database volumes and volume copies.

Configuration > Database

Accesses the individual configuration for monitoring the selected server databaseinstance.This dialog allows the selected database instance to be enabled or disabled formonitoring by the TSM KM.

123 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_LOG_CONTAINERIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMLogDetails Set by TSMLogCollector. Displays alldata returned to the standard outfrom commands executed by thedata collector.

n/a n/a n/a

TSMLogCollectorExecTime

Inactive standard parametermonitors the collector executiontime. To activate this parameter,use the PSL below, and restart thePATROL Agent:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMLogCollectorExecTime",

1);

When activated it will run everyminute and trigger a warningwhen the collector runs for morethan the observed maximum time.This maximum time can beoverridden by a preset value(example: 3600 seconds), usingthe PSL below:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMLogCollectorWarn",

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.

124Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description

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

Menu Commands

Name Description

Reports > Activity LogMessages

Reports all Tivoli Storage Manager messages today (logged since midnight).

Configuration > Logs Accesses the dialog for specifying which log files are to be monitored by the TSMKM.By default, the following log files are monitored.

Type [default] to reset to the default configuration.

Configuration > LogsFilter

Accesses the global configuration of the filter for error expressions in monitoredlog file instances.By default, following error messages are looked for in each log file. If detected,they are added to appropriate text parameter:

Type [default] to reset to the default configuration.

Configuration > LogsScan Limit

Accesses the global configuration of the data scanning limit for monitored logfile instances.By default, the log collector only scans 500KBytes of new log data for eachmonitored log file during each data collection cycle. In addition, for TSM ActivityLog, a maximum of 5 hours of data will be queried, by default.

Configuration > LogsAlert Acknowledgement

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

125 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_LOGIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMLogAlarmCount* Set by TSMLogCollector. Monitorsthe number alarm messages set inthe parameter TSMLogAlarmText.

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

Count Alarm ≥ 1 Statistics

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

These alarm messages can beacknowledged automatically(default) or manually, dependingon the configuration in the KMcommand Configuration > Log(s)Alert Acknowledgement. Manualacknowledgement is availableunder the KM sub-menuAcknowledgement.

n/a None n/a

TSMLogFSSpaceUsedPercent*

Set by TSMLogCollector. 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.

This parameter is not availablefor the activity log (actlog).

Percentage(%)

Warning =95-98Alarm > 98

Statistics

126Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

TSMLogSpaceAvailable Set by TSMLogCollector. 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 an

event.

This parameter is not availablefor the activity log (actlog).

Megabytes(MB)

Warning =2-5Alarm < 2

Availability

TSMLogSpaceGrowthRate

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

This parameter is not availablefor the activity log (actlog).

Kilobytesper second(KB/s)

None Statistics

TSMLogSpaceUsed Set by TSMLogCollector. Displaysthe amount of space used by thelog file.

This parameter is not availablefor the activity log (actlog).

Kilobytes(KB)

None Statistics

TSMLogSpaceUsedPercent*

Set by TSMLogCollector. Monitorsthe percentage of capacity used bythe log file.If this parameter changes towarning or alarm state, therecovery action will trigger anevent.

The total capacity is the usedspace (TSMLogSpaceUsed)plus available space(TSMLogSpaceAvailable). This parameter is not availablefor the activity log (actlog).

Percentage(%)

Warning =95-98Alarm > 98

Statistics

TSMLogSummary Set by TSMLogCollector.Summarizes the log fileinformation as reported bycommands executed by the datacollector

n/a n/a n/a

127 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

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

n/a n/a n/a

TSMLogWarningCount* Set by TSMLogCollector. Monitorsthe number warning messages setin the parameter TSMLogWarningText.If this parameter changes to awarning state, the recovery actionwill trigger an event

Count Warning > 1 Statistics

TSMLogWarningText Set by TSMLogCollector. Displaysall warning messages in the logfile which have not beenacknowledged. The filter used bythe data collector to determinewarning messages can becustomized using the KMcommand Configuration > Log(s)Filter.

These warning messages can beacknowledged automatically(default) or manually, dependingon the configuration in the KMcommand Configuration > Log(s)Alert Acknowledgement. Manualacknowledgement is availableunder the KM sub-menuAcknowledgement

n/a n/a n/a

For detailed information about Baselining and KPI, see Managing Baselines and Key Performance Indicators.

* Parameters marked with an asterisk are used by default when visualizing the corresponding monitor instance inTrueSight OM.

128Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

InfoBox

Name Description

Name Name of the Tivoli Storage Manager log file.

Description Description of the Tivoli Storage Manager log file.

Path Name of the table that holds information about the server activity log (actlog) orthe full file path of the log file.

Log File ModificationTime

Date & time when the log file was last modified. Not applicable for activity log(actlog).

Log File Size File size of the log file. Not applicable for activity log (actlog).

Total FS Space Total space used by the file system. Not applicable for activity log (actlog).

Available FS Space Space available for use by the file system. Not applicable for activity log(actlog).

FS Percent Used Percentage of the total file system space used. Not applicable for activity log(actlog).

Last Purge Date & time when the log file was last purged. Not applicable for activity log(actlog).

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

129 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Menu Commands

Function Description

Acknowledgement > Warnings

Allows acknowledgement of warning alerts on the selected log file instance.This dialog allows selective acknowledgement of "suspicious" error messagesdetected in the log file and sent to the text parameter TSMLogWarningText.

Acknowledgement > Alarms

Allows acknowledgement of alarm alerts on the selected log file instance.This dialog allows selective acknowledgement of "failure" error messagesdetected in the log file and sent to the text parameter TSMLogAlarmText.

Acknowledgement > All Allows acknowledgement of all warning and alarm alerts on the selected log fileinstance.This dialog allows acknowledgement of all error messages detected in the logfile and sent to the text parameter TSMLogWarningText or TSMLogAlarmText.

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

Configuration > LogFilter

Accesses the individual configuration of the log error filter for the selected logfile instance.By default, the global log error filter is used, as configured at the container levelType "[default]" to reset to the log filter configured at the global/container level.

Configuration > LogScan 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 > LogAlert Acknowledgement

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.

130Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_POLICY_CONTAINERIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMDomainCollectorExecTime

Inactive standard parametermonitors the collector executiontime. To activate this parameter,use the PSL below, and restartthe PATROL Agent:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMDomainCollectorExecTi

me", 1);

When activated it will run everyminute and trigger a warningwhen the collector runs for morethan the observed maximumtime. This maximum time can beoverridden by a preset value(example: 3600 seconds), usingthe PSL below:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMDomainCollectorWarn",

3600);

Seconds Warning > presetvalue orobservedmaximum(default)

CollectionStatus

TSMDomainDetails Set by TSMPolicyCollector. Displaysall data returned to the standardout from commands executed bythe data collector.

n/a n/a n/a

131 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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 > Domains

Accesses the dialog for specifying which domains are to be monitored by theTSM KM.By default, all domains configured on the server are monitored.Type [default] to reset to the default configuration.

Configuration > Domains BackupRestriction

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

Configuration > Domains Status

Accesses the global configuration for determining the domain status for allmonitored domain instances.By default, the following TSMDomainState to TSMDomainStatus mapping rule isused:

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

Configuration >ClientNodes

Accesses the dialog for specifying which client nodes of the selected domain areto be monitored by the KM.By default, all client nodes of enabled domains are monitored. Type [default]toreset to the default configuration.

132Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_POLICYIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMDomainBackupElapsed*

Set by TSMDomainCollector.Displays the elapsed time since thelast backup for this domain,regardless of completion status ofthe backup. This last backup isdetermined from the monitored jobsas configured in the KM command Configuration > Jobs from the Jobsicon.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, therecovery action will trigger anevent.

Hours None Statistics

TSMDomainBackupSummary

Set by TSMDomainCollector.Summarizes the last backup for thisdomain.

n/a n/a n/a

TSMDomainBackupThroughput*

Set by TSMDomainCollector.Displays the throughput of the lastsuccessful backup for this domain.

Gigabytesper second(GB/s)

None Statistics

TSMDomainFullBackupDuration

Set by TSMDomainCollector.Displays the duration of the lastsuccessful full backup for thisdomain.

Seconds None Statistics

TSMDomainFullBackupElapsed*

Set by TSMDomainCollector.Displays the elapsed time since thelast successful full backup for thisdomain. This last backup isdetermined from the monitored jobsas configured in the KM command Configuration > Jobs from the Jobsicon.

Hours None Statistics

133 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

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, therecovery action will trigger anevent.

TSMDomainFullBackupObjectCount

Set by TSMDomainCollector.Displays the number of objectsbacked up in the last successful fullbackup for this domain.

Count None Statistics

TSMDomainFullBackupSize

Set by TSMDomainCollector.Displays the size of the lastsuccessful full backup for thisdomain.

Gigabytes(GB)

None Statistics

TSMDomainIncrBackupDuration

Set by TSMDomainCollector.Displays the duration of the lastsuccessful incremental backup forthis domain.

Seconds None Statistics

TSMDomainIncrBackupElapsed*

Set by TSMDomainCollector.Displays the elapsed time since thelast successful incremental backupfor this domain. This last backup isdetermined from the monitored jobsas configured in the KM command Configuration > Jobs from the Jobsicon.

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, therecovery action will trigger anevent.

Hours None Statistics

TSMDomainIncrBackupObjectCount

Set by TSMDomainCollector.Displays the number of objectsbacked up in the last successfulincremental backup for thisdomain.

Count None Statistics

TSMDomainIncrBackupSize

Set by TSMDomainCollector.Displays the size of the lastsuccessful incremental backup forthis domain.

Gigabytes(GB)

None Statistics

134Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

TSMDomainState Set by TSMDomainCollector.Displays the state of the domain.If a backup restriction window isdefined in the KM commandConfiguration > Domain(s) BackupRestriction, this parameter will beset to Running in RestrictedWindow if there is any activityduring the specified period.

0 = Idle1 =Running2 =Running inRestrictedWindow3 = NotStarted4 =Inactive-1 =Unknown

None Availability

TSMDomainStatus Set by TSMDomainCollector.Monitors the status of the domain.This status is determined by thedomain status mapping ruledefined in the KM command Configuration > Domain(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

None Availability

TSMDomainSuccBackupElapsed*

Set by TSMDomainCollector.Displays the elapsed time since thelast successful backup for thisdomain. This last backup isdetermined from the monitored jobsas configured in the KM command Configuration > Jobs from the Jobsicon.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, therecovery action will trigger anevent.

Hours None Statistics

TSMDomainSummary Set by TSMDomainCollector.Summarizes the domaininformation as reported bycommands executed by the datacollector.

n/a n/a n/a

For detailed information about Baselining and KPI, see Managing Baselines and Key Performance Indicators.

* Parameters marked with an asterisk are used by default when visualizing the corresponding monitor instance inTrueSight OM.

135 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

InfoBox

Name Description

Name Name of the Tivoli Storage Manager domain.

Description Description of the Tivoli Storage Manager domain.

Activated Policy Set Name of the policy set that was last activated in the domain.

Activation Date/Time Date & Time when the policy set was activated.

Activated DefaultManagement Class

Assigned default management class for the policy set.

Number of RegisteredNodes

Number of client nodes registered to the policy domain.

Backup Retention Number of days to retain inactive backup versions of files.

Archive Retention Number of days to retain an archive file.

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

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

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

Last Backup Status Status of the last backup job for the domain.

Last Backup Job Name of the last backup for the domain.

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

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

Last Full Backup Job Name of the last successful full backup for the domain.

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

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

Last Incr Backup Job Name of the last successful incremental backup for the domain.

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

Next Backup ScheduleName

Name of schedule to be used during the next backup job.

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

136Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Menu Commands

Function Description

Reports > DomainSchedule

Displays the schedule for the selected domain instance for the next 24 hours.

Configuration > Domain Accesses the individual configuration for monitoring the selected domaininstance.This dialog allows the selected domain instance to be enabled or disabled formonitoring by the TSM KM.

Configuration > DomainBackup Restriction

Accesses the individual configuration for the backup restriction window forthe selected domain instance.

By default, the global backup restriction window setting is used, as configuredat the container level.

Configuration > DomainStatus

Accesses the individual configuration for determining domain status for theselected domain instance.By default, the global TSMDomainState to TSMDomainStatus mapping rule isused, as configured at the container level. Select [default] to revert to thedomain status mapping rule configured at the global/ container level.

Configuration > ClientNodes

Accesses the dialog for specifying which client nodes of the selected domain areto be monitored by the TSM KM.By default, all client nodes of enabled domains are monitored. Type [default] toreset to the default configuration.

137 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_PCLIENTIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMNodeBackupSummary

Set by TSMDomainCollector.Summarizes the last backup for thisclient node.

n/a n/a n/a

TSMNodeBackupThroughput*

Set by TSMDomainCollector.Displays the throughput of the lastsuccessful backup for this clientnode.

Megabytespersecond(MB/s)

None Statistics

TSMNodeFullBackupDuration

Set by TSMDomainCollector.Displays the duration of the lastsuccessful full backup for this clientnode.

Seconds None Statistics

TSMNodeFullBackupObjectCount

Set by TSMDomainCollector.Displays the number of objectsbacked up in the last successful fullbackup for this client node.

Count None Statistics

TSMNodeFullBackupSize*

Set by TSMDomainCollector.Displays the size of the lastsuccessful full backup for this clientnode.

Megabytes(MB)

None Statistics

TSMNodeIncrBackupDuration

Set by TSMDomainCollector.Displays the duration of the lastsuccessful incremental backup forthis client node.

Seconds None Statistics

TSMNodeIncrBackupObjectCount

Set by TSMDomainCollector.Displays the number of objectsbacked up in the last successfulincremental backup for this clientnode.

Count None Statistics

TSMNodeIncrBackupSize*

Set by TSMDomainCollector.Displays the size of the lastsuccessful incremental backup forthis client node.

Megabytes(MB)

None Statistics

138Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

TSMNodeSummary Set by TSMDomainCollector.Summarizes the client nodeinformation as reported bycommands executed by the datacollector.

n/a n/a n/a

TSMObjectExcludeList Set by TSMDomainCollector. Lists allobjects and file systems excludedfrom backup for this client node.

n/a n/a n/a

TSMObjectIncludeList Set by TSMDomainCollector. Lists allobjects and file systems includedfor backup for this client node.

n/a n/a n/a

For detailed information about Baselining and KPI, see Managing Baselines and Key Performance Indicators.

* Parameters marked with an asterisk are used by default when visualizing the corresponding monitor instance inTrueSight OM.

InfoBox

Name Description

Name Host name of the Tivoli Storage Manager client node.

Description Description of the Tivoli Storage Manager client node.

Domain Name Name of the domain that the client belongs to.

Operating System Operating system of the client node.

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

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

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

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

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

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

Last Full Backup Job Name of the last successful full backup of the client node.

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

Last Incr Backup EndTime

Date & time at the completion of the last successful incremental backup for theclient node.

Last Incr Backup Job Name of the last successful incremental backup of the client node.

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

139 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description

Next Backup ScheduleName

Name of schedule to be used during the next backup job.

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 > ClientNode

Accesses the individual configuration for monitoring the selected client nodeinstance.This dialog allows the selected client node instance to be enabled or disabledfor monitoring by the TSM KM.

140Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_JOB_CONTAINERIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMJobActiveBackupCount*

Set by TSMJobCollector. Displays thenumber of active backup jobscurrently discovered and monitored.

count none Statistics

TSMJobActiveCount* Set by TSMJobCollector. Displays thenumber of active jobs currentlydiscovered and monitored.

count none Statistics

TSMJobActiveNonBackupCount*

Set by TSMJobCollector. Displays thenumber of active non-backup jobscurrently discovered and monitored.

count none Statistics

TSMJobCollectorExecTime

Inactive standard parametermonitors the collector executiontime. To activate this parameter,use the PSL below, and restart thePATROL Agent:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMJobCollectorExecTime",

1);

When activated it will run everyminute and trigger a warningwhen the collector runs for morethan the observed maximum time.This maximum time can beoverridden by a preset value(example: 3600 seconds), usingthe PSL below:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMJobCollectorWarn",

3600);

Seconds Warning > presetvalue orobservedmaximum(default)

CollectionStatus

TSMJobDetails Set by TSMJobCollector. Displays alldata returned to the standard outfrom commands executed by thedata collector.

n/a n/a n/a

For detailed information about Baselining and KPI, see Managing Baselines and Key Performance Indicators.

141 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

* Parameters marked with an asterisk are used by default when visualizing the corresponding monitor instance inTrueSight OM.

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

142Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Menu Commands

KM Command Action

Force Full Collection Allows the user to force the data collector for jobs to perform a full discoveryduring the next collection cycle.

Acknowledgement > Warnings

Allows acknowledgement of warning alerts occurring on any monitored jobinstance.This dialog allows acknowledgement of any job in a "suspicious" state (whichsets the parameter TSMJobStatus to Warning).

Acknowledgement > Alarms

Allows acknowledgement of alarms occurring on any monitored job instance.This dialog allows acknowledgement of any job in a "failure" state (which setsthe parameter TSMJobStatus to Alarm).

Acknowledgement > All Allows acknowledgement of all warnings and alarms occurring on anymonitored job instance.This dialog allows acknowledgement of any job in a "suspicious" or "failure"state (which sets the parameter TSMJobStatus to Warning or Alarm,respectively).

Configuration> Jobs Accesses the dialog for specifying which jobs are to be monitored by the TSMKM.By default, all scheduled jobs on the server are monitored according to thefollowing conditions:

The age of a job is calculated from the job start time. The status of a job isdetermined by the state of the job (from the parameter TSMJobState) and the jobstatus mapping rule, described below.

Configuration> JobsStatus

Accesses the configuration for determining the status for all monitored jobinstances.By default, the following TSMJobState to TSMJobStatus mapping rule is used:

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

Configuration> JobsAlert Acknowledgement

Accesses the global configuration of the method of acknowledgement for alertson monitored job instances.By default, the job alerts are manually acknowledged. Using this menu you canchange this so the job collector automatically acknowledges previous job alerts(warnings or alarms) when it detects new errors.Refer to the User Guide for Tivoli Storage Manager KM for PATROL for moredetails.

143 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_JOBIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMJobDuration Set by TSMJobCollector. Displaysthe duration of the job from thestart.

Seconds None Statistics

TSMJobErrorCount* Set by TSMJobCollector. Monitorsthe number of client node errorslogged in the server activity logduring this job.

The default settings for thisparameter dictate that whenany error is detected during ajob, this parameter is alwaysset to warning state. And therecovery action will trigger anevent.

Count Warningwhen > 100

Statistics

TSMJobNetworkThroughput*

Set by TSMJobCollector. Displaysthe throughput of the job on thenetwork.

Megabytesper second(MB/s)

None Statistics

TSMJobSize Set by TSMJobCollector. Displaysthe amount of data backed up forthe job.

Megabytes(MB)

None Statistics

144Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

TSMJobState Set by TSMJobCollector. Displaysthe state of the job. This isdetermined using the event statusand result of the event.

0 =Completed1 = Future2 =Pending3 = InProgress4 = Started5 =Restarted6 =Completed/Errors7 =Started/Errors8 =Restarted/Errors9 = Failed -No Restart10 =Missed11 =Severed12 =Uncertain13 = Failed-1 =Unknown

None Availability

TSMJobStatus Set by TSMJobCollector. Monitorsthe status of the job. This status isdetermined by the job statusmapping rule defined in the KMcommand Configuration > JobsStatus.If this status parameter changes towarning or alarm state, therecovery action will trigger anevent and annotate the last datapoint.

0 = OK1 =Suspicious2 = Failure

Warning = 1Alarm = 2

Availability

TSMJobSummary Set by TSMJobCollector.Summarizes the job information asreported by commands executed bythe data collector.

n/a None n/a

TSMJobText Set by TSMJobCollector. Displaysall reported messages related tothis job.

n/a None n/a

TSMJobThroughput* Set by TSMJobCollector. Displaysthe throughput of the job.

Megabytesper second(MB/s)

None Statistics

145 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

TSMObjectCount Set by TSMJobCollector. Displaysthe number of objects inspected forthis job.

Count None Statistics

TSMObjectExpiredCount

Set by TSMJobCollector. Displaysthe total number of objects for thisjob that have expired.

Count None Statistics

TSMObjectFailedCount

Set by TSMJobCollector. Displaysthe total number of objects for thisjob that have failed.If this parameter changes to awarning state, the recovery actionwill trigger an event.

Count Warningwhen > 100

Statistics

TSMObjectProcessedCount

Set by TSMJobCollector. Displaysthe total number of objects for thisjob that have been processed.

Count None Statistics

TSMObjectReboundCount

Set by TSMJobCollector. Displaysthe total number of objects for thisjob that have been rebound.

Count None Statistics

TSMObjectUpdatedCount

Set by TSMJobCollector. Displaysthe total number of objects for thisjob that have been updated.

Count None Statistics

For detailed information about Baselining and KPI, see Managing Baselines and Key Performance Indicators.

* Parameters marked with an asterisk are used by default when visualizing the corresponding monitor instance inTrueSight OM.

InfoBox

Name Description

Job Identifier assigned to the job by TSM KM (<Domain Name>:<Client Node Name>@ <Job Start Time>).

Type Type of the job.

Mode Mode of the job (such as Incremental or Full).

Schedule Name of the schedule used by the job.

Action Action performed by the schedule.

Status Status of the job as determined by the TSM KM.

Event Status Status of the event.

Result Result of the event.

Reason Additional text depending on the Event Status and Result.

Domain Name Name of the domain this job is assigned to.

Node Name Name of the client node this job is assigned to.

146Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description

Scheduled Start Date & time that the job was scheduled to start.

Actual Start Date & time that the job actually started.

Completed Date & time at the completion of the job.

Processing Time Duration of the job.

Size Amount of data that has been written.

Objects Inspected Total number of objects inspected for this job.

Objects Processed Total number of objects for this job that have been processed.

Objects Updated Total number of objects for this job that have been updated.

Objects Rebound Total number of objects for this job that have been rebound.

Objects Deleted Total number of objects for this job that have been deleted.

Objects Expired Total number of objects for this job that have expired.

Objects Failed Total number of objects for this job that have failed.

Objects Compression Percentage of compression achieved by the job.

Data Transfer Time Time taken for the data transfer.

Network Data TransferRate

Rate of data transfer on the network.

Aggregate Data TransferRate

Aggregated rate of data transfer.

Percent Completed Estimated percentage of the job that has been completed in comparison with thelast similar successful job for the same domain, client node, and mode.

Time Remaining Remaining time of the job in comparison with the last similar successful job.

Session Numbers List of sessions opened on the client node by the job (sessions are listed bynumber).

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

Last Backup End Date & time when the last similar successful backup ended.

Last Backup Job Job ID of the last similar successful backup.

Last Backup Duration Duration of the last similar successful backup.

Last Backup Size Data size written by the last similar successful backup.

Last Backup Objects Number of objects 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).

147 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Menu Commands

Function Description

Acknowledgement > Alert

Allows acknowledgement of all warnings and alarms occurring on the selectedjob instance.This dialog allows acknowledgement if the selected job instance is in a"suspicious" or "failure" state (which sets the parameter TSMJobStatus toWarning or Alarm, respectively).

148Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_MOUNT_CONTAINERIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMRequestDetails Set by TSMRequestCollector.Displays all data returned to thestandard out from commandsexecuted by the data collector.

n/a n/a n/a

TSMRequestCollectorExecTime

Inactive standard parametermonitors the collector executiontime. To activate this parameter,use the PSL below, and restart thePATROL Agent:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMRequestCollectorExecT

ime", 1);

When activated it will run everyminute and trigger a warningwhen the collector runs for morethan the observed maximumtime. This maximum time can beoverridden by a preset value(example: 3600 seconds), usingthe PSL below:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMRequestCollectorWarn"

, 3600);

Seconds Warning > presetvalue orobservedmaximum(default)

CollectionStatus

149 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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

Administration > CancelAll

Assigns all current mount requests to be canceled.

Reports > PendingMount Requests

Reports a list of all pending mount requests.

Configuration > MountRequests

Accesses the dialog for specifying which mount requests are to be monitored bythe TSM KM.By default, all mount requests are monitored for 1 day from the time they areissued.

Configuration > MountRequests Status

Accesses the configuration for determining the status for all monitored mountrequest instances.By default, the following TSMRequestState to TSMRequestStatus mapping rule isused:

Select [default] to reset to the default mount request status mapping rule.

150Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_MOUNTIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMRequestElapsed* Set by TSMRequestCollector.Displays the elapsed time sincethe mount request was issued.

Minutes None Statistics

TSMRequestState Set by TSMRequestCollector.Displays the state of the mountrequest as reported in thecommand executed by the datacollector.

0 =Completed1 = Pending-1 = Unknown

None Availability

TSMRequestStatus Set by TSMRequestCollector.Monitors the status of the mountrequest. This status is determinedby the mount request statusmapping rule defined in the KMcommand Configuration > MountRequest(s) Status.

If this status parameter changesto warning or alarm state, therecovery action will trigger anevent and annotate the last datapoint.

0 = OK1 =Suspicious2 = Failure

Warning = 1Alarm = 2

Availability

TSMRequestSummary Set by TSMRequestCollector.Summarizes the mount requestinformation as reported bycommands executed by the datacollector.

n/a n/a

TSMRequestTimeout* Set by TSMRequestCollector.Displays the time remaining untilthe mount request times out.If the alert state changes to alarmstate, the recovery action willtrigger an event.

Minutes Alarm = 0-30

Statistics

For detailed information about Baselining and KPI, see Managing Baselines and Key Performance Indicators.

151 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

* Parameters marked with an asterisk are used by default when visualizing the corresponding monitor instance inTrueSight OM.

InfoBox

Name Description

Request ID Identifier assigned to the mount request by Tivoli Storage Manager.

Description Full detail of the mount request.

Job Type Type of job the mount request belongs to (Backup or Restore).

Mode Mode of the mount request (Read, Write or both).

Volume Requested volume name.

Volume Type Type of the requested volume.

Drive Name Name of the drive the mount request is assigned to.

Library Name Name of the library the mount request is assigned to.

Server Name Name of the server or storage agent the library is connected to.

Request Time Date & time that the mount request was detected.

Request Timeout Time remaining until the mount request times out.

Reply Required Whether a reply is required for the mount request (Yes or No).

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

Administration > Reply Allows a reply to be sent for the selected mount request once a requested actionhas been taken.A reply may be required to allow this mount request to continue processing. Thisrequirement is noted in the in the InfoBox item "Reply Required".

Administration > Cancel

Allows the selected mount request to be cancelled.

152Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_LIBRARY_CONTAINERIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMLibraryCollectorExecTime

Inactive standard parametermonitors the collector executiontime. To activate this parameter,use the PSL below, and restart thePATROL Agent:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMLibraryCollectorExecT

ime", 1);

When activated it will run everyminute and trigger a warningwhen the collector runs for morethan the observed maximum time.This maximum time can beoverridden by a preset value(example: 3600 seconds), usingthe PSL below:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMLibraryCollectorWarn"

, 3600);

Seconds Warning > presetvalue orobservedmaximum(default)

CollectionStatus

TSMLibraryDetails Set by TSMLibraryCollector.Displays all data returned to thestandard out from commandsexecuted by the data collector.

n/a n/a n/a

153 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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 > Automated Libraries

Accesses the dialog for specifying which automated libraries are to be monitoredby the TSM KM.By default, all local and remote automated libraries are monitored for a serverand all local automated libraries are monitored for a storage agent. Type [default] to reset to the default configuration.

Configuration > Automated LibrariesStatus

Accesses the global configuration for determining the status for monitoredautomated library instances.By default, the following TSMLibraryState to TSMLibraryStatus mapping rule isused:

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

Configuration > Automated LibraryDrives Status

Accesses the dialog for specifying which drives of the selected automated libraryare to be monitored by the KM. By default, all automated library drives aremonitored.

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

154Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_LIBRARYIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMLibraryState Set by TSMLibraryCollector.Displays whether the path for theautomated library is online oroffline. It will not perform anyremote automated library testcommand on the storage agent.

0 = Online1 = Offline2 = PathOffline-1 =Unknown

None Availability

TSMLibraryStatus Set by TSMLibraryCollector.Monitors the status of theautomated library. This status isdetermined by the automatedlibrary status mapping ruledefined in the KM command Configuration > Automated Library(Libraries) 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

TSMLibrarySummary Set by TSMLibraryCollector.Summarizes the automated libraryinformation as reported bycommands executed by the datacollector.

n/a n/a n/a

TSMLibraryUpDriveCount

Set by TSMLibraryCollector.Displays the number up / onlinestate drives in this robotic library.

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

Count None Statistics

TSMLibraryVolumeCount

Set by TSMLibraryCollector.Displays the total number ofvolume loaded in this automatedlibrary.

Count None Statistics

155 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

TSMLibraryVolumePrivateCount

Set by TSMLibraryCollector.Displays the number of privatevolumes in the automated library.

Count None Statistics

TSMLibraryVolumeScratchCount

Set by TSMLibraryCollector.Displays the number of scratchvolumes in the automated library.

Count None Statistics

TSMLibraryVolumeScratchPercent*

Set by TSMLibraryCollector.Monitors the percentage ofscratch volume against the totalnumber of volume loaded in thisautomated library.If this parameter changes towarning or alarm state, therecovery action will trigger anevent.

Percentage(%)

None Statistics

For detailed information about Baselining and KPI, see Managing Baselines and Key Performance Indicators.

* Parameters marked with an asterisk are used by default when visualizing the corresponding monitor instance inTrueSight OM.

InfoBox

Name Description

Name Name of the automated library.

Description Description of the automated library.

Device Device path of the automated library.

Type Type of the automated library.

Server Name Name of the remote host where the automated library is connected.

Node Name Name of the node that the automated library is assigned to.

External Manager Name of the external server responsible for controlling access to libraryresources.

Primary LibraryManager

Name of the server responsible for controlling access to library resources.

Path Online Whether the path for the automated library is online and available for use (Yesor No).

Status Status of the automated library as determined by the TSM KM.

Shared Whether this library is shared with other servers in a storage area network(SAN).

Lan Free Whether an external library is used for LAN-free operations.

Obey Mount Retention Whether the server uses the value set for mount retention in the device classassociated with this external library.

156Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description

Serial Number Serial number of the automated library.

World Wide Name World Wide Name of the port the automated library is attached to.

ACS Id Number of this STK library assigned by the ACSSA (Automatic Cartridge System,System Administrator). This can be a number from 1 to 64.

Private Category Category number for private volumes.

Scratch Category Category number for scratch volumes.

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 > AutomatedLibrary Contents

Reports the library volume contents of the selected automated library instance.

Configuration > Automated Library

Accesses the individual configuration for monitoring the selected automatedlibrary instance.This dialog allows the selected automated library instance to be enabled ordisabled for monitoring by the TSM KM.

Configuration > Automated LibraryStatus

Accesses the individual configuration for determining the status for the selectedautomated library instance.By default, the global TSMLibraryState to TSMLibraryStatus mapping rule is used,as configured at the container level. Select [default] to revert to the library statusmapping rule configured at the global/container level.

Configuration > Automated LibraryDrives

Accesses the dialog for specifying which drives of the selected automated libraryare to be monitored by the TSM KM.By default, all automated library drives are monitored.

Configuration > Automated LibraryDrives Status

Accesses the configuration for determining status for monitored drive instanceson the selected automated library instance.By default, the global TSMLDriveState to TSMLDriveStatus mapping rule is used,as configured at the container level. Select [default] to revert to the drive statusmapping rule configured at the global/container level.

157 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_LDEVICEIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMLDriveState Set by TSMLibraryCollector. Displaysthe state of the automated librarydrive. This is determined from theautomated library drive controlinformation.

0 = Online1 = Empty2 = Loaded3 =Unloaded4 =Reserved5 =Unavailable6 = DriveOffline7 = PathOffline-1 =Unknown

None Availability

TSMLDriveStatus Set by TSMLibraryCollector.Monitors the status of theautomated library drive. This statusis determined by the automatedlibrary drive status mapping ruledefined in the KM command Configuration > Automated LibraryDrive(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

TSMLDriveSummary Set by TSMLibraryCollector.Summarizes the automated librarydrive information as reported bycommands executed by the datacollector.

n/a n/a n/a

InfoBox

158Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description

Name Name of the automated library drive.

Description Description of the drive.

Device Device path of the drive.

Type Volume type used in the drive.

Server Name Name of the remote host where the drive is connected.

Node Name Name of the node that the drive is assigned to.

External Manager Name of the external server responsible for controlling access to drive resources.

Library Name Name of the automated library the drive is assigned to.

Drive Online Whether the drive is available for use. (Yes or No)

Path Online Whether the path for the drive is online and available for use (Yes or No).

Element Location of the element address of the drive within a SCSI library. The server usesthe element address to connect the physical location of the drive to SCSI addressof the drive.

Status Status of the drive as determined by the TSM KM.

Allocated To The name of the library client currently using the drive.

Serial Number Serial number of the drive.

World Wide Name World Wide Name of the port the drive is attached to.

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

159 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Menu Commands

Function Description

Administration > CleanDrive

Allows the selected automated library drive to be cleaned.

Administration > Online Drive

Allows the selected automated library drive to be brought online.

Administration > Offline Drive

Allows the selected automated library drive to be taken offline.

Configuration > Automated LibraryDrive

Accesses the individual configuration for monitoring the selected automatedlibrary drive instance.This dialog allows the selected drive instance to be enabled or disabled formonitoring by the TSM KM.

Configuration > Automated LibraryDrive Status

Accesses the individual configuration for determining the drive status for theselected automated library drive instance.By default, the TSMLDriveState to TSMLDriveStatus mapping rule configured atthe parent level is used. (Note that if the mapping rule has not been modified forthe parent automated library, then the default is the global mapping ruleconfigured at the container level.) Select [default] to revert to the drive statusmapping rule configured at the parent instance level.

160Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_DEVICE_CONTAINERIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMDriveCollectorExecTime

Inactive standard parametermonitors the collector executiontime. To activate this parameter,use the PSL below, and restart thePATROL Agent:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMDriveCollectorExecTime

", 1);

When activated it will run everyminute and trigger a warningwhen the collector runs for morethan the observed maximum time.This maximum time can beoverridden by a preset value(example: 3600 seconds), usingthe PSL below:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMDriveCollectorWarn",

3600);

Seconds Warning > presetvalue orobservedmaximum(default)

CollectionStatus

TSMDriveDetails Set by TSMDeviceCollector. Displaysall data returned to standard outfrom commands executed by thedata collector.

n/a n/a n/a

161 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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 > ManualDrives

Accesses the dialog for specifying which manual drives are to be monitored bythe TSM KM.By default, all local and remote manual drives are monitored for a server and alllocal manual drives are monitored for a storage agent. Type [default] to reset tothe default configuration.

Configuration > ManualDrives Status

Accesses the global configuration for determining the status for monitoredmanual drive instances.By default, the following TSMDriveState to TSMDriveStatus mapping rule is used:

Select [default] to reset to the default manual drive status mapping rule.

162Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_DEVICEIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMDriveState Set by TSMDriveCollector. Displaysthe state of the manual drive. Thisis determined from the manualdrive control information.

0 = Online1 = Empty2 = Loaded3 =Unloaded4 =Reserved5 =Unavailable6 = DriveOffline7 = PathOffline-1=Unknown

None Availability

TSMDriveStatus Set by TSMDriveCollector. Monitorsthe status of the manual drive. Thisstatus is determined by the manualdrive status mapping rule definedin the KM command Configuration >Manual Drive(s) Status.

If this status parameter changes towarning or alarm state, therecovery action will trigger anevent and annotate the last datapoint.

0 = OK1 =Suspicious2 = Failure

Warning = 1Alarm = 2

Availability

TSMDriveSummary Set by TSMDriveCollector.Summarizes the manual driveinformation as reported bycommands executed by the datacollector.

n/a n/a n/a

163 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

InfoBox

Name Description

Name Name of the manual drive.

Description Description of the drive.

Device Device path of the drive.

Type Volume type used in the drive.

Server Name Name of the remote host where the drive is connected.

Node Name Name of the node that the drive is assigned to.

External Manager Name of the external server responsible for controlling access to driveresources.

Library Name Name of the manual library the drive is assigned to.

Drive Online Whether the drive is available for use. (Yes or No)

Path Online Whether the path for the drive is online and available for use (Yes or No).

Element Location of the element address of the drive within a SCSI library. The serveruses the element address to connect the physical location of the drive to SCSIaddress of the drive.

Status Status of the drive as determined by the TSM KM.

Allocated To The name of the library client currently using the drive.

Serial Number Serial number of the drive.

World Wide Name World Wide Name of the port the drive is attached to.

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

164Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Menu Commands

Function Description

Administration > CleanDrive

Allows the selected manual library drive to be cleaned.

Administration > OnlineDrive

Allows the selected manual library drive to be brought online.

Administration > Offline Drive

Allows the selected manual library drive to be taken offline.

Configuration > ManualDrive

Accesses the individual configuration for monitoring the selected manual driveinstance.This dialog allows the selected manual drive instance to be enabled or disabledfor monitoring by the TSM KM.

Configuration > ManualDrive Status

Accesses the individual configuration for determining the manual drive statusfor the selected manual drive instance.By default, the global TSMDriveState to TSMDriveStatus mapping rule is used, asconfigured at the container level. Select [default] to revert to the drive statusmapping rule configured at the global/container level.

165 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_POOL_CONTAINERIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMPoolDetails Set by TSMPoolCollector. Displaysall data returned to the standardout from commands executed by thedata collector.

n/a n/a n/a

TSMPoolCollectorExecTime

Inactive standard parametermonitors the collector executiontime. To activate this parameter,use the PSL below, and restart thePATROL Agent:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMPoolCollectorExecTime"

, 1);

When activated it will run everyminute and trigger a warningwhen the collector runs for morethan the observed maximum time.This maximum time can beoverridden by a preset value(example: 3600 seconds), usingthe PSL below:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMPoolCollectorWarn",

3600);

Seconds Warning > presetvalue orobservedmaximum(default)

CollectionStatus

166Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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 > VolumePools

Accesses the dialog for specifying which storage pools are to be monitored bythe TSM KM.By default, all storage pools configured on the server are monitored. Type"[default]" to reset to the default configuration.

167 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_POOLIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMPoolSpaceAvailable*

Set by TSMPoolCollector. Monitorsthe available volume space for thebackup data to use in this storagepool.

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

Gigabytes(GB)

Warning < 1Alarm = 0

Availability

TSMPoolSpaceGrowthRate

Set by TSMPoolCollector. Displaysthe growth rate of the total volumespace used by the backup data inthis storage pool.

Gigabytesper second(GB/s)

None Statistics

TSMPoolSpaceLogicalPercent*

Set by TSMPoolCollector. Displaysthe logical occupancy of thestorage pool as a percentage of thetotal occupancy.

Percentage(%)

None Statistics

TSMPoolSpaceMigrated*

Set by TSMPoolCollector. Displaysthe amount of data that has beenmigrated, if migration is inprogress. If migration is not inprogress, this value indicates theamount of data migrated during thelast migration.Note: This parameter is notavailable for copy storage pools.

Gigabytes(GB)

None Statistics

TSMPoolSpaceMigratedPercent*

Set by TSMPoolCollector. Displaysan estimate of the percentage ofdata in the storage pool that can bemigrated.Note: This parameter is notavailable for copy storage pools.

Percentage(%)

None Statistics

168Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

TSMPoolSpaceMigrationElapsed

Set by TSMPoolCollector. Displaysthe amount of time that haselapsed since migration of thestorage pool began, if migration isactive. If migration is not active,this value indicates the amount oftime required to complete the lastmigration.Note: This parameter is notavailable for copy storage pools.

Seconds None Statistics

TSMPoolSpaceReclaimable*

Set by TSMPoolCollector. Displaysthe amount of space in the storagepool that is reclaimable.

Gigabytes(GB)

None Statistics

TSMPoolSpaceReclaimablePercent*

Set by TSMPoolCollector. Displaysthe amount of reclaimable spaceas a percentage of the total storagepool space.

Percentage(%)

None Statistics

TSMPoolSpaceUsed* Set by TSMPoolCollector. Displaysthe total volume space occupied bythe backup data in this storagepool.

Gigabytes(GB)

None Statistics

TSMPoolSpaceUsedPercent*

Set by TSMPoolCollector. Monitorsthe percentage of total occupiedvolume space against the totalvolume capacity of this storagepool (not including any scratchvolumes).If this parameter changes towarning or alarm state, therecovery action will trigger anevent.

Percentage(%)

Warning > 95Alarm > 98

Statistics

TSMPoolSummary Set by TSMPoolCollector.Summarizes the storage poolinformation as reported bycommands executed by the datacollector.

n/a n/a n/a

TSMVolumeActiveCount

Set by TSMPoolCollector. Displaysthe number of active volumes inthis storage pool. (Active volumesare available disk volumes with astatus of "Online" or tape volumeswith a status of "Filling", wheredata has been written but thevolume is not yet full.)

Count None Statistics

TSMVolumeActivePercent*

Set by TSMPoolCollector. Monitorsthe percentage of active volumesagainst the total number ofvolumes in this storage pool.

Percentage(%)

None Statistics

169 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

If the status of the parameterchanges to warning or alarm state,the recovery action will trigger anevent.

TSMVolumeAvailableCount

Set by TSMPoolCollector. Displaysthe number of volumes assigned tothis storage pool.

Count None Statistics

TSMVolumeAvailablePercent*

Set by TSMPoolCollector. Monitorsthe percentage of availablevolumes against the total numberof volumes in this storage pool.If this parameter changes towarning or alarm state, therecovery action will trigger anevent.

Percentage(%)

None Statistics

TSMVolumeCount Set by TSMPoolCollector. Displaysthe total number of volumes in thisstorage pool.

Count None Statistics

TSMVolumeEmptyCount

Set by TSMPoolCollector. Displaysthe number of empty volumes inthis storage pool. ("Empty" is apossible status for a tape volume,indicating that no data is stored onthat volume)

Count None Statistics

TSMVolumeFullCount

Set by TSMPoolCollector. Displaysthe number of full volumes in thisstorage pool. ("Full" is a possiblestatus for a tape volume.)

Count None Statistics

TSMVolumeFullPercent*

Set by TSMPoolCollector. Monitorsthe percentage of full volumesagainst the total number ofvolumes in this storage pool.If this parameter changes towarning or alarm state, therecovery action will trigger anevent.

Percentage(%)

None Statistics

TSMVolumeOfflineCount

Set by TSMPoolCollector. Displaysthe number of offline volumes inthis storage pool. ("Offline" is apossible status for a disk volume.)

Count None Statistics

TSMVolumePendingCount

Set by TSMPoolCollector. Displaysthe number of pending volumes inthis storage pool. ("Pending" is apossible status for a tape volume,where all files have been deletedbut a delay has been placed on thevolume before reuse.)

Count None Statistics

For detailed information about Baselining and KPI, see Managing Baselines and Key Performance Indicators.

170Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

* Parameters marked with an asterisk are used by default when visualizing the corresponding monitor instance inTrueSight OM.

InfoBox

Name Description

Name Name of the storage pool.

Description Description of the storage pool.

Type Type of the storage pool

Device Class Name of the device class assigned to the storage pool.

Access How the data in the storage pool can be accessed.

Storage Pool DataFormat

Type of data format used to write data to this storage pool,For example: NATIVE or NETAPPDUMP.

Maximum ScratchVolumes

Maximum number of scratch volumes that the server can request for the storagepool. (Sequential access storage pools only.)

Migration In Progress Whether at least one migration process is active for the storage pool .

Reclamation InProgress

Whether a reclamation process is active for the storage pool.

Volume Being Migrated/Reclaimed

Name of a volume for which migration or reclamation processing is active. If nomigration or reclamation processes are active, this field displays as N/A.

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 selected storage pool, and their states.

Configuration > Storage Pool

Accesses the individual configuration for monitoring the selected storage poolinstance.This dialog allows the selected storage pool instance to be enabled or disabledfor monitoring by the TSM KM.

171 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_PROCESS_CONTAINERIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMProcessCollectorExecTime

Inactive standard parametermonitors the collector executiontime. To activate this parameter,use the PSL below, and restart thePATROL Agent:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMProcessCollectorExecT

ime", 1);

When activated it will run everyminute and trigger a warningwhen the collector runs for morethan the observed maximumtime. This maximum time can beoverridden by a preset value(example: 3600 seconds), usingthe PSL below:

%PSL pconfig("REPLACE",

"/Runtime/TSM/<node-id>/

TSMProcessCollectorWarn"

, 3600);

Seconds Warning > presetvalue orobservedmaximum(default)

CollectionStatus

TSMProcessDetails Set by TSMProcessCollector.Displays all data returned to thestandard out from commandsexecuted by the data collector.

n/a n/a n/a

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.

172Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description

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

Menu Commands

Function Description

Acknowledgement > Warnings

Allows acknowledgement of warning alerts occurring on any monitored processinstance.This dialog allows acknowledgement of any process in a "suspicious" state(which sets the parameter TSMProcessStatus to Warning).

Acknowledgement > Alarms

Allows acknowledgement of alarms occurring on any monitored processinstance.This dialog allows acknowledgement of any process in a "failure" state (whichsets the parameter TSMProcessStatus to Alarm).

Acknowledgement > All Allows acknowledgement of all warnings and alarms occurring on anymonitored process instance.This dialog allows acknowledgement of any process in a "suspicious" or"failure" state (which sets the parameter TSMProcessStatus to Warning or Alarm,respectively).

Reports > ActiveProcesses

Reports a list of all active processes on the managed node.

Configuration > Processes

Accesses the dialog for specifying which processes are to be monitored by theTSM KM.By default, all processes are monitored for 3 days. The age of a process iscalculated from the process start time.

Configuration > Processes Status

Accesses the configuration for determining the status for all monitored processinstances.By default, the following TSMProcessState to TSMProcessStatus mapping rule isused:

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

Configuration > Processes AlertAknowledgment

Accesses the dialog for configuring alert acknowledgment settings (manual orautomatic).

173 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_PROCESSIcon

Parameters

Name Description Units Default AlertConditions

Type

TSMProcessDuration

Set by TSMProcessCollector.Displays the number of secondssince the start of the process.

Seconds None Statistics

TSMProcessItemCount*

Set by TSMProcessCollector.Displays the number of itemsprocessed.

Count None Statistics

TSMProcessSize Set by TSMProcessCollector.Displays the amount of dataprocessed.

Megabytes(MB)

None Statistics

TSMProcessState Set by TSMProcessCollector.Displays the state of the process.This is determined from the processcontrol information.

0 = Running1 =Running/Errors2 =Completed/Success3 =Completed/Failure-1 =Unknown

None Availability

TSMProcessStatus Set by TSMProcessCollector.Monitors the status of the process.This status is determined by theprocess status mapping rule definedin the KM command Configuration >Processes 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

174Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Name Description Units Default AlertConditions

Type

TSMProcessSummary Set by TSMProcessCollector.Summarizes the processinformation as reported bycommands executed by the datacollector.

n/a None n/a

TSMProcessThroughput*

Set by TSMProcessCollector.Displays the throughput of theprocess during the last backupevent.

Megabytesper second(MB/s)

None Statistics

For detailed information about Baselining and KPI, see Managing Baselines and Key Performance Indicators.

* Parameters marked with an asterisk are used by default when visualizing the corresponding monitor instance inTrueSight OM.

InfoBox

Name Description

Process Name Name of the process.

Process Number Number assigned to the process.

Process Mode Mode in which the process is/was run.For example BACKGROUND

Status Completion status of the process.

Start Date & time when the process started.

End Date & time at the completion of the process.

Duration Duration of the process.

Size Size of the process, in bytes.

Items Number of items processed.

Last Message Last message reported in the server activity log.

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

175 Classes and Parameters

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Function Description

Acknowledgement > Alert

Allows acknowledgement of all warnings and alarms occurring on the selectedprocess instance.This dialog allows acknowledgement if the selected process is in a "suspicious"or "failure" state (which sets the parameter TSMProcessStatus to Warning orAlarm, respectively).

Administration > Cancel Process

Allows the selected process instance to be canceled.

Managing Baselines and Key PerformanceIndicatorsTo detect abnormalities on the monitored environment, BMC TrueSight Operations Managementcalculates baselines per attribute based on values collected over a specified period of time todetermine a normal operating range. When the collected values for these parameters are out ofrange, an alert is triggered. Some attributes are identified by default as Key PerformanceIndicators (identified with the icon) and automatically included in the base lining calculation.

Managing baselines

The baseline is the expected normal operating range for an attribute of a monitor. There are twobaselines: Baseline High and Baseline Low. Baseline High represents the point at which 95% ofthe weighted average of the historical values fall below this value for the selected time period; Baseline Low represents the point at which 90% of the weighted average of historical values forthe selected time period fall above this line.

Baselines are generated for KPI attributes that have an active abnormality thresholds.

Managing Key Performance Indicators

Starting from v9.5 of BPPM, attributes that have not been initially designated in the KM as KeyPerformance Indicators (KPIs) cannot be flagged as KPIs from BPPM/TrueSight. Although enablingbaseline is possible through the Options > Administration > Intelligent Event Thresholds featureavailable in the Infrastructure Management Server operator console, BMC does not recommenddoing it.

For more information, refer to the BMC TrueSight Operations Management documentation available f romdocs.bmc.com.

Troubleshooting

177 Impact on Resources

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Impact on ResourcesThis section describes:

• CPU and memory usage of the KM

• Network traffic generated by the KM

CPU and Memory Usage

CPU and memory usage will depend on the size and complexity of your environment and yourTSM KM configuration. As you increase data collection frequency, increase the number ofinstances monitored by the KM or add functionality through customization, your CPU andmemory usage will increase.

When monitoring a standard installation of Tivoli Storage Manager using TSM KM, the PATROLAgent will consume between 5MBytes and 10MBytes of additional system memory. Anenterprise installation of Tivoli Storage Manager Server with multiple Storage Agents, Clients,Automated Libraries, and Manual Drives can consume more memory (as per other KMs used bythe PATROL Agent). The memory usage of TSM KM can be reduced by:

• disabling monitoring unnecessary component instances (by using the configuration menu)

• disabling unwanted components (by setting their instance limits to 0)

• disabling unwanted collectors (by using the PATROL Configuration Manager)

• increasing the collector scheduling interval (by using the PATROL Configuration Manager)

• decreasing the instance limits to limit the number of instances created by the collectors

The data collectors in TSM KM uses Tivoli Storage Manager command line interface to obtainTivoli Storage Manager information. Most of the performance degradation is associated withthese command executions and amount of data returned. It may improve the overallperformance, if the regular housekeeping is followed on all Tivoli Storage Manager systems.

Network Traffic

Under normal conditions, the TSM KM generates minimal network traffic. Most of the data is kepton the managed node. The amount of network traffic that it generates depends on the numberof PATROL Consoles that are connected to the PATROL Agent and the frequency of datacollection.

Additional Information

179 Where to Find Additional Help

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

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 Tivoli Storage Manager can be found in the following locations:

Tivoli Storage Manager Quick Start

Tivoli Storage Manager Administrator’s Guide

Tivoli Storage Manager Administrator’s Reference

Tivoli Storage Manager Messages Document

Tivoli Storage Manager Backup-Archive Clients Installation and User’s Guide

http://www.tivoli.com/support

Additional help for Tivoli Storage Manager KM for PATROL can be found in the followinglocation: http://www.sentrysoftware.com

180

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Index

- A -Abnormalities 175

Access

Permissions 15

User 15Acknowledge

Alarm 92

Alerts 92

Job Alerts 92

Log Alerts 92

Process Alerts 92

Warning 92Acknowledgement

Configure 82

Job 82

Log 82Adapter 57

Admin Interface Login 49

Administer

Library Drives 60

Manual Drives 60

Mount Requests 60Agent

PATROL 49Alarm

Acknowledge 92Alarm Filter State Rules 76

Alert Acknowledgement 82

Configure 82

Job 82

Log 82Alerts

Acknowledge 92Application Clas

TSM_POLICY 132Application Class

TSM_CLIENT 109

TSM_CLIENT_CONTAINER 107

TSM_DAEMON 113

TSM_DAEMON_CONTAINER 111

TSM_DATABASE 118

TSM_DATABASE_CONTAINER 116

TSM_DEVICE 162

TSM_DEVICE_CONTAINER 160

TSM_JOB 143

TSM_LDEVICE 157

TSM_LIBRARY 154

TSM_LIBRARY_CONTAINER 152

TSM_LOG 125

TSM_LOG_CONTAINER 123

TSM_MAIN 99

TSM_MOUNT 150

TSM_MOUNT_CONTAINER 148

TSM_PCLIENT 137

TSM_POLICY_CONTAINER 130

TSM_POOL 167

TSM_POOL_CONTAINER 165

TSM_PROCESS 173

TSM_PROCESS_CONTAINER 171

TSM_SERVER 100

- B -Baselines

BMC ProactiveNet Performance Management 175

Generation 175

Manage 175

Requirements 175BMC

BMC ProactiveNet Performance ManagementPortal 56

BMC PATROL

Changes 12BMC ProactiveNet

Integration 57BMC ProactiveNet Performance Management

Abnormalities 175

Baselines 175

Key Performance Indicators 175

KPI 175

- C -Cancel

Mount Request 60Central Monitoring Administration 85

Changes 8

Check

Instance Limits 53

181

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Classes 97

Classic Mode

force 85Clean

Drive 60Clients

Delete 69

Disable 69

Enable 69

Status Configuration 76Cluster

Configure 68Clustering Application 68

CMA 85

Commands

Reload 92Configuration

Admin Interface Login 100

Debug 100

Instance Limits 100

Login 100

Monitoring Mode 100

Node Status 100

Node Type 100

Paths 100

Preloading 100Configure

Alert Acknowledgement 82

Cluster 68

Domain Backup Restriction 82

KM User Account 49

Log Error Filter 77

Log Scan Limit 80

Monitoring Period 72

Multi-Node Monitoring Mode 68

Node Type 66

Paths 63

PATROL Agent 45Connection

SSH 20

WMI 20Customize

KM 62

- D -Daemons

Delete 69

Disable 69

Enable 69

Status Configuration 76Data Collectors

Force 87Databases

Delete 69

Disable 69

Enable 69Debug

Disable 89

Enable 89

End 89

Files 89

Path 89Delete

Clients 69

Daemons 69

Databases 69

Logs 69

Policies 69

Policy Clients 69

Robotic Drives 69

Robotic Libraries 69

Standalone Drives 69

Storages 69

Volume Pools 69Disable

Clients 69

Daemons 69

Databases 69

Debug 89

Logs 69

Policies 69

Policy Clients 69

Robotic Drives 69

Robotic Libraries 69

Standalone Drives 69

Storages 69

Volume Pools 69Discoveries

Force 87Discovery

Verify 53Domain Backup Restriction

Configure 82DSM_CONFIG 63

DSM_DIR 63

DSM_LOG 63

182

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

DSMADMC 65

- E -Enable

Clients 69

Daemons 69

Databases 69

Debug 89

Logs 69

Policies 69

Policy Clients 69

Robotic Drives 69

Robotic Libraries 69

Standalone Drives 69

Storages 69

Volume Pools 69

- F -Failover Group Name 68

Files 23

ins_ALL_<version>.tar 22

ins_WINDOWS_<version>.exe 22

Setup 23

setup.exe 26

setup.sh 26

uninstall.exe 37

uninstall.sh 37Filtering Options

Clients 69

Daemons 69

Databases 69

Logs 69

Policies 69

Policy Clients 69

Robotic Drives 69

Robotic Libraries 69

Standalone Drives 69

Storages 69

Volume Pools 69Force

All Data Collectors 87

All Discoveries 87

Full data collection 87

Selected Data Collectors 87Force Discovery 100

- G -Generate

Baselines 175

Reports 94

- H -help 179

- I -Improvement 8

InfoBox

Access 167

ACS Id 154

Action 143

Activated Default Management Class 132

Activated Policy Set 132

Activation Date/Time 132

Actual Start 143

Aggregate Data Transfer Rate 143

Allocated To 157, 162

Application 109

Application Name 100

Application Version 100

Archive Retention 132

Assigned Space 118

Available FS Space 125

Available Space 118

Backup Retention 132

Binary Path 100

Collector Last End 107, 109, 111, 113, 116,118, 123, 125, 130, 132, 137, 140, 143, 148,150, 152, 154, 157, 160, 162, 165, 167, 171,173

Collector Last Start 107, 111, 113, 116,118, 123, 125, 130, 132, 137, 140, 143, 148,150, 152, 154, 157, 160, 162, 165, 167, 171,173

Collector Name 107, 109, 111, 113, 116,118, 123, 125, 130, 132, 137, 140, 143, 148,150, 152, 154, 157, 160, 162, 165, 167, 171,173

Collector Next Start 107, 109, 111, 113,116, 118, 123, 125, 130, 132, 137, 140, 143,148, 150, 152, 154, 157, 160, 162, 165, 167,171, 173

183

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

InfoBox

Collector Status 107, 109, 111, 113, 116,118, 123, 125, 130, 132, 137, 140, 143, 148,150, 152, 154, 157, 160, 162, 165, 167, 171,173

Command 113

Completed 143

Copyright 99

Data Transfer Time 143

Description 109, 113, 118, 125, 132, 137,150, 154, 157, 162, 167

Device 154, 157, 162

Device Class 167

Domain Name 137, 143

Drive Name 150

Drive Online 157, 162

Duration 173

Element 157, 162

End 173

Event Status 143

External Manager 154, 157, 162

FS Percent Used 125

Host Name 100

Installation Path 100

Items 173

Job 143

Job Type 150

Lan Free 154

Last Backup 118

Last Backup Duration 143

Last Backup End 132, 137, 143

Last Backup Job 132, 143

Last Backup Objects 143

Last Backup Save Group 137

Last Backup Size 143

Last Backup Start 132, 137, 143

Last Backup Status 132, 137

Last Communication Method 109

Last Full Backup End 132, 137

Last Full Backup Job 132, 137

Last Full Backup Start 132, 137

Last Incr Backup End 132

Last Incr Backup End Time 137

Last Incr Backup Job 132, 137

Last Incr Backup Start 132, 137

Last Message 173

Last Purge 125

Last Reorg 118

Library Name 150, 157, 162

Library Path 100

Log File Modification Time 125

Log File Size 125

Maximum Scratch Volumes 167

Migration In Progress 167

Mode 143, 150

Monitoring Mode 100

Monitoring Node 100

Name 109, 113, 118, 125, 132, 137, 154,157, 162, 167

Network Data Transfer Rate 143

Next Backup 132, 137

Next Backup Schedule Name 132, 137

Node Name 143, 154, 157, 162

Node Name(s) 100

Node Type 100

Number of Registered Nodes 132

Obey Mount Retention 154

Objects Compression 143

Objects Deleted 143

Objects Expired 143

Objects Failed 143

Objects Inspected 143

Objects Processed 143

Objects Rebound 143

Objects Updated 143

Operating System 100, 109, 137

Owner 113

Path 125

Path Online 154, 157, 162

PATROL Agent Version 99

Percent Completed 143

Percent Utilized 118

Physical Volumes 118

PID 113

Platform 100

PPID 113

Primary Library Manager 154

Private Category 154

Process Mode 173

Process Name 173

Process Number 173

Processing Time 143

Product Name 99

Product Release Date 99

Product Version 99

Reason 143

Reclamation In Progress 167

Reply Required 150

184

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

InfoBox

Request ID 150

Request Time 150

Request Timeout 150

Result 143

Schedule 143

Scheduled Start 143

Scratch Category 154

Serial Number 154, 157, 162

Server Name 150, 154, 157, 162

Server(s) 100

Session Numbers 143

Shared 154

Size 143, 173

Start 173

Status 109, 113, 132, 143, 154, 157, 162,173

Storage Agent(s) 100

Storage Pool Data Format 167

Support 99

Time Remaining 143

Time Since Last Communication 109

Total FS Space 125

Total Usable Pages 118

Type 143, 154, 157, 162, 167

Used Pages 118

Used Space 118

Version 109

Volume 150

Volume Being Migrated/Reclaimed 167

Volume Type 150

Web Site 99

World Wide Name 154, 157, 162Install / Un-install 25, 37

BMC Software Installation Utility 22

Log 26

Packages 23

Procedure 26

Setup Files 23Installation 63

Instance Limits

Check 53Integration

BMC ProactiveNet 57Introduction 25

Issues

Fixed 8

- J -JAVA 20, 64

Job Alerts

Acknowledge 92Jobs

Configure 72

Monitoring Period 72

Status Configuration 76

- K -Key Performance Indicators

BMC ProactiveNet Performance Management 175

Manage 175KM

Configure 49

Customize 62

Initial Setup 54

Load 44, 45, 56

Preload 45

Preloaded 46, 47

Unload 45, 46, 47

User Account 49KPI

BMC ProactiveNet Performance Management 175

Manage 175

- L -Library Drives

Administer 60

Clean 60

Offline 60

Online 60Load

KM 44, 45, 56

PATROL Central 45Log Alerts

Acknowledge 92Log Error Filter

Configure 77Log Scan Limit

Configure 80Logs

185

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Logs

Delete 69

Disable 69

Enable 69

- M -Manage

Baselines 175

Key Performance Indicators 175

KPI 175Managed Node

Status Configuration 76Manual Drives

Administer 60

Clean 60

Offline 60

Online 60Master Server

Configure 66Media Server

Configure 66Menu Commands

About 99, 100

Acknowledgement 125, 140, 143, 171, 173

Active Processes 171

Activity Log Messages 123

Administration 100, 148, 150, 157, 162,173

Al 171

Alarms 125, 140, 171

Alert 143, 173

All 125, 140

Automated Libraries 152

Automated Libraries Status 152

Automated Library 154

Automated Library Contents 154

Automated Library Drive 157

Automated Library Drive Status 157

Automated Library Drives 154

Automated Library Drives Status 152, 154

Automated Library Status 154

Cancel 150

Cancel All 148

Cancel Process 173

Clean Drive 157, 162

Client 109

Client Node 137

Client Nodes 132

Client Status 109

Clients 107

Clients Status 107

Configuration 99, 107, 109, 111, 113, 116,118, 123, 130, 132, 137, 140, 148, 152, 154,157, 160, 162, 165, 167, 171

Daemon 113

Daemon List 111

Daemons 111

Daemons Status 111, 113

Database 118

Database Backup Volume History 116

Database Volumes 118

Databases 116

Domain 132

Domain Backup Restriction 132

Domain Schedule 132

Domain Status 132

Domains 130

Domains Backup Restriction 130

Domains Status 130

Force Classic Configuration Mode 99

Force Discovery 100

Force Full Collection 140

Jobs 140

Jobs Alert Acknowledgement 140

Jobs Status 140

KM Status 100

Log 125

Log Alert Acknowledgement 125

Log Filter 125

Log Scan Limit 125

Logs 123

Logs Alert Acknowledgement 123

Logs Filter 123

Logs Scan Limit 123

Manual Drive 162

Manual Drive Status 162

Manual Drives 160

Manual Drives Status 160

Mount Requests 148

Mount Requests Status 148

Offline Drive 157, 162

Online Drive 157, 162

Pending Mount Requests 148

Preloading 99

Processes 171

Processes Status 171

186

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Menu Commands

Refresh Parameters 100

Refresh Process Cache 100

Reload Commands 100

Reply 150

Reports 111, 116, 118, 123, 132, 148, 154,167, 171

Start Server 100

Start Storage Agent 100

Stop Server 100

Storage Pool 167

TSM Admin Client Path 99

TSM Servers 99

Volume Pools 165

Volumes List 167

Warnings 125, 140, 171Monitoring

Multipe Servers 64

Remotely 20, 64Monitoring Period

Configure 72

Jobs 72

Mount Requests 72

Processes 72Mount Requests

Administer 60

Cancel 60

Configure 72

Monitoring Period 72

Status Configuration 76Multi-Node Monitoring Mode

Configure 68

- N -New features 8

Node Status

Alarm 67

Customize 67

Warning 67Node Type

Configure 66

Master Server 66

Media Server 66Notification 60

- O -Offline

Drive 60Online

Drive 60Operating Systems

Linux 22, 23, 26, 37

Unix 22, 23, 37

Windows 22, 23, 26, 37Options

Common services 26

Console Systems role 26

Managed System 26

View Log 26Oracle Solaris Cluster 68

- P -Parameter

TSMLoginStatus 49Parameters 97

ExtraFilesList 100

Refresh 87

TSMClientCollector 100

TSMClientCollectorExecTime 107

TSMClientDetails 107

TSMClientLastAccessElapsed 109

TSMClientSpaceUsed 109

TSMClientState 109

TSMClientStatus 109

TSMClientSummary 109

TSMCreateDistribution 100

TSMDaemonCollector 100

TSMDaemonCollectorExecTime 111

TSMDaemonCPUDuration 113

TSMDaemonCPUUtilization 113

TSMDaemonDetails 111

TSMDaemonMemorySize 113

TSMDaemonProcessCount 113

TSMDaemonState 113

TSMDaemonStatus 113

TSMDaemonSummary 113

TSMDatabaseBackupElapsed 118

TSMDatabaseCacheHitPercent 118

TSMDatabaseCacheWaitPercent 118

TSMDatabaseCollector 100

187

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Parameters 97

TSMDatabaseCollectorExecTime 116

TSMDatabaseDetails 116

TSMDatabaseFSSpaceUsedPercent 118

TSMDatabaseLogConsumedSize 118

TSMDatabaseLogPoolUsedPercent 118

TSMDatabaseLogPoolWaitPercent 118

TSMDatabasePoolHitPercent 118

TSMDatabaseReorgElapsed 118

TSMDatabaseSpaceAvailable 118

TSMDatabaseSpaceChanged 118

TSMDatabaseSpaceChangedPercent 118

TSMDatabaseSpaceGrowthRate 118

TSMDatabaseSpaceMaxExtension 118

TSMDatabaseSpaceMaxReduction 118

TSMDatabaseSpaceUsed 118

TSMDatabaseSpaceUsedPercent 118

TSMDatabaseSummary 118

TSMDomainBackupElapsed 132

TSMDomainBackupSummary 132

TSMDomainBackupThroughput 132

TSMDomainCollector 100

TSMDomainCollectorExecTime 130

TSMDomainDetails 130

TSMDomainFullBackupDuration 132

TSMDomainFullBackupElapsed 132

TSMDomainFullBackupObjectCount 132

TSMDomainFullBackupSize 132

TSMDomainIncrBackupDuration 132

TSMDomainIncrBackupElapsed 132

TSMDomainIncrBackupObjectCount 132

TSMDomainIncrBackupSize 132

TSMDomainState 132

TSMDomainStatus 132

TSMDomainSuccBackupElapsed 132

TSMDomainSummary 132

TSMDriveCollector 100

TSMDriveCollectorExecTime 160

TSMDriveDetails 160

TSMDriveState 162

TSMDriveStatus 162

TSMDriveSummary 162

TSMJobActiveBackupCount 140

TSMJobActiveCount 140

TSMJobActiveNonBackupCount 140

TSMJobCollector 100

TSMJobCollectorExecTime 140

TSMJobDetails 140

TSMJobDuration 143

TSMJobErrorCount 143

TSMJobNetworkThroughput 143

TSMJobSize 143

TSMJobState 143

TSMJobStatus 143

TSMJobSummary 143

TSMJobText 143

TSMJobThroughput 143

TSMLDriveState 157

TSMLDriveStatus 157

TSMLDriveSummary 157

TSMLibraryCollector 100

TSMLibraryCollectorExecTime 152

TSMLibraryDetails 152

TSMLibraryState 154

TSMLibraryStatus 154

TSMLibrarySummary 154

TSMLibraryUpDriveCount 154

TSMLibraryVolumeCount 154

TSMLibraryVolumePrivateCount 154

TSMLibraryVolumeScratchCount 154

TSMLibraryVolumeScratchPercent 154

TSMLogAlarmCount 125

TSMLogAlarmText 125

TSMLogCollector 100

TSMLogCollectorExecTime 123

TSMLogDetails 123

TSMLogFSSpaceUsedPercent 125

TSMLoginStatus 100

TSMLogSpaceAvailable 125

TSMLogSpaceGrowthRate 125

TSMLogSpaceUsed 125

TSMLogSpaceUsedPercent 125

TSMLogSummary 125

TSMLogText 125

TSMLogWarningCount 125

TSMLogWarningText 125

TSMMonitoringMode 100

TSMNodeBackupSummary 137

TSMNodeBackupThroughput 137

TSMNodeFullBackupDuration 137

TSMNodeFullBackupObjectCount 137

TSMNodeFullBackupSize 137

TSMNodeIncrBackupDuration 137

TSMNodeIncrBackupObjectCount 137

TSMNodeIncrBackupSize 137

TSMNodeStatus 100

TSMNodeSummary 137

TSMObjectCount 143

188

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Parameters 97

TSMObjectExcludeList 137

TSMObjectExpiredCount 143

TSMObjectFailedCount 143

TSMObjectIncludeList 137

TSMObjectProcessedCount 143

TSMObjectReboundCount 143

TSMObjectUpdatedCount 143

TSMPoolCollector 100

TSMPoolCollectorExecTime 165

TSMPoolDetails 165

TSMPoolSpaceAvailable 167

TSMPoolSpaceGrowthRate 167

TSMPoolSpaceLogicalPercent 167

TSMPoolSpaceMigrated 167

TSMPoolSpaceMigratedPercent 167

TSMPoolSpaceMigrationElapsed 167

TSMPoolSpaceReclaimable 167

TSMPoolSpaceReclaimablePercent 167

TSMPoolSpaceUsed 167

TSMPoolSpaceUsedPercent 167

TSMPoolSummary 167

TSMProcessCollector 100

TSMProcessCollectorExecTime 171

TSMProcessDetails 171

TSMProcessDuration 173

TSMProcessItemCount 173

TSMProcessSize 173

TSMProcessState 173

TSMProcessStatus 173

TSMProcessSummary 173

TSMProcessThroughput 173

TSMRequestCollector 100

TSMRequestCollectorExecTime 148

TSMRequestDetails 148

TSMRequestElapsed 150

TSMRequestState 150

TSMRequestStatus 150

TSMRequestSummary 150

TSMRequestTimeout 150

TSMUpdateAgent 100

TSMVolumeActiveCount 167

TSMVolumeActivePercent 167

TSMVolumeAvailableCount 167

TSMVolumeAvailablePercent 167

TSMVolumeCount 167

TSMVolumeEmptyCount 167

TSMVolumeFullCount 167

TSMVolumeFullPercent 167

TSMVolumeOfflineCount 167

TSMVolumePendingCount 167Paths

Binary 63

DSM_CONFIG 63

DSM_DIR 63

DSM_LOG 63

Installation 63

Library 63PATROL

Agent 49

PATROL Agent 45, 46

PATROL Central Console 45, 47

PATROL Console 45, 46PATROL Agent

Configure 45

Restart 54PATROL Console 44

Restart 54Platforms

Unix 49Policies

Delete 69

Disable 69

Enable 69Policy Clients

Delete 69

Disable 69

Enable 69Preload

KM 45Preloaded

KM 46, 47Prepare

Debug Files 89Process Alerts

Acknowledge 92Processes

Configure 72

Monitoring Period 72

- R -Refresh

Parameters 87Release Notes 8

Reload

Commands 92

189

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

Remote Connection

Settings 20, 64Remote Monitoring

Blocking 72remote PATROL Agent Checking 68

Reports

Generate 94Requirements

Security 15

Software 12

System 12Restart

PATROL Agent 54

PATROL Console 54Robotic Drives

Delete 69

Disable 69

Enable 69

Status Configuration 76Robotic Libraries

Delete 69

Disable 69

Enable 69

Status Configuration 76

- S -Security

Requirements 15Server

Start 59

Stop 59Setup

Check 54

Initial 54

KM 54Software

Requirements 12SSH 20

SSH Host Key

Authentication 20Standalone Drives

Delete 69

Disable 69

Enable 69

Status Configuration 76Start

Server 59

Storage Agent 59Status Configuration

Clients 76

Daemons 76

Jobs 76

Managed Node 76

Mount Requests 76

Robotic Drives 76

Robotic Libraries 76

Standalone Drives 76Stop

Server 59

Storage Agent 59Storage Agent

Start 59

Stop 59Storages

Delete 69

Disable 69

Enable 69Sudo 15, 49

System

Requirements 12

- T -Tivoli Storage Manager

Changes 12TSM Admin Client Path 65

TSM_CLIENT

Application Class 109TSM_CLIENT_CONTAINER

Application Class 107TSM_DAEMON

Application Class 113TSM_DAEMON_CONTAINER

Application Class 111TSM_DATABASE

Application Class 118TSM_DATABASE_CONTAINER

Application Class 116TSM_DEVICE

Application Class 162TSM_DEVICE_CONTAINER

Application Class 160TSM_JOB

Application Class 143TSM_LDEVICE

190

Tivo

li St

orag

e M

anag

er

KM f

or

PA

TRO

L V

ersi

on 3

.0.0

0

TSM_LDEVICE

Application Class 157TSM_LIBRARY

Application Class 154TSM_LIBRARY_CONTAINER

Application Class 152TSM_LOG

Application Class 125TSM_LOG_CONTAINER

Application Class 123TSM_MOUNT

Application Class 150TSM_MOUNT_CONTAINER

Application Class 148TSM_PCLIENT

Application Class 137TSM_POLICY

Application Class 132TSM_POLICY_CONTAINER

Application Class 130TSM_POOL

Application Class 167TSM_POOL_CONTAINER

Application Class 165TSM_PROCESS

Application Class 173TSM_PROCESS_CONTAINER

Application Class 171TSM_SERVER

Application Class 100TSMRequestTimeout 60

- U -Unix 49

Unload

KM 45, 46, 47

- V -Verify

Application Discovery 53Veritas Cluster File System 68

Veritas Cluster Server 68

Volume Pools

Delete 69

Disable 69

Enable 69

- W -Warning

Acknowledge 92Warning Filter State Rules 76

What's new 8

WMI 20

About Sentry Software™Sentry Software, a strategic Technology Alliance Partner of BMC Software, providescomprehensive multi-platform monitoring solutions that enable management of thehardware and software aspects of all servers and SANs and covering up to 100 % ofcustom applications within the BMC TrueSight environment. Sentry Software alsodevelops adapters for BMC Atrium Orchestrator that enables IT administrators toautomate the execution of common requests and tasks that occur in the daily course ofIT operations. Combined with BMC’s servers and network automation tools, theadapters allow IT administrators to implement provisioning and decommissioningworkflows that cover all layers of their IT infrastructure. Finally, Sentry Software designsconnectors that bring storage capacity metrics into BMC TrueSight Capacity Optimizationto ensure IT administrators that their storage infrastructure is properly sized for theircurrent and future needs.

Like us on Facebook:facebook.com/sentrysoftware

Follow us on Twitter:

twitter.com/sentrysoftware

LEARN MORE

To learn more about our solutions, please visit :www.sentrysoftware.com/solutions

© BMC Software, Inc. All rights reserved.

ABOUT MARKETZONE DIRECT PRODUCTS

The BMC MarketZone Directprogram sells and supportsthird-party products thatcomplement and/or augment BMCsolutions. MarketZone Directproducts are available under BMClicense and support terms.

About BMC Software™BMC Software helps leading companies around the world put technology at the forefrontof business transformation, improving the delivery and consumption of digital services.From mainframe to cloud to mobile, BMC delivers innovative IT management solutionsthat have enabled more than 20,000 customers to leverage complex technology intoextraordinary business performance—increasing their agility and exceeding anythingthey previously thought possible. For more information about BMC Software, visit

www.bmc.com.

Bus ines s thrives when IT runs s marter,fas ter and s tronger. That’s why the mos tdemanding IT organizations in the worldrely on BMC Software acros s dis tributed,mainframe, virtual and cloudenvironments . Recognized as the leader inBus ines s Service Management, BMC offersa comprehens ive approach and unifiedplatform that helps IT organizations cutcos t , reduce ris k and drive bus ines sprofit . For the four fis cal quarters endedSeptember 30,2011, BMC revenue wasapproximately $2.2 billion.

BUSINESS RUNS ON I.T .

I.T . RUNS ON BMC SOFT WARE