appmanager for netbackup -...

NetIQ® AppManager® for Symantec NetBackup

Management GuideAugust 2009

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.

© 2009 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.

For purposes of clarity, any module, adapter or other similar material ("Module") is licensed under the terms and conditions of the End User License Agreement for the applicable version of the NetIQ product or software to which it relates or interoperates with, and by accessing, copying or using a Module you agree to be bound by such terms. If you do not agree to the terms of the End User License Agreement you are not authorized to use, access or copy a Module and you must destroy all copies of the Module and contact NetIQ for further instructions.

Contents

About This Guide........................................................................................................................................v

Chapter 1Introducing AppManager for Symantec NetBackup 1

Chapter 2Installing AppManager for Symantec NetBackup 3System Requirements..................................................................................................................................................3Establishing a Distribution Computer for Faster Setup.............................................................................................4Installing the Module .................................................................................................................................................4Verifying Your Installed Module ................................................................................................................................5Propagating Knowledge Script Changes.....................................................................................................................5

Propagating Changes to Running Jobs .........................................................................................................6Propagating Changes to Knowledge Script Groups......................................................................................6

Chapter 3NetBackup Knowledge Scripts 7Clients .........................................................................................................................................................................8DBDirSize ...................................................................................................................................................................9DeviceStatus..............................................................................................................................................................10ErrorLog....................................................................................................................................................................11EventLog ...................................................................................................................................................................12FailedJobs ..................................................................................................................................................................14IncompleteJobs .........................................................................................................................................................15LogDirSize.................................................................................................................................................................16PendingRequest ........................................................................................................................................................17ResourceHigh............................................................................................................................................................18ServiceDown .............................................................................................................................................................19StorageUnitsChanged...............................................................................................................................................20SuccessfulJobs ...........................................................................................................................................................21Discovery_NetBackup...............................................................................................................................................23

• Contents iii

iv User Guide

About This Guide

The NetIQ AppManager product (AppManager) 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 AppManager components. This guide is intended for system administrators and users responsible for installing all or part of AppManager.

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.

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.

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

• About This Guide v

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

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 about 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 from the NetIQ Web site: www.netiq.com/support/am/extended/documentation/default.asp?version=AMDocumentation.

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.

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 IT Process Automation, Systems Management, Security Management, Configuration Control and Enterprise Administration. For more information, please visit www.netiq.com.

NoteYou can access NetIQ Corporation Support without a password or registration. To access the Extended Support site, you must be a registered Update Definition in User Variables. customer.

vi User Guide

http://www.netiq.com

http://www.netiq.com/support/am/extended/documentation/default.asp?version=AMDocumentation

Contacting NetIQ CorporationPlease 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

mailto:[email protected]

http://www.netiq.com/support



viii User Guide

Introducing AppManager for Symantec NetBackup

AppManager for Symantec NetBackup is a robust and dependable tool that lets you monitor and promote the efficiency of Symantec NetBackup.

AppManager helps you monitor the status of backup jobs and maintain an accurate picture of your archiving process. In addition to monitoring NetBackup, AppManager can intervene to restart a NetBackup service or reset a device when it is down. AppManager also scans error and event logs for NetBackup entries, giving you better visibility of potential problems in backup activities.

NetBackup Knowledge Scripts ican manage and monitor the following:

• The memory and CPU resources consumed by NetBackup services

• The number of clients managed by the NetBackup server

• The status of NetBackup devices and services

• The size of NetBackup directories

• Changes made to storage units configured on the NetBackup server

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

• The number and types of errors and events

You can set thresholds that specify the boundaries of optimal performance. You can also configure AppManager to raise events when the thresholds are breached. You can collect information for data analysis and reporting, for example, on the number of failed jobs or a service that is not running.

• Introducing AppManager for Symantec NetBackup 1

2 Management Guide

Chapter 2Installing AppManager for Symantec NetBackup

This chapter describes the system requirements and the procedure to install AppManager for Symantec NetBackup.

This chapter assumes you have AppManager installed. For more information about installing AppManager or about AppManager system requirements, see the Installation Guide for AppManager, which is available on the NetIQ Web site or in the \Documentation folder of the AppManager installation kit.

System RequirementsAppManager for Symantec NetBackup: has the following requirements

