36
NetIQ ® AppManager ® for NetBackup UNIX Management Guide January 2008

AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

  • Upload
    trandat

  • View
    228

  • Download
    1

Embed Size (px)

Citation preview

Page 1: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

NetIQ® AppManager® for NetBackup UNIX

Management GuideJanuary 2008

Page 2: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

Legal Notice

NetIQ AppManager is covered by United States Patent No(s): 05829001, 05986653, 05999178, 06078324, 06397359, 06408335.

THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT ARE FURNISHED UNDER AND ARE SUBJECT TO THE TERMS OF A LICENSE AGREEMENT OR A NON-DISCLOSURE AGREEMENT. EXCEPT AS EXPRESSLY SET FORTH IN SUCH LICENSE AGREEMENT OR NON-DISCLOSURE AGREEMENT, NETIQ CORPORATION PROVIDES THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. SOME STATES DO NOT ALLOW DISCLAIMERS OF EXPRESS OR IMPLIED WARRANTIES IN CERTAIN TRANSACTIONS; THEREFORE, THIS STATEMENT MAY NOT APPLY TO YOU.

This document and the software described in this document may not be lent, sold, or given away without the prior written permission of NetIQ Corporation, except as otherwise permitted by law. Except as expressly set forth in such license agreement or non-disclosure agreement, no part of this document or the software described in this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, or otherwise, without the prior written consent of NetIQ Corporation. Some companies, names, and data in this document are used for illustration purposes and may not represent real companies, individuals, or data.

This document could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein. These changes may be incorporated in new editions of this document. NetIQ Corporation may make improvements in or changes to the software described in this document at any time.

© 1995-2008 NetIQ Corporation, all rights reserved.

U.S. Government Restricted Rights: If the software and documentation are being acquired by or on behalf of the U.S. Government or by a U.S. Government prime contractor or subcontractor (at any tier), in accordance with 48 C.F.R. 227.7202-4 (for Department of Defense (DOD) acquisitions) and 48 C.F.R. 2.101 and 12.212 (for non-DOD acquisitions), the government’s rights in the software and documentation, including its rights to use, modify, reproduce, release, perform, display or disclose the software or documentation, will be subject in all respects to the commercial license rights and restrictions provided in the license agreement.

Check Point, FireWall-1, VPN-1, Provider-1, and SiteManager-1 are trademarks or registered trademarks of Check Point Software Technologies Ltd.

ActiveAgent, ActiveAnalytics, ActiveAudit, ActiveReporting, ADcheck, Aegis, AppAnalyzer, AppManager, the cube logo design, Change Administrator, Change Guardian, Compliance Suite, Directory and Resource Administrator, Directory Security Administrator, Domain Migration Administrator, Exchange Administrator, File Security Administrator, Group Policy Administrator, Group Policy Guardian, Group Policy Suite, IntelliPolicy, Knowing is Everything, Knowledge Scripts, Mission Critical Software for E-Business, MP3check, NetConnect, NetIQ, the NetIQ logo, the NetIQ Partner Network design, Patch Manager, PSAudit, PSDetect, PSPasswordManager, PSSecure, Risk and Compliance Center, Secure Configuration Manager, Security Administration Suite, Security Analyzer, Security Manager, Server Consolidator, VigilEnt, Vivinet, Vulnerability Manager, Work Smarter, and XMP are trademarks or registered trademarks of NetIQ Corporation or its subsidiaries in the United States and other jurisdictions. All other company and product names mentioned are used only for identification purposes and may be trademarks or registered trademarks of their respective companies.

Page 3: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

About This Guide

The NetIQ AppManager Suite (AppManager Suite) is a comprehensive solution for managing, diagnosing, and analyzing performance, availability, and server health for a broad spectrum of operating environments, applications, and server hardware.

AppManager provides system administrators with a central, easy-to-use console to view critical server and application resources across the enterprise. With AppManager, administrative staffs can monitor computer and application resources, check for potential problems, initiate responsive actions, automate routine tasks, and gather performance data for real-time and historical reporting and analysis.

Intended AudienceThis guide provides information to ensure a successful installation of NetIQ AppManager components. This guide is intended for system administrators and users responsible for installing all or part of the AppManager Suite software.

