IBM Tivoli. Storage Resource Manager. Reference Guide. Version 1 Release 1 TSOS-RG

Transcription

1 IBM Tivoli Storage Resource Manager Reference Guide Version 1 Release 1 TSOS-RG

2 IBM Tivoli Storage Resource Manager Reference Guide Printed Date: September, 2002 Publication Number: TSOS-RG This edition applies to version 1, release 1, of IBM Tivoli Storage Resource Manager and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright Information Copyright International Business Machines All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Names marked or and other company and product names may be trademarks or registered trademarks of their respective vendors or organizations. Oracle is a registered trademark and Oracle8i is a trademark or registered trademark of Oracle Corporation. Microsoft is a registered trademark and SQL Server is a trademark of Microsoft Corporation. Sybase and Adapative Server are trademarks of Sybase, Inc. JCLASS - JChart, JTable, PageLayout are trademarks of SITRAKA INC. SPRINTA - JDBC driver for MS SQL is a trademark of i-net software GmbH, Berlin, Germany. REGEX - Regular Expression interpreter is a trademark of Henry Spencer. JMGMT - Free Java SNMP Stack is a trademark of Sven Dörr, Rheinstetten, Germany. ZLIB - Library Compression is a trademark of Jean-loup Gailly and Mark Adler.

3 Contents Preface 1 Basics Overview What is IBM Tivoli Storage Resource Manager? Purpose Architecture For More Information Using IBM Tivoli Storage Resource Manager Starting the User Interface Configuring the Server and Monitored Element Agents How IBM Tivoli Storage Resource Manager Works The User Interface Monitoring Overview Groups Migrating Group Definitions Creating Directory Groups Default Groups Discovery Discovering NetWare Servers and Volumes The Discovery Job Window Pings The Ping Job Window Probes The Probe Job Window Scans The Scan Job Window Scanning NetWare Volumes IBM Tivoli Storage Resource Manager Reference Guide i

4 Contents Profiles Default Profiles Creating a New Profile Migrating Profile Definitions The Profiles Window Creating File Filters Using Wildcards in File Filters Alerting Overview Computer Alerts Filesystem Alerts Directory Alerts Alert Log Running Scripts How IBM Tivoli Storage Resource Manager Runs Scripts Running scripts in response to an Alert Policy Management Overview Quotas How Quotas Work User and OS User Group Quota Definition Window Constraints Migrating User-Defined Constraint Definitions Constraint Definition Window Scheduled Actions How Scripts Work Create Script Window ii IBM Tivoli Storage Resource Manager Reference Guide

5 Contents 5 Reporting Overview Reporting Categories Reporting Tree By Clauses Working with Reports Overview Selecting a Report Selecting an Object Generating a Report Viewing a Report Drilling Down a Report Row Generating a Report Chart Navigating Tabs Trending with Historical Data Printing Reports or Charts My Reports System Reports User ID Reports Batch Reports Asset Reporting By Computer By OS Type System Wide Availability Reporting Ping Reporting Computer Uptime Reporting Capacity Reporting Disk Capacity Reporting Filesystem Capacity Reporting Filesystem Used Space Reporting Filesystem Free Space Reporting Usage Reporting Access Load Reporting Files Reporting Directories Reporting Users Reporting OS User Groups Reporting IBM Tivoli Storage Resource Manager Reference Guide iii

6 Contents Usage Violation Reporting Constraint Violations Reporting Quota Violations Reporting Backup Reporting Most At Risk Files Reporting Modified Files not Backed Up Reporting Backup Storage Requirements Reporting Index iv IBM Tivoli Storage Resource Manager Reference Guide

7 Preface What s New? 0 The following describes the new features available in IBM Tivoli Storage Resource Manager v1.1.0: Licensing Changes The user interface now provides a robust method for managing the StorageAlert licenses on the machines where you install Agents. See the IBM Tivoli Storage Resource Manager Installation Guide and IBM Tivoli Storage Resource Manager Configuration and Getting Started Guide for more information. Work with Quotas defined on Network Appliance filers IBM Tivoli Storage Resource Manager now enables you to import, view, and report on the Quotas defined on Network Appliance filers. It automatically imports certain Quotas from NetApp filers when you schedule and run a special StorageAlert Quota checking job. See the IBM Tivoli Storage Resource Manager NAS Supplement for more information. About This Guide 0 This guide assumes that the appropriate IBM Tivoli Storage Resource Manager components have been installed at your site. The instructions for installing the product are in the IBM Tivoli Storage Resource Manager Installation Guide. Ch. No. Chapter Name Content Description 1 Basics This chapter provides an overview of IBM Tivoli Storage Resource Manager and describes the elements of its user interface. 2 Monitoring This chapter describes how to use the monitoring facility to gather statistics about the storage assets and their usage within your environment. 3 Alerting This chapter describes how to use the Alerting facility to notify you of storage-related events that occur within your environment. IBM Tivoli Storage Resource Manager Reference Guide v

8 Preface Conventions used in this guide Ch. No. Chapter Name Content Description 4 Policy Management This chapter describes how to use Quotas, Constraints, and scheduled actions to enforce storage policies within your organization. 5 Reporting This chapter describes how to view and generate reports based on the storage statistics gathered by StorageAlert. Conventions used in this guide 0 Some or all of the following conventions appear in this guide: Symbol or Type Style Represents Example Bold a new term...called a source object. Alternate color (online only) hotlinked cross-references to other sections in this guide; if you are viewing this guide online in PDF format, you can click the cross-reference to jump directly to its location...see Chapter 3, Monitoring. Italic words that are emphasized...the entry after the current entry... Monospace the titles of other documents syntax variables directories, file names, command names, computer code computer screen text, system responses, command line commands IBM Tivoli Storage Resource Manager Reference Guide COPY filename &HIGHLVL.SRCLIB Copy file? Y/N Monospace bold what a user types...enter RUN APP.EXE in the Application field! choosing a command from a cascading menu File! Import! Object Highlighted Screen Text used to callout screen text on characterbased screen captures. (When viewed online, the screen text will be blue.) Dataset... Product... Parmlib... vi IBM Tivoli Storage Resource Manager Reference Guide

9 Preface Related Publications Command Syntax Conventions 0 Use syntax command statements for UNIX commands as follows: name [option...] [command argument...] Options consist of one character and are always preceded by a hyphen (-). Options with no arguments can be grouped after a single hyphen. [] Brackets surround an option or command argument that is not required. {} Curly brackets enclose options or arguments that are interdependent; everything enclosed must be treated as a unit. Related Publications 0 As you use this guide, you might find it helpful to have these additional books available for reference: IBM Tivoli Storage Resource Manager Installation Guide IBM Tivoli Storage Resource Manager Configuration and Getting Started Guide IBM Tivoli Storage Resource Manager Quick Reference Guide IBM Tivoli Storage Resource Manager Reference Guide vii

10 Preface Related Publications viii IBM Tivoli Storage Resource Manager Reference Guide

11 1 Basics Overview What is IBM Tivoli Storage Resource Manager? Purpose Architecture For More Information Using IBM Tivoli Storage Resource Manager Starting the User Interface Configuring the Server and Monitored Element Agents How IBM Tivoli Storage Resource Manager Works The User Interface IBM Tivoli Storage Resource Manager Reference Guide 1-1

12 Basics Overview Overview 1 What is IBM Tivoli Storage Resource Manager? 1 IBM Tivoli Storage Resource Manager is the industry's first and best Java- and web-based Storage Resource Management (SRM) solution designed for the open enterprise. Providing unparalleled flexibility in monitoring, alerting, policy management, and reporting on the storage assets of your enterprise, Tivoli Storage Resource Manager helps you: Reduce storage costs Ensure application availability Forecast future storage needs Make data owners accountable for storage usage Tivoli Storage Resource Manager's user interface (UI) uses a familiar tree-based navigation system similar to the scheme used in Microsoft Windows Explorer. This system allows you to see a hierarchical organization of the product and its features in the left pane of the interface while viewing detailed reports and charts in the right pane. The following graphic shows Tivoli Storage Resource Manager s main window: function tree content pane Figure 1-1 Tivoli Storage Resource Manager Main Window 1-2 IBM Tivoli Storage Resource Manager Reference Guide

13 Basics Overview See The User Interface on page 15 for more information about Tivoli Storage Resource Manager s GUI. Purpose 1 IBM Tivoli Storage Resource Manager monitors the storage assets throughout your enterprise, watching for predefined events to occur and alerting you to potential problems by or through a pager, before they occur. For example, it can notify you when your system is running out of disk space or warn you of impending storage hardware failure. By alerting you to these and other issues related to your stored data, it enables you to prevent unnecessary system and application downtime. Architecture 1 IBM Tivoli Storage Resource Manager is based upon a three-tier architecture: a UI component, a Server component, and an Agent component. Agents collect statistics about your storage and send that information to the centralized Server component. Install the Agent components on all of the machines where you want to monitor storage and storage activity. For NetWare servers: install and license Tivoli Storage Resource Manager Agents on a machine that: is running Windows 2000 or Windows NT 4.0 or above and Service Pack 4.0 or above. To use Tivoli Storage Resource Manager for retrieving storage information from the servers and volumes within NDS trees, you must install its Agent on a Windows machine(s) where a Novell NetWare client is already located. Tivoli Storage Resource Manager gathers detailed storage information about NetWare servers and volumes using native NetWare calls from these Windows machine(s). has an installed NetWare Client. has access to the Novell NetWare servers and volumes within your environment. NAS Component, install and license Agent(s) on Windows or Unix machines from which the NAS filers you want to scan are visible. You do not install Agents to the NAS filers themselves rather, you install them to Windows and/or Unix machines that have access to those NAS filers (for example, install Agents to Windows machines that can access your NAS filers; install Agents to Unix machines that have imports for the filesystems within the NAS filers). If you purchased a license for IBM Tivoli Storage Resource Manager NAS Component, see the IBM Tivoli Storage Resource Manager Installation Guide and IBM Tivoli Storage Resource Manager NAS Component User Guide for more information. IBM Tivoli Storage Resource Manager Reference Guide 1-3

14 Basics Overview Server: Receives information from the Agent(s) and saves that information in the Enterprise Repository. The Enterprise Repository is where all of your storage information and usage statistics are stored. All Agent and UI access to the central repository is done via a series of calls and requests made to the Server. See Server Component on page 6 for more information on the Enterprise Repository. Receives user requests made in the Tivoli Storage Resource Manager UI and retrieves the requested statistical information from the central repository. Users can then use this information construct and view reports. The UI enables users to make requests for information and then generate/display reports based on that information. Note All database access is done via the Server component to maximize performance and to eliminate the need to install database connectivity software on your Agent and UI machines. 1-4 IBM Tivoli Storage Resource Manager Reference Guide

15 Basics Overview The following figure illustrates an architectural overview of the Tivoli Storage Resource Manager. This section shows different workstations that are running the UI component for accessing Tivoli Storage Resource Manager. A systems or storage administrator can run the UI component from a local direct connect client, a mobile web client, or a local web client machine. The Server component acts as a central traffic cop, directing all aspects of the operation of the product. All user requests made in the UI are sent to the Server. The Server retrieves the appropriate data from the central repository and returns it to the UI, allowing the user to construct and display reports. It also directs Agent activity via its embedded job-scheduling component. This section illustrates machines (Windows and Unix) that are running the Agent component. Figure 1-2 Architecture Overview IBM Tivoli Storage Resource Manager Reference Guide 1-5

16 Basics Overview Configuring the Tivoli Storage Resource Manager Components The following describes where you can install the different Tivoli Storage Resource Manager components within your enterprise: Server. You can configure the Server component to run on its own machine or on the same machine with an Agent (to monitor the storage on that machine). Agent. You must install an Agent on each machine that contains storage you wish to monitor. See the Architecture section for information about where to install Agents for scanning the volumes on NetWare servers. Client UI. You can configure the Client UI component to run on the same machine as the Server and/or Agent components or on any other machine within your enterprise network. Securing Communications Between Components You can secure communications between the Server and Agent, and/or the Server and GUI by encrypting the data stream so that data is not visible in plain text. You can specify this in the server.config file found in the <IBM Tivoli_install_directory>/config directory. See the Installation Guide and Configuration and Getting Started Guide for more detailed information about installing and configuring these components. Client UI Component The Client UI Component of Tivoli Storage Resource Manager provides the user interface for: Monitoring your storage Defining and receiving alerts on storage events Generating and viewing reports As Tivoli Storage Resource Manager monitors your storage across your enterprise, it accumulates a repository of knowledge about your storage assets and how they are being used. You can use the reports provided in the user interface view and analyze that repository of information from different perspectives to gain insight into the use of storage across your enterprise. See Chapter 5, Reporting for more information about reports. Server Component The Server component is the center of Tivoli Storage Resource Manager s architecture and directs all of the activities related to 1) the monitoring performed on the Monitored Agent computers and 2) the reporting performed on the Client GUI computers. The Server consists of the following two components: Enterprise Repository. Tivoli Storage Resource Manager monitors your environment to accumulate information about its storage assets and their usage over time. It records this information in the centralized Enterprise Repository. The repository is organized into a series of relational database tables and is accessed by Tivoli Storage Resource Manager using Java Database Connectivity (JDBC). Java Database Connectivity is a standard SQL database access interface that provides uniform access to a wide range of relational databases. 1-6 IBM Tivoli Storage Resource Manager Reference Guide

17 Basics Overview Tivoli Storage Resource Manager currently supports Microsoft SQL Server, Oracle, and Sybase. Job Scheduler. Tivoli Storage Resource Manager deploys monitoring activities via an embedded Job Scheduler. This Job Scheduler controls when to run Discovery, Ping, Probe, Scan, and Quota checking jobs. It provides robust scheduling functionality and the flexibility to specify exactly when to run monitoring jobs. You can schedule jobs to run immediately or to run repeatedly on a specified schedule. The following figure shows the When to Probe tab on the Monitoring Probe Definition window. This tab illustrates how you can define the scheduling information when deploying the Probe monitoring function. Figure 3 Job Scheduler windows When to Probe tab You define and save the scheduling information as part of the monitoring specification. The monitoring job will then run on that schedule until the job is either changed, deleted, or disabled. IBM Tivoli Storage Resource Manager Reference Guide 1-7

18 Basics Overview Agent Component You must install the Agent component on each machine containing storage that you want to monitor. See the Architecture section for information about where to install Agents for scanning the volumes on NetWare servers. The Agent component runs in the background and deploys monitoring jobs such as Pings, Probes, and Scans. It interacts with the Job Scheduler and deploys monitoring jobs according to the schedules that you have defined. The Agent on the machine containing the storage you want to monitor controls the Ping, Probe, and Scan jobs deployed to monitor that storage. This allows an Agent to: Detect low-level problems, such as grown defects in the hardware containing the storage information Keep track information such as the uptime/downtime of the machine on which it is running See Chapter 5, Reporting for instructions about how to view reports containing information gathered by the Agent. For More Information 1 If you purchased a license for the IBM Tivoli Storage Resource Manager NAS component, see the IBM Tivoli Storage Resource Manager NAS Supplement for more detailed information about how to monitor the NAS filers in your environment. 1-8 IBM Tivoli Storage Resource Manager Reference Guide

19 Basics Using IBM Tivoli Storage Resource Manager Using IBM Tivoli Storage Resource Manager 1 Starting the User Interface 1 IBM Tivoli Storage Resource Manager provides you with two methods for running the user interface: as a downloadable Java applet or as an application. As a Java Applet The benefit of running the user interface as a Java applet is that you are not required to install the UI component on the every workstation. Users can simply access the Tivoli Storage Resource Manager applet from any web-enabled workstation in your environment and the appropriate applets will be automatically downloaded for them on an as-needed basis. To start and run the user interface as a Java applet: 1 Start a web browser session. 2 Point your browser to the URL where your administrator installed Tivoli Storage Resource Manager. The applets are downloaded and executed on your workstation. See the IBM Tivoli Storage Resource Manager Installation Guide for information on how to set up the Storage Resource Manager in a web server. As an Application The benefit of running the UI as an application is a greater speed of execution because users do not need to download any applets. To start and run the user interface as a Java applet: 1 Install the Tivoli Storage Resource Manager UI component on the desired workstation(s). 2 Execute the UI through the desktop shortcut or through the start menu. Logging In After you start the UI, the login window will appear. Enter a valid OS user ID and password defined on the machine where the Server component has been installed. See the IBM Tivoli Storage Resource Manager Configuration and Getting Started Guide for information on how to define the user ID password on the Server component machine. Configuring the Server and Monitored Element Agents 1 The Server and Agent components must be installed and defined as services that automatically start when the machine is booted. These services will then run in the background and perform the monitoring required for automatic detection of conditions of which you want to be notified. See the IBM Tivoli Storage Resource Manager Configuration and Getting Started Guide for information on how to define these components as services. IBM Tivoli Storage Resource Manager Reference Guide 1-9

20 Basics Using IBM Tivoli Storage Resource Manager How IBM Tivoli Storage Resource Manager Works 1 The Tivoli Storage Resource Manager user interface utilizes a number of repeating elements and consistent themes to better help you become familiar and comfortable with performing your critical storage management tasks. By understanding how these elements and themes form a logical pattern with the interface, you can learn to quickly navigate and use the Monitoring, Alerting, and Reporting facilities within Tivoli Storage Resource Manager. As you move through the product, you will see the same elements or constructs used repeatedly at different levels of the product function tree. The following sections provide a description of the main elements and themes within the interface. Creatable Objects You can create a number objects when working in Tivoli Storage Resource Manager to help simplify the Monitoring, Alerting, and Reporting process. Objects represent reusable definitions you can execute to perform specific tasks. Each object you can create belongs to a specific object type. The main object types appear in the product function tree and are defined in the following table: Object Type Groups (Monitoring, Policy Management) Discovery (Monitoring) Probes (Monitoring) Pings (Monitoring) Scans (Monitoring) Profiles (Monitoring) Quotas (Policy Management) Function and Use Create named groups of computers, file systems, directories, users, and OS user groups. This allows you to more easily refer to those entities when you are defining things like monitoring jobs. A Discovery job allows you to define when you want to run the Discovery job and what alerts to trigger. The Discovery job will search the network for new machines that are not yet being monitored by Tivoli Storage Resource Manager. Create Probe objects to itemize and create and inventory of your storage assets, such as computers, controllers, disk drives, file systems, logical units, etc. Create Ping objects to track the availability of your storage assets (not available for running against NetWare Servers and NAS filers). Create Scan objects to monitor the usage and consumption of your storage. Create Profile objects to define what files you want to scan and what statistical information you want to gather. Create Quota objects to control how much space a user, or group of users, can consume. This consumption can be controlled at three levels: the filesystem level, the computer level, or the entire network level IBM Tivoli Storage Resource Manager Reference Guide

21 Basics Using IBM Tivoli Storage Resource Manager Object Type Constraints (Policy Management) Alerts (Alerts) Function and Use Create Constraint objects to define what are acceptable and unacceptable file types, file sizes, and file owners on a computer or a set of computers in your environment. This allows you to do things like restrict users from storing files such as MP3 files on servers. Create Alert objects to define events that you want IBM Tivoli Storage Resource Manager to watch for. By defining the events that you want to be alerted about, you will be notified by the product in the manner you specify when one of those events occurs. To view the objects defined for an object type:! Click on the desired object type name (for example, Scans) and the tree will expand to display a list of all the objects defined for that type. To create an object for an object type: 1 Right click on that object type node in the product function tree (for example, right click the Groups node). A pop-up menu appears. 2 Select the Create New option. The create window for that object type appears in the content pane on the right side of the main window. 3 Enter information about that object. 4 Click the Save button in the toolbar, select File! Save, or select File! Save As to save the object definition. The object definition is saved in the Enterprise Repository. To edit an object definition: 1 Click on the desired object type name (for example, Scans) to expand the tree and view a list of all the objects defined for that type. 2 Left click the object you want to edit or right click it and select Edit from the pop-up menu. 3 Edit the information defined for that object. 4 Click the Save button in the toolbar, select File! Save, or select File! Save As to save the object definition. The object definition is saved in the Enterprise Repository. See Chapter 2, Monitoring, Chapter 3, Alerting, and Chapter 4, Policy Management for more information on creating and editing objects. IBM Tivoli Storage Resource Manager Reference Guide 1-11

22 Basics Using IBM Tivoli Storage Resource Manager Migrating User-Defined Objects You can migrate user-defined objects from one Server to another by using an export utility run from a command line. Exporting an objects enables you to define that object once and re-use it with the jobs on another Server. You can migrate the following objects between Servers: Groups Profiles Constraints Batch Reports To export user-defined objects, export the objects to a file and then import the data in that file into the new Server. The export utility is found in the Tivoli directory, home/server/tools. The valid command line arguments are: To export user defined objects to a file, type: export -e <target-file-name> where target-file-name represents a fully qualified file name. To import previously exported data, type: export -i <target-file-name> where target-file-name represents a fully qualified file name IBM Tivoli Storage Resource Manager Reference Guide

23 Basics Using IBM Tivoli Storage Resource Manager Schedulable Jobs Another type of creatable object are Schedulable Jobs. When you expand the tree under a named object (for example, Probes), the actual job runs for that object are displayed. For example, the monitoring jobs that you create will run according to the schedule that you specify when you define the object. The schedulable job objects are defined in the following table: Job Type Discovery Job Probe Job Ping Job Scan Job Quota Checking Job Aggregator Job Function and Use A Discovery job allows you to define when you want to run discovery and what alerts to trigger. The Discovery job will search the network for new computers that are not yet being monitored by IBM Tivoli Storage Resource Manager. Probe jobs itemize and create and inventory of your storage assets, such as computers, controllers, disk drives, file systems, logical units, etc. You can create many Probe jobs to run on any computer or subset of computers. These jobs track the availability of your storage assets. You can create many Ping jobs to monitor the availability of any computer or subset of computers on your network. You cannot run Ping jobs against NetWare servers or NAS filers. Scan jobs monitor the usage and consumption of your storage. Constraints are also checked during Scan Jobs. You create Constraints to define what are acceptable and unacceptable file types, file sizes, and file owners on a computer or a set of computers in your environment. This allows you to do things like restrict users from storing files such as MP3 files on servers. You can create many Scan jobs to monitor the file systems of any computer or subset of computers. Quota Checking jobs control how much space a user, or group of users, can consume. This consumption can be controlled at three levels: the filesystem level, the computer level, or at the whole network level. Aggregator Jobs run on a periodic basis and sum up storage usage across computers to allow for enforcement of quotas that span multiple machines. IBM Tivoli Storage Resource Manager Reference Guide 1-13

24 Basics Using IBM Tivoli Storage Resource Manager Job Runs When you create a schedulable job object, you can define when you want a job to run. You can choose to run the job: Immediately At a specified time Repeatedly on a specified schedule The term job run refers to whenever a job executes. Each job run is recorded as an entry in the product function tree and is displayed under the corresponding Schedule Job Definition (for example, Scan Definition). If you expand a job definition node (for example, the Scan node) to display its sub nodes, you will see one sub node for each job that has run. The number of jobs that are displayed is definable in the configuration facility. The job nodes that appear in the function tree are color-coded to help you quickly determine the status of a job: Job Type Job Run Node is Green Job Run Node is Red Job Run Node is Blue Function and Use The job ran successfully on all the machines on which it was deployed. The job failed. If an alert was defined for the job, you will be notified by the alert. You can also view the job log to view the error. To do this, click the job to view the run detail for the job that shows each computer on which the job ran. The status column in the detail window indicates if the job ran successfully. Click the magnifying glass icon for the computer that experienced an error to then view the log. The job is currently running on one or more machines IBM Tivoli Storage Resource Manager Reference Guide

25 Basics Using IBM Tivoli Storage Resource Manager The User Interface 1 The Tivoli Storage Resource Manager user interface consists of two main components: the function tree and content pane. Function Tree. The function tree appears on the left side of the main window. You can expand ( ), select, and collapse ( ) the nodes on this tree to navigate all of the Monitoring, Alerting, and Reporting functions of the tool. When you first start Tivoli Storage Resource Manager, the function tree is initially expanded to show all of the high level functions of the tool. The four main components are shown: Monitoring, Alerting, Policy Management, and Reporting. You can drill down on an element in the tree by clicking on it or by clicking on the key element ( ) beside it. You can right-click each of the nodes or sub-nodes within the function tree. Right-clicking brings up a pop-up menu, which enables you to perform additional actions against the node. Tips: If the function tree gets too large, or if you wish to return it to its original state, right click on the major nodes of the tree and select Collapse Branch or Expand Branch. If you right click on the main IBM Tivoli SRM node and select Collapse Branch, the entire function tree collapses. Then, right click on the main IBM Tivoli SRM node and select Expand Branch to return the function tree to its original state expanded only to show the main functions. Right click on a node and choose Print Branch to print all the sub-items within that node. For example, to print a listing of all your defined Scan jobs, expand the Scans node, right-click on Scans, and select Print Branch from the pop-up menu. Content Pane. The content pane appears on the right side of the main window. When you select a node in the function tree, the corresponding function window appears in the content pane. You can use the windows that appear in the content pane to define or run a Monitoring function, define or view the Alerting functions, or select and view a series of specific Reports. The information shown in the content pane will vary depending on if you are defining/viewing the results of a monitoring job or viewing reports. Typically, the content pane includes a series of tabs that represent the definition of a monitoring job (such as Ping, Probe, Scan) or a series of reports that you have selected for viewing. The UI works very much like a web browser, whether it is being run from a web browser or as installed GUI application. The and buttons on the tool bar allow you to move back and forth through Tivoli Storage Resource Manager screens that you have been working on during a product session. IBM Tivoli Storage Resource Manager Reference Guide 1-15

26 Basics Using IBM Tivoli Storage Resource Manager IBM Tivoli Storage Resource Manager Dashboard When you first login to Tivoli Storage Resource Manager or close all the active windows, the content pane displays the dashboard. The dashboard provides a concise, yet detailed overview of the health of your storage environment. It enables you to quickly point out potential problem areas that need further investigation. The dashboard contains four displayable areas and seven panels that you can cycle through to view your environment's storage information. Figure 1-4 The Tivoli Storage Resource Manager Dashboard 1-16 IBM Tivoli Storage Resource Manager Reference Guide

27 Basics Using IBM Tivoli Storage Resource Manager Click to update the displayed panels. Click to cycle through the following panels in the dashboard: Panel Enterprise-wide Summary Filesystem Used Space This panel... provides an enterprise-wide summary of your storage. This includes: Filesystem capacity total amount of allocated storage space Filesystem used space total amount of used storage space Filesystem Free space total amount of available storage space Disk Capacity total amount of allocated and unallocated storage space Disk Unallocated Space amount of unused space unallocated to filesystems Monitored Servers number of monitored servers Unmonitored Servers number of unmonitored servers Users number of users Disks number of disks Filesystems number of filesystems Directories number of directories Files number of files displays the total amount of used storage space across the entire network. Users Consuming the Most Space (chart) displays: a list of the users consuming the most space within your environment a graphical view of the amount of space they are consuming IBM Tivoli Storage Resource Manager Reference Guide 1-17

