Tivoli/Plus for NetWorker User’s Guide2002. 11. 9. · TheTivoli/Plus for NetWorker User's Guide describes speciﬁc features and procedures for using the Tivoli/PlusTM for NetWorker

Making Client/Server WorkTM

Tivoli/Plus for NetWorkerUser’s Guide

Limited AvailabilityFebruary 9, 1996

Tivoli/Plus for NetWorker User’s Guide (February 1996)Copyright NoticeCopyright © 1991–1996 by Tivoli Systems Inc., including this documentation and all software. All rightsreserved. May only be used pursuant to a Tivoli Systems Incorporated Software License Agreement. Nopart of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, ortranslated into any computer language, in any form or by any means, electronic, mechanical, magnetic,optical, chemical, manual, or otherwise, without prior written permission of Tivoli Systems Inc. Thisdocument was prepared by Tivoli Systems Inc., and was printed in the United States of America.

All software has been developed at private expense and is commercially available at published prices.Federal Acquisition Regulation (FAR) or Defense Federal Acquisition Regulation Supplement (DFARS)RESTRICTED RIGHTS APPLY TO U.S. GOVERNMENT USE, as applicable:

Restricted Rights Notice

SOFTWARE supplied to any unit or agency of the United States Government otherthan the DOD shall be governed by clause 52.227-19(o) of the FAR (or any successorregulations) or, in the case of NASA, in clause 45 CFR 1827.405(a) (or any successorregulations) and, in any such case, the United States Government acquires only“restricted rights” in such SOFTWARE.

Restricted Rights Legend

SOFTWARE supplied to the Department of Defense (“DOD”) is classified as “Com-mercial Software”, and the United States Government acquires only “restricted rights”in SOFTWARE, as such rights are defined in clause 252.227.7013(c)(1)(ii) of theDFARS (or any successor regulations).

Tivoli Systems Inc., 9442 Capital of Texas Hwy North, Arboretum Plaza One, Suite 500, Austin, TX78759

Associated Copyrights

Portions copyright © 1989 by the Eric C. Cooper, Carnegie Mellon University. All rights reserved.Portions copyright © 1990, 1991 by the University of Utah and the Center for Software Science (CSS).All rights reserved.Portions copyright © 1989 by Digital Equipment Corporation. All rights reserved.Portions copyright © 1989, 1990, 1991 by Massachusetts Institute of Technology. All rights reserved.Portions copyright © 1986 by University of Toronto. All rights reserved.Portions copyright © 1989, 1990, 1991 by Larry Wall. All rights reserved.Portions copyright © 1990 by Alfalfa Software Incorporated.All rights reserved.Portions copyright © 1992 by Free Software Foundation, Inc. All rights reserved.Portions copyright © 1982, 1986, 1991 by Regents of the University of California. All rights reserved.Portions copyright © 1988, 1989, 1991 by Jef Poskanzer. All rights reserved.Portions copyright © 1991, 1992 by RSA Data Security, Inc. All rights reserved.Portions copyright © 1982, 1988, 1989 by Walter Tichy. All rights reserved.Portions copyright © 1990, 1991 by Paul Eggert. All rights reserved.Portions copyright © 1990, 1992 by Hewlett-Packard Company. All rights reserved.Portions copyright © 1989, 1993 by Jim Frost. All rights reserved.Portions copyright © 1990 by GROUPE BULL. All rights reserved.

–4 Version 3.0

Trademarks

Tivoli Management Environment, Tivoli Management Platform, Tivoli Management Framework, TivoliApplication Service, Tivoli/ADE, Tivoli/Admin, Tivoli/AEF, Tivoli/Courier, Tivoli/EIF, Tivoli/EnterpriseConsole, Tivoli/FSM, Tivoli/Plus, Tivoli/Print, Tivoli/Sentry, Tivoli/Workload, and TME are trademarksof Tivoli Systems Inc.

Product and company names mentioned in this document are trademarks or registered trademarks of theirrespective manufacturers.

Patent pending.

Tivoli/Plus for NetWorker User’s Guide i

Tivoli/Plus for NetWorkerUser’s Guide

Preface ........................................................................................................................... iii

Who Should Read This Guide .............................................................................. iii

Prerequisite and Related Documents .................................................................... iv

What This Guide Contains.................................................................................... iv

Typeface Conventions ........................................................................................... v

Platform-Specific Information ............................................................................... v

Contacting Customer Support............................................................................... vi

Chapter 1—Getting Started with Tivoli/Plus for NetWorker

Installation Requirements ............................................................................................ 1-2

License Key ........................................................................................................ 1-2

Software Requirements....................................................................................... 1-2

Hardware Requirements...................................................................................... 1-3

Installing from the Desktop ......................................................................................... 1-4

Installing from the Command Line ........................................................................... 1-11

Tivoli/Plus Icons........................................................................................................ 1-11

Tivoli/Plus Unique Features ...................................................................................... 1-12

Starting a Tivoli/Plus Module.................................................................................... 1-13

Launching the NetWorker Application ..................................................................... 1-16

Chapter 2—Software Distribution for NetWorker

Configuring Tivoli/Courier File Packages .................................................................. 2-2

File Packages for UNIX Platforms ..................................................................... 2-3

File Packages for a Windows or NetWare Platform........................................... 2-6

Distributing the NetWorker Application ..................................................................... 2-8

Distributing NetWorker to All Platforms ........................................................... 2-9

Distributing NetWorker on a Single Platform .................................................. 2-10

ii Version 1.0

Chapter 3—Resource Monitoring

Using Tivoli/Plus for NetWorker Monitors................................................................. 3-1

Viewing the Status of Monitored Resources ............................................................... 3-4

Monitored Resources................................................................................................... 3-5

Host Status .......................................................................................................... 3-6

nsrexecd Daemon Status ..................................................................................... 3-7

nsrd Daemon Status (Business Hours)................................................................ 3-8

nsrd Daemon Status (Non-Business Hours) ....................................................... 3-9

Available Swap Space....................................................................................... 3-10

Network Collisions Per Output Packet ............................................................. 3-11

/nsr/index Percent Space Used.......................................................................... 3-12

Chapter 4—Enterprise Event Management

Setting Up the Tivoli/Enterprise Console.................................................................... 4-2

Events and Rules ......................................................................................................... 4-4

Event Correlation ................................................................................................ 4-5

NetWorker Event Class Hierarchy...................................................................... 4-5

NetWorker Events............................................................................................... 4-7

Sentry Events .................................................................................................... 4-15

Chapter 5—Tasks and Jobs for NetWorker

Tivoli/Plus for NetWorker Jobs................................................................................... 5-2

Running a NetWorker Job and Saving the Output ...................................................... 5-5

Modifying a NetWorker Job........................................................................................ 5-8

Preface

Tivoli/Plus for NetWorker User’s Guide iii

PrefaceTheTivoli/Plus for NetWorker User's Guide describes specific featuresand procedures for using the Tivoli/PlusTM for NetWorker module.This module was jointly developed by Tivoli Systems Inc. and LegatoSystems Inc. and provides an integration of the Legato NetWorkerbackup and recover software with the Tivoli ManagementEnvironmentTM (TME). Through this integration, the Tivoli/Plus forNetWorker module delivers the distributed system managementcapabilities of TME for specific use with NetWorker. UsingTivoli/Plus for NetWorker, the NetWorker application can be managedacross a multi-platform network that includes PCs and UNIX systems.

Tivoli/Plus provides different modules for integrating differentproduction control applications with the Tivoli ManagementEnvironment. Since all Tivoli/Plus modules have a common interface,a system administrator can implement the system managementcapabilities of the TME with various production control applicationswhile enjoying the simplicity of a common interface. The addition ofTivoli/CourierTM, Tivoli/SentryTM, and the Tivoli/EnterpriseConsoleTM provides additional management capabilities in the areas ofclient installation, resource monitoring, and event correlation.

Who Should Read This GuideThis guide is for system administrators who use the Tivoli/Plus forNetWorker module to manage the operation of the NetWorker backupand recover software. Readers of this guide should be familiar with theTivoli Management Environment and should have knowledge ofconcepts such as directories, files, symbolic links; and the operatingsystems running on the machines on which they will be using theTivoli/Plus module and TME.

Note: All references to “Sentry” in this guide refer tothe Tivoli/Sentry product or its components.

Preface

iv Version 1.0

