Manual Pages


Table of Contents

NAME

na_backuplog - captures significant events during file system or volume backup and recovery activities.

SYNOPSIS

/etc/log/backup

DESCRIPTION

Node captures significant dump/restore/smtape-related events and the respective times at which they occur. All events are recorded in one-line messages in /etc/log/backup. Dump/restore events are described first, followed by smtape events.

The following are the dump/restore events node monitors:

Start
Dump/restore starts.

Restart
Restart of a dump/restore.

End
Dump/restore completes successfully.

Abort
The operation aborts.

Error
Dump/restore hits an unexpected event.

Options
Logs the options as users specify.

Tape_open Output device is opened successfully.

Tape_close Output device is closed successfully.

Phase_change
As dump/restore completes a stage.

Dump specific events:

Snapshot
When the snapshot is created or located.

Base_dump
When a valid base dump entry is located.

Logging events for dump/restore:

Start_logging Logging begins.

Stop_logging
Logging ends.

Each dump/restore event record is in the following format:

TYPE TIME_STAMP IDENTIFIER EVENT (EVENT_INFO)

TYPE
Either dmp(dump), rst(restore) or log events.

TIME_STAMP
Shows date and time at which event occurs.

IDENTIFIER
Unique ID for the dump/restore.

EVENT
The event name.

EVENT_INFO
Event specific information.

A typical dump/restore event record message looks like:

dmp Thu Apr 5 18:54:56 PDT 2001 /vol/vol0/home(5) Start (level 0, NDMP)

In the particular example:

TYPE
= dmp

TIME_STAMP
= Thu Apr 5 18:54:56 PDT 2001

IDENTIFER
= /vol/vol0/home(5)

EVENT
= Start

EVENT_INFO
= level 0, NDMP

The following is the smtape manager event:

MGR-Start
smtape manager starts.

Events specific for smtape backup:

BKP-Start
Backup job starts.

BKP-Abort
Backup job aborts.

BKP-End
Backup job ends.

BKP-Tape-Chg Backup job is waiting for tape change.

BKP-Continue Backup job continues after tape change.

BKP-Params
Starting parameters for backup job.

BKP-DW-Start Data warehouse starts for backup job.

BKP-DW-End
Data warehouse ends for backup job.

BKP-Warning
Warning from backup job.

BKP-Tape-Stats Tape statistics for backup job.

Events specific for smtape restore:

RST-Start
Restore job starts.

RST-Abort
Restore job aborts.

RST-End
Restore job ends.

RST-Tape-Chg Restore job is waiting for tape change.

RST-Continue Restore job continues after tape change.

RST-Params
Starting parameters for restore job.

Events related to smtape operations from CLI:

CLI-Backup
smtape backup command.

CLI-Restore
smtape restore command.

CLI-Abort
smtape abort command.

CLI-Continue
smtape continue command.

Each smtape event record has the following format:

JOB_ID TIME_STAMP VOL_PATH EVENT (EVENT_INFO)

JOB_ID
Unique number for a backup/restore job. Manager and CLI events do not have job IDs.

TIME_STAMP
Shows date and time at which event occurs.

VOL_PATH
Volume path associated with a backup/restore job.

EVENT
Event name.

EVENT_INFO
Event specific information.

A typical smtape event record message looks like:

5 Tue Nov 4 19:48:56 GMT /vol/vol1 BKP-Start (level 0 backup of Backup Set ID c6872e62-ac3b-11dd-ab3c-00a0980868f8)

In the particular example:

JOB_ID
= 5

TIME_STAMP
= Tue Nov 4 19:48:56 GMT

VOL_PATH
= /vol/vol1

EVENT
= BKP-Start

EVENT_INFO
= level 0 backup of Backup Set ID c6872e62-ac3b-11dd-ab3c-00a0980868f8

All event messages go to /etc/log/backup. On every Sunday at 00:00, backup is rotated to backup.0 and backup.0 is moved to backup.1 and so on. Up to 6 log files(spanning up to 6 weeks) are kept.

The registry option backup.log.enable controls the enabling and disabling of the logging with values on and off respectively. The functionality is enabled by default. (See na_options(1) for how to set options.)

FILES

/etc/log/backup
backup log file for current week. /etc/log/backup.[0-5] backup log files for previous weeks

SEE ALSO

na_dump(1), na_smtape(1), na_options(1), na_restore(1)


Table of Contents