snapmirror

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(1) 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
snapvault target 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...

scn
SnapMirror verifier source activity

Format: type timestamp source destination event_info...

chk
SnapMirror verifier destination activity.

Format: type timestamp source destination event_info...

vol
volume-wide activity

Format: type timestamp volume 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.

Start (Snapshots to verify=#num, level={data|checksum}, {verifier|fixer}, {quick|full} mode) The beginning of a SnapMirror verifier or fixer session. The command options are included in the parentheses. All options appear on the destination side log but only the "snapshots to verify" option appears in source side log.

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.

End (src_only=num_1, dst_only=num_2, mismatch=num_3, correction==num_4)
The completion of a SnapMirror verifier or fixer session. The summary of the session is included in the parentheses. The summary is present only on the destination side logs. Source side logs will not contain any summary information.

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 (cause)
SnapMirror was enabled on this host. The operation or process that caused SnapMirror to become enabled is specified in the parentheses.

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

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

SnapVault_off (cause)
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

Abort_command (type)
User issued snapmirror abort command. The type will only be present if the abort was issued with additional options which changed the type of the abort.

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.

Request_verify (snapshot_name)
A request for a snapshot verification. This is source side log entry. Each snapshot being verified in a verifier session has its own entries.

Verifying_snapshot source snapshot_name (timestamp, cpcount=num_2, snapid=id) to dest_snapshot_name (timestamp, cpcount=count, snapid=id) The beginning of snapshot verification. It is logged on both source and destination.

Abort_verify_command
User issued snapmirror verify abort command. Corresponding log file entry appears with cmd type.

Data_differ ({block blk_num in file_name | VBN vbn})
Found a data block mismatch. Either the block number and the file name or Volume Block Number (VBN) is included in the parentheses.

Unique_in_src (entry_type for entry_path) Found an entry only present in the source. The entry type and entry path are included in the parentheses.

Unique_in_dst (entry_type for entry_path) Found an entry only present in the destina_tion. The entry type and entry path are included in the parentheses.

Size_differ (file_name)
Found a file size mismatch. The file name is included in the parentheses.

Type_differ (entry_name)
Found a directory entry type mismatch. The entry name is included in the parentheses.

UID_differ (entry_name)
Found a user ID mismatch for a directory entry. The entry name is included in the parentheses.

GID_differ (entry_name)
Found a group ID mismatch for a directory entry. The entry name is included in the parentheses.

Perm_differ (entry_name)
Found a permission mismatch for a directory entry. The entry name is included in the parentheses.

Atime_differ (entry_name)
Found a mismatch in the last access time for a directory entry. The entry name is included in the parentheses.

Mtime_differ (entry_name)
Found a mismatch in the last modification time for a directory entry. The entry name is included in the parentheses.

Ctime_differ (entry_name)
Found a mismatch in the last size/status change time for a directory entry. The entry name is included in the parentheses.

Crtime_differ (entry_name)
Found a mismatch in the creation time for a directory entry. The entry name is included in the parentheses.

Rdev_differ (entry_name)
Found a device number mismatch for a directory entry. The entry name is included in the parentheses.

DOSbits_differ (entry_name)
Found a DOS bits mismatch for a directory entry. The entry name is included in the parentheses.

ACL_differ (entry_name)
Found an NT or NFS V4 ACL mismatch for a directory entry. The entry name is included in the parentheses.

Hardlink_differ (entry_name)
Found a hardlink for a directory entry, but the inode on destination doesn't match between the links. The entry name is included in the parentheses.

Qtree_oplock_differ (entry_name)
Found oplock setting mismatch for a qtree. The entry name is included in the parentheses.

Qtree_security_differ (entry_name)
Found security setting mismatch for a qtree. The entry name is included in the parentheses.

Convert_command
User issued snapmirror convert command.

Older_snapshot
Updating from a snapshot which is older than the current base snapshot.

Snapshot_delete (snapshot name)
A snapshot is deleted from this volume. The snapshot name is included in the parentheses.

FILER_REBOOTED
The filer is rebooted.

WORM_LOG_FAIL (reason)
Write to WORM log file failed. The reason for failure is included in the parentheses.

WORM_LOG_FAILURE_RECOVER_START
The beginning of the recovery of the failed WORM log entries.

WORM_LOG_FAILURE_RECOVER_END
The end of the recovery of the failed WORM log entries.

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.

A typical SnapMirror verifier session in /etc/log/snapmirror on destination looks like:

  chk Wed Jan 19 01:07:39 GMT woolf:/vol/vol1 milton:/vol/vol1 Request (Verifier)
  chk Wed Jan 19 01:07:39 GMT woolf:/vol/vol1 milton:/vol/vol1 Start (Snapshots to verify = 2, level= data, verifier
  chk Wed Jan 19 01:07:39 GMT woolf:/vol/vol1 milton:/vol/vol1 Verifying_snapshot milton(0033587346)_vol1.5 (Jan 18
  chk Wed Jan 19 01:07:48 GMT woolf:/vol/vol1 milton:/vol/vol1 Verifying_snapshot nightly.0 (Jan 18 00:00, cpcount =
  chk Wed Jan 19 01:07:57 GMT woolf:/vol/vol1 milton:/vol/vol1 End (src_only = 0, dst_only = 0,mismatch = 0)
  chk Wed Jan 19 01:08:14 GMT woolf:/vol/vol1 milton:/vol/vol1 Request (Verifier)

A typical SnapMirror verifier session in /etc/log/snapmirror on source looks like:

  scn Wed Jan 19 00:58:27 GMT woolf:/vol/vol1 milton:/vol/vol1 Request (172.29.19.15)
  scn Wed Jan 19 00:58:27 GMT woolf:/vol/vol1 milton:/vol/vol1 Start (Snapshots to verify = 2)
  scn Wed Jan 19 00:58:27 GMT woolf:/vol/vol1 milton:/vol/vol1 Request_verify (milton(0033587346)_vol1.5)
  scn Wed Jan 19 00:58:27 GMT woolf:/vol/vol1 milton:/vol/vol1 Verifying_snapshot milton(0033587346)_vol1.5 (Jan 18
  scn Wed Jan 19 00:58:36 GMT woolf:/vol/vol1 milton:/vol/vol1 Request_verify (nightly.0)
  scn Wed Jan 19 00:58:36 GMT woolf:/vol/vol1 milton:/vol/vol1 Verifying_snapshot nightly.1 (Jan 18 00:00, cpcount =
  scn Wed Jan 19 00:58:45 GMT woolf:/vol/vol1 milton:/vol/vol1 End

FILES

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

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

SEE ALSO

na_snapmirror(1)