For more information about working with AppManager, see the user guides for the Operator Console or Control Center. For more information about configuring and maintaining an AppManager management site, see the Administrator Guide for AppManager.

iii

Page 4: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

ConventionsThis guide uses consistent conventions to help you identify items throughout the documentation. The following table summarizes these conventions.

Using Online HelpAppManager provides task-based, reference, and context-sensitive online Help.

To access task-based Help or search for Help topics, click Help Topics on the Help menu. To view context-sensitive Help within dialog boxes, click Help or press F1.

You can get help on individual Knowledge Scripts in one of the following ways:

• On the Values tab of the Knowledge Script Properties dialog box, click Help or press F1.

• In the Knowledge Script pane of the Operator Console, highlight a Knowledge Script and press F1.

Convention Use

Bold • Window and menu items• Technical terms, when introduced

Italics • Book and installation kit titles• Variable names and values• Emphasized words

Fixed Font • File and folder names• Commands and code examples• Text you must type• Text (output) displayed in the command-line interface

iv AppManager for NetBackup UNIX

Page 5: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

Other Information in the LibraryThe library provides the following information resources:

• Installation Guide for AppManager: Provides complete information about AppManager pre-installation requirements and step-by-step installation procedures for all AppManager components.

• Control Center User Guide for AppManager: Provides complete information about managing groups of computers, including running jobs, responding to events, creating reports, and working with the Control Center Console. A separate guide is available for the AppManager Operator Console.

• Administrator Guide for AppManager: Provides information about maintaining an AppManager management site, managing security, using scripts to handle AppManager tasks, and leveraging advanced configuration options.

• Upgrade and Migration Guide for AppManager: Provides complete information on how to upgrade from a previous version of AppManager.

• Management guides: Provide information about installing and monitoring specific applications with AppManager.

The AppManager library is available in Adobe Acrobat (PDF) format and is located in the \Documentation folder of the AppManager installation kit.

About This Guide v

Page 6: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

NetIQ Online Support and Extended Support Web sites provide other resources:

• Downloads, including hotfixes, service packs, and product upgrades.

• Documentation, including white papers and the most current information about version support for the systems and applications monitored by AppManager.

Note You can access NetIQ Support without a password or registration. To access the Extended Support site, you must be a registered AppManager customer.

In addition to the AppManager documentation, you may want to consult the documentation for your Windows or UNIX operating system, or other application- or system-specific documentation for reference and conceptual information. This background information can help you get the most out of your AppManager installation.

About NetIQ CorporationNetIQ Corporation, an Attachmate business, is a leading provider of comprehensive systems and security management solutions that help enterprises maximize IT service delivery and efficiency. With more than 12,000 customers worldwide, NetIQ solutions yield measurable business value and results that dynamic organizations demand. Best-of-breed solutions from NetIQ Corporation help IT organizations deliver critical business services, mitigate operational risk, and document policy compliance. The company’s portfolio of award-winning management solutions includes Systems Management, Security Management, Configuration Control and Enterprise Administration. For more information, please visit www.netiq.com.

vi AppManager for NetBackup UNIX

Page 7: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

Contacting NetIQ Corporation

Please contact us with your questions and comments. We look forward to hearing from you.

Sales Email: [email protected]

Telephone: 1-713-418-5555 (United States) +353 (0) 91-782-677 (Europe, Middle East, and Africa)For other locations, see our Support Contact Information Web site at www.netiq.com/support

Support Web Site: www.netiq.com/support

About This Guide vii

Page 8: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

viii AppManager for NetBackup UNIX

Page 9: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

Contents

About This Guide iiiIntended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iiiConventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ivUsing Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ivOther Information in the Library . . . . . . . . . . . . . . . . . . . vAbout NetIQ Corporation . . . . . . . . . . . . . . . . . . . . . . . . vi

Chapter 1 Introduction to AppManager for NetBackup UNIX 1

Chapter 2 Installing AppManager for NetBackup UNIX 3System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Installing the Module . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Installing Non-Root Extensions . . . . . . . . . . . . . . . . . . . 7Discovering AppManager for NetBackup UNIX Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Chapter 3 NetBackupUNIX Knowledge Scripts 11Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13DBDirSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14DeviceStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15ErrorLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16FailedJobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17IncompleteJobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19LogDirSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

