NSR_NOTIFICATION(5)

NAME

NSR notification − NetWorker resource type “NSR notification”

SYNOPSIS

type: NSR notification

DESCRIPTION

A resource of type NSR notification is used for each combination of an event, priority, and action handled by the NetWorker notification system. A NetWorker notification consists of a single event type, a single priority, and a message. The notification system posts each message to the action of each NSR notification resource (by executing the command listed in the action, with the message on standard input) that includes that event type and priority. See nsr_resource(5) for more information on NetWorker resources. To edit the NSR notification resources type:

nsradmin −c "type:NSR notification"

or use the networker(8) GUI. See nsradmin(8) for more information on using the NetWorker administration program.

ATTRIBUTES

The following attributes are defined for resource type NSR notification. The information in parentheses describes how the attribute values are accessed. Create-only indicates that the value cannot be changed by an administrator, except when the resource is created. Read/write means the value can be changed at any time by authorized administrators. Choice list means that any number of values can be chosen from the given list. Single string means that only a single value is allowed. Static attributes change values rarely, if ever. Hidden means it is an attribute of interest only to programs or experts, and these attributes can only be seen when the hidden option is turned on in nsradmin(8) or expert mode (−x) in networker(8). For example, an attribute marked (create-only, static) has a value which is set when the attribute is created and never changes. Several additional attributes (e.g. administrator) are common to all resources, and are described in nsr_resource(5).

name (create-only, static)
This attribute holds the name of the notification resource.

event(create-only, choice list, hidden)
Each value is a class of events that will trigger the given notification. More than one class may be selected. Valid values are: Media for events related to the media multiplexor subsystem, Savegroup for events generated by the savegroup(8) command (usually the nightly automatic backups), Index for events related to the on-line file index subsystem, Registration for events caused by changes in the product’s registration status (e.g. a license that will soon time out), and Server for other NetWorker server events, such as restarting.
Example: event: Media;

priority(create-only, choice list, hidden)
Each value is a priority at which the notification will be triggered. More than one priority may be selected. The valid values in increasing priority order are Info − supplies information about the current state of the server; Notice − an important piece of information; Warning − information about a non-fatal error; Waiting − the server is waiting for an operator to perform a routine task, such as mounting a tape; Critical − the server detected an error condition that should be fixed by a qualified operator; Alert − a severe error condition that demands immediate attention; Emergency − a condition that may cause NetWorker to fail unless corrected immediately.
Example: priority: Notice;

action(read/write, single string)
The value is a command line to be executed when the given event occurs. The command line is run (see popen(3s)) with the event information connected to standard input. Typical actions are to log the message with the syslog(3) package, or send electronic mail to a system operator.
Example: action: /usr/ucb/mail −s "savegroup completion" root;

EXAMPLE

A complete example follows with two resources, one for mail and one using the syslog mechanism:

         type: NSR notification;
         name: savegroup completion;
administrator: root;
       action: \
/usr/ucb/mail -s \"savegroup completion\" root;
        event: Savegroup;
     priority: Notice;
          type: NSR notification;
         name: log default;
administrator: root;
       action: /usr/ucb/logger -p daemon.notice -f -;
        event: Media, Savegroup, Index, Server, Registration;
     priority: Info, Notice, Warning, Waiting,
               Critical, Alert, Emergency;

FILES

/nsr/res/nsr.res − this file should never be edited directly. Use nsradmin(8) instead.

Museum

Related Articles