Prerequisite and Related DocumentsThe information in theTivoli/Plus for NetWorker User’s Guidecomplements information presented in theTivoli ManagementPlatform User’s Guideand the Tivoli/Plus User’s Guide. You must befamiliar with the Tivoli Management Platform and Tivoli/Plus beforeyou can effectively use a specific Tivoli/Plus module. You should befamiliar with these guides before attempting to use the information intheTivoli/Plus for NetWorker User’s Guide.

What This Guide ContainsTheTivoli/Plus for NetWorker User's Guide contains the followingchapters:

■ Chapter 1, "Getting Started with Tivoli/Plus for NetWorker"Contains the installation requirements and procedures forinstalling Tivoli/Plus for NetWorker. This chapter also containsinformation about Tivoli/Plus icons, features unique toTivoli/Plus, and launching the NetWorker application.

■ Chapter 2, "Software Distribution for NetWorker"Describes how to set up Tivoli/Courier to be used withTivoli/Plus for NetWorker for distributing the NetWorkerapplication across a network.

■ Chapter 3, "Resource Monitoring"Describes how Tivoli/Sentry may be used with Tivoli/Plus forNetWorker to monitor NetWorker resources in order to detect andprevent system problems.

■ Chapter 4, "Enterprise Event Management"Describes how to set up the Tivoli/Enterprise Console to be usedwith Tivoli/Plus for NetWorker to provide event management.This chapter also contains a description of the events and rulesspecific to Tivoli/Plus for NetWorker.

■ Chapter 5, "Tasks and Jobs for NetWorker"Describes how to customize and run NetWorker jobs and reportswith Tivoli/Plus for NetWorker.

Preface

Tivoli/Plus for NetWorker User’s Guide v

Typeface ConventionsThe guide uses several typeface conventions for special terms andactions. These conventions have the following meaning:

Bold Commands, keywords, file names, or otherinformation that you must use literally appear inbold.Names of windows, dialogs, and other controls alsoappear inbold.

Italics Variables and values that you must provide appear initalics.

Bold Italics New terms appear in bold italics the first time they areused.

Monospace Code examples appear in amonospace font.

This guide may include icons in the left margin. These icons providecontext for the discussion in the text or for performing a step within aprocedure. For example, if you start a procedure by double-clicking ona task icon, that icon appears in the left margin next to the first step. Ifthe fourth step of the procedure instructs you to open another icon, thaticon appears in the left margin next to the fourth step.

Platform-Specific InformationThe following markers are used to identify platform-specificinformation or procedures:

Icon Supported Platform

IBM RS/6000 series running AIX 3.2.5

IBM RS/6000 series running AIX 4.1

AT&T 3000 series running AT&T UNIX SVR4 MP-RASRelease 2.02 and 2.03

Data General AViiON series running DG/UX version5.4R3.00

IBM-compatible PCs 486 or higher running MS-DOS orPC-DOS 3.1 through 6.22

AIX 3.2.5

AIX 4.1

AT&T

DG/UX

DOS

Preface

vi Version 1.0

Contacting Customer SupportWe are very interested in hearing from you about your experience withthe products in the Tivoli Management Environment. We welcomeyour suggestions for improvements.

HP9000/700 and 800 series running HP-UX 9.00,HP/UX 9.01, HP/UX 9.03, and HP-UX 9.05

HP9000/700 and 800 series running HP-UX 10.0

Motorola 88K series running SVR4 version R40V4.2

IBM-compatible PCs 486 or higher running NovellNetWare 3.11, 3.12, or 4.0

IBM-compatible PCs 486 or higher running NEXTSTEPrelease 3.2

IBM-compatible PCs 486 or higher running MicrosoftWindows NT version 3.1, 3.5, or 3.5.1

IBM-compatible PCs 486 or higher running IBM OS/2version 2.0, 2.1, or Warp

DEC Alpha Generation system running DEC OSF/1 3.0or 3.2

Sun SPARC series running Solaris 2.3 or 2.4

Sun SPARC series running SunOS 4.1.2 or 4.1.3

All SVR4-based platforms, to include: AT&T UNIXSVR4, DG/UX version 5.4R3.00, Motorola, Solaris, andUnixWare 2.0

IBM-compatible PC 486 or higher running NovellUnixWare 2.0

IBM-compatible PC 486 or higher running MicrosoftWindows 3.1, 3.11, or 3.11 for WorkGroups

Icon Supported Platform

HP 9.x

HP 10.0

Motorola

NetWare

NEXT

NT

OS/2

OSF/1

Solaris

SunOS

SVR4

UnixWare

Windows

Preface

Tivoli/Plus for NetWorker User’s Guide vii

If you encounter difficulties with any TME product, please contactyour customer support representative. To assist you, this sectionincludes the TME Problem Report form. You can use this form to faxproblem information to your support provider. Tivoli also includes thewsupport command. This command prompts you for probleminformation, which can be e-mailed to your support provider or savedto a text file. You can then print the saved file, and fax the resultingTME Problem Report form to your support provider.

Preface

viii Version 1.0

TME Problem Report

Name:

E-mail:

Company:

System Type:Operating System Rel:

Tivoli Product:

Problem On:

Priority:

3. Minor

Short Description (10 - 12 words):

Attempted Solutions:

Description / Error Messages:

Phone #:

Fax #:

TMR #:

Version:

Tivoli Server Tivoli Client

2. Major1. Critical

4. No Impact

Previous Call Tracking #:

Tivoli/Plus for NetWorker User’s Guide 1–1

Getting S

tarted with

Tivoli/Plus for N

etWorker

Getting Started with Tivoli/Plusfor NetWorker

The Tivoli/Plus for NetWorker module provides an integration of theTivoli Management Environment with the NetWorker backup andrecover software. This integration allows centralized distribution andmanagement of the NetWorker application across a multi-platformnetwork. This module provides the following features for managingthe NetWorker application:

■ Icons for launching the NetWorker application

■ Subscription lists for clients and servers

■ Tivoli/Courier file packages

■ Tivoli/Sentry monitors

■ NetWorker tasks and jobs

Note: The Tivoli/Courier and Tivoli/Sentry applications must beinstalled and configured before their correspondingTivoli/Plus feature is operational.

1

Installation Requirements

1–2 Version 1.0

Installation RequirementsBefore attempting to install Tivoli/Plus for NetWorker into the TivoliManagement Environment, make certain you review the requirementsin this section.

The following table provides the context and authorization rolerequired to install Tivoli/Plus for NetWorker.

In order for the Tivoli/Plus for NetWorker module to functioncorrectly, it must be installed on the following machines:

■ Tivoli server.

■ Tivoli/Enterprise Console server (if there is one).

■ NetWorker server. This machine needs to be a Tivoli managednode.

License KeyYou must obtain a license key to use the Tivoli/Plus for NetWorkermodule. You must complete and return the license request form thatcame with this software. Tivoli Customer Support will then provideyou with a license key for your module.

Software RequirementsYou must have a TME 2.0.2 installation up and running. Additionally,the NetWorker backup and recover software should be installed beforethe Tivoli/Plus for NetWorker module is installed.

Tivoli/Plus for NetWorker has features that use Tivoli/Courier,Tivoli/Sentry, and the Tivoli/Enterprise Console. If these applicationsare not installed, then the specific feature requiring these applicationswill not work. However, Tivoli/Plus for NetWorker installation allowsyou to incrementally re-install those features if you buy the missingproducts at a later date.

Activity Context Required Role

Installing Tivoli/Plus forNetWorker

TME install_product

Installation Requirements


Getting S

tarted with

Tivoli/Plus for N

etWorker

Hardware RequirementsThe following table provides the client and server disk spacerequirements for Tivoli/Plus for NetWorker. This space is in additionto the space requirements for the management platform, the Tivoliapplication, and the NetWorker backup and recover software.

Tivoli/Plus for NetWorker is installed on the TME server, theTivoli/Enterprise Console server (if you have the Tivoli/EnterpriseConsole), and the NetWorker server machines. The spacerequirements are the same for all of these machines. The Tivoli/Plusfor NetWorker module uses platform-independent shell and Perlscripts, which is why the module's requirements do not differ fromplatform to platform.

Platform Libraries Binaries Database Man PagesMessageCatalogs

0 MB 500 KB † 0 0 MB 50 KB

0 MB 500 KB † 0 0 MB 50 KB

0 MB 500 KB † 0 0 MB 50 KB

0 MB 500 KB † 0 0 MB 50 KB

AIX

HP-UX

SVR4

SunOS

Installing from the Desktop

1–4 Version 1.0

Installing from the DesktopUse the following steps to install Tivoli/Plus for NetWorker from theTivoli desktop:

1. Select theInstall -> Install Product... option from theDesktopmenu

to display theInstall Product dialog.



Getting S

tarted with

Tivoli/Plus for N

etWorker

If the Tivoli/Plus for NetWorker module is listed in theSelectProduct to Install scrolling list, skip to step 3. If it is not listed,proceed to step 2.


1–6 Version 1.0

2. Press theSelect Media... button to display theFile Browserdialog.

TheFile Browser dialog enables you to identify or specify thepath to the installation media.

If you already know the path to the CD-ROM image

a. Enter the full path in thePath Name field.

b. Press theSet Path button to change to the specified directory.

c. Press theSet Media & Close button to save the new mediapath and return to theInstall Product dialog. The dialog nowcontains a list of products that are available for installation.



Getting S

tarted with

Tivoli/Plus for N

etWorker

If you do not know the exact path to the CD-ROM image

a. From theHosts scrolling list, choose the host on which theinstall media is mounted. Choosing a host updates theDirectories scrolling list to show the directories of the hostyou chose.

b. From theDirectories scrolling list, choose the directorycontaining the install media.

c. Press theSet Media & Close button to save the new mediapath and return to theInstall Product dialog. The dialog nowcontains a list of products that are available for installation.

3. Select the Tivoli/Plus for NetWorker module from theSelectProduct to Install list.


1–8 Version 1.0

4. To specify the clients on which the module will be installed, usethe arrow keys to move machine names between theClients toInstall On scrolling list and theAvailable Clients scrolling list.

By default, all machines in the current Tivoli Managed Region(TMR) are listed in theClients to Install On scrolling list. Tomove a machine name to theAvailable Clients list, choose oneor more clients from theClients to Install On scrolling list andpress the arrow button. The chosen clients are moved fromtheClients to Install On scrolling list to theAvailable Clientsscrolling list.

5. Enter your license key for the Tivoli/Plus for NetWorker modulein theLicense Key field.

6. Press theInstall & Close button to install the module and closethe Install Product dialog.

- OR -

Press theInstall button to install the module and keep theInstallProduct dialog open. You can then install Tivoli/Plus forNetWorker on another set of clients or you can install anotherproduct.



Getting S

tarted with

Tivoli/Plus for N

etWorker

The installation process prompts you with aProduct Installdialog similar to the following:

This dialog provides the list of operations that take place wheninstalling the software. This dialog also warns you of anyproblems that you may want to correct before you install theTivoli/Plus for NetWorker module.

7. Press theContinue Install button to begin the installationprocess.

-OR-

Press theCancel button to abort the installation process.


1–10 Version 1.0

When the installation is complete, theProduct Install dialogdisplays a completion message similar to the following.

8. Press theClose button when theProduct Install status dialogindicates that the installation is complete.

Completionmessage

Installing from the Command Line


Getting S

tarted with

Tivoli/Plus for N

etWorker

Installing from the Command LineUse thewinstall command to install the Tivoli/Plus for NetWorkermodule. The following is example syntax for thewinstall commandand its parameters:

winstall -c cdrom_path -s installation_server \-i index_file -l license_key

where:

-c cdrom_pathSpecifies the path to the CD-ROM image.

-s installation serverSpecifies the server on which the product is to beinstalled.

-i index_file Specifies the index file from which the product is to beinstalled.

-l license_key Specifies the license key for the product. Thisparameter is optional for installations following thefirst one.

See thewinstall command in the Tivoli Management PlatformReference Manual for more information.

Tivoli/Plus IconsAlthough the Tivoli/Plus icons look like (traditional) TME icons, theirfunctionality has been altered slightly to provide a faster, moreintuitive approach to navigating and deploying the module’s features.In some cases, like a Tivoli/Courier file package profile, menu itemshave been removed from the icon’s pop-up menu to create a more“point and click” environment.

The Tivoli/Plus icons can be activated in either of two ways:

■ Opening or executing the icon by double-clicking on it with theleft mouse button. In many cases, double-clicking executes anactivity (such as a task) without opening another dialog layer.

■ Displaying the icon’s pull-down menu by pressing and holdingthe right mouse button

Tivoli/Plus Unique Features

1–12 Version 1.0

Generally, either method may be used to access a particular function.There are cases, however, where a particular function can only beaccessed by one of these methods.

The following icon represents the Tivoli/Plus for NetWorker resources:

To prevent confusion between traditional TME and Tivoli/Plus forNetWorker functionality, each Tivoli/Plus icon has been overlaid withthe Tivoli/Plus symbol to highlight its special functionality.

Tivoli/Plus Unique FeaturesTivoli/Plus modules use the termprofile manager in a somewhatdifferent way than do the other Tivoli products. In a Tivoli/Plusmodule, a profile manager's primary function is as asubscription list.A subscription list identifies the machines that tasks and jobs run onwhen executed. Subscription lists can contain machine names or otherprofile managers. Adding a profile manager to a subscription list issimply a way of subscribing several machines at a time rather thanadding each one individually.

TheTivoli/Plus User's Guide describes the function of profilemanagers in the Tivoli/Plus modules in more detail. For moreinformation, see the section on subscribers and targets in theTivoli/Plus User's Guide.

Starting a Tivoli/Plus Module


Getting S

tarted with

Tivoli/Plus for N

etWorker

Starting a Tivoli/Plus ModuleAll Tivoli/Plus modules are kept in a collection under theTivoliPlusicon on the TME desktop. The module’s icon is added to this collectionafter installation. The following icon represents the Tivoli/Pluscollection:

Use the following steps to see the modules included in your Tivoli/Pluscollection:

1. From the main TME desktop, double-click on theTivoliPlusicon

-OR-

Select theOpen option from theTivoliPlus icon’s pop-up menu

to display theTivoliPlus window.


1–14 Version 1.0

TheTivoliPlus window displays an icon for each Tivoli/Plusmodule installed. In the case above, three modules have beeninstalled.

Note: In some cases, icons in theTivoliPlus window may beplaceholders for future modules. In the interim, they areused for informational purposes.

2. Double-click on theTivoliPlus for NetWorker icon to open themodule

-OR-

SelectOpen from theTivoliPlus for NetWorker icon's pop-upmenu



Getting S

tarted with

Tivoli/Plus for N

etWorker

to display the icons representing the tasks and other tools formanaging the NetWorker backup and recover software.

Launching the NetWorker Application

1–16 Version 1.0

Launching the NetWorker ApplicationWhen Tivoli/Plus for NetWorker is installed on a NetWorker server, theinstallation process identifies the location of the NetWorker binarydirectories and creates an icon for launching the NetWorker backupand recover software from within the TME.

Each NetWorker server has its own NetWorker icon for launching theNetWorker application from that server site. For example, for a servernamed “homer,” the following icon appears:

The NetWorker backup and recover software has five logical entrypoints. These entry points are for the administration, backup, archive,recover, and retrieve functions. Each logical entry point ispre-configured and appears on the pop-up menu for each NetWorkericon.



Getting S

tarted with

Tivoli/Plus for N

etWorker

Selecting theNetworker Admin option displays theNetWorkerAdministration window.


1–18 Version 1.0

Likewise, selecting theNetworker Backup, Networker Archive,Networker Recover, or Networker Retrieve options takes youdirectly to theNetWorker Backup, NetWorker Archive , NetWorkerRecover, or NetWorker Retrieve window, respectively.


Softw

are Distribution for

NetW

orker

Software Distribution forNetWorker

Tivoli/Plus for NetWorker includes hierarchical, pre-writtenTivoli/Courier file packages for distributing the NetWorker client andserver applications and the NetWorker Database Module for Oracle.Much of the configuration activity normally associated with aTivoli/Courier file package has been done for you. Using Tivoli/Plusfor NetWorker and Tivoli/Courier, you can distribute these NetWorkerapplications across a network.

Distributing NetWorker applications is a two-stage process. First, youset up the NetWorker distribution by configuring a Tivoli/Courier filepackage for each type of platform to which you are distributingNetWorker. For example, if you are distributing NetWorker clientsoftware to both a Solaris and a Sun platform, you need to configure aTivoli/Courier file package twice, once for each platform.

Second, you distribute the configured file packages by running theDistribute NetWorker Software task. This task distributesNetWorker to the selected subscribers for each platform for which youhave configured a Tivoli/Courier file package. You can distributeNetWorker to all configured platforms or choose to distribute to onlya single platform.

Note: Although Tivoli/Plus for NetWorker distributes theNetWorker installation binaries, it does not perform the actualinstallation, since unattended installation is not possible.