ix

Page 10: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

PendingRequest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21ResourceHigh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22StorageUnitsChanged . . . . . . . . . . . . . . . . . . . . . . . . . . 23SuccessfulJobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Discovery_NetBackupUNIX . . . . . . . . . . . . . . . . . . . . . . 26

x AppManager for NetBackup UNIX

Page 11: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

Chapter 1

Introduction to AppManager for NetBackup UNIX

AppManager for NetBackup UNIX is a robust and dependable tool to monitor and promote the efficiency of NetBackup servers. Using a set of NetBackup UNIX-specific Knowledge Scripts, AppManager for NetBackup UNIX monitors:

• The number of successful, incomplete, and failed backup jobs.

• The memory and CPU resources consumed by NetBackup UNIX servers.

• The number of clients managed by the NetBackup UNIX servers.

• The status of NetBackup UNIX devices and services.

• The size of NetBackup UNIX directories.

• Changes made to storage units configured on the NetBackup UNIX servers.

By monitoring the status of backup jobs, AppManager for NetBackup UNIX helps you maintain an accurate, up-to-date picture of how well archiving protects your information. If the number of incomplete or failed backup jobs exceeds your expectations, or the number of successful jobs fails to meet a minimum threshold, AppManager for NetBackup UNIX alerts you. You can investigate your NetBackup UNIX implementation to see whether the necessary daemons are running or the appropriate classes are active. You can also know the status of network connections and of any backup devices in use.

In addition to monitoring NetBackup UNIX, AppManager for NetBackup UNIX can intervene to restart a NetBackup UNIX service or reset a device.

1

Page 12: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

AppManager for NetBackup UNIX also scans error logs for NetBackup UNIX entries, giving you better visibility of potential problems with backup activities.

The Knowledge Scripts for AppManager for NetBackup UNIX raise events in the AppManager Operator Console or Control Center Console when problems arise. For example, if the number of failed jobs exceeds a threshold, or if a daemon is not running the Knowledge Scripts raise events. The Knowledge Scripts collect information that you can use for data analysis and reporting.

AppManager for NetBackup UNIX provides a single location from which to manage your implementation of NetBackup UNIX. Using the Operator Console or Control Center Console, you can monitor the health and activity of your NetBackup UNIX servers, the efficacy with which the servers archive your information, and the status of NetBackup UNIX daemons and storage devices. In addition to monitoring, the Operator Console and Control Center Console provide the means to initiate responsive actions like restarting a stopped daemon, or paging the necessary personnel when problems arise. You can also use the tools available in the Operator Console and Control Center Console to generate and view reports based on NetBackup UNIX information.

2 AppManager for NetBackup UNIX

Page 13: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

Chapter 2

Installing AppManager for NetBackup UNIX

This chapter describes the procedure to install AppManager for NetBackup UNIX.

If you do not have the AppManager repository, management server, Operator Console, and Control Center Console installed in your environment, you can install them from the AppManager installation kit. For more information about installing AppManager components and the agent, see the Installation Guide for AppManager.

The following topics are covered in this chapter:

• “System Requirements” on page 4

• “Installing the Module” on page 5

• “Installing Non-Root Extensions” on page 7

• “Discovering AppManager for NetBackup UNIX Resources” on page 9

3

Page 14: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

System RequirementsThe following table lists the system requirements for AppManager for NetBackup UNIX:

The requirements for AppManager for NetBackup UNIX are different from the operating system versions and platforms that the UNIX agent supports. The AppManager Supported Products Web site contains complete and up-to-date information about supported environments for both the agent and modules, which are listed separately:

www.netiq.com/support/am/supportedproducts.asp#Unix.

Note For more information about system requirements and instructions for installing the AppManager repository, console, and management server, see the Installation Guide for AppManager. For more information about installing and running the AppManager UNIX agent, see the AppManager for UNIX Servers Management Guide. Adobe Acrobat versions of management guides are available in the AppManager UNIX Components installation kit.

Item Requirement

AppManager repository, management server, Operator Console, and Control Center Console

Version 6.0.2, 7.0, or 7.0.1

AppManager UNIX agent Version 6.0.2, 6.5, 7.0, or 7.0.1

Symantec NetBackup Enterprise Server

Version 6.0 or 6.5