For the latest information about supported software versions and the availability of module updates, visit the AppManager Supported Products page at www.netiq.com/support/am/supportedproducts/default.asp. If you encounter problems using this module with a later version of your application, contact NetIQ Technical Support.

For more information about system requirements for the AppManager agent, repository, and management server, see the Installation Guide for AppManager.

Item Requirement

AppManager installed on the AppMan-ager repository, console, and managed (agent) computers

At minimum, version 7.0

Microsoft operating system installed on the managed (agent) computers

One of the following:• Windows Server 2003 Server Standard Edition Service Pack 2• Windows Server 2003 Enterprise Edition Service Pack 2

Symantec NetBackup installed on the managed (agent) computers

One of the following:• Symantec NetBackup Server or Enterprise Server 5.0 or 5.1• Symantec NetBackup Server or Enterprise Server 6.0• Symantec NetBackup Server 6.5

Chapter 2 • Installing AppManager for Symantec NetBackup 3

http://www.netiq.com/support/am/supportedproducts/default.asp

http://www.netiq.com/support/am/supportedproducts/default.asp

Establishing a Distribution Computer for Faster SetupThe AppManager for Symantec NetBackup setup program updates the following components of an existing AppManager installation:

• Managed computers, with the AppManager managed object for NetBackup.

• The AppManager repository (QDB), with Knowledge Scripts for NetBackup.

• The Report Manager, with NetBackup reports and online documentation.

This means that you need to run the setup program on every computer you plan to monitor. In most cases, you will want to establish a distribution computer on your network where you can save the AppManager for Symantec NetBackup setup program. You can then update various computers by running the setup program from a central location.

When deciding where to save the setup program, keep these requirements in mind:

• If you are updating the AppManager repository or Report Manager, the distribution computer and the computer you are updating must be in the same domain, or in domains having a trust relationship. This holds true even if you want to run the setup locally on a managed client.

You must run the AppManager for Symantec NetBackup setup program on your remote computer. The setup program does a pre-installation check and only updates the necessary .DLL file without performing a full setup.

Installing the ModuleThe setup program automatically identifies and updates all relevant AppManager components on a computer. Therefore, run the setup program only once on any computer. The pre-installation check also runs automatically when you launch the setup program.

You can install the module in an AppManager version 7.x environment in one of the following ways:

• Run the AppManager setup program, amsetup.exe, which you can begin from Setup.exe. You can start these programs from the distribution computer on which you saved the setup files or from the AppManager installation kit.

• Run the module setup program, AM7x-NetBackup-7.x.x.0.msi, which you downloaded from the Web.

• Use Control Center to install the module on the remote computer where an agent is installed.

To install the module on AppManager version 7.x:

1. If you downloaded the module from the Web, ensure you save the module setup files on the distribution computer, and then delete the older versions of the module setup files. For more information about the distribution computer, see the Installation Guide for AppManager.

2. Run the AppManager or module setup program on all QDB computers to install Knowledge Scripts and reports. For repositories running in a clustered environment, run the setup program on the node that currently owns the cluster resource.

3. Install the module on the NetBackup computer you want to monitor. Use one of the following methods:

• Run the AppManager setup program.

• Run the module setup program.

4 User Guide

• Use Control Center Console to deploy the installation package. Ensure you check in and then configure the installation package, which is the .XML file included with the module setup program. For more information about the .XML file, see the AppManager for Symantec NetBackup ReadMe. For more information about deploying modules on agents, see the Control Center User Guide for AppManager.

4. Run the AppManager or module setup program on all Operator Console and Control Center computers to install the Help.

5. If you have not already discovered NetBackup resources, run the Discovery_NetBackup Knowledge Script on all agent computers where you installed the module. For more information, see “Discovery_NetBackup” on page 23.

After the installation has completed, you can find a record of problems encountered in the NetBackup_Install.log file, located in the \NetIQ\Temp\NetIQ_Debug\<ServerName> folder.

Verifying Your Installed ModuleTo verify installation on many computers, run the ReportAM_CompVersion Knowledge Script. Ensure you discover a report-enabled agent before running this script. For more information, see the Help for the script.

To verify installation on one or only a few computers, use the Operator Console.

To verify your installed module with the Operator Console:

1 In the TreeView pane, select the computer for which you want to verify your installed module.

2 From the TreeView menu, select Properties. On the System tab, the System information pane displays the version numbers for all modules installed on the computer.