28 Basics Using IBM Tivoli Storage Resource Manager Panel Monitored Server Summary This panel... displays: the number of monitored machines running each OS type total amount of filesystem and disk capacity per OS type Filesystems with Least Free Space Percentage shows the monitored machines with the least percentage of free space, including the: the percent of free space on each machine the total filesystem capacity on each machine the name of the machines and filesystems/mount points Users Consuming the Most Space Report displays: a list of the users consuming the most space within your environment the total amount of storage each user is consuming Alerts Pending Displays the active alerts that are still pending. These alerts are organized by: All Computer Disk Filesystem Directory User Quota OS User Group Quota Directed to user 1-18 IBM Tivoli Storage Resource Manager Reference Guide

29 Basics Using IBM Tivoli Storage Resource Manager Working with the Function Tree and Content Pane This section describes some methods for working with the nodes and windows in the function tree and content pane. Right-Clicking and Pop-Up Menus As you navigate through the Tivoli Storage Resource Manager, notice that you can right-click many fields to access a pop-up menu containing actions related to that field. All the nodes in the function tree support pop-up menus. This allows you to access many powerful features, while at the same time, keep the interface uncluttered. For example, depending on the object type you right click, the pop-up menu that appears will contain the valid operations that you can apply to that object type. If you right click on a Scan Job node (or any other monitoring job node), a pop-up menu with the following options appears: Option Edit Delete Rename Refresh History Run Now Print Branch Description Edit the job definition. Delete the job definition. Rename the job. Refresh the list of job runs for the selected job. Show a job run history on the right pane. Run the job now. Print this node and any expanded node in the branch under it. Selecting windows in the Content Pane When you click a node in the function tree, the content pane displays a window related to that node. Each time you select a new node, the window displayed for the previously selected node is not deleted. Instead, it moves into the background and is accessible via the and buttons on the toolbar. You can also select currently active windows from the Windows dropdown menu. When viewing the active windows listed in the Windows menu, a > appears next to the current window (i.e., the window that currently occupies the content pane). Objects that you are currently editing (such as a Scan definition) will be marked with a green circle if they have no pending changes that have not been saved; a red circle indicates objects with pending changes that have not been saved. IBM Tivoli Storage Resource Manager Reference Guide 1-19

30 Basics Using IBM Tivoli Storage Resource Manager Using the By Clauses for Reports As you drill down through reports while working in the Reporting facility, you will notice a set of options that repeats for each report type. These By Clauses allow you to generate variations of the reports with different perspectives and groupings of the data. The available By Clauses are described in the following table: By Clause By Directory By Directory Group By Filesystem By Filesystem Group By Computer By Computer Group By Domain Network Wide Description Use this clause to select the directories that you want to report upon and the report that will be generated based upon those directories. Use this clause to select the directory groups that you want to report upon and the report that will be generated based upon those directory groups. Use this clause to select the filesystems that you want to report upon and the report that will be generated based upon those filesystems. Use this clause to select the filesystem groups that you want to report upon and the report that will be generated based upon those filesystem groups. Use this clause to select the computers that you want to report upon and the report that will be generated based upon those computers. Use this clause to select the computer groups that you want to report upon and the report that will be generated based upon those computer groups. Use this clause to select the Window Domains that you want to report upon and the report that will be generated based upon those domains. The reports and charts that you see will be generated on all data, network wide. This allows you to get a global view of the storage and storage usage for your whole enterprise IBM Tivoli Storage Resource Manager Reference Guide

31 Basics Using IBM Tivoli Storage Resource Manager Menu Bar The menu bar at the top of the main window provides access to the main functions within Tivoli Storage Resource Manager. The menus include the following: The File Menu The View Menu The Connection Menu The Preferences Menu The Window Menu The Help Menu The following sections describe the options available in these menus. IBM Tivoli Storage Resource Manager Reference Guide 1-21

32 Basics Using IBM Tivoli Storage Resource Manager The File Menu Menu Option Save Save As Export Data Description Save the changes for the current object you are editing. Save the changes for the current object you are editing and allow the specification of a new object name. Export the report data to other formats: Formatted Report file (.txt) Comma delimited file (.csv) Comma delimited file with headers HTML file This allows you to import the data to another application, such as Excel, if needed. Print Print Tree Refresh Alerts Close Exit Print the current data in the content pane. You can print tabular reports or report charts. You can also save the output to a PDF file or HTML file, and print those files at a later time. Print the expanded contents of the function tree. You can also save output to a PDF or HTML file, and print those files at a later time. Refresh all the alerts from the Enterprise Repository and update the UI by highlighting the appropriate objects and showing all the new alerts in the alert logs. Close the current window that occupies the content pane. End the current session. The View Menu Menu Option Tree Current Page in Tree Description Use this option to control the display of the function tree. If you want to increase the size of the content pane to occupy the entire window, unselect the Tree option. To redisplay the function tree next to the content pane in the main window, reselect the Tree option. Use this option to display the highlighted node on the Tree that was responsible for displaying the data on the content pane. The Connection Menu Menu Option New Connection Description Initiate a new connection to the Server from the current UI session IBM Tivoli Storage Resource Manager Reference Guide

33 Basics Using IBM Tivoli Storage Resource Manager The Preferences Menu Menu Option Description Look and Feel Windows Set the look and feel of the UI to appear like Microsoft Windows UI. CDE/Motif Metal Set the look and feel of the UI to appear like the Unix Motif interface. Set the look and feel of the UI to appear like Metal. Edit General Panel Retention Control the number of windows that are linked in the content pane for access via the he and buttons on the toolbar. This also controls how many windows to store in memory, which allows to optimize the system s performance. On login, show Control which alerts you will view upon logging in to a UI session. You can select: No Alerts Alerts Directed to <Userid> All Active Alerts Initial Reporting Tab to Display Control what tab will be displayed when you first generate and view a report. You can select: Selection tab Report tab Chart tab (if Available) IBM Tivoli Storage Resource Manager Reference Guide 1-23

34 Basics Using IBM Tivoli Storage Resource Manager Menu Option Description Advanced Options Select the unit of measurement that should be used to reflect the storage sizes included in Tivoli Storage Resource Manager reports. This setting affects the results in online, exported, and Batch reports. You can choose from the following options: As Appropriate Choose this option to automatically determine the unit measurement (kb, mb, gb, tb) to display for storage sizes in a report. Kilobytes (kb) Choose this option to display storage sizes in reports using the kb unit of measurement. For example, if the storage capacity for a computer is 100 megabytes, it would be shown as kb in a Capacity report. Megabytes (mb) Choose this option to display storage sizes in reports using the mb unit of measurement. For example, if the storage capacity for a computer is 1 gigabyte, it would be shown as 1000mb in a Capacity report. Gigabytes (gb) Choose this option to display storage sizes in reports using the gb unit of measurement. For example, if the free space on a computer is 500 megabytes, it would be shown as.5gb in a free space report. Terabytes (tb) Choose this option to display storage sizes in reports using the tb unit of measurement. For example, if the free space on a computer is 350 gigabytes, it would be shown as.35tb in a free space report IBM Tivoli Storage Resource Manager Reference Guide

35 Basics Using IBM Tivoli Storage Resource Manager The Window Menu Menu Option Close all Windows with out changes Show Dashboard Show Window List Description Close all of the open windows and lose the active changes that you have made to any editable objects. Display the Tivoli Storage Resource Manager dashboard. Lists names of all open windows active in the content pane. Select one of these options to view the corresponding window. Beside each window name is an icon that indicates the status of the window: Green circle - No changes were made to the window Red circle - Changes were made, but have not been saved Green arrow (>) - Current window displayed. No changes were made Red arrow (>) - Current window displayed. Changes were made, but have not been saved The Help Menu Menu Option Help Directory Help for Displayed Panel About Description Launch the online Help system. View the help for the window. You can also view help for the window by pressing F1. Display product information, such as version number, contact information, and copyright text. IBM Tivoli Storage Resource Manager Reference Guide 1-25

36 Basics Using IBM Tivoli Storage Resource Manager Tool Bar The tool bar appears below the menu bar at the top of the Tivoli Storage Resource Manager main window and provides one-click access to key commands. The buttons on the tool bar are described below: Button Description Back ( ) Click this button to navigate backward through the active windows in the content pane. Forward ( ) Click this button to navigate forward through the active windows in the content pane. Save ( ) Click this button to save the current object that you are editing. The object changes are saved to the to the Enterprise Repository. Print ( ) Click this button to print the current data or report chart displayed in the content pane. You can send the output directly to a printer or a PDF file. Cancel Edit Session ( ) Stop Current Server Request ( ) Click this button to cancel all the changes in the current object edit session. Click this button to stop the current server request. This button becomes active when a request is made to the Server and the UI is waiting for a response. During the server request wait time, the cursor arrow in the UI will appear as an hourglass. If you decide the current request is taking too long or you do not wish to wait any longer, click this button to cancel that request and regain control of the UI IBM Tivoli Storage Resource Manager Reference Guide

37 2 Monitoring Overview Groups Migrating Group Definitions Creating Directory Groups Default Groups Discovery Discovering NetWare Servers and Volumes The Discovery Job Window Pings The Ping Job Window Probes The Probe Job Window Scans The Scan Job Window Scanning NetWare Volumes Profiles Default Profiles Creating a New Profile Migrating Profile Definitions The Profiles Window Creating File Filters Using Wildcards in File Filters IBM Tivoli Storage Resource Manager Reference Guide 2-1

38 Monitoring Overview Overview 2 The monitoring functions available in the Tivoli Storage Resource Manager function tree enable you to run regularly scheduled or ad-hoc data collection jobs. These jobs gather statistics about the storage assets and their usage within your enterprise. The following lists the different kinds of data collection jobs that Tivoli Storage Resource Manager supports: New Server Discovery Discovery Jobs. Use Discovery jobs to collect information about the computers and Novell NetWare trees in your network. Discovery jobs will: find new computers that have been introduced to your network and have not yet been detected by Tivoli Storage Resource Manager (for NetWare) log in to NDS trees and enumerate the NetWare servers in those trees (for NetWare) log in to the NetWare servers in the NDS trees and gather volume/disk information Availability Monitoring Ping Jobs. Use Ping jobs to collect information about the availability of the storage assets in your enterprise. Asset Collection Probe Jobs. Use Probe jobs to collect statistics about the storage assets in your enterprise, such as computers, disk controllers, hard disks, and file systems. Usage Monitoring Scan Jobs. Use Scan jobs to collect statistics about the usage and trending of your actual storage consumption. Scan jobs perform the majority of the work for Tivoli Storage Resource Manager by providing all the data for usage reporting, as well as for quota and constraint analysis. They gather information at both the file and directory level. Simplified Object Selection and Object Management Groups. Create groups that represent a set of objects that you define, such as computers and users, to reuse within the different jobs that you run. Groups enable you to define a set of related objects one time and save these selections as a named group for future use in Scans, Probes, Pings or other entities within the Tivoli Storage Resource Manager. When you update the objects within a group, those updates are automatically picked up by the jobs that reference that group. If you purchased a license of the IBM Tivoli Storage Resource Manager NAS component, see the IBM Tivoli Storage Resource Manager NAS Supplement for more detailed information about how to use Monitoring functions with the NAS Filers in your environment. 2-2 IBM Tivoli Storage Resource Manager Reference Guide

39 Monitoring Groups Groups 2 A Group represents a set of user-defined objects against which you want to run monitoring and reporting jobs. For example, if you want to scan all of the computers in your Payroll department, create a Computer Group named Payroll and populate that group with the individual computers from the Payroll department. Then, whenever you want to collect information about those computers, you can simply select the Computer Group named Payroll when defining a monitoring job. As computers are added or removed from the Payroll department, you can simply update the Payroll Computer Group to reflect those changes. The following table lists and describes the types of groups you can create. Group Type Computer Filesystem Directory Description A logical grouping of related computers. A computer can belong to one Computer Group only. Why use Computer Groups?: Use Computer Groups to monitor computers that are related to each other or belong to a common group such as a department, a location, a territory, etc. Examples of Computer Groups:Sales, Accounting, Development, IT, West, East, Midwest, NAS Filers, Remote Servers A grouping of filesystems across multiple computers. A filesystem can belong to one Filesystem Group only. Why use Filesystem Groups?: Use Filesystem Groups to monitor entire filesystems across multiple machines. Example of a Filesystem Group: C:\, D:\, /boot, /home, /usr A grouping of directories across multiple computers. Why use Directory Groups?: Use Directory Groups to monitor a directory across a number of machines. You can include a directory in multiple Directory Groups. Examples of Directory Groups: Example1 Group Name - UnixUserHomes Included Computer Name:Directory - hp11:\home, hp11i:\home, smc:\home Example 2 Group Name - WindowsTempDir Included Computer Name:Directory - machine1:\winnt\temp, machine2:\winnt\temp, machine3:\winnt\temp IBM Tivoli Storage Resource Manager Reference Guide 2-3

40 Monitoring Groups Group Type User OS User Groups Description A logical grouping of related users. A user can belong to one User Group only. Why use User Groups?: Use User Groups to monitor users that are related to each other or belong to a common group such as a department, a location, a territory, etc. Examples of User Groups: Administrators, Developers, Marketing staff, HR staff A grouping of related users defined outside of Tivoli Storage Resource Manager at the operating system level. Why use OS User Groups?: Use OS User Groups to monitor users that are grouped together within the operating system. Each type of group is represented by a node under the Monitoring! Groups section of the function tree. You can expand the tree for each type of group to see what groups exist for that type. To create a new group: 1 Expand the Monitoring! Groups nodes of the function tree. 2 Right click the type of group you want to create. A pop-up menu appears. 3 Select New Group from the pop-up menu. The content pane displays a window for defining the group. 4 Define information about the group in the content pane. 5 Click to save the group definition. To edit an existing group: 1 Expand the Monitoring! Groups section of the function tree. 2 Click the name of the group you want to edit.the content pane displays information about that group. 3 Edit the values defined for the group as desired. 4 Click to save the updated group definition. 2-4 IBM Tivoli Storage Resource Manager Reference Guide

41 Monitoring Groups Migrating Group Definitions 2 You can migrate user-defined group definitions from one Server to another by using an export utility run from a command line. When you export a group, the specific computers, directories, users, and filesystems within those groups are not included in the export. However, any Constraints that are exported will retain the association with these groups. For example, if a Constraint includes Computer Groups named accounting and sales, the following will happen during an export: user-defined Constraints and Groups are exported the specific computers included in the Computer Group are not included in the export any user-defined Constraints that are exported will continue to include the accounting and sales Computer Groups within their definition To export Groups, simply export the user-defined objects to a file, then import the exported data into the Server. The export utility is found in the directory, home/server/tools. The valid command line arguments are: To export user defined objects to a file, type: export -e <target-file-name> where target-file-name represents a fully qualified file name. To import previously exported data, type: export -i <target-file-name> where target-file-name represents a fully qualified file name. IBM Tivoli Storage Resource Manager Reference Guide 2-5

42 Monitoring Groups Creating Directory Groups 2 Create and use Directory Groups within Scans to gather information about specific directories within filesystems without having to scan all the storage in those filesystems. To create a Directory group: 1 Right-click the Directory sub-node under Groups or click from the Directory Groups tab of the Scan window. 2 The Create Directory Group window is displayed. 2-6 IBM Tivoli Storage Resource Manager Reference Guide

43 Monitoring Groups Use the New Directory window to edit or add directories to a Directory group.. Field Creator Name Description New Computer, New Directory Description Displays the creator of the group. Displays the name of the group you are adding or editing. This name can be helpful in determining the content of the group. For example, a Directory Group named UnixUserHomes might consist of the /home directory on all the Unix machines within an organization. A description of the group you are adding or editing. Click these buttons to add a directory or computer to the group. See the following section Viewing Directory Groups for more information. Viewing Directory Groups When adding directories to a group, you can determine how you want to view groups of directories. You can choose either of the following options: Directories by computer. Use this option to display the directories in the Directory Group according to the computer on which they exist. Computers by directory. Use this option to display the computers in the group according to the directories included in the Directory Group. Choosing these different buttons enables you to add directories to a Directory Group in different ways. For example, if you want to monitor or receive alerts on different directories on multiple machines, you would choose the directories by computer option. If you want to monitor or receive alerts on the same directory across multiple machines, you would choose the computers by directory option. See the following sections for more information on Adding New Directories by Computer or Adding New Computers by Directory. IBM Tivoli Storage Resource Manager Reference Guide 2-7