Operating System One of the following operating systems:• Sun Solaris versions 2.7, 8.0, 9.0 and 10.0• IBM AIX versions 4.3.3, 5.L 5.1, 5.2 and 5.3• Red Hat Linux Advanced Server versions 3.0, 4.0,

Enterprise Server version 3.0, 4.0 or 5.0• HP-UX versions 11, 11i and 11iv2• Novell SUSE version 8, 9, or 10

4 AppManager for NetBackup UNIX

Page 15: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

Installing the ModuleTo install AppManager for NetBackup UNIX, you must install components on the following computers:

• Windows computers with AppManager components installed

• UNIX computers with NetBackup installed

This section includes the following topics:

• “Installing the Windows Components” on page 5

• “Installing the UNIX Components” on page 6

Installing the Windows Components

AppManager for NetBackup UNIX includes a setup file that you can install in one of the following ways:

• Silently, from a command prompt.

For more information about silent installation, see the Installation Guide for AppManager.

• Manually, on the local computer.

You can launch the setup file directly.

When you run the setup program, it automatically identifies and updates all relevant AppManager components on the computer. Therefore, you need to run the setup program only once on any computer. The pre-installation check runs automatically when you launch the setup program.

To install AppManager for NetBackup UNIX on AppManager version 6.0.2:

1 Run AM602_NetBackupUNIX_Setup.exe on the repository computer to install Knowledge Scripts, reports, and object type information. For repositories running in a clustered environment, run the setup program on the node that currently owns the cluster resource.

Chapter 2 • Installing AppManager for NetBackup UNIX 5

Page 16: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

2 Run AM602_NetBackupUNIX_Setup.exe on all Operator Console and Control Center Console computers.

The MAINT.LOG lists all changes and problems encountered during the installation process. The MAINT.ERR log file lists only the problems encountered. By default, these files are located in the \NetIQ\Temp\NetIQ_Debug folder.

To install AppManager for NetBackup UNIX on AppManager version 7.x.x:

1 Run AM70-NetBackupSvrUnix-7.1.xx.x.msi on all repository computers to install AppManager for NetBackup UNIX Knowledge Scripts. For repositories running in a clustered environment, run the setup program on the node that currently owns the cluster resource.

2 Run AM70-NetBackupSvrUnix-7.1.xx.x.msi on all Operator Console and Control Center Console computers to install the Help.

For more information about installing modules, see the Installation Guide for AppManager. After the installation is complete, you can find a record of problems encountered in the NetBackupUNIX_Install.log file, located in the \NetIQ\Temp\NetIQ_Debug\<ServerName> folder.

Installing the UNIX Components

Install the AppManager UNIX agent on the UNIX computer where you installed the NetBackup server. You can perform either a manual installation or a silent installation. For more information about how to install the UNIX components, see the AppManager for UNIX Servers Management Guide, which is available in the AppManager UNIX Components installation kit.

6 AppManager for NetBackup UNIX

Page 17: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

Installing Non-Root ExtensionsWhen the UNIX agent runs as a user other than root, AppManager for NetBackup UNIX requires you to install the optional non-root extensions as part of the agent installation procedure. Without these extensions, most Knowledge Scripts in the NetBackupUNIX category including the Discovery Knowledge Script, fail to run.

Non-root extensions use the sudo utility to allow programs to run as different users on UNIX operating systems. The NetBackup programs called by the NetBackupUNIX Knowledge Scripts require root privileges to execute properly.

For non-root extensions to function correctly with AppManager for NetBackup UNIX, you need to perform some extra configuration. Update the sudo configuration file, /etc/sudoers, with the commands that AppManager for NetBackup UNIX executes. NetIQ Corporation recommends that you edit this file using the supplied editing program, visudo. For more information about the detailed procedure to install the non-root extensions, see the AppManager for UNIX Servers Management Guide.

Note The visudo program must run as the root user. If you used the default installation path for the AIX operating system, the visudo program is located in /usr/netiq/UnixAgent/sbin. For the Sun Solaris operating system, the path varies slightly.

About the Extensions

To enable sudo functionality, use a command alias to specify the commands that a user can run. AppManager for NetBackup UNIX uses a form of command matching in which the command alias lists only the path and filename for each program to be executed.

