logo

Manual Pages


Table of Contents

NAME

na_snapmirror - Log of SnapMirror Activity

SYNOPSIS

/etc/log/snapmirror

DESCRIPTION

The SnapMirror log file contains a log of SnapMirror activity for this filer. The file lives in /etc/log on the root volume of both the source and destination filers. When the option snapmirror.log.enable is set to on, all the SnapMirror activities will be recorded in this log file. See na_options(5) for details regarding how to enable and disable this option.

Every Sunday at 00:00, /etc/log/snapmirror is moved to /etc/log/snapmirror.0, /etc/log/snapmirror.0 is moved to /etc/log/snapmirror.1, and so on. The suffix can go up to 5. This process is called rotation. SnapMirror log entries are saved for a total of six weeks.

Each entry of the /etc/log/snapmirror file is a single line consisting of space-separated fields. All log entries begin with a type field and a timestamp field. The final field may be enclosed by parentheses, in which case it may contain spaces. The timestamp field contains a fixed number of spaces, and as such can be parsed as five space-delimited fields. Which fields appear, and in what order they appear in, is determined by the type field of log entry (which is the first field).

Following is a description of each field.

type Indicate the type of the entry, which also determines the format of the rest of the entry. It can be one of the following values:

log
log facility activity

Format: type timestamp event_info...

sys
system-wide activity

Format: type timestamp event_info...

tgt
target (volume-wide) activity

Format: type timestamp volume target event_info...

src
source activity

Format: type timestamp source destination event_info...

dst
destination activity

Format: type timestamp source destination event_info...

cmd
user command activity

Format: type timestamp source destination event_info...

timestamp
Displayed in ctime() format, e.g. Fri Jul 17 20:41:09 GMT. Indicates the time this event is recorded.

volume Specifies the name of the volume to which this entry applies.

target This is the name and type of the target for this entry. Targets are volume-wide actions, typically snapshot creations. It is displayed as two colonseparated fields, as follows:

target_type:target_name

The target name may be an empty string.

source This is the name of the source filer and the volume name or qtree path to be mirrored. The name is specified as two colon-separated fields, as follows:

host:path

This field may be `-' when not applicable for the event.

destination
This is the name of the destination filer and the volume name or qtree path of the destination. The name is specified as two colon-separated fields, same as in the source field.

This field may be `-' when not applicable for the event.

event_info
This field contains the event which is being logged. Some events may have extra information in parentheses.

Request (IP address | transfer type) A transfer request has been sent (destination) or received (source). On source side, the IP address of the destination filer that made the request is included in parentheses. On destination side, the transfer type is included in the parentheses.

Start The beginning of a transfer.

Restart (@ num KB)
The beginning of a restarted transfer.

End (num KB done)
The completion of a transfer. The total size of the transfer in KB is included in the parentheses.

Abort (error msg)
A transfer is aborted. The error message is included in the parentheses.

Defer (reason)
Indicates a transfer is deferred because of a resource limitation. The reason for the deferment is included in the parentheses.

Wait_tape
A SnapMirror tape operation is waiting for next tape.

New_tape
A SnapMirror tape operation continued the operation with the new tape.

Sync_start
The start of synchronous mirroring mode for the SnapMirror relationship specified by this log entry.

Sync_end (reason)
The end of synchronous mirroring mode for the SnapMirror relationship specified by this log entry. The reason for dropping out of synchronous mode is included in the parentheses.

Quiesce_start
The beginning of quiesce process.

Quiesce_end
The completion of quiesce process.

Quiesce_failed (reason)
The failure of quiesce process. The reason for failure is included in the parentheses.

Rollback_start
The beginning of a rollback process for a qtree SnapMirror or SnapVault.

Rollback_end
The completion of a rollback process for a qtree SnapMirror or SnapVault.

Rollback_failed (reason)
The failure of a rollback process for a qtree SnapMirror or SnapVault. The reason for failure is included in the parentheses.

Coalesce_start (snapshot)
The beginning of a coalesce process for a SnapVault qtree. The base snapshot for the coalesce operation is included in the parentheses.

Coalesce_end
The completion of a coalesce process for a SnapVault qtree.

Coalesce_failed (reason)
The failure of a coalesce process for a SnapVault qtree. The reason for failure is included in the parentheses.

Target_start
The beginning of a SnapVault target.

Target_end
The completion of a SnapVault target.

Target_failed (reason)
The failure of a SnapVault target. The reason for failure is included in the parentheses.

Start_logging
SnapMirror log was enabled.

End_logging
SnapMirror log was disabled.

SnapMirror_on (ause)
SnapMirror was enabled on this host. The operation or process that caused SnapMirror to become enabled is specified in the parentheses.

SnapMirror_off (ause)
SnapMirror was disabled on this host. The operation or process that caused SnapMirror to become disabled is specified in the parentheses.

SnapVault_on (ause)
SnapVault was enabled on this host. The operation or process that caused SnapVault to become enabled is specified in the parentheses.

SnapVault_off (ause)
SnapVault was disabled on this host. The operation or process that caused SnapVault to become disabled is specified in the parentheses.

Resume_command
User issued snapmirror resume command.

Break_command
User issued snapmirror break command.

Release_command
User issued snapmirror release command.

Abort_command
User issued snapmirror abort command.

Resync_command (common snapshot)
User issued snapmirror resync command. The common snapshot for the resync operation is included in the parentheses.

Migrate_command
User issued snapmirror migrate command. _FI_FI_

EXAMPLE

A typical entry in /etc/log/snapmirror looks like:

  dst Fri Jul 17 22:50:18 GMT filer1:srcvol filer2:dstvol Request (Update)

This example shows an update request recorded by the destination side for a SnapMirror relationship from filer:srcvol to filer2:dstvol that happened at the recorded time.

FILES

/etc/log/snapmirror
SnapMirror log file for current week.

/etc/log/snapmirror.[0-5]
SnapMirror log files for previous weeks.

SEE ALSO

na_options(1), na_snapmirror(1)


Table of Contents