3 Verify that the version number from the AppManager for Symantec NetBackup Readme matches the version number shown in the System information pane.

Propagating Knowledge Script ChangesThis release of AppManager for Symantec NetBackup may contain updated Knowledge Scripts. You can propagate script changes to jobs that are running and to Knowledge Script Groups, including recommended Knowledge Script Groups.

Before propagating script changes, verify that the script parameters are set to your specifications. Customized script parameters may have reverted to default parameters during the installation of the module. New parameters may need your attention.

You can propagate only properties (specified in the Schedule, Values, Actions, and Advanced tabs), only the script (which is the logic of the Knowledge Script), or both. Unless you know specifically that changes affect only the script logic, you should propagate both properties and the script.

For more information about propagating Knowledge Script changes, see the “Running Monitoring Jobs” chapter of the AppManager Operator Console User Guide.

Chapter 2 • Installing AppManager for Symantec NetBackup 5

Propagating Changes to Running JobsYou can propagate the properties and the logic of a Knowledge Script to running jobs started by that Knowledge Script. Corresponding jobs are stopped and restarted with the Knowledge Script changes.

To propagate changes to running Knowledge Script jobs:

1 In the Knowledge Script pane, select the Knowledge Script for which you want to propagate changes.

2 On the KS menu, select Properties propagation, and then select Ad Hoc Jobs.

3 Select the components of the Knowledge Script that you want to propagate to associated running jobs:

4 Click OK.

Propagating Changes to Knowledge Script GroupsYou can propagate the properties and logic of a Knowledge Script to corresponding Knowledge Script Group members.

After you propagate script changes to Knowledge Script Group members, you can propagate the updated Knowledge Script Group members to associated running jobs. For more information, see “Propagating Changes to Running Jobs” on page 6.

To propagate Knowledge Script changes to Knowledge Script Groups:

1 In the Knowledge Script pane, select the Knowledge Script for which you want to propagate changes.

2 On the KS menu, select Properties propagation, and then select Knowledge Script Group Members.

3 Select the components of the Knowledge Script that you want to propagate to associated Knowledge Script Groups:

4 Click OK.

Select To propagate

Script The logic of the Knowledge Script.

Properties The Knowledge Script properties, including schedule, monitoring values, actions, and advanced options.

Select To propagate

Script The logic of the Knowledge Script.

Properties The Knowledge Script properties, including schedule, monitoring values, actions, and advanced options.

6 User Guide

Chapter 3NetBackup Knowledge Scripts

The NetBackup category provides the following Knowledge Scripts for monitoring the operations of Symantec NetBackup on Windows computers.

From the Knowledge Script view of the Control Center, you can access more information about any Knowledge Script by selecting it and pressing F1. Or in the Operator Console, click any Knowledge Script in the Knowledge Script pane and 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 (db) directory.

DeviceStatus Detects when a NetBackup device is down, and optionally resets it.

ErrorLog Scans the NetBackup error log file for Error, Warning, and Critical entries during the monitoring interval.

EventLog Monitors the Windows Application log for entries created by NetBackup.

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

IncompleteJobs Monitors the number of backup jobs that partially completed during the monitoring 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 services.

ServiceDown Monitors discovered NetBackup services to see if any service is down.

StorageUnitsChanged Monitors whether modifications have been made to storage units configured on the NetBackup server during the monitoring interval.

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

Discovery_NetBackup Discovers NetBackup resources and configuration information.

Chapter 3 • NetBackup Knowledge Scripts 7

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

Resource ObjectNetBackup server

Default ScheduleThe default interval for this script is every 24 hours.

Setting Parameter ValuesSet the following parameters as needed:

Description How to Set It

Monitoring Parameters

Raise event if threshold exceeded?

Select Yes to raise an event if number of clients exceeds the threshold you set. The default is Yes.

Collect data? Select Yes to collect data for charts and reports. If enabled, data collection returns the number of clients managed by the NetBackup server. The default is unselected.

Threshold -- Maximum number of clients

Specify the maximum number of clients that can be managed by the server before an event is raise.d The default is 10 clients.

Event severity when threshold is exceeded

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of clients exceeds the threshold you set. The default is 15.

Success and Failure Events

Raise event on script success? Select Yes to raise an event if the Knowledge Script job succeeds. The default is unselected.