In addition to the command alias, you need a user specification. The user specification lists all the commands that are allowed for a particular user account. An example is provided below.

Chapter 2 • Installing AppManager for NetBackup UNIX 7

Page 18: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

Example of an Edited Sudoers File

The following example shows the updates required for a default installation of the AppManager UNIX agent to run with an installation of NetBackup UNIX that uses the default program file locations.

The user in this example is netiq. Set this user to the same user account as the account under which the UNIX agent is running:

# __START_NETIQ_ADDITIONS_NETBACKUP__## This block contains code required by NetIQ AppManager for# NetBackup UNIX.#Cmnd_Alias NETIQ_CMDS_NETBACKUP = \/bin/find, \/usr/openv/netbackup/bin/admincmd/bpminlicense, \/usr/openv/netbackup/bin/admincmd/bpplclients, \/usr/openv/netbackup/bin/admincmd/bpclinfo, \/usr/openv/netbackup/bin/admincmd/bppllist, \/usr/openv/netbackup/bin/admincmd/bperror, \/usr/openv/netbackup/bin/admincmd/bpstulist, \/usr/openv/netbackup/bin/bpclntcmd, \/usr/openv/netbackup/bin/bpps, \/usr/openv/netbackup/bin/initbpdbm, \/usr/openv/netbackup/bin/initbprd, \/usr/openv/volmgr/bin/ltid, \/usr/openv/volmgr/bin/vmoprcmd, \/usr/openv/volmgr/bin/vmps, \/usr/openv/volmgr/bin/vmdnetiq ALL = NOPASSWD: NETIQ_CMDS_NETBACKUP## __END_NETIQ_ADDITIONS_NETBACKUP__

Note The example provided above lists the default paths to the appropriate NetBackup program files. When you edit the sudoers file to allow access to these program files, make sure the paths are accurate.

8 AppManager for NetBackup UNIX

Page 19: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

Discovering AppManager for NetBackup UNIX Resources

After installing AppManager for NetBackup UNIX, you might need to discover NetBackup resources if you have not already run the Discovery_NetBackupUNIX Knowledge Script.

To run the Discovery_NetBackupUNIX Knowledge Script:

1 Ensure the NetBackup server is running.

2 Click the Discovery tab in the Knowledge Script pane of the Control Center or Operator Console.

3 Drag the Discovery_NetBackupUNIX Knowledge Script in the TreeView pane onto the computer that contains at least one installation of NetBackup server.

4 Click the Schedule tab to review the schedule. By default, Discovery jobs are set to Run once.

5 Click the Values tab and specify the parameters required to run the Discovery_NetBackupUNIX Knowledge Script. For more information on specifying parameters, see “Discovery_NetBackupUNIX” on page 26.

6 Click OK to start the Discovery job.

After you successfully run the Knowledge Script, the Operator Console and Control Center Console display the new NetBackupUNIX Knowledge Script category. You are now ready to begin monitoring NetBackup servers.

Chapter 2 • Installing AppManager for NetBackup UNIX 9

Page 20: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

10 AppManager for NetBackup UNIX

Page 21: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

Chapter 3

NetBackupUNIX Knowledge Scripts

The NetBackupUNIX category provides the following Knowledge Scripts for monitoring NetBackup on UNIX servers.

To access more information about any Knowledge Script, select the Knowledge Script and then press F1 in the Knowledge Script view of the Control Centre Console. Or in the Operator Console, click any Knowledge Script in the Knowledge Script pane and then press F1.

Knowledge Script What It Does

Clients Monitors the number of clients managed by the NetBackup server.

DBDirSize Monitors the size (in MB) of the NetBackup database directory on the NetBackup server.

DeviceStatus Monitors the NetBackup device status and optionally resets.

ErrorLog Checks for errors, generates an error log, warning, and critical entries made since the last time the script was run.

FailedJobs Monitors the number of backup jobs that failed during the specified interval.

IncompleteJobs Monitors the number of incomplete backup jobs during the specified interval.

LogDirSize Monitors the size (in MB) of the NetBackup log directory.

PendingRequest Monitors the number of pending device requests on the NetBackup server.

ResourceHigh Monitors the CPU and memory usage of NetBackup daemons.

StorageUnitsChanged Monitors whether changes are made to the storage units configured on the NetBackup Server.