2

Configuring Tivoli/Courier File Packages

2–2 Version 1.0

Configuring Tivoli/Courier File PackagesWhen configuring a Tivoli/Courier file package to be used withTivoli/Plus for NetWorker, you need to establish the location of theNetWorker installation directories so that Tivoli/Courier can locate theinstallation binaries when distributing the NetWorker applications.Tivoli/Plus for NetWorker has a different setup icon for eachNetWorker application.

Function Icon

Configures the NetWorker serverdistribution parameters for a UNIXplatform.

Configures the NetWorker clientdistribution parameters for a UNIXplatform.

Configures the NetWorkerDatabase Module for Oracledistribution parameters for a UNIXplatform.

Configures the NetWorkerNetware client distributionparameters for a NetWareplatform.

Configures the NetWorkerWindows client distributionparameters for a Windowsplatform.



Softw


NetW

orker

File Packages for UNIX PlatformsThe procedure for configuring Tivoli/Courier file packages isessentially the same for each of the UNIX platforms. You need tocomplete a setup window for each type of UNIX platform to whichyou are distributing NetWorker.

1. Double-click on theSetup NetWorker UNIX ServerDistribution icon,SetupNetWorker UNIX Client Distributionicon, orSetup NetWorker UNIX D.M.O. Distribution icon todisplay the setup window.

Note: The above example setup window is theSetupNetWorker UNIX Client Distribution window.However, the setup window for distributing eachNetWorker UNIX application contains the sameparameters.


2–4 Version 1.0

2. Select the type of operating system on which you will be runningNetWorker from theTivoli Interpreter Type to Configurepop-up menu.

If the operating system is not on the list, enter it in theOther field.

3. Identify the location of the NetWorker source binaries as follows:

a. In theManaged Node Name field, enter the name of theTME server or the managed node where the NetWorkersource binaries are located.

b. In theGet NetWorker Files From field, select whether thefiles will come directly from CDROM, a tape device, or aninstall directory.

c. In thePath to source file or Device field, enter the directorypath where the NetWorker binaries can be found.

d. Since you are distributing from an external device, the systemneeds a directory in which to unpack these files beforedistribution. Enter the path to the directory that you choosefor this purpose in the50 Mb Scratch Directory field.



Softw


NetW

orker

Note: After you have distributed NetWorker from a deviceor tar file, you can use the scratch directory as thesource of the NetWorker binaries for subsequentdistributions. To do this, selectInstall Directoryfrom theGet NetWorker Files from field and thenenter the path to the scratch directory in thePath tosource file or Device field. When you distributeNetWorker for the first time, the system createssubdirectories in the directory that you specified forthe NetWorker binaries. These subdirectories arenamed with the following format:

interpreter_type/networker

where interpreter type refers to the platform to whichNetWorker was distributed.

On subsequent distributions, be sure to specify thefull path name including the additional directories.For example, if the original path was

/usr/networker/networker4.4.7

and you distributed to a Solaris2 platform, you wouldspecify:

/usr/networker/networker4.4.7/solaris2/networker

4. In theDestination Pathfield, enter the path to the NetWorkerdirectory where the binaries and libraries for the NetWorkerapplication will be distributed.

5. Press theOk button to set all of the information you have entered.Output from the configuration activity is displayed in an outputwindow.


2–6 Version 1.0

File Packages for a Windows or NetWare PlatformThe procedure for configuring Tivoli/Courier file packages isessentially the same for a Windows or NetWare platform.

1. Double-click on theSetup NetWorker Windows ClientDistribution icon or theSetup NetWorker NetWare ClientDistribution icon to display the setup window.

Note: The above example setup window is theConfigureNetWorker Windows 3.x Clientwindow. However, thesetup window for distributing the NetWorker NetWareapplication contains the same parameters.

2. Identify the location of the NetWorker source binaries as follows:

a. In theManaged Node Name field, enter the name of theTME server or the managed node where the NetWorkersource binaries are located.



Softw


NetW

orker

b. In thePath to NetWorker staging directoryfield, enter thedirectory path where the NetWorker binaries can be found.

3. In theDestination on Clientfield, enter the path to the directorywhere the binaries and libraries for the NetWorker applicationwill be distributed on the client machine.

4. Press theOk button to set all of the information you have entered.Output from the configuration activity is displayed in an outputwindow.

Distributing the NetWorker Application

2–8 Version 1.0

Distributing the NetWorker ApplicationAfter you have configured a Tivoli/Courier file package for eachplatform to which you wish to distribute NetWorker, you are ready todistribute NetWorker to these platforms. You can distribute to allplatforms for which you have configured a file package or to a singleplatform. Tivoli/Plus for NetWorker performs pre-distribution checks(such as verifying available disk space and memory) but does notperform the actual installation. Output for each platform is sent to thesource machine in the following directory:

/tmp/networker_client_install.platform_name

whereplatform_name refers to the operating system to whichNetWorker was distributed.

You will use theDistribute NetWorker Software icon to distributethe file packages. If you wish to view the Tivoli/Courier file packagesthat you have created, select theOpen... option from theDistributeNetWorker Software icon's pop-up menu.

In this example, fiveTivoli/Courier filepackages have beencreated for distribut-ing the NetWorkersoftware.



Softw


NetW

orker

Distributing NetWorker to All PlatformsUse the following steps to distribute the NetWorker application to allconfigured platforms.

1. Select theSubscribers...option from theDistribute NetWorkerSoftware icon's pop-up menu to display theSubscriberswindow.

2. Specify the subscription lists to which you want to installNetWorker by using the arrow buttons to move the desired listsinto theCurrent Subscribers field. When finished, press theSetSubscriptions & Close button.

3. Select theDistribute option from theDistribute NetworkerSoftware icon's pop-up menu. Selecting this option installsNetWorker onto the client machines listed on the subscriptionlists that you chose.


2–10 Version 1.0

Distributing NetWorker on a Single PlatformIf you want to install NetWorker on only one type of platform, you candistribute only the Tivoli/Courier file package that applies to thatplatform.

Use the following steps to install NetWorker on a single platform.

1. Select theOpen... option from theDistribute NetWorkerSoftware icon's pop-up menu to display theDistributeNetWorker Software window.

2. In theDistribute NetWorker Software window, select theSubscribers... option from the pop-up menu of the iconrepresenting the file package for the platform to which you wishto distribute NetWorker.

3. Specify the subscription lists to which you want to distributeNetWorker on a single platform by using the arrow buttons tomove the desired lists into theCurrent Subscribers field. Whenfinished, press theSet Subscriptions & Close button.



Softw


NetW

orker4. Select theDistribute option from the icon's pop-up menu.Selecting this option distributes NetWorker to the machineslisted on the subscription lists that you chose.


2–12 Version 1.0


Resource M

onitoring

Resource Monitoring

Tivoli/Plus for NetWorker provides the ability to monitor criticalresources with Tivoli/Sentry. The Sentry monitors are predefined toenable you to manage different aspects of the operating system, suchas processes, swap space, directory size, or the NetWorker server, thatare crucial to the continued availability of the NetWorker application.These monitors allow you to quickly identify and respond to potentialproblems so that system down time is avoided.

Using Tivoli/Plus for NetWorker MonitorsTivoli/Plus for NetWorker comes with monitors for the central server,remote server, and clients.

Function Icon

These monitors check thecondition of the system where theNetWorker server resides.

These monitors check the status ofNetWorker daemons, availableswap space, file size, and so forthon remote NetWorker servers.

3

Using Tivoli/Plus for NetWorker Monitors

3–2 Version 1.0

Before the Tivoli/Plus for NetWorker monitors are operational, theymust be distributed to their subscription lists. To distribute a monitor,simply select theDistribute... option from the monitor's pop-up menuand then click on theDistribute Now button.

The monitors are ready to be distributed after installation. TheNet-Worker Central Server Monitors are distributed to the Tivoli server.TheNetWorker Remote Server Monitors are distributed to theNet-Worker Server List . TheNetWorker Client Monitors are distributedto theNetWorker Client List .

The default subscription list can be viewed or changed by using theSubscribers... option from the monitor's pop-up menu.

These monitors check the status ofNetWorker daemons, availableswap space, file size, and so forthon remote NetWorker clients.

Function Icon

Using Tivoli/Plus for NetWorker Monitors


Resource M

onitoring

Although the Tivoli/Plus for NetWorker monitors come alreadydefined to monitor resources specific to NetWorker, you can addmonitors from the Tivoli/Sentry collection or delete monitors as youwish. You can also edit existing monitors to perform different actionsunder different conditions.