44 Monitoring Groups Adding New Directories by Computer If you want to add new directories to a Directory Group by first selecting the computers on which they exist, perform the following steps: 1 In the Create Directory Group window, select the directories by computer radio button. 2 Click the New computer... button. The Edit Directories for Computer window displays. This window enables you to select the computer for which you want to monitor specific directories, and enter the directories for the selected computer. 3 Click the Computer drop-down list box. A list of available computers is displayed. 4 Select the computer for which you want to monitor specific directories. 5 Enter the directory you want to add to the group in the Directories field. For example: c:\ or /home/*. 6 Click Add. The directory is added to the list box. 7 Click OK when you are done adding directories. The New Directory Group window is displayed. The computer you added will be displayed as a node in the display area, with the specified directories under the node. 2-8 IBM Tivoli Storage Resource Manager Reference Guide

45 Monitoring Groups Adding New Computers by Directory If you want to add new directories to a Directory Group by first specifying the directory and then selecting the computers on which they exist, perform the following steps: 1 In the Create Directory Group window, select the computers by directory radio button. The Edit Computers for Directory window displays. This window enables you to enter the directories you want to add to the Directory Group and specify which computers contain those directories. 2 Enter the directory you want to add to the group in the Directory field. For example: c:\, /home/*, \user\*, \windows\temp\, /usr/*. 3 Select the All computers option to include all computers that contain the directory in the Directory Group. Skip to step 5. To select just specific computers that contain the directory, continue to the next step. 4 Select the computers you want to include in the group and click. The computer will be displayed in the Current Selections list box. 5 Click OK. The New Directory Group window is displayed. The directory you added will be displayed as a node in the display area, with the selected computers under the node. IBM Tivoli Storage Resource Manager Reference Guide 2-9

46 Monitoring Groups Default Groups 2 IBM Tivoli Storage Resource Manager contains pre-defined default groups for Computers, File systems, Users, and OS User Groups. As the system discovers these entities within your enterprise via Discovery, Probe, and Scan jobs, the entities are automatically added to the corresponding default groups. Note Objects can belong to only one group at a time. For example, if a computer already belongs to a Computer group and you attempt to add it to a different Computer group, the system will remove it from the first Computer group before adding it to the new Computer group (this includes removing it from the Default group if it had never been previously assigned to a user defined group). An object is only allowed in one group at a time in order to prevent it from being counted twice statistically. The following table lists the names of the default groups for each group type. Group Type Computer Filesystem User OS User Group Default Group Name Tivoli.Default Computer Group Tivoli.Default FS Group Tivoli.Default User Group Tivoli.Default OSGroup Group 2-10 IBM Tivoli Storage Resource Manager Reference Guide

47 Monitoring Discovery Discovery 2 Run Discovery jobs to find new computers that have been introduced into your environment. Unlike the other types of monitoring jobs (for example, Scans, Probes, and Pings), there is only one defined Discovery job. To indicate when to run a Discovery job and what alerts to set: 1 Expand the Monitoring section of the function tree and click the Discovery node. The content pane displays the two tabs for defining the parameters for the Discovery job: When to Run and Alert. Note If you want to discover the NetWare trees within your environment, you must enter information in the window under the Monitoring! NetWare Discovery window. 2 Enter the desired values in the tabs. 3 Click to save the Discovery job definition. When you expand the Discovery or NetWare Discovery nodes in the function tree, a sub node for each job that has run will appear. The number of jobs that is kept for viewing is definable in the configuration facility of the product. The job nodes that appear in the Discovery and NetWare Discovery section of the function tree are color-coded to help you quickly determine the status of a job: Job Node Color Job Run Node is Green Job Run Node is Red Job Run Node is Blue Function and Use The job ran successfully on all the machines on which it was deployed. The job failed. If an alert was defined for the job, you will be notified by the alert. You can also view the job log to view the error. To do this, click the job to view its run detail. The run detail window shows each computer on which the job ran and indicates if the job ran successfully. Click the magnifying glass icon for the computer that experienced an error to view the corresponding log. The job is currently running on one or more machines. Discovering NetWare Servers and Volumes 2 Before you can monitor and scan NetWare storage, you must configure and run Discovery jobs to identify the servers and volumes within your environment s NetWare trees (NDS trees). A Discovery job will: log in to NDS trees and enumerate the NetWare servers in those trees log in to the NetWare servers in the NDS trees and gather volume/disk information IBM Tivoli Storage Resource Manager Reference Guide 2-11

48 Monitoring Discovery To discover the NetWare servers and volumes within your environment, you must: 1 Access the NetWare Tree Logins windows in the Configuration! IBM Tivoli SRM node of the function tree and enter a valid, fully-qualified user login ID and password for each of the listed NDS trees found by the Agent. The user logins must have permission to enumerate the servers and volumes in every NDS tree against which you want to run discovery. See the IBM Tivoli Storage Resource Manager Configuration and Getting Started Guide for more information. 2 Once you have configured Tivoli Storage Resource Manager to access your NDS trees, you can run a Discovery job on all the agents for which you specified valid ID and passwords on the NetWare Tree Logins window. To run the NetWare Discovery job, right click the Monitoring! Discovery node in the function tree and select Run Now from the pop-up menu. The Discovery job will discover all the NetWare servers in the NDS trees, and log in to those servers (using the ID and password supplied on the NetWare Tree Logins window) to gather volume and disk information. See the IBM Tivoli Storage Resource Manager Configuration and Getting Started Guide for more information about setting up NetWare devices for IBM Tivoli Storage Resource Manager. The Discovery Job Window 2 The window for defining or editing a Discovery job contains the following tabs: When to Run Tab Alert Tab Options Tab The following sections describe each of these tabs. When to Run Tab Use the When to Run tab to schedule when you want the Discovery job to run. You have the following options for determining when to run a Discovery: Run the job immediately Run the job once at a specified time and date Run the job repeatedly according to a schedule you specify Select the option you want and then edit the time and date information accordingly. The following figure shows the When to Run tab on the Discovery Job window 2-12 IBM Tivoli Storage Resource Manager Reference Guide

49 Monitoring Discovery Figure 2-1 Discovery When to Run tab IBM Tivoli Storage Resource Manager Reference Guide 2-13

50 Monitoring Discovery Alert Tab Use this tab to define an alert that will be triggered when Tivoli Storage Resource Manager discovers a new computer. The following figure shows the Alert tab on the Discovery Job window. Figure 2-2 Discovery Job window Alert tab The following describes what you can define within the main sections on this tab: Section Name Description Triggering Condition Condition Triggered-Actions SNMP Trap Login Notification The only condition available for a Discovery job is when a new computer is discovered, Choose to be notified when an alert occurs via an SNMP Trap, Login Notification, Windows Event Log message, or an . Check this box to generate an SNMP trap message to any NMS, console or terminal to indicate the occurrence of an alert. Check this box to indicate that alert should appear to the specified user upon logging in to the system IBM Tivoli Storage Resource Manager Reference Guide

51 Monitoring Discovery Section Name Login ID Windows Event Log Event Type Run Script Description Indicate the ID of the user who will receive alert notification upon logging in to the system. Check this box to indicate that alerts will be recorded to the Windows Event Log. Indicate the type of event that will be recorded to the Windows Event Log. Check this box to run a script in response to this Alert. Press. The Specify Script dialog box appears, enabling you to specify a script to run and the computer on which to run. See Chapter 3, Alerting for more information on running scripts. Use this section to view, add, and delete addresses for the alert notification. Recipients: Enter the addresses you want to include for the alert notification in the top box in the list box. The bottom box displays the addresses already associated with the alert notification. Click this button to add an address you enter in the Recipients field. Click this button to delete the address you highlight in the Recipients list box. Click this button to edit the text of the alert notification on the Edit Text of the Message dialog box. IBM Tivoli Storage Resource Manager Reference Guide 2-15

52 Monitoring Discovery Options Tab Use this tab to: determine whether Tivoli Storage Resource Manager should discover machines that are flagged as workstations by the domain controller enter the name of the SNMP communities Tivoli Storage Resource Manager should use when communicating with machines in your environment. If you do not enter the name of an SNMP community, the default community public is used. Tivoli Storage Resource Manager uses the SNMP protocol to contact and identify NAS filers. Figure 2-3 Discovery Job window Options tab 2-16 IBM Tivoli Storage Resource Manager Reference Guide

53 Monitoring Discovery The following describes what you can define within the main sections on this tab: Section Name Skip Workstations Description Check this box to skip discovery of machines flagged as workstations according to the domain controller. The operating systems on the machines within your environment inform the domain controller whether they are workstations or servers. Checking this option can significantly speed up the discovery process. Enter the name of an SNMP community and click this button to add that community to the display window. Tivoli Storage Resource Manager will use the community when communicating with machines in your environment. Highlight an SNMP community and click this button to delete it from the display window. entry field display window Enter the name of the SNMP community you want to add. Displays the name of the SNMP communities that Tivoli Storage Resource Manager will use. IBM Tivoli Storage Resource Manager Reference Guide 2-17

54 Monitoring Pings Pings 2 Run Ping jobs to collect information about the availability of the storage assets in your enterprise. The results of Ping jobs are stored in the Enterprise Repository and are used to supply the data necessary for the Availability Reporting facility. See the Reporting chapter for information about Availability Reporting. To create a new Ping job: 1 Expand the Monitoring! Pings section of the function tree. 2 Right click the Pings node. A pop-up menu appears. 3 Select New Ping from the pop-up menu. The content pane displays a window for defining the Ping job. 4 Define information about the Ping job in the content pane. 5 Click to save the Ping job definition. To edit an existing Ping job definition: 1 Expand the Monitoring! Pings section of the function tree. 2 Click the name of the Ping job you want to edit.the content pane displays information about that job. 3 Edit the values defined for the Ping job as desired. 4 Click to save the updated job definition. The Ping Job Window 2 The window for defining or editing a Ping job contains the following tabs: Computers Tab When to PING Tab Options Tab Alert Tab The following sections describe each of these tabs IBM Tivoli Storage Resource Manager Reference Guide

55 Monitoring Pings Computers Tab Use the Computers tab to select which computers whose availability you want to check. The following figure shows the Computers tab on the Ping Job window. Figure 2-4 Ping Job window Computers tab The Current Selections list box shows the computers and computer groups that have been selected for the job. The Available list box shows what computers and computer groups are still available for selection. You can include individual computers or computer groups (that have been predefined using the Groups facility) against which to run a Ping job. IBM Tivoli Storage Resource Manager Reference Guide 2-19

56 Monitoring Pings To select a computer or group: 1 Highlight the desired computers or groups in the Available list box. 2 Click. The computers or groups you selected appear in the Current Selections list box. To remove or unselect computers or groups from Current Selections list box:! Highlight the computers or groups you want to remove and click. This will remove the computer or group from the Current Selections list box and move them to the Available list box. To exclude one or more computers from a selected Computer group: If you want to exclude specific computers in a computer group that you included in a job, perform the following steps. 1 Double click the group s name in the Current Selections list box. 2 Right click on the computer(s) that you want to exclude. A pop-up menu appears. 3 Select Exclude. This will create an Excludes section in the Current Selections list box that displays the names of the computers that you have chosen to exclude from the Ping job IBM Tivoli Storage Resource Manager Reference Guide

57 Monitoring Pings When to PING Tab Use the When to Ping tab to schedule when you want this Ping job to run. You have the following options for determining when to run a Ping Job: Run the job immediately Run the job once at a specified time and date Run the job repeatedly according to a schedule you specify Select the option you want and then edit the time and date information accordingly. The following figure shows the When to PING tab on the Ping Job window. Figure 2-5 Ping Job window When to PING tab You can also select the time zone for the schedule you specify. You can either select the time zone that the Server is in or any other time zone. IBM Tivoli Storage Resource Manager Reference Guide 2-21

58 Monitoring Pings Options Tab Use the Options tab to specify how often you want the Server component to write out the Ping job results to the Enterprise Repository. For greater efficiency, the Server temporarily stores Ping job results in memory. The unit of time you specify in the Options tab determines how often these results are externalized to the repository. You can specify a unit of time in a number of Pings, Minutes, Hours or Days. The following figure shows the Options tab on the Ping Job window. Figure 2-6 Ping Job window Options tab 2-22 IBM Tivoli Storage Resource Manager Reference Guide

59 Monitoring Pings Alert Tab Use this tab to define an alert that will be triggered if a computer is unavailable. The following figure shows the Alert tab on the Ping Job window. Figure 2-7 Ping Job window Alert tab The following describes what you can define within the main sections on this tab: Section Name Description Triggering Condition Condition Triggered-Actions SNMP Trap Login Notification Define how many times a Ping job must fail before it indicates that a computer is unreachable. Choose to be notified when an alert occurs via an SNMP Trap, Login Notification, Windows Event Log message, or an . Check this box to generate an SNMP trap message to any NMS, console or terminal to indicate the occurrence of an alert. Check this box to indicate that alert should appear to the specified user upon logging in to the system. IBM Tivoli Storage Resource Manager Reference Guide 2-23

60 Monitoring Pings Section Name Login ID Windows Event Log Event Type Run Script Description Indicate the ID of the user who will receive alert notification upon logging in to the system. Check this box to indicate that alerts will be recorded to the Windows Event Log. Indicate the type of event that will be recorded to the Windows Event Log. Check this box to run a script in response to this Alert. Press. The Specify Script dialog box appears, enabling you to specify a script to run and the computer on which to run. See Chapter 3, Alerting for more information on running scripts. Use this section to view, add, and delete addresses for the alert notification. Recipients: Enter the addresses you want to include for the alert notification in the top box in the list box. The bottom box displays the addresses already associated with the alert notification. Click this button to add an address you enter in the Recipients field. Click this button to delete the address you highlight in the Recipients list box. Click this button to edit the text of the alert notification on the Edit Text of the Message dialog box IBM Tivoli Storage Resource Manager Reference Guide

61 Monitoring Probes Probes 2 Run Probe jobs to collect statistics on the storage assets in your enterprise, such as computers, disk controllers, hard disks, and file systems. The results of Probe jobs are stored in the Enterprise Repository and are used to supply the data necessary for the Asset Reporting facility. See the Reporting chapter for information about Availability Reporting. The Probe Job Window 2 The window for defining or editing a Probe job contains the following tabs: Computers Tab When to PROBE Tab Alert Tab The following sections describe each of these tabs. Computers Tab Use this tab to select the computers whose storage assets you want to itemize. The following figure shows the Computers tab on the Probe Job window. Figure 2-8 Probe Job window Computers tab IBM Tivoli Storage Resource Manager Reference Guide 2-25

62 Monitoring Probes The Current Selections list box shows the computers and Computer groups that have been selected for the job. The Available list box shows what computers and computer groups are still available for selection. You can include individual computers or computer groups (that have been predefined using the Groups facility) against which to run a Probe job. To select a computer or group: 1 Highlight the desired computers or groups in the Available list box. 2 Click. The computers or groups you selected appear in the Current Selections list box. To remove or unselect computers or groups from Current Selections list box:! Highlight the computers or groups you want to remove and click. This will remove the computer or group from the Current Selections list box and move them to the Available list box. To exclude one or more computers from a selected Computer group: If you want to exclude specific computers in a computer group that you included in a job, perform the following steps. 1 Double click the group s name in the Current Selections list box. 2 Right click on the computer(s) that you want to exclude. A pop-up menu appears. 3 Select Exclude. This will create an Excludes section in the Current Selections list box that displays the names of the computers that you have chosen to exclude from the Probe job IBM Tivoli Storage Resource Manager Reference Guide

63 Monitoring Probes When to PROBE Tab Use the When to PROBE tab to schedule when you want a Probe job to run. Figure 2-9 Probe Job window When to PROBE tab You have the following options for determining when to run a Probe Job: Run the job immediately Run the job once at a specified time and date Run the job repeatedly according to a schedule you specify You can also select how to handle time zones. You can choose to run the Probe job at the same local time in each time zone, or you can choose to run the job at the same global time across all time zones. IBM Tivoli Storage Resource Manager Reference Guide 2-27

64 Monitoring Probes Alert Tab Use the Alert tab to define an alert that will be triggered if a Probe job fails. Figure 2-10 Probe Job window Alert tab The following describes what you can define within the main sections of the Alert tab: Section Name Description Triggering Condition Condition Triggered-Actions SNMP Trap Login Notification Login ID The only triggering condition is when a Probe fails. Choose to be notified when an alert occurs via an SNMP Trap, Login Notification, Windows Event Log message, or an . Check this box to generate an SNMP trap message to any NMS, console or terminal to indicate the occurrence of an alert. Check this box to indicate that alert should appear to the specified user upon logging in to the system. Indicate the ID of the user who will receive alert notification upon logging in to the system IBM Tivoli Storage Resource Manager Reference Guide

65 Monitoring Probes Section Name Windows Event Log, Unix Syslog Event Type Run Script Description Check this box to indicate that alerts will be recorded to the Windows Event Log or Unix Syslog. Indicate the type of event that will be recorded to the OS log. Check this box to run a script in response to this Alert. Press. The Specify Script dialog box appears, enabling you to specify a script to run and the computer on which to run. See Chapter 3, Alerting for more information on running scripts. Use this section to view, add, and delete addresses for the alert notification. Recipients: Enter the addresses you want to include for the alert notification in the top box in the list box. The bottom box displays the addresses already associated with the alert notification. Click this button to add an address you enter in the Recipients field. Click this button to delete the address you highlight in the Recipients list box. Click this button to edit the text of the alert notification on the Edit Text of the Message dialog box. IBM Tivoli Storage Resource Manager Reference Guide 2-29

66 Monitoring Scans Scans 2 Run Scan jobs to collect statistics on the usage and trending of your actual storage consumption. The results of Scan jobs are stored in the Enterprise Repository and are used to supply the data necessary for the Capacity, Usage, Usage Violations, and Backup Reporting facilities. See the Reporting chapter for information about Availability Reporting. The Scan Job Window 2 The window for defining or editing a Scan job contains the following tabs: Filesystems Tab Directory Groups Tab Profiles Tab When to SCAN Tab Alert Tab The following sections describe each of these tabs IBM Tivoli Storage Resource Manager Reference Guide

67 Monitoring Scans Filesystems Tab Use the Filesystems tab to select what computers and filesystems whose storage usage and consumption you want to monitor. You can include individual file systems/computers or filesystem/computer groups (that have been predefined using the Groups facility) against which to run the Scan job. The following figure shows the Filesystems tab on the Scan Job window. Figure 2-11 Scan Job window Filesystems tab The Current Selections list box shows the filesystems, filesystem groups, computer groups, and computers that have been selected for the job. The Available list box shows what items are still available for selection. To select a filesystem, computer, or group: 1 Highlight the desired filesystems, computers, or groups in the Available list box. 2 Click. The filesystems, computers, or groups you selected appear in the Current Selections list box. To remove or unselect items from Current Selections list box:! Highlight the items you want to remove and click. This will remove the filesystems, computers, or groups from the Current Selections list box and move them to the Available list box. IBM Tivoli Storage Resource Manager Reference Guide 2-31

68 Monitoring Scans To exclude one or more filesystems or computers from a selected Filesystem or Computer group: If you want to exclude specific filesystems or computers from a group that you included in a job, perform the following steps. 1 Double click the group s name in the Current Selections list box. 2 Right click on the filesystem(s) or computer(s) that you want to exclude. A pop-up menu appears. 3 Select Exclude. This will create an Excludes section in the Current Selections list box that displays the names of the filesystems or computers that you have chosen to exclude from the Scan job. This is useful when you want to select a group for scanning, but you want to exclude a few filesystems or computers from that monitoring. Directory Groups Tab Use the Directory Groups tab to select the Directory Groups you want to scan. Specifying directories within a Scan provides a way to scan a specific directory within a filesystem rather than having to scan an entire filesystem. The following figure shows the Directory Groups tab on the Scan Job window. Figure 2-12 Scan Job window Directory Groups tab 2-32 IBM Tivoli Storage Resource Manager Reference Guide

69 Monitoring Scans The Selected Directory Groups list box shows what directory groups have been selected for the job. The Available Directory Groups list box shows the items that are still available for selection. You can select directory groups that have been predefined using the Groups facility. To select a directory group: 1 Highlight the desired group in the Available Directory Groups list box. 2 Click. The group you selected appears in the Selected Directory Groups list box. To remove or unselect a directory group from Selected Directory Groups list box:! Highlight the groups you want to remove and click. This will remove the groups from the Selected Directory Groups list box and move them to the Available Directory Groups list box. To create a new directory group:! Click. The New Directory Group window displays, enabling you to create a new group. See Groups for more information. IBM Tivoli Storage Resource Manager Reference Guide 2-33

70 Monitoring Scans Profiles Tab Use the Profiles tab to select which Profiles to use during the scan of the selected computers and filesystems. Profiles control what files are scanned and what statistics are gathered by a Scan job. The following figure shows the Profiles tab on the Scan Job window. Figure 2-13 Scan Job window Profiles tab Note Using Profiles is a powerful method for determining the statistics you want to gather during Scans. Keep in mind that the more Profiles you include within a Scan, the longer the Scan will take to gather the statistics specified by those Profiles IBM Tivoli Storage Resource Manager Reference Guide

71 Monitoring Scans To select a Profile: 1 Highlight the desired Profile(s) in the Available Profiles list box. 2 Click the top to apply the selected Profile(s) to filesystems; click the bottom to apply the selected Profile(s) to directories. The Profiles you selected appear in the either the Profiles to apply to Filesystems or Profiles to apply to Directories list box Note To collect statistics according to Tivoli Storage Resource Manager default settings, select all of the default Profiles. To remove or unselect Profiles:! Highlight the Profiles you want to remove and click the corresponding. This will remove the Profile from the list boxes on the right and move them to the Available Profiles list box. To create a new profile:! Click. The Statistics tab on the Create Profile window displays, enabling you to create a new profile. See Profiles for more information. When to SCAN Tab Use the When to SCAN tab to schedule when you want a Scan job to run. You have the following options for determining when to run a Scan Job: Run the job immediately Run the job once at a specified time and date Run the job repeatedly according to a schedule you specify You can also select how to handle time zones. You can choose to run a Scan job at the same local time in each time zone, or you can choose to run the job at the same global time across all time zones. IBM Tivoli Storage Resource Manager Reference Guide 2-35

72 Monitoring Scans Alert Tab Use the Alert tab to define an alert that will be triggered if the Scan job fails. Figure 2-14 Scan Job window Alert tab The following describes what you can define within the main sections of the Alert tab: Section Name Description Triggering Condition Condition Triggered-Actions SNMP Trap Login Notification Login ID The only triggering condition is when a Scan fails. Choose to be notified when an alert occurs via an SNMP Trap, Login Notification, Windows Event Log message, or an . Check this box to generate an SNMP trap message to any NMS, console or terminal to indicate the occurrence of an alert. Check this box to indicate that alert should appear to the specified user upon logging in to the system. Indicate the ID of the user who will receive alert notification upon logging in to the system IBM Tivoli Storage Resource Manager Reference Guide

73 Monitoring Scans Section Name Windows Event Log, Unix Syslog Event Type Run Script Description Check this box to indicate that alerts will be recorded to the Windows Event Log or Unix Syslog. Indicate the type of event that will be recorded to the OS log. Check this box to run a script in response to this Alert. Press. The Specify Script dialog box appears, enabling you to specify a script to run and the computer on which to run. See Chapter 3, Alerting for more information on running scripts. Use this section to view, add, and delete addresses for the alert notification. Recipients: Enter the addresses you want to include for the alert notification in the top box in the list box. The bottom box displays the addresses already associated with the alert notification. Click this button to add an address you enter in the Recipients field. Click this button to delete the address you highlight in the Recipients list box. Click this button to edit the text of the alert notification on the Edit Text of the Message dialog box. Scanning NetWare Volumes 2 Scan jobs enable you to gather detailed information about the NetWare volumes within your environment. However, before you can gather information about NetWare volumes, you must: 1 Configure Tivoli Storage Resource Manager to discover all the NetWare servers in your NDS trees and then run a Discovery job. See the Discovering NetWare Servers and Volumes section for information about configuring and running Discovery jobs against NDS trees. IBM Tivoli Storage Resource Manager Reference Guide 2-37

74 Monitoring Scans 2 Access the Scanning Agent Administration window in the Configuration node of the function tree to assign Agents to each of the volumes discovered on your licensed NetWare servers. You can assign any Agent to a volume that has the ability to access that volume. The servers discovered in the NDS trees The NDS trees discovered by Agents The filesystem/ volumes discovered in the NetWare servers Agents assigned to the filesystem/ volumes in the NetWare servers Note If you do not assign an Agent to a volume, Tivoli Storage Resource Manager will not scan and gather information about that volume. 3 Define a Scan job and include the NetWare volumes/filesystems for which you want to gather detailed storage information. See the IBM Tivoli Storage Resource Manager Configuration and Getting Started Guide for more information about assigning Agents to NetWare volumes IBM Tivoli Storage Resource Manager Reference Guide

75 Monitoring Profiles Profiles 2 Profiles enable you to specify exactly what statistical information is gathered and to fine tune and control what files are scanned during a filesystem scan. Until you begin creating your own Profiles, you can use the default Profiles that are supplied with Tivoli Storage Resource Manager. Each of these default Profiles allows you to select a specific statistic that you want to gather. If you want to scan a computer or filesystem, and want to gather all of the statistical information available, simply select all of the default profiles when you create your Scan job. Default Profiles 2 Default Profiles are provided for your use with Tivoli Storage Resource Manager. Each default Profile represents a specific statistic that you can gather (which is included in the name of the Profile for convenient identification). When creating Scan jobs, Profile(s) are selected to be used during that job. The Profiles you include in the job determine what statistics are gathered and how they are correlated. This then determines what reports are available for the computers or file systems that you are scanning. If you want all reports to be available, select all of the default Profiles. You can learn to create new Profiles and model the statistics to your requirements as you grow more comfortable with using Tivoli Storage Resource Manager. Creating custom profiles will enable you to find out specific information on certain files or file types throughout your enterprise. Tivoli is the creator of the default Profiles, so you will see their names prefixed by Tivoli within the system. The following table shows the default Profile names and describes their function: Default Profile Name By Access By Creation By Mod Not Backed Up By Modification Size Distribution Largest Directories Largest Files Description Gathers statistics by length of time since last access of files. Gathers statistics by length of time since creation of files. Gathers statistics by length of time since last modification (only for files not backed up since modification). (Windows only) Gathers statistics by length of time since last modification of files. Gathers information on the size distribution of files. Gathers statistics on the n largest directories. (20 is the default amount.) Gathers statistics on the n largest files. (20 is the default amount.) IBM Tivoli Storage Resource Manager Reference Guide 2-39

76 Monitoring Profiles Default Profile Name Largest Orphans Most At Risk Oldest Orphans Most Obsolete Files Summary By Filesystem/ Directory Summary By Group Summary By Owner Wasted Space Description Gathers statistics on the n largest orphan files. (20 is the default amount.) Gathers statistics on the n files that have been modified the longest time ago and have not yet been backed up since they were modified. (20 is the default amount.) (Windows only) Gathers statistics on the n oldest orphan files. (20 is the default amount.) Gathers statistics on the n most obsolete files (i.e., files that have not been accessed or modified for the longest period of time). (20 is the default amount.) Summarizes space usage by Filesystem or Directory. Summarizes space usage by OS Group. Summarizes space usage by Owner. Gathers statistics on the non-os files not accessed in the last year and orphaned files. Creating a New Profile 2 You can create custom profiles and model the statistics to your requirements for each scan job. Profiles indicate what information should be gathered during a scan. In addition, you can make your profiles more exclusive by defining file filters. Creating custom profiles enables you to find out specific information on certain files or file types throughout your enterprise. To create a new profile: 1 Right-click the Profiles node on the function tree and select New Profile from the pop-up menu IBM Tivoli Storage Resource Manager Reference Guide

77 Monitoring Profiles OR click from the Profiles tab of the Scan window. 2 The Statistics tab on the Create Profile window is displayed. 3 Select statistics you want the scan job to collect. Statistics are tied to a specific profile. See the Statistics Tab section for more information on using this tab. 4 If you want to further limit specific files to be scanned, select the File Filters tab. This tab enables you to define exclusive conditions that will be used to filter what files are analyzed during the scan job. See the File Filters Tab section for more information on using this tab. Migrating Profile Definitions 2 You can migrate user-defined profile definitions from one Server to another by using an export utility run from a command line. Exporting Profiles enables you to define Profiles once and reuse them with the jobs on another Server. To do this, simply export the user-defined objects to a file, then import the exported data into the Server. The export utility is found in the directory, home/server/tools. The valid command line arguments are: To export user defined objects to a file, type: export -e <target-file-name> where target-file-name represents a fully qualified file name. To import previously exported data, type: export -i <target-file-name> where target-file-name represents a fully qualified file name. IBM Tivoli Storage Resource Manager Reference Guide 2-41

78 Monitoring Profiles The Profiles Window 2 The window for defining or editing a Profile contains the following tabs: Statistics Tab File Filters Tab The following sections describe each of these tabs. Statistics Tab Use the Statistics tab to specify exactly what level of detail to collect when running a Scan job. The more information that you specify, the more reports that you will be able to run against the information that you collect during the scan. Statistics are tied to a specific profile. The following figure shows the Statistics tab on the Profiles window. Figure 2-15 Profiles window Statistics tab 2-42 IBM Tivoli Storage Resource Manager Reference Guide

79 Monitoring Profiles File Filters Tab Use the File Filters tab to build a complex where clause that will be used to filter what files are analyzed in the collection of data during a Scan job. In the following example, a Group (All of) has been created with three conditions: The first condition controls what type of files to collect information on (MP3, GIF, AVI, and JPG files). The second condition specifies that the files must have been created within the last year The third condition limits this Profile to analyzing files greater than 500 kilobytes only To create, edit or delete groups or conditions, right click on the groups and conditions in the Profile definition and choose the desired option. Figure 2-16 Profiles window File Filters Tab Important The first time you view a new Profile, this window is blank except for the text (All files selected). That is the default behavior of a Profile it collects information on all files. To create your first group or condition, simply right click on the (All files selected) text and choose to create a new group or condition. IBM Tivoli Storage Resource Manager Reference Guide 2-43

80 Monitoring Profiles 1 In the File Filters tab, the default condition (All files selected) is displayed. Right-click the condition and select New Condition from the pop-up menu. You can also specify groups for these conditions, by selecting New Group IBM Tivoli Storage Resource Manager Reference Guide

81 Monitoring Profiles 2 In the figure above, New Condition is selected. The Create Condition window displays, enabling you to define your file conditions. You can create conditions based on access time, creation time, file name or group, modification time, file attributes, size, type, owner, or length. 3 After defining each condition, press. 4 If you are defining more than one condition, the Create Group dialog box displays to help you associate the conditions you created: 5 Select how you want to associate the conditions you have defined. See Associating Conditions with Groups for more information on creating groups. IBM Tivoli Storage Resource Manager Reference Guide 2-45

82 Monitoring Profiles 6 The condition is displayed in the File Filter window. See Creating File Filters for more information on creating file filters for your custom profiles IBM Tivoli Storage Resource Manager Reference Guide

83 Monitoring Profiles Creating File Filters 2 File filters enable you to further define files you want to include or exclude in your scan job. Filters limit the files on which you are gathering data during the scan. You can use the File Filters tab to easily build complex conditions or where clauses. Defining a Condition In the File Filters tab, right-click on the default (All files selected) text and select New Condition from the pop-up menu. The following Create Condition window is displayed. Figure 2-17 File Filters Create Condition window The first drop-down list displays file criteria that you can select to define your condition. You can define file criteria based on access time, creation time, file name or group, modification time, file attributes, size, type, owner, or length. Depending on the criteria you choose to define, the second drop-down list and window fields change dynamically to help you set parameters for the selected criteria. The following sections describe the file criteria you can select for your file filter. IBM Tivoli Storage Resource Manager Reference Guide 2-47

84 Monitoring Profiles Last Accessed When you select Last Accessed from the Create Condition window drop-down list, the following window displays: Figure 2-18 Create Condition Last Accessed Use this window to limit files based on accessed date and time. 1 Select files that were last accessed: later than earlier than between not between 2 Specify the time as: Length of time before scan - enter the years, weeks, days, hours, or minutes before a scan Timestamp - select files based on the timestamp 3 When you are finished, press. The condition will be displayed in the File Filters tab IBM Tivoli Storage Resource Manager Reference Guide

85 Monitoring Profiles Created Select Created from the Create Condition window drop-down list to limit files based on created date and time. This window is similar to the Last Accessed window shown above. 1 Select files that were last created: later than earlier than between not between 2 Specify the time as: Length of time before scan - enter the years, weeks, days, hours, or minutes before a scan Timestamp - select files based on the timestamp 3 When you are finished, press. The condition will be displayed in the File Filters tab. Name When you select Name from the Create Condition window drop-down list, the following window displays: Figure 2-19 Create Condition Name Use this window to limit files based on file name. 1 Select files based on file names that: matches any of IBM Tivoli Storage Resource Manager Reference Guide 2-49

86 Monitoring Profiles matches none of matches doesn t match 2 In the Match field, enter the file name upon which you want the condition to be based. For example, you can specify, *.exe, *.mp3, *.avi. 3 Select the location where the file name will be searched during the scan: In any directory. During a scan, Tivoli Storage Resource Manager will look for the file name in any directory. In this condition, the search string will occur at the end of the full directory path. Append to scanned directory. This option allows you to restrict what directory to scan. Tivoli Storage Resource Manager will look for the file type in the specified file system root directory or in a monitored directory in a directory group tied to a scan. In this option, you must first specify what directory group(s) you want scanned in the Directory Groups tab of the Scan window. See Directory Groups Tab for more information. Fully-qualified path. Enter the fully-qualified path when you enter the file type in the Match field. During a scan, Tivoli Storage Resource Manager will look for the file type in the exact path you specify here. This is useful when you want to exclude system directories and files in a Most Obsolete Files report. 4 After you specify each file type and the location, press. The file name will be shown in the display window. 5 When you are finished specifying all the file names you want to filter, press. The condition will be displayed in the File Filters tab IBM Tivoli Storage Resource Manager Reference Guide

87 Monitoring Profiles Group When you select Group from the Create Condition window drop-down list, the following window displays: Figure 2-20 Create Condition Group Use this window to limit files based on the OS group to which the file belongs. 1 Select groups based on those that: matches any of matches none of between not between matches doesn t match >= < > <= 2 Enter the name of the group or OS group. 3 When you are finished, press. The condition will be displayed in the File Filters tab. IBM Tivoli Storage Resource Manager Reference Guide 2-51

88 Monitoring Profiles Last Modified Select Last Modified from the Create Condition window drop-down list to limit files based on last modification date. This window is similar to the Last Accessed window displayed above. 1 Select files that were last modified: later than earlier than between not between 2 Specify the time as: Length of time before scan - enter the years, weeks, days, hours, or minutes before a scan Timestamp - select files based on the timestamp 3 When you are finished, press. The condition will be displayed in the File Filters tab. Attributes When you select Attributes from the Create Condition window drop-down list, the following window displays: Figure 2-21 Create Condition Attributes 2-52 IBM Tivoli Storage Resource Manager Reference Guide

89 Monitoring Profiles Use this window to limit files based on file attributes. 1 Select files based on file attributes that: include any of include none of include all of don t include all of 2 From the drop-down list box, select the file attribute upon which you want the condition to be based. You can select: Read only - Users cannot write to the file. Hidden - A file that cannot be seen by users during a normal directory listing. System - A file used by the operating system that caanot normally be viewed by users. Archive - A file that has been backed-up and the archive bit is turned off. An Archive bit signifies that the file has been changed since it was last archived. Normal - A file with no special attributes set to it. Temporary - (Windows only) A temporary or backup copy of a file. Sparse - A file with a special kind of compression that doesn't take up a lot of CPU time. The logical size of the file looks bigger than is actually allocated. It contains some blank pages which are not on disk. Reparse Point - New NTFS file system objects that have a definable attribute containing user-controlled data and are used to extend functionality in the input/output (I/O) Subsystem. Compressed - A file to which a compression algorithm was applied. This file takes up less space on disk, but it will be slower to read. For Novell NetWare, the file itself isn't usually compressed, rather the whole volume is compressed. Offline - A file that was migrated to tape. Not Content Indexed - A file that is not indexed--the Windows indexing service was told that this is not a file that should be searched through for text strings. Encrypted - A file that was saved with a password (is password-protected). Orphaned - (for Windows, Unix, and Netware) The user who owns the file is no longer present in the system database. Block Device - (Unix only) A disk device file (not a real file). Executable - A file that you can run or execute. Sticky - A special type of executable file that is read into memory when it is first run and never released. Use Scans to find these types of files and set them to "unsticky". IBM Tivoli Storage Resource Manager Reference Guide 2-53

90 Monitoring Profiles SETGID - (Unix only, for executable files) When a file is run, its group changes to the group of the file. For example, if a user belongs to User group and runs a file from a different group (e.g., Root), than the user's group will be changed to Root while running the file (for security purposes). SETUID - (Unix only, for executable files) When a file is run, the user's effective user will be changed when the file is run. For example, if a file is SETUID =Root, a users effective user ID becomes Root when running the file. This is considered a security hole by Unix Administrators, so you can define a Profile to search for files that have a SETUID = Root. 3 Click after selecting the file attribute. The attribute will be shown in the display window. 4 When you are finished, press. The condition will be displayed in the File Filters tab. Size When you select Size from the Create Condition window drop-down list, the following window displays: Figure 2-22 Create Condition Size Use this window to limit files based on the physical file size that the file occupies the disk. 1 Select files based on size that are: between not between >= 2-54 IBM Tivoli Storage Resource Manager Reference Guide

91 Monitoring Profiles < > <= 2 Enter the file size range by bytes, KB, MB, GB, or TB. 3 When you are finished, press. The condition will be displayed in the File Filters tab. Type When you select Type from the Create Condition window drop-down list, the following window displays: Figure 2-23 Create Condition Type Use this window to limit files based on pre-defined file types. 1 Select files based on file types that are: in not in = < > 2 From the drop-down list box, select the file type upon which you want the condition to be based. You can select: Link IBM Tivoli Storage Resource Manager Reference Guide 2-55

92 Monitoring Profiles Directory Fifo Socket Device 3 Click after selecting the file type. The file type will be shown in the display window. 4 When you are finished, press. The condition will be displayed in the File Filters tab. Owner When you select Owner from the Create Condition window drop-down list, the following window displays: Figure 2-24 Create Condition Owner Use this window to limit files based on owner. 1 Select files based on owner that: matches any of matches none of between not between matches doesn t match 2-56 IBM Tivoli Storage Resource Manager Reference Guide

93 Monitoring Profiles >= < > <= 2 In the entry field, enter the name of the owner upon which you want the condition to be based. 3 Click. The owner will be shown in the display window. 4 When you are finished, press. The condition will be displayed in the File Filters tab. Length When you select Length from the Create Condition window drop-down list, the following window displays: Figure 2-25 Create Condition Length Use this window to limit files based on the logical size of the files contents. 1 Select files based on length that are: between not between >= < > IBM Tivoli Storage Resource Manager Reference Guide 2-57

94 Monitoring Profiles <= 2 Enter the file length range by bytes, KB, MB, GB, or TB. 3 When you are finished, press. The condition will be displayed in the File Filters tab. Associating Conditions with Groups When you create more than one condition, you have to associate the conditions with each other in a group or groups. Groups enable you to further define your file filter to include or exclude certain files based on specific criteria. To create a new group you can either do one of the following: 1 In the File Filters tab, right-click a condition and select New Group from the pop-up menu. The Create Group dialog box is displayed: OR 2 First create each file condition you want for your file filter. As you create a new file condition, the Create Group dialog box is displayed: 3 Select the grouping for the file conditions you created. The grouped condition will be displayed in the File Filters tab IBM Tivoli Storage Resource Manager Reference Guide

95 Monitoring Profiles The following describes the group you can select: Group All of Any of None of Not all of Description All inclusive. All the conditions must be met. For example: a and b and c Any one or more of the following conditions will be met. For example: a or b or c None of the conditions are met. For example: not (a or b or c) All of the following conditions are not met. For example: not (a and b and c) For example, say you want to create a file filter with the following conditions: Name in (*.gif, *.jpg) Size > 1 MB Attribute is Read Only How you group the conditions listed above will produce different results. The following table shows the different results depending on the group you select: File Group Result A.gif 500KB read only B.jpg 2 MB read only All of Any of None of Not all of All of Any of None of Not all of False True False True True True False False IBM Tivoli Storage Resource Manager Reference Guide 2-59

96 Monitoring Profiles File Group Result C.gif 2 MB read/write D.txt 500KB read/write All of Any of None of Not all of All of Any of None of Not all of False True False True False False True True Using Wildcards in File Filters 2 You can use wildcards within the conditions of file filters to perform pattern matching of file names. A wildcard is a special symbol that represents one or more characters. You can use wildcards in File Filter conditions to identify multiple files and directories with a single specification. The following table describes some of the wildcards supported by Tivoli Storage Resource Manager: Wildcard Character Description Examples * Use the asterisk (*) to stand-in for unknown characters in file names. It can act as a wildcard for zero or more characters of any value within a directory or file name. s* refers to all files that begin with s *.exe refers to all files that have.exe as an extension /user/* refers to all files under the /user directory 2-60 IBM Tivoli Storage Resource Manager Reference Guide

97 Monitoring Profiles Wildcard Character Description Examples % Use the percent (%) character to specify a wildcard for a directories within the path of a file. It can act as a wildcard for zero or more directories within a path.? Use the question mark (?) to stand in for a character within a file name or directory name. It can as a wildcard for a character within a directory or file name. /home/%/*.cmd will match all files with the extension.cmd and located in any of the subdirectories under the /home directory /usr/%/* will match all files and subdirectories under the /usr directory (for example, /usr/files/ c, /usr/c, /usr/files/documents/c) /home/usr?/ will match directories like: /home/usr1/, / home/usr2/, etc. /usr/temp/temp??.tmp will match files like /usr/temp/ temp01.tmp, /usr/temp/ temp02.tmp, etc. Tivoli Storage Resource Manager supports standard Unix shell path name expansion wildcarding within file filter conditions. Please refer to the appropriate Unix man pages for more information about the wildcards you can use. IBM Tivoli Storage Resource Manager Reference Guide 2-61

98 Monitoring Profiles 2-62 IBM Tivoli Storage Resource Manager Reference Guide

99 3 Alerting Overview Alert Notification Mechanisms Computer Alerts Computer Alert Window Filesystem Alerts Directory Alerts Alert Log Running Scripts How IBM Tivoli Storage Resource Manager Runs Scripts Running scripts in response to an Alert IBM Tivoli Storage Resource Manager Reference Guide 3-1

100 Alerting Overview Overview 3 The main purpose of Tivoli Storage Resource Manager s Alerting facility is to alert you to storage-related events that occur within your environment. Once you have defined the events or conditions for which you want to be alerted, you can let Tivoli Storage Resource Manager monitor your storage so that you don't have to. The following lists the different kinds of alerts that you can define: Alerts Computer Alerts Filesystem Alerts Directory Alerts Use these alerts to... be notified when certain conditions are detected on a computer during a Probe. be notified when certain conditions are detected on a filesystem during a filesystem Scan. be notified when certain conditions are detected on a directory during a Scan. If you purchased a license of the IBM Tivoli Storage Resource Manager NAS component, see the IBM Tivoli Storage Resource Manager NAS Supplement for more detailed information about how to use Alerting functions with the NAS Filers in your environment. Alert Notification Mechanisms 3 IBM Tivoli Storage Resource Manager provides you with a number options for defining who gets notified when an alert occurs and how that notification is delivered. The choice of which alert mechanism to use will most likely depend upon the severity of the event that triggers the alert. The available alert mechanisms are described below: Alert Mechanism SNMP Trap Upon Log In to Tivoli Storage Resource Manager GUI Allows you to: Interface with the frameworks that might already be in use within your environment. See the IBM Tivoli Storage Resource Manager Configuration and Getting Started Guide for information on how to specify where to send SNMP traps. Receive a list of alerts that are targeted for you every time you log in to Tivoli Storage Resource Manager. See the Preferences Menu section in Chapter 1, Basics for information on how to control which alerts you will view upon logging in to Tivoli Storage Resource Manager. 3-2 IBM Tivoli Storage Resource Manager Reference Guide

101 Alerting Overview Alert Mechanism Windows or Unix Event log Run Script or Pager Allows you to: Write out alert messages to the OS log. If you already have an administrator monitoring OS logs, this is an easy way to have all of your priority messages centralized for quick notification and viewing. Run a script in response to an alert. See the Running Scripts section for more information about running scripts. Receive and or page when a specific type of alert is triggered. Tivoli Storage Resource Manager can send this type of notification to you, the storage administrator, and/or the violating user. This is very useful for high priority events such as running out of free space or imminent disk failure. See the IBM Tivoli Storage Resource Manager Configuration and Getting Started Guide for information on how to specify server information. IBM Tivoli Storage Resource Manager Reference Guide 3-3

102 Alerting Computer Alerts Computer Alerts 3 Computer Alerts allow you to be notified when certain conditions are detected on a computer during a Probe. Computer Alert Window 3 The window for defining or editing a computer alert contains the following tabs: Alert Tab Computers Tab The following sections describe each of these tabs. Alert Tab The following figure shows the Alert tab on the Computer Alert window. Figure 3-1 Computer Alert Window Alert Tab 3-4 IBM Tivoli Storage Resource Manager Reference Guide

103 Alerting Computer Alerts The Alert tab consists of the following two sections: Section Name Description Triggering Condition Condition Use this section to define what condition will trigger the alert. When Tivoli Storage Resource Manager detects the condition that you have specified, the alert is triggered. When the alert is triggered, the actions you specify in the Triggered Actions section are taken. You can select one triggering condition only. To alert on more than one condition, you must create more Computer Alerts, with each one containing a single condition for which to monitor and look. Triggering conditions for Computer alerts are: RAM Increased RAM Decreased Virtual Memory Increased Virtual Memory Decreased New Disk Detected Disk Not Found New Disk Defect Found Total Disk Defects Exceed n value Disk Failure Predicted New Filesystem Detected Triggered-Actions SNMP Trap Login Notification Login ID Windows Event Log, Unix Syslog Use this section to specify what actions you want taken when the alert is triggered. You can choose to set an SNMP trap, have log in notification, write messages to the OS event log, or have an or page sent to you or a list of users (these users could include the storage or system administrator in addition to the violating user). Check this box to generate an SNMP trap message to any NMS, console or terminal to indicate the occurrence of an alert. Check this box to indicate that alert should appear to the specified user upon logging in to the system. Indicate the ID of the user who will receive alert notification upon logging in to the system. Check this box to indicate that alerts will be recorded to the OS log. IBM Tivoli Storage Resource Manager Reference Guide 3-5

104 Alerting Computer Alerts Section Name Event Type Run Script Description Indicate the type of event that will be recorded to the OS log. Check this box to run a script in response to this Alert. Press. The Specify Script dialog box appears, enabling you to specify a script to run and the computer on which to run. See Running Scripts for more information on running scripts. Use this section to view, add, and delete addresses for the alert notification. Recipients: Enter the addresses you want to include for the alert notification in the top box in the list box. The bottom box displays the addresses already associated with the alert notification. Click this button to add an address you enter in the Recipients field. Click this button to delete the address you highlight in the Recipients list box. Click this button to edit the text of the alert notification on the Edit Text of the Message dialog box. 3-6 IBM Tivoli Storage Resource Manager Reference Guide

105 Alerting Computer Alerts Computers Tab Use the Computers tab to select the computers and computer groups that you would like to monitor for the alerting condition you defined in the Alert tab. The following figure shows the Computers tab on the Computer Alert window. Figure 3-2 Computer Alert Window Computers Tab The Current Selections list box shows the computers and computer groups that have been selected for the alert. The Available list box shows what computers and computer groups are still available for selection. To select a computer or group: 1 Highlight the desired computers or groups in the Available list box. 2 Click. The computers or groups you selected appear in the Current Selections list box. To remove or unselect computers or groups from Current Selections list box:! Highlight the computers or groups you want to remove and click. This will remove the computer or group from the Current Selections list box and move them to the Available list box. IBM Tivoli Storage Resource Manager Reference Guide 3-7

106 Alerting Filesystem Alerts Filesystem Alerts 3 Filesystem Alerts allow you to be notified when certain conditions are detected on a filesystem during a filesystem Scan. Figure 3-3 Filesystem Alert Window Alert Tab 3-8 IBM Tivoli Storage Resource Manager Reference Guide

107 Alerting Filesystem Alerts The main tab on the Filesystem Alert window consists of the following two sections: Section Name Description Triggering Condition Condition Use this section to define what condition will trigger the alert. When Tivoli Storage Resource Manager detects the condition that you specify, the alert is triggered. When the alert is triggered, the actions you specified in the Triggered Actions section are taken. You can select one triggering condition only. To alert on more than one condition, you must create more Filesystem alerts, with each one containing a single condition for which to monitor and look. Triggering conditions for Filesystem alerts are: Filesystem Not Found Filesystem Reconfigured Filesystem Freespace Less than n percent, KB, MB, or GB Free Unix FS Inodes Less than n percent or inodes Triggered-Actions SNMP Trap Login Notification Login ID Windows Event Log, Unix Syslog Event Type Use this section to specify what actions you want taken when the alert is triggered. You can choose to set an SNMP trap, have log in notification, write messages to the OS event log, or have an or page sent to you or a list of users (these users could include the storage or system administrator in addition to the violating user). Check this box to generate an SNMP trap message to any NMS, console or terminal to indicate the occurrence of an alert. Check this box to indicate that alert should appear to the specified user upon logging in to the system. Indicate the ID of the user who will receive alert notification upon logging in to the system. Check this box to indicate that alerts will be recorded to the OS log. Indicate the type of event that will be recorded to the OS log. IBM Tivoli Storage Resource Manager Reference Guide 3-9

108 Alerting Filesystem Alerts Section Name Run Script Description Check this box to run a script in response to this Alert. Press. The Specify Script dialog box appears, enabling you to specify a script to run and the computer on which to run. See Running Scripts for more information on running scripts. Use this section to view, add, and delete addresses for the alert notification. Recipients: Enter the addresses you want to include for the alert notification in the top box in the list box. The bottom box displays the addresses already associated with the alert notification. Click this button to add an address you enter in the Recipients field. Click this button to delete the address you highlight in the Recipients list box. Click this button to edit the text of the alert notification on the Edit Text of the Message dialog box IBM Tivoli Storage Resource Manager Reference Guide

109 Alerting Directory Alerts Directory Alerts 3 Directory Alerts allow you to be notified when certain conditions are detected on a directory during a Scan. Figure 3-4 Directory Alert Window Alert Tab IBM Tivoli Storage Resource Manager Reference Guide 3-11

110 Alerting Directory Alerts The main tab on the Directory Alert window consists of the following two sections: Section Name Description Triggering Condition Condition Use this section to define what condition will trigger the alert. When Tivoli Storage Resource Manager detects the condition that you specify, the alert is triggered. When the alert is triggered, the actions you specified in the Triggered Actions section are taken. You can select one triggering condition only. To alert on more than one condition, you must create more Directory Alerts, with each one containing a single condition for which to monitor and look. Triggering conditions for Directory alerts are: Directory Not Found Directory Consumes More Than n KB, MB, or GB Triggered-Actions SNMP Trap Login Notification Login ID Windows Event Log, Unix Syslog Event Type Use this section to specify what actions you want taken when the alert is triggered. You can choose to set an SNMP trap, have log in notification, write messages to the OS event log, or have an or page sent to you or a list of users (these users could include the storage or system administrator in addition to the violating user). Check this box to generate an SNMP trap message to any NMS, console or terminal to indicate the occurrence of an alert. Check this box to indicate that alert should appear to the specified user upon logging in to the system. Indicate the ID of the user who will receive alert notification upon logging in to the system. Check this box to indicate that alerts will be recorded to the OS log. Indicate the type of event that will be recorded to the OS log IBM Tivoli Storage Resource Manager Reference Guide

111 Alerting Directory Alerts Section Name Run Script Description Check this box to run a script in response to this Alert. Press. The Specify Script dialog box appears, enabling you to specify a script to run and the computer on which to run. See Running Scripts for more information on running scripts. Use this section to view, add, and delete addresses for the alert notification. Recipients: Enter the addresses you want to include for the alert notification in the top box in the list box. The bottom box displays the addresses already associated with the alert notification. Click this button to add an address you enter in the Recipients field. Click this button to delete the address you highlight in the Recipients list box. Click this button to edit the text of the alert notification on the Edit Text of the Message dialog box. IBM Tivoli Storage Resource Manager Reference Guide 3-13

112 Alerting Alert Log Alert Log 3 Use the Alert Log to view alerts and operate upon those alerts. You can view: Alerts by type (such as by Computer, Disk, Filesystem, Directory, User, OS User Group) All alerts Alerts directed to you (the user currently logged into the UI component) The following figure shows the Alert Log window. Figure 3-5 Alert Log Window All The following table describes the buttons at the top of the Alert Log window: Button Clear Delete Clear ALL Description Clear the selected alerts. Delete the selected alerts from the alert log. Clear all of the alerts in the report IBM Tivoli Storage Resource Manager Reference Guide

113 Alerting Running Scripts Button Delete ALL Refresh Description Delete all of the alerts in the current report from the alert log. Regenerate the report you are viewing to pick up any newly generated alerts that have been triggered since you last generated the report. Running Scripts 3 IBM Tivoli Storage Resource Manager's Triggered Action Facility allows you to define thresholds and constraints that result in notification or action. The Triggered Action Facility is script-based, allowing you to use any third-party tools for actions, such as archiving, back-up and recovery, or provisioning. How IBM Tivoli Storage Resource Manager Runs Scripts 3 During installation, Tivoli Storage Resource Manager creates a directory on every Server and Agent machine called: \<install_directory>\scripts, where <install_directory> represents to the directory where the Agent or Server is installed. The default installation directory for Tivoli Storage Resource Manager components is: (Windows) \Program Files\Tivoli\TSRM (Unix) /opt/tivoli/tsrm or /usr/tivoli/tsrm When a script is run: 1 The Server looks in its local \scripts directory. 2 If the Server can resolve that script name, it loads that script and sends it to the Agent where you designated the script to be run. When running a script against a NAS filer, the script is run from the Agent assigned to the filesystem where the triggering condition occurred. 3 The Agent receives the script, names it as a temporary file, and runs it. 4 After the Agent has finished running the script, the temporary file is deleted. There are two main reasons to run a script: in response to an alert for batch reports When a script is run, the Server looks in its local \scripts directory. If the Server can resolve that script name, it loads that script, sends it to the Agent where you designated the script to be run. The Agent receives the script, names it as a temporary file, and runs it. After the Agent has finished running the script, the temporary file is deleted. IBM Tivoli Storage Resource Manager Reference Guide 3-15

114 Alerting Running Scripts There are two conditions why the script may not run when sent by the Server: 1 The script already exists in the Agent's \scripts directory. In this case, the Agent will ignore the script sent by the Server and just run its local version. 2 If you did not check the Agent may run scripts sent by server option in the installation parameters screen, the Agent will ignore the script sent by the server. If you checked the Agent may run scripts sent by server option during the Tivoli Storage Resource Manager installation, the Agent will run scripts sent by the Server. The advantage of checking this option is you need only store one copy of the script in the Servers' \scripts directory and do not have to keep a copy of the script on every Agent machine. When a script needs to be run on a particular Agent, the Server will access the script from it's local \scripts directory and send it to the Agent to be run. When the script is pushed out to the Agent, it is named as temporary file. After the Agent has finished running the script, the temporary file is deleted. For example: If a computers filesystem free space falls below a certain threshold, you can run a script based on that threshold on the machine where the filesystem exists. To do this, you would not target a particular Agent on which to run the script, but instead indicate that the script should run on any computer that has the filesystem low freespace condition. If the Agent may run scripts sent by server option is unchecked, you must make sure that the script is stored in every Agent s \scripts directory. If the Agent may run scripts sent by server option is checked, the Server will push out the script to the Agent machine that has the low freespace condition. In this case, you only have to ensure that the script exists on the Servers \scripts directory, and not on any of the Agents s scripts directory. Note We recommend storing the scripts you want to run globally (across all your Agents) on the Server machine. Store the scripts you want to run locally on the Agent machines where you want them to run IBM Tivoli Storage Resource Manager Reference Guide

115 Alerting Running Scripts Running scripts in response to an Alert 3 When you define an Alert, you can define a script to be run when the triggered condition is met. 1 On the Alert tab, check Run Script. 2 Press. The Specify Script dialog box displays. IBM Tivoli Storage Resource Manager Reference Guide 3-17

116 Alerting Running Scripts 3 Enter the name of the script in the Script Name field. Note This script name is used to tell the Server what script to send to the Agent. If the script sent by the Server is run by the Agent, the name of the script will not be the name you specify in the Script Name field. Instead, the Agent names the script as temporary file, runs it, then deletes it after the script has run. Because of this, you should not have code in your script that depends on this script name. 4 Specify where you want the script to run in the Where to Run field. You can select a specific Agent, or the triggering computer. For example, if a constraint is violated on a filesystem on a specific machine, you would typically want the script to run the machine that triggered the constraint violation. (For some types of Alerts such as Job Failed, you will not have the option to run the script on the triggering computer. Here you can run the script on any agent you choose.) 5 The Script Parameters section displays what parameters will be passed to the script when it is run. Each triggering condition passes different parameters. The parameters will be passed in the order specified on the dialog box. See Script Parameters for information on all available script parameters. 6 When you are finished, press IBM Tivoli Storage Resource Manager Reference Guide

117 Alerting Running Scripts Script Parameters Script parameters provide specific information on the alert that triggered the script to be run. The parameters passed to a script depends on the type of alert that was triggered by Tivoli Storage Resource Manager. The following table describes all the script parameters: Script Parameter <creator>.<name> <run-number> <failed-jobs> <total-jobs> <computer> <old-ram> MB <current-ram> MB <old VM> MB <current-vm> MB <old-grown-defects> <mount-point> <manufacturer>/<serialnumber> <current-growndefects> <freespace><sizedesignator> <threshold><thrdesignator> <percent-of-capacity>% <free-inodes> <threshold> <consecutive-failures> Description Creator of the ping, probe, scan schedule. Name of the schedule. Number of the run. Number of failed jobs in the run. (Each job runs on a different machine). Total number of jobs in a run. Computer name where the triggering condition occurred. Previous value of the RAM in megabytes. Current value of the RAM in megabytes. Previous value of the sum of the RAM and the swap space in megabytes. Current value of the sum of the RAM and the swap space in megabytes. Manufacturer of the disk. Serial number of the disk. Current number of grown defects on the disk. Previous number of grown defects on the disk. Path to the filesystem. Value of freespace, in KB, MB, or GB. Value of the triggering condition, in KB, MB, or GB, or % (value units). Percentage of capacity of the filesystem. Maximum number of files available to be created on this filesystem. Value that you set for the triggering condition. If the value unit was specified as a %, then a % will follow this value. Number of consecutive failed attempts to ping the computer. IBM Tivoli Storage Resource Manager Reference Guide 3-19

118 Alerting Running Scripts Script Parameter <path> <violating-file-count> <file-of-violating-files> <usage><sizedesignator> <file-of-violatingowners> Description Path to the directory. Value of used disk space, in KB, MB, or GB. Number of files which met the conditions defined in the constraint. Temporary file containing a list of files violating the constraint. This is listed as one file per line. Temporary file containing a list of owners who owns the violating files IBM Tivoli Storage Resource Manager Reference Guide

119 4 Policy Management Overview Alert Notification Mechanisms Quotas How Quotas Work User and OS User Group Quota Definition Window Constraints Migrating User-Defined Constraint Definitions Constraint Definition Window Scheduled Actions How Scripts Work Create Script Window IBM Tivoli Storage Resource Manager Reference Guide 4-1

120 Policy Management Overview Overview 4 Use the Policy Management feature of Tivoli Storage Resource Manager enables you to: define limits on the amount of storage that a user or a group of users can consume. Quotas allow you to specify limits at three different levels for a user or group of users: at the filesystem level, at the computer level, and at the level of the whole network. define the acceptable and unacceptable file types, file sizes, and file owners for a computer or a set of computers in your environment. Constraints enable you to do such things as restrict users from putting certain files (such as MP3 files) on monitored computers. schedule actions to execute scripts against your storage-related resources. The NAS component of Tivoli Storage Resource Manager enables you to manage the Quotas created on NetApp filers using the software provided with those filers. If you purchased a license of the IBM Tivoli Storage Resource Manager NAS component, see the IBM Tivoli Storage Resource Manager NAS Supplement for more detailed information about how to use Policy Management functions with NAS Filers in your environment. Alert Notification Mechanisms 4 IBM Tivoli Storage Resource Manager provides you with a number options for defining who gets notified when a Quota or Constraint is violated and how that notification is delivered. The choice of which alert mechanism to use will most likely depend upon the severity of the violation that triggers the alert. The available alert mechanisms are described below: Alert Mechanism SNMP Trap Upon Log In to Tivoli Storage Resource Manager GUI Allows you to: Interface with the frameworks that might already be in use within your environment. See the IBM Tivoli Storage Resource Manager Configuration and Getting Started Guide for information on how to specify where to send SNMP traps. Receive a list of violations that are targeted for you every time you log in to Tivoli Storage Resource Manager. See the Preferences Menu section in Chapter 1, Basics for information on how to control which alerts you will view upon logging in to Tivoli Storage Resource Manager. 4-2 IBM Tivoli Storage Resource Manager Reference Guide

121 Policy Management Overview Alert Mechanism Windows Event Log, Unix Syslog Run Script or Pager Allows you to: Write out alert messages to the OS log. If you already have an administrator monitoring OS logs, this is an easy way to have all of your priority messages centralized for quick notification and viewing. Run a script in response to an alert. See the Running Scripts section in the Alerting chapter for more information about running scripts. Receive and or page when a specific type of violation occurs. Tivoli Storage Resource Manager can send this type of notification to you, the storage administrator, and/or the violating user. See the IBM Tivoli Storage Resource Manager Configuration and Getting Started Guide for information on how to specify server information. IBM Tivoli Storage Resource Manager Reference Guide 4-3

122 Policy Management Quotas Quotas 4 Use Quotas to define limits on the amount of storage that a user or a group of users can consume. Quotas allow you to specify limits at three different levels for a user or group of users: at the filesystem level, at the computer level, and at the level of the whole network. Level Filesystem Network Computer Description Define Quotas for a user or group of users at the filesystem level. Define a Quota that place limits over multiple machines. You can place network level limits on users or groups of users for all the computers (or a chosen subset) or filesystems in your environment. This enables you to define quotas that affect multiple machines on your network. Define a Quota that places limits on a specific machine for a user or group of users. This means that the quota that you set for a user or group of users, will be enforced on each computer for which you have defined the quota. By providing you with the ability to define Quotas at different levels, you can control precisely how much storage a user can consume, not only on specific file systems, but on specific computers and groups of computers within your organization. Tivoli Storage Resource Manager provides you the unique ability to specify these limits at any or all three different levels. How Quotas Work 4 1 A Scan gathers extensive information about the computers, filesystems, and directories within an enterprise. This information is stored in the Enterprise Repository. 2 When a Quota job runs, it checks the information in the Enterprise Repository to determine if any quota violations exist. 3 If there are any violations, an alert is triggered and the appropriate action is taken. Tip Because the information analyzed by Quotas is provided by Scans, you should schedule a Quota to run after the corresponding Scan. This ensures that Quotas are using the latest information about an enterprise to determine violations. 4-4 IBM Tivoli Storage Resource Manager Reference Guide

123 Policy Management Quotas User and OS User Group 4 You can define two different kinds of Quotas: User and OS User Group. User Quota. Select users and groups of users for a Quota that have been defined within Tivoli Storage Resource Manager. OS User Group Quota. Select OS User Groups for a Quota. OS USer Groups are groups of users that have been defined in the operating system outside of Tivoli Storage Resource Manager. You can create Groups that contain many OS User Groups. When creating a Quota of this type, you can either select an OS User Group and/or a group that consists of multiple OS User Groups. Quota Definition Window 4 The window for defining or editing a Quotas contains the following tabs: Users Tab Filesystems Tab When to CHECK Tab Alert Tab The following sections describe each of the Users and Filesystems tabs. IBM Tivoli Storage Resource Manager Reference Guide 4-5

124 Policy Management Quotas Users Tab Selecting users is the first step in defining a Quota. Access the Users tab to select individual users and user groups that you have previously defined using the Group facility. See Groups on page 3 for more information about defining groups. The following figure shows the Users tab on the Quota Definition window. Figure 4-1 Quota Definition window Users tab The Profile selection list controls which storage usage statistics are used when checking for Quota violations. You can select any of the GROUP_BY_OWNER type Profiles shown. Make sure that the selected profile is used in scans of all the filesystems chosen on the Filesystems tab. This ensures that the Quota is fairly enforced for all users. To select a user or user group: 1 Highlight the desired users or groups in the Available list box. 2 Click. The users or groups you selected appear in the Current Selections list box. To remove or unselect users or groups from Current Selections list box:! Highlight the users or groups you want to remove and click. This will remove the users or groups from the Current Selections list box and move them to the Available list box. 4-6 IBM Tivoli Storage Resource Manager Reference Guide

125 Policy Management Quotas Filesystems Tab Selecting filesystems and computers against which the Quota will apply is the next step when defining a Quota. Use the Filesystems tab to select individual filesystems and computers, as well as filesystem and computer groups that you have previously defined using the Group facility. See Groups on page 3 for more information about defining groups. The following figure shows the Filesystems tab on the Quota Definition window. Figure 4-2 Quota Definition window Filesystems tab The Current Selections list box shows the filesystems, filesystem groups, computer groups, and computers that have been selected for the Quota. The Available list box shows what items are still available for selection. To select a filesystem, computer, or group: 1 Highlight the desired filesystems, computers, or groups in the Available list box. 2 Click. The filesystems, computers, or groups you selected appear in the Current Selections list box. To remove or unselect items from Current Selections list box:! Highlight the items you want to remove and click. This will remove the filesystems, computers, or groups from the Current Selections list box and move them to the Available list box. IBM Tivoli Storage Resource Manager Reference Guide 4-7

126 Policy Management Quotas When to CHECK Tab Use the When to CHECK tab to schedule how often you want the quota to be checked. The following figure shows the When to CHECK tab on the Quota Definition window. Figure 4-3 Quota Definition window When to CHECK tab Check the quota immediately Check the quota once at a specified time and date Check the quota repeatedly according to a schedule you specify Select the option you want and then edit the time and date information accordingly. When scheduling Quotas, keep in mind that the statistics checked by the Quota are gathered by a Scan. To ensure the most accurate reflection of storage usage within your environment, it is recommended that you schedule Quotas to run after the appropriate Scan job. You can also select the time zone for the schedule you specify. You can either select the time zone that the Server is in or any other time zone. 4-8 IBM Tivoli Storage Resource Manager Reference Guide

127 Policy Management Quotas Alert Tab Use the Alert tab to define an alert that will be triggered if a user or user group violates the quota. The following figure shows the Alert tab on the Quota Definition window. Figure 4-4 Quota Definition window Alert tab The Alert tab consists of the following two sections: Section Name Description Triggering Condition Condition Triggered-Actions Specify what condition will violate Quota by entering the quota limit value in terms of KB, MB, or GB. Once this value is reached (i.e., exceeded the total size amount you specified in this section), the Quota is considered violated and the alert is triggered. When the alert is triggered, the actions you specified in the Triggered Actions section are taken. Use this section to specify what actions you want taken when a Quota is exceeded. You can choose to set an SNMP trap, have log in notification, write messages to the OS event log, or have an or page sent to you or a list of users (these users could include the storage or system administrator in addition to the violating user). IBM Tivoli Storage Resource Manager Reference Guide 4-9

128 Policy Management Quotas Section Name SNMP Trap Login Notification Login ID Windows Event Log, Unix Syslog Event Type Run Script Description Check this box to generate an SNMP trap message to any NMS, console or terminal to indicate the occurrence of an alert. Check this box to indicate that alert should appear to the specified user upon logging in to the system. Indicate the ID of the user who will receive alert notification upon logging in to the system. Check this box to indicate that alerts will be recorded to the Windows Event Log or Unix Syslog. Indicate the type of event that will be recorded to the OS log. Check this box to run a script in response to this Alert. Press. The Specify Script dialog box appears, enabling you to specify a script to run and the computer on which to run. See Running scripts in response to an Alert for more information on running scripts triggered by alerts. Use this section to view, add, and delete addresses for the alert notification. Recipients: Enter the addresses you want to include for the alert notification in the top box in the list box. The bottom box displays the addresses already associated with the alert notification. Click this button to add an address you enter in the Recipients field. Click this button to delete the address you highlight in the Recipients list box. Click this button to edit the text of the alert notification on the Edit Text of the Message dialog box IBM Tivoli Storage Resource Manager Reference Guide

129 Policy Management Constraints Constraints 4 Use Constraints to define the acceptable and unacceptable file types, file sizes, and file owners for a computer or a set of computers in your environment. Constraints enable you to do such things as restrict users from putting certain files (for example, MP3 files) on monitored servers. Migrating User-Defined Constraint Definitions 4 You can migrate user-defined constraint definitions from one Server to another by using an export utility run from a command line. Exporting Constraints enables you to define Constraints once and re-use them with the jobs on another Server. To do this, simply export the user-defined objects to a file, then import the exported data into the new Server. The export utility is found in the directory, home/server/tools. The valid command line arguments are: To export user defined objects to a file, type: export -e <target-file-name> where target-file-name represents a fully qualified file name. To import previously exported data, type: export -i <target-file-name> where target-file-name represents a fully qualified file name. Constraint Definition Window 4 The window for defining or editing a Constraint contains the following tabs: Filesystems Tab File Types Tab Users Tab Options Tab Alert Tab The following sections describe each of these tabs. Filesystems Tab Selecting filesystems and computers against which a Constraint will apply is the first step when defining a Constraint. Use the Filesystems tab to select individual filesystems and computers, as well as filesystem and computer groups that you have previously defined using the Group facility. See Groups on page 3 for more information about defining groups. IBM Tivoli Storage Resource Manager Reference Guide 4-11

130 Policy Management Constraints The following figure shows the Filesystems tab on the Constraint Definition window. Figure 4-5 Constraint Definition Window Filesystems tab The Current Selections list box shows the filesystems, filesystem groups, computer groups, and computers that have been selected for the Constraint. The Available list box shows what items are still available for selection. To select a filesystem, computer, or group: 1 Highlight the desired filesystems, computers, or groups in the Available list box. 2 Click. The filesystems, computers, or groups you selected appear in the Current Selections list box. To remove or unselect items from Current Selections list box:! Highlight the items you want to remove and click. This will remove the filesystems, computers, or groups from the Current Selections list box and move them to the Available list box IBM Tivoli Storage Resource Manager Reference Guide

131 Policy Management Constraints File Types Tab Use the File Types tab to select the file types that you want to allow or forbid. The following figure shows the File Types tab on the Constraint Definition window. Figure 4-6 Constraint Definition Window File Types tab To set up the file types you want to forbid or allow: 1 Click the Forbid file matching these patterns radio button to not allow files of the specified type on a server. Or Click the Allow ONLY file matching these patterns radio button to allow files only of the specified type on a server. 2 Click the file type(s) that you would like to allow or forbid in the Choose a file type list box. The file types listed in this box are predefined in the system. Note You can also enter your own wildcard pattern for file types. 3 Click. The file types you selected will appear in the Forbidden files list box. IBM Tivoli Storage Resource Manager Reference Guide 4-13

132 Policy Management Constraints To define a custom file type: 1 Enter the pattern in the Or enter a pattern field. 2 Click. The custom file type appears in the Forbidden files list box. To remove a file type: 1 Click the file type you want to remove in the Forbidden files list box. 2 Click. The file type is moved back to the Choose a file type list box. Users Tab Use the Users tab to allow or forbid files owned by specific users. The following figure shows the Users tab on the Constraint Definition window. Figure 4-7 Constraint Definition Window Users tab To set up the file owners you want to forbid or allow: 1 Click the Forbid file owned by selected users radio button to not allow files owned by the specified users. Or Click the Allow ONLY file owned by the specified owner radio button to allow files owned by the specified users only IBM Tivoli Storage Resource Manager Reference Guide

133 Policy Management Constraints 2 Click the user(s) that you would like to select in the Available Users list box. 3 Click. The users you selected will appear in the Forbidden Users list box. To remove a user: 1 Click the user you want to remove in the Forbidden Users list box. 2 Click. The file type is moved back to the Available Users list box. Options Tab The Options tab allows you to define the file characteristics that will trigger the alert. Figure 4-8 Constraint Definition Window Options tab The Options tab consists of the following two sections: Alert On Files. Use this section to define alerts for files based on characteristics other than file type and file owner. These characteristics include: Files that have not been accessed in a user-defined length of time Files that are larger a user-defined size Files that have the SET-UID root bit on (because this can be a security consideration) Files that have been modified and not backed up IBM Tivoli Storage Resource Manager Reference Guide 4-15

134 Policy Management Constraints File Filter Text. This section displays a where clause that will be used as a filter for locating files that violate the Constraint definition. The choices you make on this tab and the choices you made on the Users and File Type tabs are reflected in the content of this where clause. To edit the where clause filter text, click the Edit Filter button on the right of the tab. This will allow you to create new where conditions and groupings using the where clause interface. See Creating File Filters for more information. Figure 4-9 Constraint Definition Window Editing Filter Text 4-16 IBM Tivoli Storage Resource Manager Reference Guide

135 Policy Management Constraints Alert Tab Use the Alert tab to define the alerting criteria for a Constraint. The following figure shows the Alert tab on the Constraint Definition window. Figure 4-10 Constraint Definition Window Alert tab The Alert tab consists of the following two sections: Section Name Description Triggering Condition Condition Specify what condition will violate the Constraint by entering the space limit the violating files can consume. You can select one triggering condition only. To alert on more than one condition, you must create more Constraints, with each one containing a single condition for which to monitor and look. Once Tivoli Storage Resource Manager has found enough files that violate the condition (i.e., that exceed the total size amount you specified in this section), the Constraint is considered violated and the alert is triggered. When the alert is triggered, the actions you specified in the Triggered Actions section are taken. IBM Tivoli Storage Resource Manager Reference Guide 4-17

136 Policy Management Constraints Section Name Triggered-Actions SNMP Trap Login Notification Login ID Windows Event Log, Unix Syslog Event Type Run Script Description Use this section to specify what actions you want taken when a Constraint is violated. You can choose to set an SNMP trap, have log in notification, write messages to the OS event log, or have an or page sent to you or a list of users (these users could include the storage or system administrator in addition to the violating user). Check this box to generate an SNMP trap message to any NMS, console or terminal to indicate the occurrence of an alert. Check this box to indicate that alert should appear to the specified user upon logging in to the system. Indicate the ID of the user who will receive alert notification upon logging in to the system. Check this box to indicate that alerts will be recorded to the Windows Event Log or Unix Syslog. Indicate the type of event that will be recorded to the OS log. Check this box to run a script in response to this Alert. Press. The Specify Script dialog box appears, enabling you to specify a script to run and the computer on which to run. See Running scripts in response to an Alert for more information on running scripts triggered by alerts. Use this section to view, add, and delete addresses for the alert notification. Recipients: Enter the addresses you want to include for the alert notification in the top box in the list box. The bottom box displays the addresses already associated with the alert notification. Click this button to add an address you enter in the Recipients field. Click this button to delete the address you highlight in the Recipients list box. Click this button to edit the text of the alert notification on the Edit Text of the Message dialog box IBM Tivoli Storage Resource Manager Reference Guide

137 Policy Management Scheduled Actions Scheduled Actions 4 Use the Scheduled Action facility allows you to schedule scripts to run against selected computers and computer groups. The Scheduled Actions facility is script-based, allowing you to use any third-party tools for actions, such as archiving, back-up and recovery, or provisioning. You can schedule scripts to run: immediately once at a specified time and date repeatedly according to a schedule you specify Select the option you want and then edit the time and date information accordingly. You can also select the time zone for the schedule you specify. You can either select the time zone that the Server is in or any other time zone. Note The Scheduled Actions facility should not be confused with the Triggered Action facility. The Triggered Action facility enables you to run scripts based upon conditions/alerts that are detected within your storage environment. The Scheduled Action facility enables you to run scripts according to the schedule that you define, without having to associate the script with an alert. How Scripts Work 4 During installation, Tivoli Storage Resource Manager creates a directory on every Server and Agent machine called: \<install_directory>\scripts, where <install_directory> represents to the directory where the Agent or Server is installed. The default installation directory for Tivoli Storage Resource Manager components is: (Windows) \Program Files\Tivoli\TSRM (Unix) /opt/tivoli/tsrm or /usr/tivoli/tsrm When a script is run: 1 The Server looks in its local \scripts directory. 2 If the Server can resolve that script name, it loads that script and sends it to the Agent where you designated the script to be run. When running a script against a NAS filer, the script is run from the Agent assigned to the filesystem where the triggering condition occurred. 3 The Agent receives the script, names it as a temporary file, and runs it. 4 After the Agent has finished running the script, the temporary file is deleted. There are two conditions why the script may not run when sent by the Server: 1 The script already exists in the Agent's \scripts directory. In this case, the Agent will ignore the script sent by the Server and just run its local version. IBM Tivoli Storage Resource Manager Reference Guide 4-19

138 Policy Management Scheduled Actions 2 If you did not check the Agent may run scripts sent by server option in the installation parameters screen, the Agent will ignore the script sent by the server. If you checked the Agent may run scripts sent by server option during the Tivoli Storage Resource Manager installation, the Agent will run scripts sent by the Server. The advantage of checking this option is you need only store one copy of the script in the Servers' \scripts directory and do not have to keep a copy of the script on every Agent machine. When a script needs to be run on a particular Agent, the Server will access the script from it's local \scripts directory and send it to the Agent to be run. Create Script Window 4 The window for scheduling scripts contains the following tabs: Computers Tab Script Options Tab When to Run Tab Alert Tab The following sections describe each of these tabs. Computers Tab Selecting the computers and computer groups against which to run a script is the first step when defining a scheduled action. Use the Computers tab to select individual computers, as well as computer groups that you have previously defined using the Group facility IBM Tivoli Storage Resource Manager Reference Guide

139 Policy Management Scheduled Actions The following figure shows the Computers tab on the Create Script window. Figure 4-11 Create Script Window Computers tab The Current Selections list box shows the computer groups and computers that have been selected for the scheduled action. The Available list box shows what items are still available for selection. To select a computer or computer group: 1 Highlight the desired computers and/or computer groups in the Available list box. 2 Click. The items you selected appear in the Current Selections list box. To remove or unselect items from Current Selections list box:! Highlight the items you want to remove and click. This will remove the computers/ groups from the Current Selections list box and move them to the Available list box. IBM Tivoli Storage Resource Manager Reference Guide 4-21

140 Policy Management Scheduled Actions Script Options Tab Use the Script Options tab to select the script you want to run against the selected computers and computer groups. The following figure shows the Script Options tab on the Create Script window. Figure 4-12 Create Script Window Script Options tab! To select a script, choose a file from the Script Name drop-down list. The scripts that appear in the drop-down list are stored in the \<tivoli_home_directory>\scripts directory on the Server. Note The scripts that appear in the Script Name drop-down list are stored on the machine where Tivoli Storage Resource Manager Server component is located. If you want to run a script that is stored on an Agent, you must type the name of that script in the Script Name field IBM Tivoli Storage Resource Manager Reference Guide

141 Policy Management Scheduled Actions When to Run Tab Use the When to Run tab to schedule how often to run the action/script. The following figure shows the When to Run tab on the Create Script window. Figure 4-13 Create Script window When to Run tab You can schedule a script to run: immediately at a specified time and date repeatedly according to a schedule you specify Select the option you want and then edit the time and date information accordingly. You can also select the time zone for the schedule you specify. You can either select the time zone that the Server is in or any other time zone. IBM Tivoli Storage Resource Manager Reference Guide 4-23

142 Policy Management Scheduled Actions Alert Tab Use the Alert tab to define an alert that will be triggered if the script fails. The following figure shows the Alert tab on the Create Script window. Figure 4-14 Quota Definition window Alert tab The Alert tab consists of the following two sections: Section Name Triggered-Actions SNMP Trap Login Notification Login ID Description Use this section to specify what actions you want taken when a Quota is exceeded. You can choose to set an SNMP trap, have log in notification, write messages to the OS event log, or have an or page sent to you or a list of users (these users could include the storage or system administrator in addition to the violating user). Check this box to generate an SNMP trap message to any NMS, console or terminal to indicate the occurrence of an alert. Check this box to indicate that alert should appear to the specified user upon logging in to the system. Indicate the ID of the user who will receive alert notification upon logging in to the system IBM Tivoli Storage Resource Manager Reference Guide

143 Policy Management Scheduled Actions Section Name Windows Event Log, Unix Syslog Event Type Run Script Description Check this box to indicate that alerts will be recorded to the OS log. Indicate the type of event that will be recorded to the OS log. Check this box to run a script in response to this Alert. Press. The Specify Script dialog box appears, enabling you to specify a script to run and the computer on which to run. See Running scripts in response to an Alert for more information on running scripts triggered by alerts. Use this section to view, add, and delete addresses for the alert notification. Recipients: Enter the addresses you want to include for the alert notification in the top box in the list box. The bottom box displays the addresses already associated with the alert notification. Click this button to add an address you enter in the Recipients field. Click this button to delete the address you highlight in the Recipients list box. Click this button to edit the text of the alert notification on the Edit Text of the Message dialog box. IBM Tivoli Storage Resource Manager Reference Guide 4-25

144 Policy Management Scheduled Actions 4-26 IBM Tivoli Storage Resource Manager Reference Guide

145 5 Reporting Overview Reporting Categories Reporting Tree By Clauses Working with Reports Overview Selecting a Report Selecting an Object Generating a Report Viewing a Report Drilling Down a Report Row Generating a Report Chart Navigating Tabs Trending with Historical Data Printing Reports or Charts My Reports System Reports User ID Reports Batch Reports Asset Reporting By Computer By OS Type System Wide Availability Reporting Ping Reporting Computer Uptime Reporting IBM Tivoli Storage Resource Manager Reference Guide 5-1

146 Reporting Capacity Reporting Disk Capacity Reporting Filesystem Capacity Reporting Filesystem Used Space Reporting Filesystem Free Space Reporting Usage Reporting Access Load Reporting Files Reporting Directories Reporting Users Reporting OS User Groups Reporting Usage Violation Reporting Constraint Violations Reporting Quota Violations Reporting Backup Reporting Most At Risk Files Reporting Modified Files not Backed Up Reporting Backup Storage Requirements Reporting IBM Tivoli Storage Resource Manager Reference Guide

147 Reporting Overview Overview 5 Use the Reporting facility of Tivoli Storage Resource Manager to view both overview and detailed information about your storage. The 300+ available reports are constructed from the statistical information accumulated in the Enterprise Repository. The reporting features are very powerful, allowing you to select exactly the computers, disks, file systems, and even users upon which you want to report. You can view reports as tables of data or as graphical charts, which provides you with the flexibility to get a very detailed look at your information or a very high level overview. If you purchased a license of the IBM Tivoli Storage Resource Manager NAS Component, see the IBM Tivoli Storage Resource Manager NAS Supplement for more detailed information about how to use Reporting functions with the NAS Filers in your environment. Reporting Categories 5 There are many types of reporting available. The major reporting categories are: Reporting Category Asset Reporting Use these reports to... view the informatoin gathered by Probes. While running Probes, it itemizes the information about your computers, disks, controllers, and file systems, and builds a hardware inventory of your storage assets. You can then navigate through a hierarchical view of your assets by drilling down through computers, controllers, disks, file systems, directories, and exports/ shares. These reports can be viewed hierarchically: based upon computer based upon operating system type throughout the system, allowing you to investigate all of your disks, file systems, controllers, and other assets for your entire system Availability Reporting monitor and report on the availability of your storage, both from a network point of view and from a computer up-time perspective. This allows you to see what percentage of the time the storage in your enterprise (or on particular server or group of servers), is off-network due to network problems or perhaps is unavailable due to system downtime. In today s fast-paced marketplace, 24x7 application availability is critical, and the Availability reporting function provides a powerful tool for monitoring the availability of the storage and data that back up your applications. IBM Tivoli Storage Resource Manager Reference Guide 5-3

148 Reporting Overview Reporting Category Capacity Reporting Use these reports to... view storage capacity at a file system, computer, or entire network level. For a specific computer, group of computers, or all the computers in your enterprise, you can view: how much storage you have how much storage is being used what percentage of storage is free for expansion The Capacity reporting function provides you with the ability to view your entire enterprise in a single view. Usage Reporting monitor and report on the usage and growth of the consumption of your storage. You can view these reports based on specific file systems and computers, groups of file systems and computers, or throughout your entire enterprise. Use these reports to: view which servers and file systems are experiencing the heaviest (or lightest) load of data and storage access identify wasted space by pinpointing files that are no longer needed or have not been accessed for the longest time associate users with the amount of storage they are consuming on specific file systems, groups of file systems, specific computers, groups of computers, and throughout the entire network These reports help you project storage consumption for the future and maximize the current storage assets that you have in place by eliminating wasted space and making the most of the space you have. 5-4 IBM Tivoli Storage Resource Manager Reference Guide

149 Reporting Overview Reporting Category Usage Violation Reporting Use these reports to... create and enforce corporate storage usage policies. You can report on both Quota Violations and Constraint Violations. With Quotas, you can control how much storage a user, or a group of users, can consume on: a file system or group of file systems a computer or group of computer throughout the entire network With Constraints you can set policies about which types of files, owners, and file sizes are allowed on: a file system or group of file systems a computer or group of computer throughout the entire network Backup Reporting identify the most at risk files in your enterprise that are not backed up properly. Critical data that is not backed up might expose you to costly losses of information. The Backup reporting function also allows you: to investigate the sizes of data that would be required to backup to achieve full backups of any subset of your enterprise (including the whole enterprise) determine the amount of space required to perform an incremental backup of any or all of your data at any given point in time IBM Tivoli Storage Resource Manager Reference Guide 5-5

150 Reporting Overview Reporting Tree 5 Each of the major reporting categories in the Reporting facility can be expanded in the function tree to reveal additional sub-categories of reporting. Below is an expanded view of the Reporting function tree: Asset Reports Availability Reports Capacity Reports 5-6 IBM Tivoli Storage Resource Manager Reference Guide

151 Reporting Overview Usage Reports Usage Violations Reports Backup Reports IBM Tivoli Storage Resource Manager Reference Guide 5-7

152 Reporting Overview By Clauses 5 As you drill down through reports while working in the Reporting facility, you will notice a set of options that repeats for each report type. These By Clauses allow you to generate variations of the reports with different perspectives and groupings of the data. The available By Clauses are described in the following table: By Clause By Directory By Directory Group By Filesystem By Filesystem Group By Computer By Computer Group By Domain Network Wide Description Use this clause to select the directories that you want to report upon and the report that will be generated based upon those directories. Use this clause to select the directory groups that you want to report upon and the report that will be generated based upon those directory groups. Use this clause to select the file systems that you want to report upon and the report that will be generated based upon those file systems. Use this clause to select the file system groups that you want to report upon and the report that will be generated based upon those file system groups. Use this clause to select the computers that you want to report upon and the report that will be generated based upon those computers. Use this clause to select the computer groups that you want to report upon and the report that will be generated based upon those computer groups. Use this clause to select the Window Domains that you want to report upon and the report that will be generated based upon those domains. The reports and charts that you see will be generated on all data, network wide. This allows you to get a global view of the storage and storage usage for your whole enterprise. 5-8 IBM Tivoli Storage Resource Manager Reference Guide

153 Reporting Working with Reports Working with Reports 5 Overview 5 When you select a report you want to view, you are allowed to fine tune the objects that you want to report on via object selection. After selecting the objects to report on, you generate the report by clicking. Tab will dynamically appear in the content pane representing the reports that you generate. You can scroll up/down and right/left within a tabbed window to view the entire contents of a report. To sort the columns within a report: Columns within each report can be sorted on by clicking on the column header. This will sort the entire tabular report in either ascending or descending order based upon the column you have selected. Clicking on the same column again will cause the order of sorting to be reversed (i.e., if the column was sorted in ascending order, clicking on it again will sort the report in descending order on that column). To view a chart of all of the rows in the table: 1 Click on the that appears at the top of the report. All reports that support charting will have this multi-colored pie chart icon at the top of the report. 2 Select the type of chart you would like to generate. A new tab will be added to the tab dialog to contain the chart. Any row in a report that supports charting on that individual row will have a that row. on the left of To generate a chart for just the element in that row:! Double-click contained in the left of that report row. Many of the rows presented in reports allow you to drill down and get additional reports containing more detailed information. For example, if you are looking at a report on computers, you might be able to drill down on a row for a specific computer and generate a report for the file systems contained on that computer. When detailed drill down is allowed within a report, a magnifying glass icon appears to the left of a row. To drill down, double-click on the magnifying glass icon and a new tab will appear that contains information about the specific row. IBM Tivoli Storage Resource Manager Reference Guide 5-9

154 Reporting Working with Reports Selecting a Report 5 To select the report that you want to generate and view, navigate through the function tree by expanding the Reporting node and sub nodes that lead you to the report that you wish to view. After you have expanded the tree representing the desired report, click that node to view the report in the content pane. Depending on the report you have chosen and the level upon which you have chosen to report (for example, by computer, by file system, network wide, etc.), you are typically presented with a single tab dialog in the content pane containing the object Selection tab. Use this tab to select what objects you would like to be reporting upon. For example, if you want to generate an Obsolete Files report By Computer, expand Reporting! Usage! Files! Most Obsolete Files! By Computer. Figure 5-1 Selecting a Report 5-10 IBM Tivoli Storage Resource Manager Reference Guide

155 Reporting Working with Reports Selecting an Object 5 Once you have selected the report that you want to generate and view, you are presented with a Selection tab in the content pane. Figure 5-2 Selection Tab Use this tab to fine tune the selection of objects upon which you want to generate a report. In the above example, the Most Obsolete Files report By Computer has been selected. Because report has been selected from the Computer perspective, the Selection tab appears. This tab allows you to pick one or more of the available computers upon which to report. This tab is divided into two distinct sections: Report Filter Specifications. Use the options in this section to fine-tune the generation of the report. You can enter a number in the Return maximum of rows per computer field to control how many rows are generated in the report. This will allow you to control the size of the report that is generated. In the example of Most Obsolete File reporting, you can enter 10 in the Return maximum of rows per computer field and to limit the number of rows in the report to only 10 Obsolete Files per computer. If you have set up scans to collect many more row than that per computer, this is an effective and efficient way to control the size of the generated report. IBM Tivoli Storage Resource Manager Reference Guide 5-11

156 Reporting Working with Reports Also within the Report Filter Specifications section of the Selection tab, there is a Profile drop-down list box. Select a Profile you want to use to generate the report. You can report on one profile at a time. This field will display the last profile you used to generate this report. If you select a profile that was not used in the Scan to gather the report data, then generate the report, Tivoli Storage Resource Manager will display No Data to Display. If you want to use the supplied default Profile, then leave the field as is and generate the report. However, if you want to use a customized Profile that you have set up for this reporting, choose that Profile from the drop-down list. Keep in mind that Profiles control what statistics are gathered and also what files are included in that statistical analysis. Object Selection. When the Selection tab is initially displayed, all objects in the list are preselected for your convenience. If you would like to generate the report for all the objects that have been selected for you, then click. You can use the Select All and Clear All buttons to quickly select and unselect all of the objects in the list. To select/deselect individual rows in the object selection list, simply click on the checkbox at the left of the object row in the selection list. When there is a check mark in the checkbox, then the object has been selected for inclusion in the report. Note If you are generating a Network Wide report, then the Selection tab will not have an Object Selection section, because you have chosen to generate the report network wide, for all objects. In this case, the Selection tab will simply contain a Report Filter Specifications section, allowing you to alter the selection of the Profile used to generate the report. If you wish to proceed with the profile that is already selected in the Profile box, simply click IBM Tivoli Storage Resource Manager Reference Guide

157 Reporting Working with Reports Generating a Report 5 Once you have completed selecting the objects that you want to report upon, and fine-tuned the other generation criteria on the Selection tab, click and a new tab will be added to the tab dialog representing the report you want to generate. o Figure 5-3 Report Tab Note that the reports are tabular in format and are comprised of rows and columns. You can scroll the report up and down and to the right and left to view the entire report. Use the View menu to hide/show the function tree to increase the viewable area of the report or drag the divider bar in the middle of the screen back and forth to reallocate the amount of space that is given each pane. Viewing a Report 5 To view a report, click the tab in the content pane that contains the report. Note that reports are tabular in format and are comprised of rows and columns. You can scroll the report up and down and to the right and left to view the entire report. Sorting Columns You can sort the columns or change the order of the columns according to your needs. IBM Tivoli Storage Resource Manager Reference Guide 5-13

158 Reporting Working with Reports Re-sorting columns. To re-sort a column, click on the column header. The column will resort in ascending or descending order. Moving columns. To change a column order, press <Alt>, and then click and drag the column you want to move. Use the View menu to hide/show the function tree to increase the viewable area of the report. You can also drag the divider bar in the middle of the screen back and forth to reallocate the amount of space that is given each pane. Drilling Down a Report Row 5 Many of the rows that are presented in the generated reports allow you to drill down and get more reports of more detailed information. In the example of Most Obsolete Files, you can drill down on a file row to view a File Detail report. Figure 5-4 File Detail Drill Down Report When detailed drill down is allowed within a report, there is a icon at the left of that row. To drill down, simply click on and a new tab with the drill down report will be generated and added to the tab dialog. You will then be positioned on that tab viewing the new detail report that you have generated IBM Tivoli Storage Resource Manager Reference Guide

159 Reporting Working with Reports Generating a Report Chart 5 There are a large number of chart reports and chart types that can be generated within the Reporting facility. If you wish to view a chart of all of the rows in the table, click. All reports that support charting will have this multi-colored pie chart icon at the top of the report. After you click, a new tab containing the chart is added to the window. Any row in a report that supports charting on that individual row will have a beside it. To generate a chart for just the element in that row, click contained in the left of that report row. If you would like to generate a chart for multiple rows in the current report, then you can select those rows by clicking on them. Multiple rows can be selected by holding down the control key (Ctrl key) on the keyboard while clicking on the desired rows. Figure 5-5 Chart Generation Part 1 To select a range of rows in a report, simply click on the first row desired and then hold down the Shift and Ctrl while clicking on the end row of the range. After you have selected the rows you want to chart, then click and select the type of chart you would like to generate. A new tab is added to the window that contains the chart. IBM Tivoli Storage Resource Manager Reference Guide 5-15

160 Reporting Working with Reports Note that many charts can be generated simultaneously from the same report. Simply return to the Report tab and choose another chart or another set of objects to generate a chart upon. In that case, a second or subsequent Chart tab will be generated to the right of the already existing tabs and you will be positioned to the new chart tab. Figure 5-6 Chart Generation Part IBM Tivoli Storage Resource Manager Reference Guide

161 Reporting Working with Reports Viewing Different Chart Types While viewing a chart, you can change the type of chart (for example, from a Pie chart to a Bar chart) by right clicking on the chart and choosing another chart type from the pop-up menu that appears. Figure 5-7 Chart Types The following is a list of the various types of charts from which you can choose. Pie Chart Bar Chart Stacked Bar Chart 100% Stacked Bar Stacked Area 100% Stacked Area Advanced Chart Options. This option launches a window that provides you with complete and advanced control over every aspect of the chart generation, including axes orientation, borders, legends, colors, etc. IBM Tivoli Storage Resource Manager Reference Guide 5-17

162 Reporting Working with Reports Navigating Tabs 5 As you generate reports and drill down on rows to generate detailed sub reports, the number of tabs in the Reporting window will grow. You can move about from tab to tab simply by clicking on the tab name. Figure 5-8 Tabs You can also return to the Selection tab and change your selection criteria to start all over again with a newly generated report at any time. If you change your selection criteria and generate a new report, all subsequent or dependent tabs (i.e., drill down and chart tabs) are closed. To close a tab, right click on the tab folder top and select Close from the pop-up menu IBM Tivoli Storage Resource Manager Reference Guide

163 Reporting Working with Reports Trending with Historical Data 5 IBM Tivoli Storage Resource Manager s History Aggregator enables you to define and run jobs to sum data in the enterprise repository for historical reporting purposes. For example, you can view the sum of usage across multiple resources, by filesystem. Trending enables you to see patterns of your historical data across your entire network. To view a historical data, simply right-click on the row or row(s) for which you want to view the data. A pop-up menu is displayed, enabling you to view historical charts. Figure 5-9 Trending with Historical Data Depending on the type of report you are generating, you can generate a history chart for the items you select: History chart File Count for Selected Free Space for Selected Free Space % for Selected Used Space for Selected Description Shows the number of files for selected item(s) over a specified period of time: daily, weekly or monthly Shows the free space available over a specified period of time: daily, weekly or monthly Shows the percentage of free space available over a specified period of time: daily, weekly or monthly Shows used space over a specified period of time: daily, weekly or monthly IBM Tivoli Storage Resource Manager Reference Guide 5-19

164 Reporting Working with Reports History chart Used Space % for Selected Capacity for Selected File Count File Count % Size Size % Description Shows percentage of used space over a specified period of time: daily, weekly or monthly Shows capacity for selected over a specified period of time: daily, weekly, or monthly Shows the number of files accessed or modified over a period of: 1 day 1 day - 1 week 1 week - 1 month 1 month - 1 year > year Shows the percentage of files accessed or modified over a period of: 1 day 1 day - 1 week 1 week - 1 month 1 month - 1 year > year Shows the size of files accessed or modified over a period of: 1 day 1 day - 1 week 1 week - 1 month 1 month - 1 year > year Shows the percentage of file size accessed or modified over a period of: 1 day 1 day - 1 week 1 week - 1 month 1 month - 1 year > year 5-20 IBM Tivoli Storage Resource Manager Reference Guide

165 Reporting Working with Reports The following figure shows a history chart for used space for a filesystem: Figure 5-10 History Chart for Filesystem Used Space You can export the history data to a comma delimited file (.csv). To do so, simple select File! Export data. A dialog box is displayed allowing you to export the history data into a.csv file. You can choose to include or not include headers in the comma delimited file you create. The column headings within the header reflect the type of report from which you are exporting history data. IBM Tivoli Storage Resource Manager Reference Guide 5-21

166 Reporting Working with Reports Printing Reports or Charts 5 You can print any Tivoli Storage Resource Manager report or chart displayed in the content pane, or save it as a PDF file. To print a report or chart or save it as a PDF file: 1 Generate the report you want to print. 2 Click File! Print or click on the tool bar. A print dialog box displays. 3 Select Printer to send the output directly to a printer, or: select PDF file to save the output as a PDF file select HTML file to save the output as an HTML file 4 Click Continue. If you selected Printer, the report or chart is printed to your default printer. If you selected PDF file or HTML file, a dialog box displays prompting you to enter a filename and select the location where you want to save the file.. 5 Select the location where you want to store the PDF or HTML file and enter a name for the file in the File Name field. 6 Click Save. Depending on the file type you selected, the report or chart is saved as a PDF or HTML file IBM Tivoli Storage Resource Manager Reference Guide

167 Reporting My Reports My Reports 5 IBM Tivoli Storage Resource Manager enables you to generate and use reports easily and efficiently through the My Reports node found on the function tree. The My Reports node consists of the following sub nodes: Node Name System Reports User ID Reports Batch Reports This report... contains a number of pre-defined reports that are provided with the product. contains custom report definitions that you create. You can generate these reports repeatedly without having to select your report criteria again. enables you to run any report on a regularly-scheduled basis. Use this feature to conveniently run reports and gather data on a set schedule. IBM Tivoli Storage Resource Manager Reference Guide 5-23

168 Reporting My Reports System Reports 5 The System Reports node in the function tree contains standard reports that are automatically generated for all the machines on your network that are being monitored. These pre-defined reports enable you to view your storage enterprise data quickly and efficiently. Data for these system reports is gathered during the last scan scheduled for each computer. What Information is Available in System Reports? The following table lists the names of the Storage Alert system reports and what information is included within each: Report Name This report shows... What s in it? Disk Defects Most At Risk Files Oldest Orphaned Files Most Obsolete Files any disk defects on the computers being monitored information on files that have been modified the longest time ago and have not yet been backed-up or archived since they were modified information on files that have the oldest creation date and no longer have the owners registered as users on the computer/ network information on files that have not been accessed or modified for the longest period of time General tab includes general information about the computer Latest Probe tab provides information about the latest probe Probe History tab includes probe history for the selected machine name of computer filesystem where file is stored path to file owner of file OS user group of file owner physical and logical size of file date/time when file was last accessed/modified date/time when file was created attributes associated with the file name of computer filesystem where file is stored path to file owner of file OS user group of file owner physical and logical size of file date/time when file was last accessed/modified date/time when file was created attributes associated with the file date/time when the file was last accessed name of computer where file is stored filesystem where file is stored path to file owner of file OS user group of file owner physical and logical size of file date/time when file was last accessed/modified date/time when file was created attributes associated with the file 5-24 IBM Tivoli Storage Resource Manager Reference Guide

169 Reporting My Reports Report Name This report shows... What s in it? Storage Access Times Storage Availability Storage Capacity Storage Modification Times Total Freespace when files were last accessed and how long ago they were accessed the availability of the computers that are monitored via PING storage capacity information about each computer within your organization provides information about files within the network that were modified the total amount of unused storage across a network name of computer where the file is stored number and size of files accessed within the last 24 hours number and size of files accessed between 24 hours and one week previous number and size of files accessed between one week to one month previous number and size of files accessed between one month to one year previous number and size of files that have not been accessed for over a year name of the monitored computer the percentage of free space available # of pings transmitted # of responses received damaged: # of responses with errors average transit time max transit time min transit time report start time report end time total storage capacity amount of unused storage space operating system network and IP address the time zone in which the computer is running number and size of files modified within the last 24 hours number and size of files modified between 24 hours and one week previous number and size of files modified between one week to one month previous number and size of files modified between one month to one year previous number and size of files modified more than a year previous total amount of available storage space available on the network percentage of total space that is unused amount of used storage space total amount (capacity) of storage space total number of files on the network total number of directories on the network percent of free Inodes number of used Inodes number of free Inodes IBM Tivoli Storage Resource Manager Reference Guide 5-25

170 Reporting My Reports Report Name This report shows... What s in it? User Quota Violations User Space Usage Wasted Space which users within the enterprise have violated a Tivoli Storage Resource Manager quota information about storage statistics related to a specific user within your enterprise information about storage statistics on non-os files not accessed in the last year and orphan files creator of the quota name of the quota name of computer that violated the quota filesystem that violated the quota ID of the user that violated the quota total amount of space used threshold defined by the quota percentage by which the violator exceeded the quota number of violations by the user type of the quota (for example, Network Wide, Filesystem, etc.) ID of the user total amount of space used by the user number of files owned/created by the user number of directories owned/created by the user largest file owned by the user number and total size of files in the following size ranges: less than 1KB 1KB - 10KB 10KB - 100KB 100KB - 1MB 1MB - 10MB 10MB - 100MB 100MB - 500MB greater than 500MB name of computer where the files are stored total size of the files total number of files total number of directories affected average file size 5-26 IBM Tivoli Storage Resource Manager Reference Guide

171 Reporting My Reports Viewing System Reports Many of the rows that are presented in the generated system reports allow you to: drill down into a report to get more detailed information view report information in a chart format To drill down for more detailed report information:! Click on the desired row. The drill down report is displayed and a new tab representing that report is added to the tabs at the top of the report. To view report information in a chart format:! Click on the desired row. The chart is displayed and a new tab representing that chart is added to the tabs at the top of the report. IBM Tivoli Storage Resource Manager Reference Guide 5-27

172 Reporting My Reports Disk Defects The Disk Defects report shows any disk defects on the computers being monitored. The following figure shows an example a Disk Defects report that lists all the monitored computers on a system that contain disk defects: Figure 5-11 System Reports Disk Defects Field Descriptions This section describes the fields on the Disk Defects report. All the fields on the report are for display only. Computer Path Primary Defects Manufacturer Model RPM Read Cache name of the computer containing a disk defect full path to the location of a disk defect number of defects on the disk when it was new name of the manufacturer for the disk drive containing the disk defect model number of the disk drive containing a disk defect speed that the disk turns (revolutions per minute) hardware caching turned on/off for reads 5-28 IBM Tivoli Storage Resource Manager Reference Guide

173 Reporting My Reports Write Cache Failure Predicted Probe Last Run Discovered Time Capacity Unallocated Space Grown Defects Recovered Errors Unrecovered Errors Bytes Written Bytes Read Automatic Write Reallocation Desired Automatic Write Reallocation Automatic Read Reallocation Desired Automatic Read Reallocation Read Continuous Desired Read Continuous hardware caching turned on/off for writes disk predicts a failure date and time when the last probe was run date and time when a disk defect was discovered storage capacity of the disk drive containing a defect amount of unused storage space on the disk drive containing a defect number of defects detected by the disk since new number of errors (read, write, verify) from which the disk was able to recover number of errors (read, write, verify) from which the disk was not able to recover number of bytes written to the disk number of bytes read from the disk disk attempts to move the data sector on the disk in the event of a write error change automatic write allocation on the next probe disk attempts to move the data sector on the disk in the event of a read error change automatic read allocation on the next probe no error correction (setting is ON=no error correction) change automatic read continuous on the next probe To view more information for a specific computer:! Click. Detailed information regarding the computer will be available in three tabs: General tab. This tab displays general information about the computer, such as computer information, discovered date and time, disk allocation information, etc. Latest Probe tab. This tab displays information about the latest probe, and provides information such as sector size, probe last run, primary and grown defects, etc. Probe History tab. This tab displays probe history for the selected machine, and provides information such as probe times, record type, bytes written, etc. IBM Tivoli Storage Resource Manager Reference Guide 5-29

174 Reporting My Reports The following figure shows the General tab Figure 5-12 Disk Defects General Tab 5-30 IBM Tivoli Storage Resource Manager Reference Guide

175 Reporting My Reports The following figure shows the Latest Probe tab: Figure 5-13 Disk Defects Latest Probe Tab IBM Tivoli Storage Resource Manager Reference Guide 5-31

176 Reporting My Reports The following figure shows the Probe History tab: Figure 5-14 Disk Defects Probe History Tab 5-32 IBM Tivoli Storage Resource Manager Reference Guide

177 Reporting My Reports Most At Risk Files The Most At Risk Files report provides information on files that have been modified the longest time ago and have not yet been backed-up or archived since they were modified. The following figure shows a sample report of the most at risk files by computer: Figure 5-15 System Reports Most At Risk Files Field Descriptions This section describes the fields on the Most At Risk Files report. All the fields on the report are for display only. Modification Time Computer Filesystem Path Owner OS User Group Physical Size date and time when an at risk file was last modified name of the computer where an at risk file is stored filesystem where an at risk file is stored full path to the location of an at risk file ID of the user who owns an at risk file OS User group of the user who owns an at risk file physical size of an at risk file (measured in kilobytes, megabytes, or gigabytes) IBM Tivoli Storage Resource Manager Reference Guide 5-33

178 Reporting My Reports Access Time Create Time date and time when an at risk file was last accessed date and time when an at risk file was created To view more information about a specific file:! Click. Detailed information regarding the file will be displayed in a File Detail tab. The File Detail tab displays more information for the specific file and provides information such as file ownership, modification and creation time, and any file attributes that have been set. Figure 5-16 Most At Risk Files File Detail Tab 5-34 IBM Tivoli Storage Resource Manager Reference Guide

179 Reporting My Reports Most Obsolete Files The Most Obsolete Files report provides information on files that have not been accessed or modified for the longest period of time. The following figure shows a sample report of the most obsolete files by computer: Figure 5-17 System Reports Most Obsolete Files To view more information for a specific file:! Click. Detailed information regarding the file will be displayed in a File Detail tab. The File Detail tab displays more information for the specific file and provides information such as file ownership, modification and creation time, and any file attributes that have been set. Field Descriptions This section describes the fields on the Most Obsolete Files report. All the fields on the report are for display only. Access Time Computer Filesystem Path date and time when an obsolete file was last accessed name of the computer where an obsolete file is stored filesystem where an obsolete file is stored full path to the location of an obsolete file IBM Tivoli Storage Resource Manager Reference Guide 5-35

180 Reporting My Reports Owner OS User Group Physical Size Modification Time Create Time ID of the user who owns an obsolete file OS User Group to which the owner of the obsolete file belongs physical size of an obsolete file (measured in kilobytes, megabytes, or gigabytes) date and time when an obsolete file was last modified date and time when an obsolete file was created Oldest Orphaned Files The Oldest Orphaned Files report provides information on files that have the oldest creation date and no longer have the owners registered as users on the computer/network. The following figure shows a sample report of the oldest orphaned files by computer: Figure 5-18 System Reports Oldest Orphaned Files To view more information for a specific file:! Click. Detailed information regarding the file will be displayed in a File Detail tab. The File Detail tab displays information about a specific file such as file ownership, modification and creation time, and any file attributes that have been set IBM Tivoli Storage Resource Manager Reference Guide

181 Reporting My Reports Field Descriptions This section describes the fields on the Oldest Orphaned Files report. All the fields on the report are for display only. Access Time Computer Filesystem Path Owner OS User Group Physical Size Modification Time Create Time date and time when an orphaned file was last accessed name of the computer where an orphaned file is stored filesystem where an orphaned file is stored full path to the location of an orphaned file operating system internal ID of the user who owned the orphaned file. This is the internal ID the operating system uses to identify the user, and not the user ID. OS User group to which the owner of an orphaned file belongs physical size of an orphaned file (measured in kilobytes, megabytes, or gigabytes) date and time when an orphaned file was last modified data and time when an orphaned file was created IBM Tivoli Storage Resource Manager Reference Guide 5-37

182 Reporting My Reports Storage Access Times The Storage Access Times report indicates when files where last accessed and how long ago they were accessed. The following figure shows a sample report of access times by computer: Figure 5-19 System Reports Storage Access Times Field Descriptions This section describes the fields on the Storage Access Times report. All the fields on the report are for display only. Computer Last Accessed <= 1 day Count, Total Size Last Accessed 1 day - 1 week Count, Total Size Last Accessed 1 week - 1 month Count, Total Size name of a computer against which the report was run number of files that were accessed within the last 24 hours and the total physical size of those files (measured in kilobytes, megabytes, or gigabytes) number of files that were accessed between 1 day to 1 week previous and the total physical size of those files (measured in kilobytes, megabytes, or gigabytes) number of files that were accessed between 1 week to 1 month previous and the total physical size of those files (measured in kilobytes, megabytes, or gigabytes) 5-38 IBM Tivoli Storage Resource Manager Reference Guide

183 Reporting My Reports Last Accessed 1 month - 1 year Count, Total Size Last Accessed > 1 year Count, Total Size Total Count Total Size Average Age number of files that were accessed between 1 month to 1 year previous and the total physical size of those files (measured in kilobytes, megabytes, or gigabytes) number of files that were accessed over one year previous and the total physical size of those files (measured in kilobytes, megabytes, or gigabytes) total of all the counts total of all the sizes average time since the file was last accessed To view graphical information about specific computers access times:! Click. A new tab displaying a chart for each selected computer is displayed. Figure 5-20 Storage Access Times Chart View of Access Time By Computer IBM Tivoli Storage Resource Manager Reference Guide 5-39

184 Reporting My Reports Storage Availability The Storage Availability report provides information about the availability of computers within the enterprise. If the computer is not available (determined via a ping), the storage is likely not available for use. The following figure shows the access time by computer: Figure 5-21 System Reports Storage Availability Field Descriptions This section describes the fields on the Storage Availability report. All the fields on the report are for display only. Computer name of the computer % Available percentage of successful pings Transmitted Received Damaged Avg Transit Time Max Transit Time number of pings transmitted number of responses from the ping number of responses with errors average time it took to send and receive response from a ping maximum time it took to send and receive response from a ping 5-40 IBM Tivoli Storage Resource Manager Reference Guide

185 Reporting My Reports Min Transit Time Report Start Time Report End Time minimum time it took to send and receive response from a ping start time of information in this row end time of information To view the ping history for a specific computer:! Click. A new tab displaying ping history information for the selected computer is displayed: Figure 5-22 Storage Availability Ping History for a Specific Computer IBM Tivoli Storage Resource Manager Reference Guide 5-41

186 Reporting My Reports Storage Capacity The Storage Capacity report provides storage capacity information about each computer within your organization. The following figure shows a sample Storage Capacity report. Figure 5-23 System Reports Storage Capacity Field Descriptions This section describes the fields on the Storage Capacity report. All the fields on the report are for display only. Computer Capacity Unallocated Space OS Type Network Address IP Address Time Zone name of a computer against which the report was run total storage capacity for a computer amount of unused storage space on a computer (not in filesystems seen by this operating system) operating system running on a computer network address of a computer IP address of a computer time zone in which a computer is running 5-42 IBM Tivoli Storage Resource Manager Reference Guide

187 Reporting My Reports Storage Modification Times The Storage Modification Times report provides information about files within the network that were modified: within the last 24 hours between 24 hours and one week previous between one week to one month previous between one month to one year previous more than one year previous The following figure shows the size and modification times of files across a network: Figure 5-24 System Reports Storage Modification Times Report Field Descriptions This section describes the fields on the Storage Modification Times report. All the fields on the report are for display only. Last Modified <= 1 day Count, Total Size number of files that were modified in the last 24 hours and the total physical size of those files (measured in kilobytes, megabytes, or gigabytes) IBM Tivoli Storage Resource Manager Reference Guide 5-43

188 Reporting My Reports Last Modified 1 day - 1 week Count, Total Size Last Modified 1 week - 1 month Count, Total Size Last Modified 1 month - 1 year Count, Total Size Last Modified > 1 year Count, Total Size Total Count Total Size Average Age number of files that were modified between 1 day to 1 week previous and the total physical size of those files (measured in kilobytes, megabytes, or gigabytes) number of files that were modified between 1 week to 1 month previous and the total physical size of those files (measured in kilobytes, megabytes, or gigabytes) number of files that were modified between 1 month to 1 year previous and the total physical size of those files (measured in kilobytes, megabytes, or gigabytes) number of files that were modified over a year previous and the total physical size of those files (measured in kilobytes, megabytes, or gigabytes) sum of the files sum of the size of the files average age since files were modified To view graphical information about storage modification times:! Click. A new tab displaying a chart for the network is displayed: Figure 5-25 Storage Modification Times Chart View 5-44 IBM Tivoli Storage Resource Manager Reference Guide

189 Reporting My Reports Total Freespace The Total Freespace report shows the total amount of unused storage across a network. The following figure shows a Total Freespace report for a sample network: Figure 5-26 System Reports Total Freespace Field Descriptions This section describes the fields on the Total Freespace report. All the fields on the report are for display only. Free Space Percent Free Space Used Space Capacity File Count Directory Count Percent Free Inodes Used Inodes total amount of available storage space available on a network percentage of total space that is unused on a network amount of used storage space on a network total amount (capacity) of storage space on a network total number of files on a network total number of directories on a network percent of free Inodes on a network number of used Inodes on a network IBM Tivoli Storage Resource Manager Reference Guide 5-45

190 Reporting My Reports Free Inodes number of free Inodes on a network To view a chart that displays the distribution of free space across a network:! Click. A new tab displaying a total freespace chart for the network is displayed: Figure 5-27 Total Freespace Report Chart View 5-46 IBM Tivoli Storage Resource Manager Reference Guide

191 Reporting My Reports User Quota Violations The User Quota Violations report indicates which users within the enterprise have violated a Tivoli Storage Resource Manager quota. The following figure shows a User Quota Violations report for a sample network: Figure 5-28 System Reports User Quota Violations Report Field Descriptions This section describes the fields on the User Quota Violations report. All the fields on the report are for display only. Quota Creator Quota Name Computer Filesystem User Name Space Used Threshold creator of a quota name of a quota computer that violated a quota filesystem that violated a quota ID of the user that violated a quota total amount of space used threshold defined by a quota % of Threshold percentage of quota; always > 100 IBM Tivoli Storage Resource Manager Reference Guide 5-47

192 Reporting My Reports Number of Violations Quota Type number of violations by a user type of quota: Network Wide, Filesystem, or Computer User Space Usage The User Space Usage report provides information about storage statistics related to a specific user within your enterprise. The following figure shows a User Space Usage report for a sample network: Figure 5-29 System Reports User Space Usage Report Field Descriptions This section describes the fields on the User Space Usage report. All the fields on the report are for display only. User Name Total Size File Count Directory Count Largest File ID of a user total amount of space used by a user number of files owned/created by a user number of directories owned/created by a user largest file owned by a user 5-48 IBM Tivoli Storage Resource Manager Reference Guide

193 Reporting My Reports 2nd Largest File File Size <1KB Count, Total Size File Size 1KB - 10KB Count, Total Size File Size 10KB - 100KB Count, Total Size File Size 100KB - 1MB Count, Total Size File Size 1MB - 10MB Count, Total Size File Size 10MB - 100MB Count, Total Size File Size 100MB - 500MB Count, Total Size File Size > 500MB Count, Total Size second-largest file owned by a user number and total space usage of files under 1KB in size number and total space usage of files between 1KB and 10KB in size number and total space usage of files between 10KB and 100KB in size number and total space usage of files between 100KB and 1MB in size number and total space usage of files between 1MB and 10MB in size number and total space usage of files between 10MB and 100MB in size number and total space usage of files between 100MB and 500MB in size number and total space usage of files over 500MB in size IBM Tivoli Storage Resource Manager Reference Guide 5-49

194 Reporting My Reports Wasted Space The Wasted Space report provides information about storage statistics on non-os files not accessed in the lst year and orphan files. The following figure shows a Wasted Space report for a sample network: Figure 5-30 System Reports Wasted Space Report 5-50 IBM Tivoli Storage Resource Manager Reference Guide

195 Reporting My Reports To view more information for a specific file:! Click. Detailed information per computer will be displayed in a Network tab. The Network tab displays file summary by computer. Figure 5-31 Wasted Space Report File Summary by Computer Field Descriptions This section describes the fields on the Wasted Space-File Summary by Computer report. All the fields on the report are for display only. Computer Total Size File Count Directory Count Avg File Size name of the computer that contains wasted space total amount of space used by the obsolete and orphan files total number of obsolete and orphan files total number of orphan directories average size of obsolete and orphan files IBM Tivoli Storage Resource Manager Reference Guide 5-51

196 Reporting My Reports User ID Reports 5 The User ID reports node enables you to save report definitions that you create. You can then generate a report without having to redefine your report criteria again. In the window below, the user cantigua saved three report definitions: constraint violations, mod_files not backed up, and networkquotaviolations. Figure 5-32 My Reports User ID Reports To save a report definition under My Reports: 1 Generate a report through the Reporting facility. 2 Select File! Save, and a enter a name for the report. The report will be saved under the user name (for example, cantigua s Reports) sub node in the My Reports node of the function tree IBM Tivoli Storage Resource Manager Reference Guide

197 Reporting My Reports Batch Reports 5 The Batch reporting feature enables you to run any report on a regularly scheduled basis. This enables you to conveniently run reports and gather data on a set schedule. The Batch reporting feature provides a convenient and powerful way for you to save report definitions and schedule when to run the report. To create a new Batch report: 1 Right-click on the Batch Reports node on the function tree, and select New Batch Report. 2 The Create Batch Report window displays, showing the Report tab. 3 The Batch Report job window contains five tabs: Report, Selection, Options, When to REPORT, and Alert tabs. Go through the tabs to define and schedule the batch report. The following sections describe each of these tabs. 4 Click to save the batch report definition. When you enter a name for the batch report, you can add an extension to the report name (i.e.:.txt or.xls), depending on the report format you want to create. 5 The batch report run will be displayed under the Batch Reporting node. The batch report will run according to the schedule you have defined in the When to REPORT tab. 6 You can view the batch report job run by clicking on the actual job run listed in the node. Information about the run history will be displayed. The log file name for the batch report shows the path and name of the log file. IBM Tivoli Storage Resource Manager Reference Guide 5-53

198 Reporting My Reports Click to view the log file for the batch report job run. Viewing a Batch report The batch report will be saved in the reports sub-directory within the install directory on the computer (agent) where the report was run. The default install directory is: \program files\tivoli\tsrm\log\computername\reports. If you defined the output file to be formatted as a.txt file, you can view the report with Note Pad. If you defined the output file as.xls, you can import the data to MS Excel, by selecting Data! Get External Data! Import Data. Exporting Batch Report Definitions You can migrate batch report definitions from one Server to another by using an export utility run from a command line. Exporting Batch reports enables you to define a Batch report once and re-use it on another Server. To do this, simply export the user-defined objects to a file, then import the exported data into the Server. The export utility is found in the directory, home/server/tools. The valid command line arguments are: To export user defined objects to a file, type: export -e <target-file-name> where target-file-name represents a fully qualified file name. To import previously exported data, type: export -i <target-file-name> where target-file-name represents a fully qualified file name. The Batch Report Window The window for defining a Batch Report contains the following tabs: Report Tab Selection Tab Options Tab When to REPORT Tab Alert Tab 5-54 IBM Tivoli Storage Resource Manager Reference Guide

199 Reporting My Reports Report Tab Use the Report tab to define the report you want to generate. The following figure shows the Report tab on the Batch Report window. Figure 5-33 Batch Reports Report tab The Report tab displays all the reports that you can create for the batch report. The Current Selections list box shows the report that has been selected for the job. The Available list box shows the reports that you can choose to generate for the batch job. The reports listed in the Available section are the same reports displayed in the Reporting function tree. To select a report: 1 Highlight the desired report in the Available list box. 2 Click. The report you selected appears in the Current Selections list box. To remove or unselect the report from Current Selections list box:! Highlight report you want to remove and click. This will remove the report from the Current Selections list box and move them to the Available list box. IBM Tivoli Storage Resource Manager Reference Guide 5-55

200 Reporting My Reports Selection Tab Use the Selection tab to select specific reporting criteria you want for the batch report. This is where you can select the user or user groups, as well as the computer upon which the batch report will run. The following figure shows the Selection tab on the Batch Report window: Figure 5-34 Batch Reports Selection tab The Selection tab enables you to fine tune the selection of objects upon which you want to generate a report: Computer Selection. When the Selection tab is initially displayed, all objects in the list are pre-selected for your convenience. If you would like to generate the report for all the objects that have been selected for you, click. You can use the Select All and Clear All buttons to quickly select and unselect all of the objects in the list. To select/deselect individual rows in the object selection list, simply click on the checkbox at the left of the object row in the selection list. When there is a check mark in the checkbox, then the object has been selected for inclusion in the report IBM Tivoli Storage Resource Manager Reference Guide

201 Reporting My Reports Note If you are generating a Network Wide report, then the Selection tab will not have an Object Selection section, because you have chosen to generate the report network wide, for all objects. In this case, the Selection tab will simply contain a Report Filter Specifications section, allowing you to alter the selection of the Profile used to generate the report. If you wish to proceed with the profile that is already selected in the Profile box, simply click. Options Tab Use the Options tab to define where the batch report will run and information about the output file. The following figure shows the Options tab on the Batch Report window: Figure 5-35 Batch Reports Options tab To define an Agent computer and output file specification: 1 In the Agent Computer Specification section, choose the agent machine where the batch report will run and where the output file will be created. The report file will be saved on the agent machine you choose. IBM Tivoli Storage Resource Manager Reference Guide 5-57

202 Reporting My Reports 2 In the Report Type Specification section, select the type of report you want the batch report to be. You can select the following output formats: Comma Delimited File Formatted File HTML File History CSV File. For reports with historical trending, you can export the historical data to a CSV file. The CSV file will have the following format: <object name, date, amount, date, amount,> and so on, where <date, amount> corresponds to each data point on the history chart. Include Headers. Click this option to include headers in the generated file. The column headings that appear in the header reflect the type of report from which you are exporting history data. Historical data drop-down field. Depending on the type of report you are generating, select the type of history file for the report, such as File Count, Free Space, Free Space %, Used, Space, Used Space%, etc., from the drop-down field. See Trending with Historical Data on page 19 for more information on the types of history files. Timeframe drop-down field. Select whether you want to generate Daily, Weekly, or Monthy data. 3 In the Script section, check Run Script to run a script when the batch report is completed. In the Script Name field, enter the name of the script you want to run. For example, when a batch report completes, you may want to run a script to process the generated file. Here, there is only one parameter that is passed to the script: the <path> to the generated batch report. 4 In the Output File Specification section, define the output file naming format for the batch report log. You can select the following replaceable parameters: report creator name title run # run date run time Unique # 5-58 IBM Tivoli Storage Resource Manager Reference Guide

203 Reporting My Reports When to REPORT Tab Use the When to REPORT tab to specify when and how often to run the Batch reporting job. The following figure shows the When to REPORT tab on the Batch Report window: Figure 5-36 Batch Reports When to REPORT tab You have the following options for determining when to generate a report: Generate the report immediately Generate the report once at a specified time and date Generate the report repeatedly according to a schedule you specify Select the option you want and then edit the time and date information accordingly. You can also select the time zone for the schedule you specify. You can either select the time zone that the Server is on, or any other time zone. IBM Tivoli Storage Resource Manager Reference Guide 5-59

204 Reporting My Reports Alert Tab Use the Alert tab to define an alert that will be triggered if the report does not run on schedule. The following figure shows the Alert tab on the Batch Report window: Figure 5-37 Batch Reports Alert tab The following describes what you can define within the main sections on this tab: Section Name Description Triggering Condition Condition Triggered-Actions SNMP Trap Login Notification Failure to generate the report on the set schedule will trigger an alert. Choose to be notified when an alert occurs via an SNMP Trap, Login Notification, Windows Event Log message, or an . Check this box to generate an SNMP trap message to any NMS, console or terminal to indicate the occurrence of an alert. Check this box to indicate that alert should appear to the specified user upon logging in to the system IBM Tivoli Storage Resource Manager Reference Guide

205 Reporting My Reports Section Name Login ID Windows Event Log Event Type Run Script Description Indicate the ID of the user who will receive alert notification upon logging in to the system. Check this box to indicate that alerts will be recorded to the Windows Event Log. Indicate the type of event that will be recorded to the Windows Event Log. Check this box to run a script in response to this Alert. Press. The Specify Script dialog box appears, enabling you to specify a script to run and the computer on which to run. See Chapter 3, Alerting for more information on running scripts. Use this section to view, add, and delete addresses for the alert notification. Recipients: Enter the addresses you want to include for the alert notification in the top box in the list box. The bottom box displays the addresses already associated with the alert notification. Click this button to add an address you enter in the Recipients field. Click this button to delete the address you highlight in the Recipients list box. Click this button to edit the text of the alert notification on the Edit Text of the Message dialog box. IBM Tivoli Storage Resource Manager Reference Guide 5-61

206 Reporting Asset Reporting Asset Reporting 5 Asset reporting allows you to view the centralized asset repository that Tivoli Storage Resource Manager constructs during probes. While running probes, it itemizes the information about your computers, disks, controllers, and file systems, and builds a hardware inventory of your storage assets. You can then navigate through a hierarchical view of your assets by drilling down through computers, controllers, disks, file systems, directories, and exports/shares. These reports can be viewed hierarchically: By Computer. Based upon computer By OS Type. Based upon operating system type System Wide. Based throughout the system, allowing you to investigate all of your disks, file systems, controllers, and other assets for your entire system The following table lists and describes the Asset Reporting Types you can view: Asset Reporting Type By Computer By OS Type Windows NT Windows 2000 Solaris Linux HP-UX AIX Netware Unknown System Wide Computers By Boot Time By Probe Time By Discovered Time Description Drill down through your storage assets in a hierarchical manner. You can drill down into a computer and expose its controllers, disks, file systems, logical volumes, and directories. You can then drill down on a specific controller to see the disks under it and/or drill down on a disk to see the file systems under it, etc. View your storage assets based upon the operating systems that are running on those storage servers. This gives you an easy way to see what your OS dependencies are throughout your organization. By drilling down on any or each of these different supported Operating System types, you can see how many of each server type you have and you can drill down into them to investigate the storage underlying them. View your storage assets as a whole, across the entire system. This lets you get lists of all of your disks, all of your computers, all of your file systems, as well as viewing aggregated reports based upon certain filters, such as grown defects per disk. View all of your computers based upon the following report types: Sort based on when the computer was last booted Sort based on when the last probe ran on the computer Sort based upon when the computer was first detected on the network. This allows you to see what is the oldest equipment, most likely to need replacement sooner 5-62 IBM Tivoli Storage Resource Manager Reference Guide

207 Reporting Asset Reporting Asset Reporting Type Disks By Unallocated Space By Grown Defects By Primary Defects By Recovered Errors By Unrecovered Errors By Probe Time By Discovered Time File Systems/Logical Volumes By Freespace By Probe Time By Scan Time By Discovered Time Description View all of your disks based upon the following report types: View your disks, in order of which ones have the most unallocated space. View which disks have the most grown defects, allowing you to see which disks are the most likely to fail soon. Views disks sorted by which have the most primary defects, also an indicator of potential trouble. View which disks have been experiencing errors that have been able to be recovered from. View which disks have been experiencing errors that have not been able to be recovered from View the disks sorted by when they were last probed View the disks by when they were discovered in your enterprise. This allows you to see what is the oldest equipment and most likely to needs replacement sooner. View all of your disks based upon the following report types: View which file systems have the least/most amount of freespace View file systems sorted by when they were last probed View file systems sorted by when they were last scanned View file systems sorted by when they were discovered in your enterprise Removed File systems View file systems that have been removed Logical Vols without Filesystems Exports/Shares By Discovered Time View logical volumes that do not have file systems on them View all of your exports/shares based upon the following report types: View the exports/shares sorted by when they were discovered in your enterprise. IBM Tivoli Storage Resource Manager Reference Guide 5-63

208 Reporting Asset Reporting Asset Reporting Type Monitored Directories By Space Used By Scan Time By Discovered Time Removed Directories Unmanaged Computers Users By Discovered Time OS User Groups By Discovered Time Description View all of your monitored directories based upon the following report types: View the directories sorted by of how much space they are consuming View the directories sorted by when they were last scanned View the exports/shares sorted by when they were discovered in your enterprise. View all of the computers that are discovered, via Discovery, which are not being scanned or probed. These computers are not being monitored by Tivoli Storage Resource Manager, therefore are considered to be "unmanaged". It is most likely that these are new computers, that have been placed on the system and have not yet been scheduled for scanning / probing (monitoring). View all of your Users based upon the following report types: View the users sorted by when they were discovered in your enterprise View all of your OS User Groups based upon the following report types: View the OS User Groups sorted by when they were discovered in your enterprise 5-64 IBM Tivoli Storage Resource Manager Reference Guide

209 Reporting Asset Reporting By Computer 5 Drill down through your storage assets in a hierarchical manner. You can drill down into a computer and expose its controllers, disks, file systems, logical volumes, and directories. You can then drill down on a specific controller to see the disks under it and/or drill down on a disk to see the file systems under it, etc. Computer Information The following figure shows an example of an Asset Reporting By Computer, Computer Information report. Figure 5-38 Asset Reporting By Computer Computer Info As you drill down into Asset Reporting By Computer, you can expand the assets under a computer, or you can select a computer to view the details for that computer. In this example, the NW51-DEV1 computer is selected. The detailed report on the right shows the computer s: Name Group and domain IP address Time zone Hardware manufacturer and model numbers IBM Tivoli Storage Resource Manager Reference Guide 5-65

210 Reporting Asset Reporting Processor type Count and speed Amount of RAM Operating System (OS) information such as: type of OS and version the storage attributes of the server the computer's disk capacity, unallocated space, and free space Controller Information The following figure shows an example of an Asset Reporting By Computer, Controller Information report. Figure 5-39 Asset Reporting By Computer Controller Info As you drill down into Asset Reporting By Computer, you can expand the assets under a controller, or you can select a controller to view the details for that controller. The name of the controller's computer is shown, as well as the driver name, instance number, bus number, address, and type of driver (for example, SCSI, IDE, etc.) IBM Tivoli Storage Resource Manager Reference Guide

211 Reporting Asset Reporting Disk Information As you drill down into Asset Reporting By Computer, you can expand the assets under a disk, or you can select a disk to view the details for that disk. The disk detail information is shown in a tab dialog that is made of up three tabs: General, Latest Probe, and Probe History. General Tab The following figure shows the information on the General tab. Figure 5-40 Asset Reporting By Computer Disk Info General Tab This information on this tab includes the computer name, the path name, SCSI Target ID, logical unit number, the number of access paths. The disk information shown includes the hardware manufacturer of the disk, the model number of the disk, the firmware revision, the disk serial number, and the manufacture date along with the time when Tivoli Storage Resource Manager discovered the disk. In the bottom area of the tab is a breakdown of how the disk is allocated, including the disk allocation point and the length of the allocation. IBM Tivoli Storage Resource Manager Reference Guide 5-67

212 Reporting Asset Reporting Latest Probe Tab The following figure shows the information on the Latest Probe tab. This tab shows the information that was obtained by Tivoli Storage Resource Manager about this disk during the most recent probe of that disk. Figure 5-41 Asset Reporting By Computer Disk Info Latest Probe Tab, Part 1 This information on this tab includes: sector size and sector information the number of heads the number of cylinders the logical block size the capacity of the disk the RPM or revolutions per minute that the disk spins at the elapsed time the disk has been powered on spare blocks the current write protection setting the cache enabled setting whether failure is predicted for this disk the time and date of the last Probe the unallocated space the number of primary defects the number of grown defects the NonMedium errors the recorded operating temperature 5-68 IBM Tivoli Storage Resource Manager Reference Guide

213 Reporting Asset Reporting Some of these values are manufacturer specific, so if they are unavailable, then you will see N/A for a value. The following figure shows the information on the Latest Probe tab when you can scroll the tab down to show more information. Figure 5-42 Asset Reporting By Computer Disk Info Latest Probe Tab, Part 2 The additional information shown here is a breakdown of recovered errors, unrecovered errors, and the number of bytes broken down by Write, Read, and Verify. Also included are three SCSI disk bit settings that you can turn on/off and the change will actually be made to the disk settings the next time a probe is run on that disk. These include on/off settings for: Automatic read reallocation Automatic write reallocation Read continuous (no error correction) IBM Tivoli Storage Resource Manager Reference Guide 5-69

214 Reporting Asset Reporting Probe History Tab The following figure shows the information on the Probe History tab. Figure 5-43 Asset Reporting By Computer Disk Info Probe History Tab This tab shows the history of probes that have been run on the disk you are reporting on. Each row on this report represents one time that a probe has been run against the disk. Each row shows what time the probe ran, the type of record (which could be daily, weekly or monthly), bytes written, bytes read, number of grown defects IBM Tivoli Storage Resource Manager Reference Guide

215 Reporting Asset Reporting File System / Logical Volume Information The following figure shows an Asset Reporting By Computer File System / Logical Volume information report. Figure 5-44 Asset Reporting By Computer File System Info File System Tab In this example, the Asset node in the function tree is expanded under the computer tsoft-pdc, and the E:/ filesystem under the File Systems/Logical Volumes reporting is selected. This is one example of the reports that are available for the assets as you drill down hierarchically under asset reporting by computer. This contains two tabs: File System and Logical Volume. File System Tab This tab shows a pie chart depicting use space and free space on the file system and includes the following information: computer name file system type use count mount point physical size of the file system capacity of the file system the time and date of the last Probe and Scan when the file system was discovered on the system by Tivoli Storage Resource Manager if the file system has been removed then a removed date/time will be shown IBM Tivoli Storage Resource Manager Reference Guide 5-71

216 Reporting Asset Reporting Also shown for Unix based systems are: the maximum file count used inodes free inodes. Inodes are areas reserved for index entries within the Unix file systems. For Windows machines, these values will be zero. the amount of used space and free space is shown Logical Volume Tab The following figure shows the information on the Logical Volume tab. Figure 5-45 Asset Reporting By Computer File System Info Logical Volume Tab This information on this tab includes: the pathname of the logical volume the capacity of the logical volume the use count the type of logical volume whether it is a swap volume and mirrored a tree displaying the mapping of the logical volume on the disk area(s) that make up the logical volume 5-72 IBM Tivoli Storage Resource Manager Reference Guide

217 Reporting Asset Reporting Exports/Shares Information The following figure shows an example of an Asset Reporting By Computer Exports/Shares information report. Figure 5-46 Asset Reporting By Computer Exports/Shares Info In this example, a report on the ADMIN$ export/share is shown. This report includes the following information: the name of the computer the share is on the export name that it will be known by the path on the computer the share resides upon the protocol being used and the date/time that Tivoli Storage Resource Manager discovered the export/share IBM Tivoli Storage Resource Manager Reference Guide 5-73

218 Reporting Asset Reporting Monitored Directory Information The following figure shows an example of an Asset Reporting By Computer Monitored Directory report. Figure 5-47 Asset Reporting By Computer Monitored Directory Info To view a report on a directory that you are monitoring, expand the Monitored Directories node on the function tree and select the directory that you want to report on. In this example, a report on the C:/WINNT/Profiles/Administrator directory has been selected. The information shown in the report includes the: computer name the directory resides on name of the directory owner OS Group total size of the directory number of files in the directory count of subdirectories in the directory average file size access time modification time and creation time of the directory last scan time and the time that Tivoli Storage Resource Manager discovered the directory file attributes that are set list of the Directory Groups that the directory is a part of 5-74 IBM Tivoli Storage Resource Manager Reference Guide

219 Reporting Asset Reporting By OS Type 5 Asset reporting By OS Type allows you to view your storage assets based upon the operating systems that are running on those storage servers. This gives you an easy way to see what your OS dependencies are throughout your organization. The following figure shows an example of an Asset Reporting By OS Type report. Figure 5-48 Asset Reporting By OS Type In this example, the Asset tree under the Solaris OS Type is expanded, and the tsoft-sun1 server is selected. This is one example of the reports that are available for the assets as you drill down hierarchically under asset reporting by OS Type. The content pane shows the detail information for the computer that has been selected. This includes hardware and processor information, OS software type and version, and disk storage statistics as well. You can drill down into any of the computers within the Asset Reporting by OS type section to have access to all of the same sub-reports that are described above. IBM Tivoli Storage Resource Manager Reference Guide 5-75

220 Reporting Asset Reporting System Wide 5 Asset reporting System Wide allows you to view your storage assets as a whole, across the entire system. This lets you get lists of all of your disks, all of your computers, all of your file systems, as well as viewing aggregated reports based upon certain filters, such as grown defects per disk. Computer Reporting The following figure shows an example of an Asset Reporting System Wide, Computers by Boot Time report. Figure 5-49 Asset Reporting System Wide Computers This report allows you to see all the computers in the system, sorted in order of the time they were last booted. This is valuable in environments where computers become more unreliable after they have been up and running for long periods of time IBM Tivoli Storage Resource Manager Reference Guide

221 Reporting Asset Reporting Disks Reporting The following figure shows an example of an Asset Reporting System Wide, Disks by unallocated space report. Figure 5-50 Asset Reporting System Wide Disks Unallocated Space This report allows you to see all the disks in the system, sorted in order of the amount of unallocated space they have on them. IBM Tivoli Storage Resource Manager Reference Guide 5-77

222 Reporting Asset Reporting The following figure shows an example of an Asset Reporting System Wide, Disks by Grown Defects report. o Figure 5-51 Asset Reporting System Wide Disks Grown Defects This report allows you to view: all the disks in the system sorted in order of the number of grown defects they have on them what disks in your system are experiencing problems and may be in danger of an imminent failure 5-78 IBM Tivoli Storage Resource Manager Reference Guide

223 Reporting Asset Reporting The following figure shows an example of an Asset Reporting System Wide, Disks by Primary Defects report. Figure 5-52 Asset Reporting System Wide Disks Primary Defects This report allows you to view all the disks in the system sorted in order of the number of primary defects they have on them what disks in your system are in good shape and which ones are more or less defective IBM Tivoli Storage Resource Manager Reference Guide 5-79

224 Reporting Asset Reporting File systems / Logical Volumes Reporting The following figure shows an example of an Asset Reporting System Wide, File systems by Free Space report. Figure 5-53 Asset Reporting File systems Freespace This report allows you to view: all the file systems in the system sorted in order of the amount of free space they have on them which file systems have less free space and may be in danger of running out of free space which file systems have perhaps too much free space and where space consolidation may be necessary 5-80 IBM Tivoli Storage Resource Manager Reference Guide

225 Reporting Asset Reporting The following figure shows an Asset Reporting System Wide, File systems by Free Space report with an historical graph. Figure 5-54 Asset Reporting System Wide Disks Free space History This graph was obtained by clicking on the graphing history icon on the highlighted row in the previous figure. This graphs depicts free space / used space for a specific file system historically, in this case over the prior week. This graph allows you to see how rapidly free space is being consumed or released on a given file system. This can alert you to potential problems that may require your attention. IBM Tivoli Storage Resource Manager Reference Guide 5-81

226 Reporting Asset Reporting Exports/Shares Reporting The following figure shows an example of an Asset Reporting System Wide, Exports/Shares by Discovered Time report. Figure 5-55 Asset Reporting Exports/Shares Discovered Time This report allows you to see all the Exports/Shares in your environment, sorted in the order that Tivoli Storage Resource Manager discovered them IBM Tivoli Storage Resource Manager Reference Guide

227 Reporting Asset Reporting Monitored Directories Reporting The following figure shows an example of an Asset Reporting System Wide, Directories by Space Used report. Figure 5-56 Asset Reporting Monitored Directories Space Used This report allows you to see all the monitored directories in the system, sorted in order of the amount of space they are taking up. This gives you an easy way to view your directories based upon how big they are and how much space they are consuming. IBM Tivoli Storage Resource Manager Reference Guide 5-83

228 Reporting Asset Reporting Unmanaged Computers Reporting The following figure shows an example of an Asset Reporting System Wide, Unmanaged Computers report. Figure 5-57 Asset Reporting Unmanaged Computers This report enables you to see all of the new computers that have been introduced into your system and that do not have Agents installed on them to monitor their storage. It also lists other computers that you have not put under Tivoli Storage Resource Manager control IBM Tivoli Storage Resource Manager Reference Guide

229 Reporting Asset Reporting Users Reporting The following figure shows an example of an Asset Reporting System Wide, Users by iscovered Time report. o Figure 5-58 Asset Reporting Users Discovered Time This report allows you to see all the Users in your environment, sorted in the order that Tivoli Storage Resource Manager discovered them. IBM Tivoli Storage Resource Manager Reference Guide 5-85

230 Reporting Asset Reporting OS User Groups Reporting The following figure shows an example of an Asset Reporting System Wide, OS Groups by Discovered Time report. Figure 5-59 Asset Reporting OS Groups Discovered Time This report allows you to see all the OS User Groups in your environment, sorted in the order that Tivoli Storage Resource Manager discovered them IBM Tivoli Storage Resource Manager Reference Guide

231 Reporting Availability Reporting Availability Reporting 5 Availability reporting allows you to monitor and report on the availability of your storage, both from a network point of view and from a computer up-time perspective. This allows you to see what percentage of the time the storage in your enterprise (or on particular server or group of servers), is off-network due to network problems or perhaps is unavailable due to system downtime. In today s fast-paced marketplace, 24x7 application availability is critical, the Availability reporting function provides a powerful tool for monitoring the availability of the storage and data that back up your applications. Reporting Type Ping Reporting Computer Uptime Reporting Description Use Ping Reporting to monitor how available your storage is on the network. To do this, regularly scheduled Pings are sent out from the Server to all of the monitored Agent machines in your environment. The Server checks not only for whether the Agent is available on the network, but records the amount of time that the request was in transit on the network.this allows you to get an idea of the responsiveness of the various storage servers on the network as well. Use Computer Uptime reporting to track the availability of the storage based upon what percentage of the time the server that hosts that storage is down or not running. This is accomplished by the Agent component that runs on the monitored machine. The Agent keeps track of this information and it is periodically sent to the Server to be recorded in the Enterprise Repository. IBM Tivoli Storage Resource Manager Reference Guide 5-87

232 Reporting Availability Reporting Ping Reporting 5 Ping Reporting allows you to monitor how available your storage server is on the network. The following figure shows Ping Reporting By Computer and the Selection tab on its main window. This tab allows you to select which computers for which you would like to run the report. Figure 5-60 Ping Reporting Selection Tab Notice that in the Report Filter Specification section of the Selection tab you are allowed to limit the time range to use in generating the report. If you would like to limit the time range, then you can check the checkbox next to Limit To This Time Range and then use the date selection boxes to specify the range to generate a report for. When you are done, click IBM Tivoli Storage Resource Manager Reference Guide

233 Reporting Availability Reporting The following figure shows Ping Reporting By Computer and the Computers tab that you will see upon generating the report. Figure 5-61 Ping Reporting Computers Tab This tab shows the: computer name percentage of time the computer is available on the network number of pings that have been transmitted and the number that have been received number of damaged requests and the average transit time for the request to go between the Server and the monitored agent machine that is being monitored maximum transit time minimum transit time report start time and report end time for each computer in the report Note You can sort on any of these columns by simply clicking on the column name at the top of the report. You can also generate charts and drill down on each computer for more detail. IBM Tivoli Storage Resource Manager Reference Guide 5-89

234 Reporting Availability Reporting Computer Uptime Reporting 5 Use Computer Uptime reporting to track the availability of the storage based upon what percentage of the time the server that hosts that storage is down or not running. This is accomplished by the Agent component that runs on the monitored machine. The Agent keeps track of this information and it is periodically sent to the Server to be recorded in the Enterprise Repository. Computers Tab The following figure shows a Computer Uptime By Computer report and the Computers tab that you will see upon generating the report. Figure 5-62 Computer Uptime Reporting Computers Tab This tab shows the: computer name percentage of time the computer is up and running number of reboots that have been recorded total amount of time the computer has been down and unavailable as well as the average down time that has been recorded report start time and report end time for each computer in the report 5-90 IBM Tivoli Storage Resource Manager Reference Guide

235 Reporting Availability Reporting Note You can sort on any of these columns by simply clicking on the column name at the top of the report. You can also generate charts and drill down on each computer for more detail. Chart Tab The following figure below shows a Computer Uptime By Computer report and the Chart tab that you will see if you generate a chart for all of the computers in the previous report. Figure 5-63 Computer Uptime Reporting Chart Tab This gives you an easy way to quickly analyze the information and gives you an immediate read on which computers are the most available and experience the most downtime. IBM Tivoli Storage Resource Manager Reference Guide 5-91

236 Reporting Capacity Reporting Capacity Reporting 5 Capacity reporting provides a mechanism for viewing storage capacity at a file system, computer, or entire network level. For a specific computer, group of computers, or all the computers in your enterprise, you can view: how much storage you have how much storage is being used what percentage of storage is free for expansion The Capacity reporting function provides you with the ability to view your entire enterprise in a single view. Disk Capacity Reporting 5 Disk Capacity allows you to report on, and chart disk capacity, per disk, per computer, per computer group, per domain or for the whole network. Selection Tab The following figure shows the Selection tab for the Disk Capacity By Computer Reporting facility. This tab enables you to pick one or more computers on which to report. Figure 5-64 Capacity Reporting Disk Capacity Selection Tab 5-92 IBM Tivoli Storage Resource Manager Reference Guide

237 Reporting Capacity Reporting Computers Tab The following figure shows the Computers tab for the Disk Capacity By Computer Reporting facility. Figure 5-65 Capacity Reporting Disk Capacity Computers Tab This tab includes one row for each computer that shows the total amount of storage capacity on that computer and the associated computer and disk storage information. For detail on any computer in the report, simply click on the magnifying glass on the left of the report row. IBM Tivoli Storage Resource Manager Reference Guide 5-93

238 Reporting Capacity Reporting Chart Tab The following figure below shows the Chart tab for the Disk Capacity By Computer Reporting facility. Figure 5-66 Capacity Reporting Disk Capacity Chart Tab This chart provides you an easy-to-interpret bar chart, showing the total storage capacity of each computer that you have chosen to report on and chart. To get the exact amount of storage for a computer, simply position the cursor over the associated bar and a box will appear showing the total amount for the selected computer IBM Tivoli Storage Resource Manager Reference Guide

239 Reporting Capacity Reporting Filesystem Capacity Reporting 5 The following figure shows the Computers tab for the Filesystem Capacity By Computer Reporting facility. Figure 5-67 Capacity Reporting Filesystem Capacity Computers Tab This tab shows you one row for each file system, showing the total amount of storage capacity on that file system, along with the breakdown based upon used and free space and the associated file counts. For detail on any file system in the report, simply click on the magnifying glass on the left of the report row. IBM Tivoli Storage Resource Manager Reference Guide 5-95

240 Reporting Capacity Reporting Filesystem Used Space Reporting 5 The following figure shows the Chart tab for the Filesystem Used Space By Computer Reporting facility. Figure 5-68 Capacity Reporting Filesystem Used Space Chart Tab This tab shows you one pie chart for each computer, showing the breakdown of file system free space and used space on that computer IBM Tivoli Storage Resource Manager Reference Guide

241 Reporting Capacity Reporting Filesystem Free Space Reporting 5 The following figure shows the Chart tab for the Filesystem Free Space Network Wide Reporting facility. Figure 5-69 Capacity Reporting Filesystem Free Space Chart Tab This tab includes one pie chart for your entire enterprise that shows the amount of free space and used space that you have on all your servers. This gives you a simple and powerful way to get a very quick high-level view of the consumption level for all the storage in your enterprise. IBM Tivoli Storage Resource Manager Reference Guide 5-97

242 Reporting Usage Reporting Usage Reporting 5 Usage reporting allows you to monitor and report on the usage and growth of the consumption of your storage. You can view these reports based on specific file systems and computers, groups of file systems and computers, or throughout your entire enterprise. Use these reports to: view which servers and file systems are experiencing the heaviest (or lightest) load of data and storage access identify wasted space by pinpointing files that are no longer needed or have not been accessed for the longest time associate users with the amount of storage they are consuming on specific file systems, groups of file systems, specific computers, groups of computers, and throughout the entire network These reports help you project storage consumption for the future and maximize the current storage assets that you have in place by eliminating wasted space and making the most of the space you have. Access Load Reporting 5 The Access Load Reporting facility shows which servers and file systems are experiencing the heaviest (or lightest) load of data and storage access. Access Time Reporting Access Time Reporting allows you to report and chart the amount of data and the number of files that have been accessed during the last day, the last week, the last month, the last year, and over. You can view this information at the directory level, the file system level, the computer level, at the domain level, and for the entire network IBM Tivoli Storage Resource Manager Reference Guide

243 Reporting Usage Reporting The following report shows a single pie chart that depicts all of the data across the entire enterprise, giving you an easy way to see how much of your corporate data is accessed every day, every week, and even data that has not been accessed in over a year. Figure 5-70 Usage Reporting Access Load Access Time Chart Network Wide IBM Tivoli Storage Resource Manager Reference Guide 5-99

244 Reporting Usage Reporting Modification Time Reporting Modification Time Reporting allows you to report and chart the amount of data and the number of files that have been modified during the last day, the last week, the last month, the last year, and over. You can view this information at the directory level, the file system level, the computer level, at the domain level, and for the entire network. The following report shows a single pie chart that depicts all of the data across the entire enterprise, allowing you to see how much of your corporate data is modified every day, every week, and even data that has not been modified in over a year. Figure 5-71 Usage Reporting Access Load Modification Time Chart Network Wide Creation Time Reporting Creation Time Reporting allows you to report and chart the amount of data and the number of files that have been access during the last day, the last week, the last month, the last year, and over. You can view this information at the directory level, the file system level, the computer level, at the domain level, and for the entire network IBM Tivoli Storage Resource Manager Reference Guide

245 Reporting Usage Reporting Files Reporting 5 Use Files Reporting to report on the files found on the storage in your environment during the Scan process. During the scan process, Tivoli Storage Resource Manager gathers a vast number of statistics on your files and a number of attributes about the files. These can be reported on in a variety of ways using this facility. Largest Files Reporting Largest files reporting allows you to generate reports on the largest files found in your environment. You can view this information at the directory level, the file system level, the computer level, and at all those levels sorted by domain and network wide. The following report shows the largest files Network Wide for all the computers. Figure 5-72 Usage Reporting Files Largest Files Network Wide The number of files that are gathered and stored in the Enterprise Repository is dependent upon the number that you specify in the profile that you use during scanning. The default profile gathers information on the 20 largest files. IBM Tivoli Storage Resource Manager Reference Guide 5-101

246 Reporting Usage Reporting Most Obsolete Files Reporting Most Obsolete files reporting allows you to generate reports on the files found in your environment that have not been accessed in the longest period of time. It is very likely that many of these files are no longer needed, at least online, and could be wasting space. You can view this information at the directory level, the file system level, the computer level, at the domain level, and for the entire network. The following report shows the most obsolete files Network Wide for all the computers. Figure 5-73 Usage Reporting Files Most Obsolete Files Network Wide The number of files that are gathered and stored in the Enterprise Repository is dependent upon the number that you specify in the profile that you use during scanning. The default profile gathers information on the 20 most obsolete files IBM Tivoli Storage Resource Manager Reference Guide

247 Reporting Usage Reporting Orphan Files Reporting Orphan files reporting allows you to generate reports on the files found in your environment that are owned by users that are no longer active in the environment. It is very likely that many of these files are no longer needed and could be wasting space. You can view this information at the directory level, the file system level, the computer level, at the domain level, and for the entire network. The following report below shows the largest orphan files Network Wide for all the computers. Figure 5-74 Usage Reporting Files Orphan Files Network Wide The number of files that are gathered and stored in the Enterprise Repository is dependent upon the number that you specify in the profile that you use during scanning. The default profile gathers information on the 20 largest orphan files. You can also generate reports on the oldest orphan files that have not been accessed for the longest periods of time. IBM Tivoli Storage Resource Manager Reference Guide 5-103

248 Reporting Usage Reporting This following report shows the file detail for one of the files from the Orphan File report. To get to this detail report, click on the magnifying glass icon on the left of the report row. Figure 5-75 Usage Reporting Files Orphan Files File Detail IBM Tivoli Storage Resource Manager Reference Guide

249 Reporting Usage Reporting File Size Distribution Reporting The File Size Distribution Reporting Facility allows you to generate reports that will allow you to see the distribution of file sizes on a specific directory, a file system, a computer, the domain, or across your entire network. The following report shows a single pie chart for each computer in the report. Figure 5-76 Usage Reporting Files Files Size Distribution File Count Chart Tab Each pie chart depicts the number of files that fall into each file size bucket that are described in the legend. For example, the blue portion of the pie represents the number of files on each computer that are smaller than 1024 bytes long. This gives you an easy way to get a quick grasp of what are the size distribution of your data files. IBM Tivoli Storage Resource Manager Reference Guide 5-105

250 Reporting Usage Reporting File Summary Reporting The File Summary Reporting facility gives you an easy way to report on overview information for files, also at the directory level, the file system level, the computer level, the domain level or for the whole network. This report shows you (for each entity at the level you are reporting by): the total size of the files the number of files the number of directories the average file size The following is a history chart generated from the File Summary report. This chart shows (historically) the number of files for each computer in the report. The historical chart can be generated to show daily, weekly, or monthly history. Figure 5-77 Usage Reporting Files Files Summary History File Count Chart Tab IBM Tivoli Storage Resource Manager Reference Guide

251 Reporting Usage Reporting Directories Reporting 5 Directory Reporting allows you to report on the directories found on the storage in your environment during the Scan process. During the scan process, Tivoli Storage Resource Manager gathers a vast number of statistics on your directories and a number of attributes about the directories. These can be reported on in a variety of ways using this facility. Largest Directories Reporting The Largest Directories Reporting facility allows you to view reports on the N largest directories found in your environment: for specific directories on specific computers or groups of computers on specific file systems or groups of file systems in specific domains on the entire network The number of largest (or the value of N in finding the N largest directories), is determined by the Profile that you use for doing the reporting. When you define a Profile, you specify the number of largest directories to collect information on. Then when you generate the report, you can select what Profile to use. Figure 5-78 Usage Reporting Directories Largest Directories Computers Tab IBM Tivoli Storage Resource Manager Reference Guide 5-107

252 Reporting Usage Reporting The following figure displays a series of pie charts that depict the largest directories by computer. The various colors represent how many directories in each size range are found on each of the computers being charted. This gives you a very quick way to compare the computers to each other. Figure 5-79 Usage Reporting Directories Largest Directories Chart Tab Monitored Directory Space Reporting Monitored Directory Reporting allows you to report on the monitored directories that you have defined via the Directory Group facility. This information is gathered during the Scan process. During the scan process, Tivoli Storage Resource Manager gathers a number of statistics on your directories and a number of attributes about the directories. These can be reported on in a variety of ways using this facility IBM Tivoli Storage Resource Manager Reference Guide

253 Reporting Usage Reporting Users Reporting 5 The Users Reporting facility allows you to report on the users that are found as file owners in your environment. This gives you an easy and convenient way to view and aggregate storage resource consumption by owner across directories, file systems, computers, domains, and across your entire network. The following figure shows the Selection tab for the User reporting, Grouped by User Name, By Computer report. To view this report, you must first select some Users and then select the computers that you want to report upon. Once you have selected both of these, then click. Figure 5-80 Usage Reporting Users Group by User name Selection Tab IBM Tivoli Storage Resource Manager Reference Guide 5-109

254 Reporting Usage Reporting The following figure shows the Computer tab that displays the report that would be generated after the Selection tab was processed. Figure 5-81 Usage Reporting Users Group by User name Computers Tab This tab shows one row for each user and computer combination. This allows you to see how much space and how many files and directories are owned by a given user on any one or more computers IBM Tivoli Storage Resource Manager Reference Guide

255 Reporting Usage Reporting The following figure shows the pop-up menu that appears when you click Computers tab. at the top of the Figure 5-82 Usage Reporting Users Group by User name Chart Dropdown The charts from which you can select show both space consumed and number of files owned by a given user or groups of users. You can also generate a number of historical charts to aid in your analysis of user owned storage. IBM Tivoli Storage Resource Manager Reference Guide 5-111

256 Reporting Usage Reporting In the following case, the chart shows the User space usage by computer for the user Administrator on the three selected computers. Figure 5-83 Usage Reporting Users Group by User name Chart Tab This chart shows the amount of space consumed by the files of various sizes on each of those computers, and where the files are owned by Administrator IBM Tivoli Storage Resource Manager Reference Guide

257 Reporting Usage Reporting The following figure shows the Selection tab for the User reporting, Grouped by User Name, by User Quota report. To view this report, you must first select some Users and then select the Quotas that you want to report upon. Once you have selected both of these, then click. Figure 5-84 Usage Reporting Users Group by User name User Quota Selection Tab IBM Tivoli Storage Resource Manager Reference Guide 5-113

258 Reporting Usage Reporting The following figure shows the Quotas tab that displays the report that would be generated after the Selection tab was processed. This shows one row for each user and computer combination. This allows you to see how much space and what percentage of quota they are consuming on that computer. Figure 5-85 Usage Reporting Users Group by User name Quotas Tab IBM Tivoli Storage Resource Manager Reference Guide

259 Reporting Usage Reporting The following figure shows the Network Wide tab that shows the report that would be generated for a Network Wide request of the same report. Figure 5-86 Usage Reporting Users Group by User name Network Wide Tab This report shows you, for the entire network, all the space consumed by a specific user. For each user you can view the: total size of the files they own number of files they own number of directories they own size of the largest file and 2nd largest files that they own If you scroll the report to the right, you see even more file level statistics for each owner. Additional information show will be the file size distribution, showing the number of files and the total file sizes for all files of various sizes. IBM Tivoli Storage Resource Manager Reference Guide 5-115

260 Reporting Usage Reporting The following figure shows one of the charts that can be generated from the prior report. This report shows the file size breakdown for a number of file owners. Figure 5-87 Usage Reporting Users Group by User name Network Wide Chart Tab OS User Groups Reporting 5 The OS User Groups Reporting gives you the exact same capabilities as the Users Reporting. The only difference is that you are doing your analysis of OS User Groups as opposed to actual single Users. Refer to Users Reporting on page 109 for examples of the types of reports that you can generate for this facility IBM Tivoli Storage Resource Manager Reference Guide

261 Reporting Usage Violation Reporting Usage Violation Reporting 5 Usage Violation reporting allows you to create and enforce corporate storage usage policies. You can report on both Quota Violations and Constraint Violations. With Quotas, you can control how much storage a user, or a group of users, can consume on: a file system or group of file systems a computer or group of computer throughout the entire network With Constraints you can set policies about which types of files, owners, and file sizes are allowed on: a file system or group of file systems a computer or group of computer throughout the entire network Constraint Violations Reporting 5 Constraints allow you to set policies about what types of files, what owners, and what sizes of files are allowed on file systems groups of file systems computers groups of computers the entire enterprise IBM Tivoli Storage Resource Manager Reference Guide 5-117

262 Reporting Usage Violation Reporting The following figure is an example of the report for Constraint Violations By Constraint. Figure 5-88 Usage Violations Constraint Violations Objects Tab The report shows one row for each Constraint. The row shows the detail of the constraint and the violating space totals for the files that violate the constraint IBM Tivoli Storage Resource Manager Reference Guide

263 Reporting Usage Violation Reporting The following figure is an example of the chart for a specific constraint from the Constraint Violations By Constraint. Figure 5-89 Usage Violations Constraint Violations Chart Tab This chart shows the amount of space that is being used by violating files. IBM Tivoli Storage Resource Manager Reference Guide 5-119

264 Reporting Usage Violation Reporting Quota Violations Reporting 5 Quota Violations Reporting allows you to report on the quotas that you have defined and see how much space is being used by the various entities that have quotas defined upon them. Quotas can be defined on either of two categories of users: on a specific user or group of users that you have defined within either Users or on OS User Groups. Quota Category User OS User Group Description This allows you to define a Quota on a user or group of users. The users are the owners of the files that Tivoli Storage Resource Manager finds as it scans your systems. This allows you to define a Quota on an OS user group or group of OS user groups. OS user groups are defined outside the tool and are found by Tivoli Storage Resource Manager as it scans your systems. Within each of those categories, you can define Quotas at any one of following three levels: Quota Level Network Computer Filesystem Description This allows you to define Quotas on users or groups of users at the entire network level. This enables you to control how much any single user or group of users is using on all of the storage throughout your enterprise. This allows you to define Quotas on users or groups of users at the computer level. This enables you to control how much any single user or group of users is using on a single computer, or on any given group of computers. This allows you to define Quotas on users or groups of users at the file system level. This enables you to control how much any single user or group of users is using on a single file system, or on any given group of file systems IBM Tivoli Storage Resource Manager Reference Guide

265 Reporting Usage Violation Reporting All Quotas Reporting The All Quotas Reporting facility allows you to report on all quotas, including network level, computer level and file system level quotas. The following figure shows the Selection tab that allows you to select what users you wish to do quota reporting upon: Figure 5-90 Usage Violations All Quota Violations Selection Tab The Objects tab shows you for each user and computer and file system: how much space is being used what the Quota threshold is what the percentage of the Quota that is being consumed IBM Tivoli Storage Resource Manager Reference Guide 5-121

266 Reporting Usage Violation Reporting This gives you a simple way to analyze how much space is being used relative to the Quotas that you have defined on your systems and users. Figure 5-91 Usage Violations All Quota Violations Objects Tab IBM Tivoli Storage Resource Manager Reference Guide

267 Reporting Usage Violation Reporting Network-Wide Quotas Reporting The following figure shows a Network Wide Quota report. For each network level Quota that has been defined, the amount of space being used and the threshold and the percentage of threshold are shown. Figure 5-92 Usage Violations Network Wide Quota Violations Quotas Tab Computer Quotas Reporting The following figure shows a Computer Quota violations report by User. For each user, the amount of space being used, the threshold, and the percentage of the threshold that is being consumed is displayed. Filesystem Quotas Reporting Filesystem Quota reporting behaves and looks the same as computer level Quota reporting. This difference is that you are doing your analysis based upon Quotas defined at the file system level, as opposed to the computer level. IBM Tivoli Storage Resource Manager Reference Guide 5-123

268 Reporting Backup Reporting Backup Reporting 5 Backup reporting allows you to identify the most at risk files in your enterprise that are not backed up properly. Critical data that is not backed up might expose you to costly losses of information. The Backup reporting function also allows you to: investigate the sizes of data that would be required to backup to achieve full backups of any subset of your enterprise (including the whole enterprise) determine the amount of space required to perform an incremental backup of any or all of your data at any given point in time Most At Risk Files Reporting 5 The Most At Risk Files Reporting enables you to view the files that have been modified the longest ago, but have not been backed up since they were modified. This can alert you to a dangerous situation where you may have at risk data that could be lost and not recovered due to lack of backups. Figure 5-93 Most At Risk by Computer Computers Tab IBM Tivoli Storage Resource Manager Reference Guide

269 Reporting Backup Reporting The following figure shows file detail for a file that was in the Most At Risk report on the previous page. To get the file detail report, simply click on the magnifying glass icon at the left of the row. Figure 5-94 Most At Risk by Computer File Detail Tab IBM Tivoli Storage Resource Manager Reference Guide 5-125

270 Reporting Backup Reporting Modified Files not Backed Up Reporting 5 The Modified Files not Backed Up Reporting will show you the numbers of files that have been modified, the longest ago, but have not been backed up since they were modified. This can alert you to a dangerous situation where you may have at risk data that could be lost and not recovered due to lack of backups. The following figure shows one row for each computer. The report then shows, for each computer, the number of files and the total size of the files that have been modified but not backed up. Figure 5-95 Modified Files not Backed Up by Computer Computers Tab IBM Tivoli Storage Resource Manager Reference Guide

271 Reporting Backup Reporting The following figure shows one chart for each computer. These charts show the total size of the files that have been modified but not backed up for each of the time ranges shown in the legend. Figure 5-96 Modified Files not Backed Up by Computer Chart Tab IBM Tivoli Storage Resource Manager Reference Guide 5-127

272 Reporting Backup Reporting Backup Storage Requirements Reporting 5 Backup Storage Requirements Reporting allows you to determine, at a network, domain computer, file system, or directory level, how much storage will be required to do backups. You can determine how much storage will be required to do both full backups and to do incremental backups. Full Backup Size Reporting Full Backup Size Reporting allows you report on how much space it will take to do full backups of specific computers, file systems, directories, groups of those entities, domains, and the entire network. Figure 5-97 Backup Reporting Full Backup Size Requirements Computers Tab IBM Tivoli Storage Resource Manager Reference Guide

273 Reporting Backup Reporting The following figure shows the Full Backup Size Reporting History Charting facility. Figure 5-98 Backup Reporting Full Backup Size Requirements History Chart Tab This example allows you to see, for each computer, a line graph that shows how much space is required to do a full backup of the storage on that computer. This is shown historically over time, so you can see any changes in the amount of storage required for backups historically and chart growth in requirements. The chart can be generated for history daily, weekly or monthly. You can also limit the days that are used for chart generation with the controls on the top of the tab. IBM Tivoli Storage Resource Manager Reference Guide 5-129

274 Reporting Backup Reporting Incremental Backup Size Reporting The Incremental Range Sizes Reporting allows you to determine how much data you would need to backup if you wanted to do incremental backups of data every day, every week, each month, and greater. This report can be generated by Directory, by Directory Group, by Filesystem, by Filesystem Group, by Computer, by Computer Group, by Domain and Network Wide. This allows you to see for any of these levels, how much data would need to be backed up for any of these desired time intervals. This is useful for backup sizing and can be used to determine appropriate backup groups and sets for timing your backups. Figure 5-99 Backup Reporting Incremental Range Sizes Computers Tab IBM Tivoli Storage Resource Manager Reference Guide

275 Reporting Backup Reporting Incremental Range Sizes Reporting The Incremental Range Sizes Reporting allows you to determine how much data you would need to backup if you wanted to do incremental backups of data every day, every week, each month, and greater. The following figure shows you a bar chart for the various time frames and gives you a quick way to visualize how much data would need to be backed up for the different time frames. Figure Backup Reporting Incremental Range Sizes Chart Tab IBM Tivoli Storage Resource Manager Reference Guide 5-131