11

Page 22: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

SuccessfulJobs Monitors the number of successfully completed backup jobs during the specified interval.

Discovery_NetBackupUNIX

Discovers NetBackup resources and configuration information on UNIX servers.

Knowledge Script What It Does

12 AppManager for NetBackup UNIX

Page 23: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

ClientsUse this Knowledge Script to monitor the number of NetBackup clients managed by the NetBackup server. This Knowledge Script raises an event if the number of managed clients exceeds the threshold you set.

Resource Object

NetBackup server

Default Schedule

The default interval for this Knowledge Script is Every 24 hours.

Setting Parameter Values

Set the following parameters as needed.

Description How to Set It

Raise event when the managed backup clients threshold is exceeded?

Set to y to raise events. The default is y.

Collect data for number of clients being managed?

Set to y to collect data for charts and reports. If set to y, this script returns the number of clients managed by the NetBackup server. The default is n.

Threshold -- Maximum number of clients being managed

Type a threshold for the maximum number of clients NetBackup sever can manage before raising an event. The default is 10 clients.

Event severity level Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 8.

Chapter 3 • NetBackupUNIX Knowledge Scripts 13

Page 24: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

DBDirSizeUse this Knowledge Script to monitor the size (in MB) of the NetBackup database directory in the NetBackup server. This Knowledge Script raises an event and executes the specified action if the size of the database directory exceeds the threshold you set.

Resource Object

NetBackup server

Default Schedule

The default interval for this Knowledge Script is Every 24 hours.

Setting Parameter Values

Set the following parameters as needed.

Description How to Set It

Raise event when the database directory size threshold is exceeded?

Set to y to raise events. The default is y.

Collect data for database directory size?

Set to y to collect data for charts and reports. If set to y, this script returns the size (in MB) of the database directory. The default is n.

Threshold -- maximum size of database directory

Type a threshold for the maximum size (in MB) of the NetBackup database directory. The default is 200 MB.

Event severity level Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 10.

14 AppManager for NetBackup UNIX

Page 25: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

DeviceStatusUse this Knowledge Script to detect the status of a NetBackup device. If the device status is Not Connected, you can change the status to Connected. A NetBackup device is the medium used to store archived information, such as a tape drive.

This Knowledge Script raises an event when the auto-reset feature succeeds in resetting a device from the Not Connected status to the Connected status, and when the auto-reset feature fails.

Resource Object

NetBackup device

Default Schedule

The default interval for this Knowledge Script is Every 24 hours.

Setting Parameter Values

Set the following parameters as needed.

Description How To Set It

Collect data for device status?

Set to y to collect data for charts and reports. If set to y, this script returns 0 if the device is down, or 100 if the device is up. The default is n.

Auto-reset device? Set to y to automatically reset a device that is detected as down. The default is y.

Event severity level when auto-reset fails

Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 5.

Event severity level when auto-reset succeeds

Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 25.

Chapter 3 • NetBackupUNIX Knowledge Scripts 15

Page 26: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

ErrorLogUse this Knowledge Script to generate a log of problems on the NetBackup server, and then scan the log for Error, Warning, and Critical entries.

An iteration is the schedule you set for running the Knowledge Script. For example, Every hour. During the first iteration, this Knowledge Script sets a starting point to check for log entries but does not generate any events. During subsequent iterations, this Knowledge Script generates events if the server creates log entries.

Resource Object

NetBackup server

Default Schedule

The default interval for this Knowledge Script is Every hour.

Setting Parameter Values

Set the following parameters as needed.

Description How To Set It

Raise event if a log entry is found?

Set to y to raise events. The default is y.

Collect data for the number of log entries found?

Set to y to collect charts for graphs and reports. If set to y, this script returns the total number of entries in the error log during the interval. The default is n.

Event severity level Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 10.

16 AppManager for NetBackup UNIX

Page 27: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

FailedJobsUse this Knowledge Script to monitor the number of failed backup jobs. This Knowledge Script raises an event if the number of failed jobs during the interval exceeds the set threshold.

An iteration is the schedule you set for running the Knowledge Script. For example, Every 24 hours. During the first iteration, this Knowledge Script sets a starting point to check for failed backup jobs but does not generate any events. During subsequent iterations, this Knowledge Script generates events if the server generates failed backup jobs.