Selecting the options on a NetWorker monitor's pop-up menu displaysthe usual Tivoli/Sentry windows. Refer to the Tivoli/Sentrydocumentation for more detailed information on using these windows.

Displays the Sentry Profile Propertieswindow, which includes functions foradding, deleting, and editing monitors.

Displays the Distribute Profiles window fordistributing monitors to those managednodes (machines) and profiles included onthe monitor’s subscription list.

Displays the Subscribers window forspecifying to which subscription list themonitor is distributed.

Viewing the Status of Monitored Resources

3–4 Version 1.0

Viewing the Status of Monitored ResourcesUse theNetWorker Sentry Indicators icon to view the status of themonitored resources.

The thermometer on theNetWorker Sentry Indicators icon rises asthe status of a monitored resource becomes more urgent. In theexample, theNetWorker Remote Server Monitors has received a“critical” status from one of its monitored resources.

Open theNetWorker Central Server Monitors, NetWorker RemoteServer Monitors, or theNetWorker Client Monitors icon to view thestatus of these monitored resources. For each monitored resource, themonitor only reports the most urgent status received within a recenttime frame. The monitor reports are organized so that the most urgentstatus level appears at the top of the report.

For more information on viewing the status of a monitored resourceand on the Tivoli/Sentry indicator collection, refer to the Tivoli/Sentrydocumentation.

Monitored Resources


Resource M

onitoring

Monitored ResourcesThe following table indicates the network resources that Tivoli/Plusfor NetWorker monitors.

Monitored ResourceDescribedon Page

Monitor Icon

Host status 3-6

nsrexecddaemon 3-7

nsrd daemon (businesshours)

3-8

nsrd daemon(non-business hours)

3-9

Available swap space 3-10

Network collisions peroutput packet

3-11

/nsr/index percent spaceused

3-12

Monitored Resources

3–6 Version 1.0

Host StatusTheHost Status monitoring source monitors whether the status of ahost is up or down. This monitor checks the status of any host or otherresource on the network that can respond to a ping request. Thismonitor checks specifically to see whether the targeted hosts are up ordown. This monitor runs every minute.

The following table lists the pre-configured actions for this monitoringsource:

Monitors that are defined with this monitoring source use status opera-tors to evaluate data. Refer to the Tivoli/Sentry documentation for infor-mation on using theEdit Sentry Monitor window to display a list ofthe available operators.

Severity Trigger When Default Actions

Critical Becomes unavailable Send a Fatal event to theTivoli/Enterprise Console.

Change icon.

Send a Sentry notification.

Severe Never None

Warning Never None

Reset Never None

Normal Never None

Always Never None

Monitored Resources


Resource M

onitoring

nsrexecd Daemon StatusThensrexecd Daemon Status monitoring source monitors whetherthensrexecd daemon is up and running. This monitor checks theavailability of the NetWorkernsrexecd daemon on remote NetWorkerclients. This monitor runs every minute.


Monitors that are defined with this monitoring source use statusoperators to evaluate data. Refer to the Tivoli/Sentry documentation forinformation on using theEdit Sentry Monitor window to display a listof the available operators.


Critical Becomes unavailable Send Fatal event to theTivoli/Enterprise Console.

Change icon.

Send a Sentry Notification.

Severe Never None

Warning Never None

Reset Never None

Normal Never Change icon.

Always Never None

Monitored Resources

3–8 Version 1.0

nsrd Daemon Status (Business Hours)Thensrd Daemon Status (Business Hours) monitoring sourcemonitors whether thensrd daemon is up and running during regularbusiness hours. This monitor checks the availability of the NetWorkernsrd daemon on subscribed remote NetWorker servers during thedaytime on every weekday. This monitor runs every minute.


It is necessary to edit this monitor so that thensrd daemon is checkedduring the correct time period. To display the usual Tivoli/Sentrywindow for editing a monitor, select theProperties... option on themonitor’s pop-up menu. Refer to the Tivoli/Sentry documentation forinformation on editing a monitor.


Critical Becomes unavailable Send Critical event to theTivoli/Enterprise Console.

Change icon.


Severe Never None

Warning Never None

Reset Never None


Always Never None

Monitored Resources


Resource M

onitoring

nsrd Daemon Status (Non-Business Hours)Thensrd Daemon Status (Non-Business Hours) monitoring sourcemonitors whether thensrd daemon is up and running duringnon-business hours. This monitor checks the availability of theNetWorkernsrd daemon on subscribed remote NetWorker serversduring nights and weekends. This monitor runs every minute.


It is necessary to edit this monitor so that thensrd daemon is checkedduring the correct time period. To display the usual Tivoli/Sentrywindow for editing a monitor, select theProperties... option on themonitor’s pop-up menu. Refer to the Tivoli/Sentry documentation forinformation on editing a monitor.


Critical Becomes unavailable Send Critical event to theTivoli/Enterprise Console.

Change icon.


Severe Never None

Warning Never None

Reset Never None


Always Never None

Monitored Resources

3–10 Version 1.0

Available Swap SpaceTheAvailable Swap Space monitoring source monitors the amount ofavailable swap space. This monitor checks for the amount of swapspace, in megabytes, being used on subscribed remote NetWorkerservers. This monitor runs every minute.


Monitors that are defined with this monitoring source use numericoperators to evaluate data. Refer to the Tivoli/Sentry documentation forinformation on using theEdit Sentry Monitor window to display a listof the available operators.


Critical < 10 MB Send Critical event to theTivoli/Enterprise Console.

Change icon.


Severe Never None

Warning < 25 MB Send Warning event to theTivoli/Enterprise Console.

Change icon.

Reset Never None


Always Never None

Monitored Resources


Resource M

onitoring

Network Collisions Per Output PacketTheNetwork Collisions Per Output Packet monitoring sourcemonitors network collisions per output packet. This monitor checksthe amount of network collisions occurring on subscribed remoteNetWorker servers. The monitor checks for network collisionthresholds that are specified percentages of the total number of outputpackets. This monitor runs every minute.




Critical > 4% Send Critical event to theTivoli/Enterprise Console.

Change icon.


Severe > 3% Send Warning event to theTivoli/Enterprise Console.

Change icon.


Warning > 2% Send Minor event to theTivoli/Enterprise Console.

Change icon.


Reset Never None


Always Never None

Monitored Resources

3–12 Version 1.0

/nsr/index Percent Space UsedThe /nsr/index Percent Space Used monitoring source monitors diskspace utilization within the NetWorker/nsr/index file system onsubscribed remote NetWorker servers. The monitor checks for diskusage thresholds that are specific percentages of available allocateddisk space for that directory. This monitor runs every minute.




Critical > 98% space used Send Critical event to theTivoli/Enterprise Console.

Display popup alarm dialog.

Change icon.


Severe > 95% space used Send Warning event to theTivoli/Enterprise Console.

Change icon.


Warning > 90% space used Send Minor event to theTivoli/Enterprise Console.

Change icon.


Reset Never None


Always Never None


Enterprise E

ventM

anagement

Enterprise Event Management

With the Tivoli/Enterprise Console, Tivoli/Plus for NetWorkerprovides a set of filters for identifying events and a set of predefinedcorrelation rules to automate the task of responding to specific events.An event is any significant change in the state of system resources oran application. In the case of Tivoli/Plus for NetWorker, an event isactivity from the NetWorker application or a change in a monitoredresource that affects NetWorker. Examples of events are the startingand stopping of a process or a host going down. Event managementprovides a predefined or automated response to specific events, so thatpotential problems are identified and responded to before causingsystem down time. For example, if a process fails, theTivoli/Enterprise Console can automatically rerun the process. TheTivoli/Enterprise Console can also notify the system administrator ofrepeated process failures that may indicate a more severe problem withan application or the network. For some events, there is no automatedresponse except to be displayed in the Tivoli/Enterprise Console.

4

Setting Up the Tivoli/Enterprise Console

4–2 Version 1.0

Setting Up the Tivoli/Enterprise ConsoleThe following describes the configuration activity that occurs whensetting up the Tivoli/Enterprise Console to be used with Tivoli/Plus forNetWorker. This activity takes place on the Tivoli/Enterprise Consoleand NetWorker servers.

Tivoli/Enterprise Console ServerThe Tivoli/Enterprise Console is set up to

■ Recognize and accept NetWorker events.

■ Respond to NetWorker events according to thepredefined rules.

■ Notify the system administrator of the eventsreceived and the action taken.