Severity of success event Set the event severity level, from 1 to 40, to indicate the importance of an event in which the Knowledge Script job succeeds. The default is 35.

Severity of event raised when script fails

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the Knowledge Script job fails. The default is 10.

8 User Guide

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







Select Yes to raise an event if the size of the DB directory exceeds the threshold you set. The default is Yes.

Collect data? Select Yes to collect data for charts and reports. When enabled, data collection returns the size (in MB) of the NetBackup db directory. The default is unselected.

Threshold -- Maximum size of DB directory

Specify the maximum size the the NetBackup DB directory can attain before an event is raised. The default is 20 MB.


Set the event severity level, from 1 to 40, to indicate the importance of an event in which the size of the NetBackup DB directory exceeds the threshold you set. The default is 15.







DeviceStatusUse this Knowledge Script to detect when a NetBackup tape device is DOWN, and optionally set it to an UP state. This script raises an event when the reset feature succeeds in resetting a device from the DOWN state to the UP state, and when the reset feature fails.

Resource ObjectNetBackup device





Raise event if device is down? Select Yes to raise an event if the device is down. The default is Yes.

Collect data? Select Yes to collect data for charts and reports. When enabled, data collection returns 0 if the device is down, or 100 if the device is up. The default is unselected.

Reset device? Select Yes to automatically reset a device that is detected as down. The default is unselected.

Event severity when reset fails Set the event severity level, from 1 to 40, to indicate the importance of an event in which AppManager fails to reset a device. The default is 10.

Event severity when reset succeeds

Set the event severity level, from 1 to 40, to indicate the importance of an event in which AppManager succeeds in resetting a device. The default is 25.

Event severity when device is down and reset is not enabled

Set the event severity level, from 1 to 40, to indicate the importance of the event when the device is down and the Reset device? parameter is disabled. The default severity level is 20.






10 User Guide

ErrorLogUse this Knowledge Script to generate a log of problems on the NetBackup server, and then scan that log for Error, Warning, and Critical entries. The first iteration of the script collects all entries for the last 24 hours. Subsequent iterations of the script collect entries made since the previous iteration. This script raises an event if the number of entries exceeds the threshold you set.


Default ScheduleThe default interval for this script is every hour.


NoteWhen running this script on a media server, AppManager filters log entries and only collects entries originating from that media server. No filtering is applied when running this script on a master server, so AppManager returns log entries originating from both the master server and/or any associated media servers.




Select Yes to raise an event if the number of error entries exceeds the threshold you set. The default is Yes.

Collect data? Select Yes to collect data for charts and reports. When enabled, data collection returns the total number of entries in the error log during the monitoring interval. The default is unselected.

Threshold--Maximum number of error entries

Specify the maximum number of entries that can be found during the monitoring interval before an event is raised. The default is 0.


Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of error entries exceeds the threshold you set. The default is 15.







EventLogUse this Knowledge Script to monitor event log entries created by NetBackup. These entries are under the Windows Application Log. You can define other categories for filtering Application Log entries, such as event ID and event description.







Select Yes to raise an event if the number of log entries exceeds the threshold you set. The default is Yes.

Collect data? Select Yes to collect data for charts and reports. When enabled, data collection returns the number of log entries that match the search criteria. The default is unselected.

Start collecting events from past N hours

Use this parameter to determine which events are searched the first time you run the Knowledge Script job. Subsequent searches begin where the previous one finished. The following entries are valid:

• -1 to search all existing log entries during the first interval• N to search entries for the past N hours (8 for the past 8 hours, 50 for the

past 50 hours, etc.)• 0 to search no previous entries (search from the current time forward)

The default is 0.

Threshold -- Maximum number of log entries

Specify the maximum number of new log entries that can be found during the monitoring interval before an event is raised. The default is 10.


Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of log entries exceeds the threshold you set. The default is 15.

Log Entry Selection

Count ERROR entries Select Yes to monitor this type of event. The default is Yes..

Count WARNING entries Select Yes to monitor this type of event. The default is Yes..

Count INFO entries Select the Yes to monitor this type of event. The default is Yes..

Text filter for the Event ID field Provide an appropriate search string to find matching entries in the Event field of the Event Log. Separate multiple IDs with commas.The search string can contain criteria used to include entries, exclude entries, or both. Separate the include and exclude criteria with a colon (:). If you are specifying only include criteria, the colon is not necessary.