Note The first iteration of this Knowledge Script may list a job multiple times. In subsequent iterations, the Knowledge Script lists the jobs only once.

Resource Object

NetBackup server

Default Schedule

The default interval for this Knowledge Script is Every 24 hours.

Setting Parameter Values

Set the following parameters as needed.

Description How to Set It

Raise event when threshold is exceeded?

Set to y to raise events. The default is y.

Collect data for number of failed backup jobs?

Set to y to collect data for charts and reports. If set to y, this script returns the number of failed jobs since the last script iteration. The default is n.

Chapter 3 • NetBackupUNIX Knowledge Scripts 17

Page 28: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

Threshold -- Maximum number of failed backup jobs

Type a threshold for the maximum number of failed jobs that can be detected before an event is raised. The default is 10.

Event severity level Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 5.

Description How to Set It

18 AppManager for NetBackup UNIX

Page 29: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

IncompleteJobsUse this Knowledge Script to monitor the number of incomplete backup jobs. This Knowledge Script raises an event if the number of incomplete jobs during the interval exceeds the set the threshold.

An iteration is the schedule you set for running the Knowledge Script. For example, Every 24 hours. During the first iteration, this Knowledge Script sets a starting point to check for incomplete backup jobs but does not generate any events. During subsequent iterations, this Knowledge Script generates events if the server generates incomplete backup jobs.

Resource Object

NetBackup server

Default Schedule

The default interval for this Knowledge Script is Every 24 hours.

Setting Parameter Values

Set the following parameters as needed.

Description How to Set It

Raise event when the incomplete jobs threshold is exceeded?

Set to y to raise events. The default is y.

Collect data for number of incomplete jobs?

Set to y to collect data for charts and reports. If set to y, this script returns the number of jobs submitted and the number of incomplete jobs since the last script iteration. The default is n.

Threshold -- Maximum number of incomplete backup jobs

Type a maximum threshold for the number of incomplete jobs since the last script iteration. The default is 10.

Event severity level Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 10.

Chapter 3 • NetBackupUNIX Knowledge Scripts 19

Page 30: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

LogDirSizeUse this Knowledge Script to monitor the size (in MB) of the NetBackup log directory. This Knowledge Script raises an event if the size of this directory exceeds the threshold you set.

Resource Object

NetBackup server

Default Schedule

The default interval for this Knowledge Script is Every 24 hours.

Setting Parameter Values

Set the following parameters as needed.

Description How To Set It

Raise event when the log directory size threshold is exceeded?

Set to y to raise events. The default is y.

Collect data for log directory size?

Set to y to collect data for charts and reports. If set to y, this script returns the size (in MB) of the NetBackup log directory. The default is n.

Threshold -- Maximum size of log directory

Type a threshold for the maximum size (in MB) of the NetBackup log directory. The default is 200 MB.

Event severity level Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 10.

20 AppManager for NetBackup UNIX

Page 31: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

PendingRequestUse this Knowledge Script to monitor the current number of pending device requests on the NetBackup server. This Knowledge Script raises an event if the current number of pending device requests exceeds the threshold you set.

Resource Object

NetBackup server

Default Schedule

The default interval for this Knowledge Script is Every hour.

Setting Parameter Values

Set the following parameters as needed.

Description How To Set It

Raise event when the current number of pending device requests threshold is exceeded?

Set to y to raise events. The default is y.

Collect data for number of pending device requests?

Set to y to collect data for charts and reports. If set to y, this script returns the current number of pending device requests. The default is n.

Threshold -- Maximum number of pending device requests

Type a threshold for the maximum current number of pending device requests that can be detected before an event is raised. The default is 5 requests.

Event severity level Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 8.

Chapter 3 • NetBackupUNIX Knowledge Scripts 21

Page 32: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

ResourceHighUse this Knowledge Script to monitor the CPU and memory usage of NetBackup daemons. This Knowledge Script raises an event if the CPU or memory usage exceeds the threshold you set.

Resource Objects

NetBackup daemons

Default Schedule

The default interval for this Knowledge Script is Every 5 minutes.

Setting Parameter Values

Set the following parameters as needed:

Description How to Set It

Raise event when either threshold is exceeded?