Tivoli/Enterprise Console ServerOn the NetWorker server

■ NetWorker is configured to send NetWorkerevents to the Tivoli/Enterprise Console.

■ The log file adapter is configured to recognize andforward NetWorker events to the Tivoli/EnterpriseConsole.

Tivoli/Plus for NetWorker performs most of the setup activityautomatically.

Setting Up the Tivoli/Enterprise Console


Enterprise E

ventM

anagement

To set up the Tivoli/Enterprise Console:

1. Select theRun job... option from theSetup Event Server forNetWorker icon's pop-up menu.

2. Specify the fields to indicate the rule base that you want tocontain the NetWorker event classes and rules. You can acceptthe default rule base (TivoliPlus) or create a new rule base (byentering a new name) or modify an existing rule base (by enteringan existing name).

Note: It is not advisable to modify theDefault rule base, so donot enterDefault.

New rule bases are created by copying (cloning) andmodifying an existing one. If you are creating a new rule

Events and Rules

4–4 Version 1.0

base, enter the name of the rule base to be copied in thefollowing field:

If you are creating a new rule base, specify the path nameto the directory on the Tivoli/Enterprise Console server inwhich you want to create the new rule base. Only use thefollowing field if you are creating (not modifying) a rulebase.

Note: The current user for the TME administrator musthave write access to the directory that you specifyin this field.

3. Use the following optional field to display NetWorker relatedevents on a particular system administrator's event console. Tomake this assignment, enter the name that appears under thedesired system administrator's event console icon.

4. Press theSet and Close button when finished.

Events and RulesTivoli/Plus for NetWorker configures the Tivoli/Enterprise Console toreceive events from NetWorker and Tivoli/Sentry. TheTivoli/Enterprise Console classifies the events and then matches themagainst the rule base to see if the event has a predefined rule (automatedresponse).

Events and Rules


Enterprise E

ventM

anagement

Event CorrelationTivoli/Plus for NetWorker also provides event correlation for multipleevents of the same type or for events of different types. If the “cleaningcartridge expired” event occurs more than four times in a week, forexample, a message is sent to the Tivoli/Enterprise Console. Likewise,events of different types can be correlated. The “save group processstarted” event, for example, has a 24-hour timer. When 24 hours haveexpired, this event searches for a corresponding “save group processcompleted” event. If the completion event is not found, the eventseverity level is raised to “critical.”

NetWorker Event Class HierarchyTivoli/Plus for NetWorker utilizes a hierarchical system of eventclasses to categorize events which are unique to the NetWorkerenvironment. These event classes may be used in Tivoli/EnterpriseConsole event group filters to determine which events are directed toa particular event console.

The following diagrams illustrate the event class hierarchy used byTivoli/Plus for NetWorker. The containment level of a particular eventclass is indicated by its horizontal position in the diagram; event classnames to the right are at a lower level than event classes on the left.Event subclass names are positioned directly underneath theirimmediate parent superclass.

Note: Event classes BACKUP and NW_Base are superclasses to allNetWorker event classes.

Event Class Hierarchy

Media Events BACKUP

NW_Base

NW_Media

NW_Tape_Request

NW_Tape_Request_Repeated

Events and Rules

4–6 Version 1.0

Save GroupEvents

BACKUP

NW_Base

NW_Savegroup

NW_Savegroup_Started

NW_Savegroup_Completed

NW_Savegroup_Not_Completed

NW_Client_Backup_Failed

NW_Client_Backup_Failed_Multiple

Index Events BACKUP

NW_Base

NW_Index

NW_File_Index_Capacity

TapeCleaningEvents

BACKUP

NW_Base

NW_Tape_Cleaning

NW_Cleaning_Required

NW_Cleaning_Required_Critical

NW_Cartridge_Required

NW_Cartrdige_Expired

NW_Cartridge_Expired_Multiple

NW_Cleaning_Completed

ExpirationEvents

BACKUP

NW_Base

NW_Expiration

NW_Expiring

NW_Expirining_One

NW_Expiring_Today


Events and Rules


Enterprise E

ventM

anagement

Defining an event group filter to include a particular event class willincludeall event-subclasses contained by that event class as part of theevent group. For example: filtering on event class NW_Expiration willcapture events from three event classes: NW_Expiring,NW_Expiring_One, and NW_Expiring_Today. However, filtering onevent class NW_Base will capture every single event generated byNetWorker.

TheTivoli/Enterprise Console User’s Guide describes the function ofevent groups and filters within Tivoli/Plus modules in more detail. Formore information on event classes, see Appendix A, "Tivoli/EnterpriseConsole Class Hierarchy" in theTivoli/Enterprise Console EventIntegration Facility Guide.

NetWorker EventsThe following table describes the Tivoli/Plus for NetWorker eventsand rules. The table is organized according to the message that theTivoli/Enterprise Console sends to the system administrator for eachNetWorker event. The percent sign (%s) in the message indicates avariable. The definition for each variable follows the message.

Note: Certain sections in the following tables contain a “see nextsection” reference. This reference indicates that the eventdescribed in the first section is correlated with the eventdescribed in the next section.

Server Events BACKUP

NW_Base

NW_Server

NW_nsrd_Restarted

NW_nsrexecd_Down_Multiple


Events and Rules

4–8 Version 1.0

NetWorker Media Event Messages

“Tape request made: original request.”

Event Description:

Event Class:

Event Severity:

Correlation Activity:

NetWorker has issued an initial request for atape to be used as a storage medium.

NW_Tape_Request

HARMLESS

None

“Tape request outstanding: 5 minutes.”

Event Description:

Event Class:

Event Severity:


Five minutes have passed since NetWorkerissued a request for a tape, and no tape has beenprovided.

NW_Tape_Request

WARNING

None

“Tape request outstanding: 30 minutes.”

Event Description:

Event Class:

Event Severity:


Thirty minutes have passed since the systemissued a request for a tape, and no tape has beenprovided.

NW_Tape_Request

CRITICAL

If this event occurs three times or more over thecourse of one month, the system sends e-mail tothe senior administrator.

Events and Rules


Enterprise E

ventM

anagement

NetWorker Save Group Event Messages

“Save Group process started.”

Event Description:

Event Class:

Event Severity:


Indicates that a NetWorker Save Group processhas begun to perform a scheduled backup.

NW_Savegroup_Started

HARMLESS

If the Save Group process is not successfullycompleted within 24 hours, a message is sent tothe T/EC console (see next section).

“Save Group %s did not finish execution within 24 hours on host %s.”(savegroup, hostname)

Event Description:

Event Class:

Event Severity:


Save Group process has not been completedwithin 24 hours.

NW_Savegroup_Not_Completed

CRITICAL

None

Save Group process completed.

Event Description:

Event Class:

Event Severity:


Save Group process has successfully completedexecution.

NW_Savegroup_Completed

HARMLESS

The status values of this event and itscorresponding NW_Savegroup_Started eventare set to CLOSED. This prevents the systemfrom generating an event of classNW_Savegroup_Not_Completed.

Events and Rules

4–10 Version 1.0

“Client backup failed for %s.” (client)

Event Description:

Event Class:

Event Severity:


File backup process has failed for the specifiedclient.

NW_Client_Backup_Failed

MINOR

If this event occurs more than once over a 48hour period for a specified client, a message issent to the T/EC console (see next section).

“Client %s had a backup fail on host %s at least twice in 2 days.” (client,hostname)

Event Description:

Event Class:

Event Severity:


File backup process has failed for the specifiedclient.

NW_Client_Backup_Failed_Multiple

CRITICAL

None

NetWorker Tape Cleaning Event Messages

“Device cleaning required for device %s.” (device)

Event Description:

Event Class:

Event Severity:


The specified tape device requires cleaning.

NW_Cleaning_Required

WARNING

If three hours have passed after this eventoccurs, and the tape device still has not beencleaned, a message is sent to the T/EC console(see next section).

NetWorker Save Group Event Messages

Events and Rules


Enterprise E

ventM

anagement

“Device cleaning required for device %s on host %s and notaccomplished within 3 hours.” (device, hostname)

Event Description:

Event Class:

Event Severity:


3 hours have elapsed since the initialNW_Cleaning_Required event, and thespecified device on the specified host has notbeen cleaned.

NW_Cleaning_Required_Critical

CRITICAL

None

“Cleaning cartridge required for device %s.” (device)

Event Description:

Event Class:

Event Severity:


A cleaning cartridge is required for the specifieddevice.

NW_Cartridge_Required

WARNING

None