12 User Guide

Text filter for the Event Description field

Provide an appropriate search string to find matching entries in the Description field of the Event Log. Separate multiple strings with commas. The search string can contain criteria used to include entries, exclude entries, or both. Separate the include and exclude criteria with a colon (:). If you are specifying only include criteria, the colon is not necessary.








FailedJobsUse this Knowledge Script to monitor the number of failed backup jobs. This script raises an event if the number of failed jobs during the interval exceeds the threshold you set. A failed job is one that returns an Exit status code of >1 in the NetBackup log.

During the first iteration, this Knowledge Script checks for failed backup jobs during the preceding 24 hours. During subsequent iterations, this script checks for failed backup jobs during the scheduled interval. For example, if this script is set to run every 8 Hour(s), then it checks for failed jobs during the previous eight hours.




NoteWhen running this script on a media server, AppManager filters log entries and only collects entries originating from that media server. No filtering is applied when running this script on a master server, so AppManager returns log entries originating from both the master server and any associated media servers.




Select Yes to raise an event if the number of failed jobs exceeds the threshold ou set. The default is Yes.

Collect data? Select Yes to collect data for charts and reports. When enabled, data collection returns the number of failed jobs during the interval you specify. The default is unselected.

Threshold -- Maximum number of failed jobs

Specify the maximum number of failed jobs allowed during the monitoring interval before an event is raised. The default is 10.


Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of failed jobs exceeds the threshold you set. The default is 15.






14 User Guide

IncompleteJobsUse this Knowledge Script to monitor the number of incomplete backup jobs. If the number of incomplete jobs during the interval exceeds the threshold you set, an event is raised. An incomplete job is one that returns an Exit status code of =1 in the NetBackup log.

During the first iteration, this Knowledge Script checks for incomplete backup jobs during the preceding 24 hours. During subsequent iterations, this script checks for incomplete backup jobs during the scheduled interval. For example, if this script is set to run every 8 hours, it checks for incomplete jobs during the previous eight hours.








Select Yes to raise an event if the number of incomplete jobs exceeds the threshold you set. The default is Yes.

Collect data? Select Yes to collect data for charts and reports. When enabled, data collection returns the number of jobs submitted and the number of incomplete jobs during the interval you specify. The default is unselected.

Threshold -- Maximum number of incomplete jobs

Specify the maximum number of incomplete jobs allowed during the monitoring interval before an event is raised. The default is 10.


Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of incomplete jobs exceeds the threshold you set. The default is 15.







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







Select Yes to raise an event if the size of the log directory exceeds the threshold you set. The default is Yes.

Collect data? Select Yes to collect data for charts and reports. When enabled, data collection returns the size (in MB) of the NetBackup log directory. The default is unselected.

Threshold -- Maximum size of log directory

Specify the maximum size the NetBackup log directory can attain before an event is raised. The default is 20 MB.


Set the event severity level, from 1 to 40, to indicate the importance of an event in which the size of the log directory exceeds the threshold you set. The default is 15.






16 User Guide

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


Default ScheduleThe default interval for this script is every hour.





Select Yes to raise an event if the number of pending requests exceeds the threshold you set. The default is Yes.

Collect data? Select Yes to collect data for charts and reports. When enabled, data collection returns the number of pending device requests. The default is unselected.

Threshold -- Maximum number of pending device requests

Specify the maximum number of device requests that can be pending before an event is raised. The default is 10 requests.


Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of pending requests exceeds the threshold you set. The default is 15.







ResourceHighUse this Knowledge Script to monitor the CPU and memory utilization of NetBackup services. This script raises an event if CPU or memory utilization exceeds the thresholds you set.

Resource ObjectNetBackup service

Default ScheduleThe default interval for this script is every 10 minutes.





Select Yes to raise an event if CPU usage or memory utilization exceeds the threshold you set. The default is Yes.

Collect data? Select Yes to collect data for charts and reports. When enabled, data collection returns the percentage of CPU usage and the number of MB of memory usage for a service. The default is unselected.

Threshold -- Maximum percent CPU usage

Specify the maximum amount of CPU usage allowed before an event is raised. The default is 60%.

Threshold -- Maximum memory usage