Set to y to raise events. The default is y.

Collect data for CPU and memory utilization? (y/n)

Set to y to collect data for charts and reports. If set to y, returns the CPU utilization (%) and the memory utilization (MB) of the NetBackup daemons. The default is n.

Threshold -- Maximum CPU utilization

Type a threshold for the maximum CPU utilization of the NetBackup daemons (as a percentage of total CPU time) that can be detected before an event is raised. The default is 60%.

Threshold -- Maximum memory utilization

Type a threshold for the maximum number of MB of memory utilization that can be detected before an event is raised. The default is 6 MB.

Event severity level Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 8.

22 AppManager for NetBackup UNIX

Page 33: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

StorageUnitsChangedUse this Knowledge Script to detect whether modifications have been made to storage units configured on the NetBackup server. This Knowledge Script raises an event if you add a new storage unit or delete a storage unit.

Resource Object

NetBackup storage unit folder

Default Schedule

The default interval for this Knowledge Script is Every 24 hours.

Setting Parameter Values

Set the following parameters as needed.

Description How To Set It

Raise event if modification to storage units is detected?

Set to y to raise events. The default is y.

Collect data for number of modified storage units?

Set to y to collect data for charts and reports. If set to y, this script returns the number of added and deleted storage units. The default is n.

Event severity level Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 10.

Chapter 3 • NetBackupUNIX Knowledge Scripts 23

Page 34: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

SuccessfulJobsUse this Knowledge Script to monitor the number of successfully completed backup jobs. This Knowledge Script raises an event if the number of successfully completed jobs during the interval falls below the set threshold.

An iteration is the schedule you set for running the Knowledge Script. For example, Every 24 hours. During the first iteration, this Knowledge Script sets a starting point to check for successful backup jobs but does not generate any events. During subsequent iterations, this Knowledge Script generates events if the server generates successful backup jobs.

Resource Object

NetBackup server

Default Schedule

The default interval for this Knowledge Script is Every 24 hours.

Setting Parameter Values

Set the following parameters as needed.

Description How To Set It

Raise event when threshold not met?

Set to y to raise events. The default is y.

Collect data for number of successfully completed backup jobs?

Set to y to collect data for charts and reports. If set to y, this script returns the number of successfully completed backup jobs since the last script iteration. The default is n.

Threshold -- Minimum number of successfully completed backup jobs

Type a minimum threshold for the number of successfully completed backup jobs since the last script iteration. The default is 10 jobs.

Event severity level Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 5.

24 AppManager for NetBackup UNIX

Page 35: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

Example of How this Script is Used

Assume that you run three backup jobs every morning at 2 A.M. and expect all the jobs to be complete by 7 A.M. You can run this script once each day at 8 A.M. with the Number of successfully completed jobs minimum threshold set to 3. This script raises an event and alerts you to possible problems if any of the scheduled backup jobs fails to complete by 8 A.M.

Chapter 3 • NetBackupUNIX Knowledge Scripts 25

Page 36: AppManager for NetBackup UNIXdownload.netiq.com/.../70/AppManagerForNetBackup_UNIX.pdfCheck Point, FireWall-1, ... performance, availability, and server health for a broad spectrum

Discovery_NetBackupUNIXUse this Knowledge Script to discover NetBackup resource and configuration information on UNIX servers.

Resource Objects

UNIX servers

Default Schedule

The default schedule for this Knowledge Script is Run once.

Setting Parameter Values

Set the following parameters as needed.

Description How To Set It

Raise event for successful discovery?

Set to y to raise an event if the discovery job succeeds. In addition, this Knowledge Script raises an event even if the job fails for any reason. The default is n.

Search path for NetBackup programs

Type the path to the NetBackup program to direct the search for NetBackup resources. The default is /usr/openv (the default NetBackup installation path).

Event severity when discovery...

Set the event severity level, from 1 to 40, to reflect the importance when the job:• ...succeeds. Set the severity level for a successful

discovery and to raise an event when the job succeeds. The default is 25.

• ...fails. The default is 5.• ...is partially done. Set the event severity level for a

discovery that returns some data but also generates warning messages. The default is 10.

• ...is not applicable. This type of failure usually occurs when NetBackup is not installed on the target computer. The default is 15.

26 AppManager for NetBackup UNIX