“Cleaning cartridge expired.”

Event Description:

Event Class:

Event Severity:


Cleaning cartridge has expired.

NW_Cartridge_Expired

WARNING

If this event occurs four times or more over aone week period, a message is sent to the T/ECconsole (see next section).


Events and Rules

4–12 Version 1.0

“4 or more events indicating that the cleaning cartridge has expired ondevice %s of host %s have occurred within the last week.” (device,hostname)

Event Description:

Event Class:

Event Severity:


The NW_Cartridge_Expired event has occurredat least four times over the course of the pastweek.

NW_Cartridge_Expired_Multiple

WARNING

None

“Device cleaning completed on device %s.” (device)

Event Description:

Event Class:

Event Severity:


Tape device cleaning has been completed on thespecified device.

NW_Cleaning_Completed

HARMLESS

The status values of this event and itscorresponding NW_Cleaning_Required eventare set to CLOSED. This prevents the systemfrom generating an event of classNW_Cleaning_Required_Critical.


Events and Rules


Enterprise E

ventM

anagement

NetWorker Expiration Event Messages

“Temporary license will expire in %s days.” (days until)

Event Description:

Event Class:

Event Severity:


The current date is nearing the expiration datefor the NetWorker temporary enabler. Theamount of days remaining until expiration isindicated in the console message.

NW_Expiring

MINOR for days until = 30WARNING for days until = 10 to 29CRITICAL for days until = 2 to 9

The severity of this event is upgraded fromMINOR to WARNING to CRITICALdepending on the number of days remaininguntil the expiration date.

“Temporary license will expire in 1 day.”

Event Description:

Event Class:

Event Severity:


The current date is one day away from theNetWorker temporary enabler expiration date.

NW_Expiring_One

CRITICAL

None

“Temporary license will expire today.”

Event Description:

Event Class:

Event Severity:


The current date is the expiration date for theNetWorker temporary enabler.

NW_Expiring_Now

FATAL

None

Events and Rules

4–14 Version 1.0

NetWorker Index Event Messages

File index low on space

Event Description:

Event Class:

Event Severity:


The size of the online file index (catalog) hasexceeded 90% of its allocated partition capacity.

NW_File_Index_Capacity

CRITICAL

None

NetWorker Server Event Messages

“nsrd process restarted.”

Event Description:

Event Class:

Event Severity:


Thensrd daemon has been restarted on aparticular server workstation.

NW_nsrd_Restarted

MINOR

If this event occurs more than three times over a24-hour period, the system sends e-mail to thesenior administrator.

“The nsrexecd process failed 4 or more times in one week on host %s.”(hostname)

Event Description:

Event Class:

Event Severity:


Thensrexecd daemon has failed 4 or moretimes in one week on the specified host.

NW_nsrexecd_Down_Multiple

CRITICAL

None

Events and Rules


Enterprise E

ventM

anagement

Sentry EventsThe following table describes the events and rules that Tivoli/Sentrymay use when monitoring NetWorker resources. The table is organizedaccording to the Tivoli/Sentry monitor that sends the event to theTivoli/Enterprise Console.

Since Tivoli/Sentry messages follow a standard format, thesemessages are not reproduced in the table. The following is an exampleof a Tivoli/Sentry message:

Sentry NetWorker Remote Monitors/Daemon status on hostnoonanMon Oct 02 08:00:00 1995

Status: >>> critical <<<

Daemon status (nsrd) Changes to down(Previous: up Current: down Effective: down)Daemon: nsrd

Tivoli/Sentry Events

Host Status

Event Description:

Event Class:

Event Severity:

Sentry Activity


A specified host is down.

Sentry2_0_host

FATAL

Send event to the Tivoli/Enterprise Console;change icon; send a Sentry Notification.

None

Events and Rules

4–16 Version 1.0

nsrd Daemon Status (Business Hours)

Event Description:

Event Class:

Event Severity:

Sentry Activity


Thensrd daemon has become unavailableduring regular business hours.

Sentry2_0_daemon

CRITICAL


If this event occurs more than twice during a 24hour period, then a page is sent to the senioradministrator.

nsrd Daemon Status (Non-business hours)

Event Description:

Event Class:

Event Severity:

Sentry Activity


Thensrd daemon has become unavailableduring non-business hours.

Sentry2_0_daemon

FATAL

Send event to the Tivoli/Enterprise Console;change icon; send a Sentry Notification; restartthensrd daemon.

Restarting thensrd daemon generates an eventof class NW_nsrd_Restarted. If this event isrepeated more than 3 times over a one dayperiod, e-mail is sent to the senior administrator.

nsrexecd Daemon Status

Event Description:

Event Class:

Event Severity:

Sentry Activity


Thensrexecd daemon has become unavailable.

Sentry2_0_daemon

FATAL


None


Events and Rules


Enterprise E

ventM

anagement

Available Swap Space

Event Description:

Event Class:

Event Severity:

Sentry Activity


The available swap space on a specifiedmachine is less than a specified threshold.

Sentry2_0_SwapAvail

WARNING if < 25MBCRITICAL if < 10MB


None

Network Collisions Per Output Packet

Event Description:

Event Class:

Event Severity:

Sentry Activity


The network collision per output packet hasexceeded a specified threshold.

Sentry2_0_NetColl

MINOR if > 2%,WARNING if > 3%CRITICAL if > 4%


None


Events and Rules

4–18 Version 1.0

/nsr/index Percent Space Used

Event Description:

Event Class:

Event Severity:

Sentry Activity


The size of the/nsr/index file system hasexceeded a specified threshold of allocated diskspace.

Sentry2_0_DiskUsed

MINOR if > 90%,WARNING if > 95%CRITICAL if > 98%

Send event to the Tivoli/Enterprise Console;display popup alarm dialog; change icon; send aSentry Notification.

None



Tasks and Jobs forN

etWorker

Tasks and Jobs for NetWorker

Tivoli/Plus for NetWorker provides many tasks for running NetWorkerjobs on multiple machines and operating systems. These tasks areready to be executed as soon as you have installed your Tivoli/Plus forNetWorker module. Simply double-click on the task icon to executethe NetWorker job. You can modify the default executioncharacteristics of a particular job, such as where the output of a job isdisplayed and on which machines the job will run. You may alsospecify whether a job runs serially on each machine, in parallel on allmachines, or staged in groups of machines.

5

Tivoli/Plus for NetWorker Jobs

5–2 Version 1.0

Tivoli/Plus for NetWorker JobsThe following table lists the NetWorker jobs and reports that can becustomized and executed with Tivoli/Plus for NetWorker. For specificinformation on using these jobs, refer to the NetWorker documentation.

Job Function Job Name and Icon

Displays NetWorker enabler code, registration, andlicensing information for each NetWorker server.

Starts NetWorker servers by running thensrd daemonon all NetWorker servers included on the job’ssubscription list.

Shuts down all NetWorker servers by running thensr_shutdown command on all NetWorker serversincluded on the job’s subscription list.

Initiates file recovery on a remote client by runningthenwrecover command on all NetWorker clientsincluded on the job’s subscription list.

This job opens a session of the GUI-based NetWorkerRecover application for each client on which this jobis run.

Note: Since it is usually necessary to recover files ononly one client at a time, you may wish to use theModify job... or Run on selected subscribers...option from the job's pop-up menu to change thesubscription list to include only one client.



Tasks and Jobs forN

etWorker

Stops the file recovery initiated by thenwrecovercommand on all clients included on the job’ssubscription list.

Note: You can edit the job’s subscription list toindicate the clients on which you want to halt filerecovery. To do so, use theModify job... or Run onselected subscribers... option from the job’s pop-upmenu.

Retrieves files from archive volumes and copies themback to a client disk by running thenwretrievecommand on all clients included on the job’ssubscription list.

Note: Since it is usually necessary to retrieve files ononly one client at a time, you may wish to use theModify job... or Run on selected subscribers...option from the job's pop-up menu to change thesubscription list to include only one client.

Stops file retrieval initiated by thenwretrievecommand on all clients included on the job’ssubscription list.

Note: You can edit the job’s subscription list toindicate the clients on which you want to halt fileretrieval. To do so, use theModify job... or Run onselected subscribers... option from the job's pop-upmenu.

Displays the operational status of selected NetWorkerbackup groups. This report contains information suchas status of a scheduled backup, pending clients,completed clients, and client failures.

Displays status information for all devices (includinga backup volume mounted on a device) known to aparticular NetWorker server.



5–4 Version 1.0

Generates a list of NetWorker event messages.