Specify the maximum memory usage allowed before an event is raised. The default is 6 MB.

Event severity when CPU or memory threshold is exceeded

Set the event severity level, from 1 to 40, to indicate the importance of an event in which CPU usage or memory utilization exceeds the threshold you set. The default is 15.






18 User Guide

ServiceDownUse this Knowledge Script to monitor discovered NetBackup services to see if any service is down. This script raises an event if a service is not running. This script can automatically restart any service that is down.

Resource ObjectNetBackup service





Raise event if service is down? Select Yes to raise an event if a service is down. The default is Yes.

Collect data? Select Yes to collect data for charts and reports. When enabled, data collection returns:

• 100--monitored service is running • 0--monitored service is not running.

The default is unselected.

Restart service? Select Yes to automatically restart any service that is down. The default is Yes.

Event severity when... Set the event severity level, from 1 to 40, to indicate the importance of an event in which an attempt is made to restart a service that is down, and:

• ... restart fails. Specify a value that indicates the service is down and AppManager for Symantec NetBackup cannot restart it. The default is 10.

• ... restart succeeds. Specify a value that indicates the service was down and AppManager for Symantec NetBackup successfully restarted it. The default is 25.

• ... service is down and restart is not enabled. Specify a value to indicate the service is down and the Restart service? parameter is disabled. The default is 20.




Severity of event raised when script fails Set the event severity level, from 1 to 40, to indicate the importance of an event in which the Knowledge Script job fails. The default is 10.


StorageUnitsChangedUse this Knowledge Script to monitor whether modifications have been made to storage units configured on the NetBackup server during the monitoring interval. This script raises an event if a storage unit is deleted or a new one is added.

Resource ObjectNetBackup storage unit folder





Raise event if storage units are changed?

Select Yes to raise an event if a storage unit has been modified. The default is Yes.

Collect data? Select Yes to collect data for charts and reports. When enabled, data collection returns the number of added and deleted storage units. The default is unselected.

Event severity when a storage unit is changed

Set the event severity level, from 1 to 40, to indicate the importance of an event in which a storage unit has been modified. The default is 15.






20 User Guide

SuccessfulJobsUse this Knowledge Script to monitor the number of successfully completed backup jobs. This script raises an event if the number of successfully completed jobs during the interval falls below the threshold you set. A successful job is one that returns an Exit status code =0 in the NetBackup log.

During the first iteration, this Knowledge Script checks for successful backup jobs during the previous 24 hours. During subsequent iterations, this script checks for successful backup jobs during the scheduled interval. For example, if this script is set to run every 8 Hour(s), then it checks for successful jobs during the previous eight hours.

The following is an example of how you can use this Knowledge Script. Assume you run three backup jobs every morning at 2:00 AM, and you expect all of the jobs to be complete by 7:00 AM. You can run this script once a day at 8:00 AM. with the Threshold -- Minimum number of successfully completed jobs parameter set to 3. If any of the scheduled backup jobs fails to complete by 8:00 AM, an event is raised, alerting you to possible problems.







Raise event if threshold not met? Select Yes to raise an event if the number of successfully completed jobs falls below the threshold you set. The default is Yes.

Collect data? Select Yes to collect data for charts and reports. When enabled, data collection returns the number of successfully completed backup jobs during the interval you specify. The default is unselected.

Threshold -- Minimum number of successfully completed jobs

Specify the minimum number of backup jobs that must be successfully completed to prevent an event from being raised. The default is 10 jobs.

Event severity when threshold is not met

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of successfully completed jobs falls below the threshold you set. The default is 15.








22 User Guide

Discovery_NetBackupUse this Knowledge Script to discover Symantec NetBackup resources and configuration information.

Resource ObjectNetBackup servers

Default ScheduleBy default, this script is only run once for each computer.


Description How to set it

Event for successful discovery? This Knowledge Script always raises an event when the job fails for any reason. In addition, you can set this parameter to y to raise an event when the job succeeds. The default is n.

Event severity when discovery... Set the event severity level, from 1 to 40, to reflect the importance when the job:

• ...succeeds. If you set this Knowledge Script to raise an event when the job succeeds, set the event severity level for a successful discovery. The default is 25 (blue event indicator).

• ...fails. The default is 5 (red event indicator).


24 User Guide

appmanager for netbackup -...

Documents