Provides current information on which clients arebacking up, browsing or recovering files.

Displays information about the NetWorker server’scollection of backup volumes and the save sets theycontain.

Replicates NetWorker group configuration onmultiple workstations.

Replicates the NetWorker administrator list ontomultiple NetWorker servers.

Simulates a NetWorker backup by running thesavegrp -pgroup_name command to verify whetherNetWorker can successfully back up a client’s files.


Running a NetWorker Job and Saving the Output


Tasks and Jobs forN

etWorker

Running a NetWorker Job and Saving the OutputAll Tivoli/Plus for NetWorker jobs can be run immediately afterinstallation. You can run these jobs from the desktop only.

To run a NetWorker job with the default execution characteristics:

If Tivoli/Plus for NetWorker requires further information to executethe job, a pop-up window appears prompting you for the information.Online help is available to assist you in completing these windows.

—OR—Double-click onthe icon.

SelectRun job... from theicon’s pop-up menu.


5–6 Version 1.0

For example:

Where appropriate, apop-up window with fieldsand pulldown menus assistsyou in supplying additionalinformation.

Output is displayed in anoutput window.



Tasks and Jobs forN

etWorker

The job’s output is displayed in an output window. To save the job’soutput to a file:

1. Select theSave to File button to display theSave Job Outputdialog box.

2. Enter the name of the workstation on which to save the output filein theOn Host field.

3. Enter the name of the output file that will contain the job’s output.

4. Select theSave & Close button to save the output of the job tothe file you specified.

You can also use theModify job... option of the job icon’s pop-upmenu to specify that the output be sent to a file.

Modifying a NetWorker Job

5–8 Version 1.0

Modifying a NetWorker JobYou can modify the execution characteristics of a job for each time thejob is run or for only a single execution of the job.

Use the following steps to modify a job for each time it is run:

1. Select theModify job... option from the task icon’s pop-up menu.

Be sure to specifyon which man-aged nodes andprofile managersthe job will run.



Tasks and Jobs forN

etWorker

2. Make the necessary changes in theEdit Job window. Online helpis available to assist you.

Note: Be sure to specify on which managed nodes and profilemanagers the job will run.

3. Click on theChange & Close button when finished.

Use the following steps to modify a job for only a single execution ofthe job. The next time you run the same job, it will return to the defaultexecution characteristics.

1. Select theRun on selected subscribers... option from the taskicon’s pop-up menu.

Be sure to specifyon which managednodes and profilemanagers the jobwill be run thistime.


5–10 Version 1.0

2. Make the necessary changes in theExecute Task window. Onlinehelp is available to assist you.

3. Click on theExecute & Dismiss button when finished.

Tivoli/Plus for NetWorker User’s Guide Index-1

Index

Aactivating Tivoli/Plus icons 1-11administrator roles 5-4

Ccommand line installation 1-11commands

winstall 1-11wsupport vii

configuring file packages 2-2– 2-7conventions, typeface vcorrelating, events 4-5customer support vi

Ddesktop installation 1-4dialogs

See windowsdistributing NetWorker 2-1– 2-11documents, related to this guide iv

Eenablers, showing 5-2event correlation 4-5event group filter 4-7event management 4-1– 4-18event messages 4-8– 4-14

NetWorker expiration 4-13

NetWorker index 4-14NetWorker media 4-8NetWorker save group 4-9NetWorker server 4-14NetWorker tape cleaning 4-10

events 4-4– 4-18correlating 4-5expiration 4-6group filter 4-7index 4-6media 4-5NetWorker 4-7NetWorker class hierarchy 4-5save group 4-6server 4-7tape cleaning 4-6Tivoli/Sentry 4-15

expiration events 4-6, 4-13

Ffile packages 2-1

configuring 2-2– 2-7distributing 2-8– 2-11

Ggetting started 1-1– 1-18groups

previewing save 5-4replicating 5-4

Iicons

activating 1-11monitors 3-1NetWorker application 1-16

Index-2 Version 1.0

tasks 5-2Tivoli/Plus 1-11

identifying platform-specific information vindex events 4-6, 4-14installing NetWorker

See distributing NetWorkerinstalling Tivoli/Plus for NetWorker 1-2–

1-11from the command line 1-10from the desktop 1-4requirements for 1-2

hardware 1-3license key 1-2machines 1-2software 1-2

Jjobs 5-1– 5-10

modifying 5-8running 5-5saving output 5-7summary of 5-2– 5-4

Llaunching NetWorker 1-16lists, subscription 1-12

Mmanaging events 4-1– 4-18media events 4-5, 4-8modifying jobs 5-8monitored resources 3-5

host status 3-6network collisions 3-11

nsr/index 3-12nsrd daemon status (business hours) 3-8nsrd daemon status (non-business hours)

3-9nsrexecd daemon status 3-7swap space 3-10viewing 3-4

monitoring resources 3-1– 3-12monitors, using 3-1

NNetWorker

application icons 1-16distributing 2-8event classes 4-5events

See eventsinstalling

See distributing NetWorkerjobs, summary of 5-2– 5-4launching 1-16NetWorker Administration window

1-17NetWorker Archive window 1-18NetWorker Backup window 1-18NetWorker Recover window 1-18NetWorker Retrieve window 1-18

NetWorker jobssummary of 5-2– 5-4

NetWorker server 1-2nwrecover

starting 5-2stopping 5-3

nwretrievestarting 5-3stopping 5-3

Tivoli/Plus for NetWorker User’s Guide Index-3

Pplatform-specific information, identifying vpreviewing NetWorker backup 5-4printing

NetWorker device status report 5-3NetWorker elegible tapes report 5-4NetWorker group status report 5-3NetWorker pending events report 5-4NetWorker sessions report 5-4

problem report, TME viiiprocedures

configuring file packages 2-2distributing NetWorker 2-8installing from command line 1-11installing from desktop 1-4modifying jobs 5-8NetWorker jobs

See jobsrunning jobs 5-5saving ouput 5-7setting up Tivoli/Enterprise Console

4-2using monitors 3-1viewing monitored resources 3-4

profile manager 1-12

Rrelated documents, to this guide ivreplicating

NetWorker administrator roles 5-4NetWorker groups 5-4

reportsdevice status 5-3elegible tapes 5-4group status 5-3sessions 5-4

requirements, for installationhardware 1-3license key 1-2

machines 1-2software 1-2

resource monitoring 3-1– 3-12resources, monitored 3-5

See monitored resourcesroles, administrator 5-4rules 4-4– 4-18running jobs 5-5

Ssave group events 4-6, 4-9saving output 5-7screens

See windowsserver events 4-7, 4-14servers

NetWorker 1-2shutting down 5-2starting 5-2Tivoli 1-2Tivoli/Enterprise Console 1-2

setting up Tivoli/Enterprise Console 4-2showing NetWorker enablers 5-2shutting down NetWorker servers 5-2software distribution 2-1– 2-11starting

NetWorker client nwrecover 5-2NetWorker client nwretrieve 5-3NetWorker servers 5-2

starting NetWorker 1-16starting Tivoli/Plus for NetWorker 1-13stopping

NetWorker client nwrecover 5-3NetWorker client nwretrieve 5-3

subscription lists 1-12support, customer vi

Index-4 Version 1.0

Ttape cleaning events 4-6, 4-10tasks

See jobsTivoli server 1-2Tivoli/Courier file packages

See file packagesTivoli/Enterprise Console 1-2

event management 4-1event messages 4-8setting up 4-2

Tivoli/Pluscollection of modules 1-13icons 1-11

Tivoli/Plus for NetWorkergetting started 1-1module icon 1-12monitors 3-1– 3-3starting 1-13unique features 1-12

Tivoli/Plus symbol 1-12Tivoli/Sentry

events 4-15See also resource monitoring

TME problem report viiitypeface conventions v

Uusing monitors 3-1

Vviewing monitored resources 3-4

Wwindows

Distribute NetWorker Software 2-8Edit Job 5-8Execute Tasks 5-9File Browser 1-6Install Product 1-5, 1-7NetWorker Administration 1-17NetWorker Archive 1-18NetWorker Backup 1-18NetWorker Recover 1-18NetWorker Retrieve 1-18Product Install 1-9, 1-10Sentry Indicator Collection 3-4Setup EventServer for NetWorker 4-3Setup NetWorker Client Distribution

2-3, 2-6Subscribers 2-9, 2-11TivoliPlus 1-14TivoliPlus for NetWorker 1-15TME Desktop 1-4

winstall command 1-11wsupport command vii