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 node. The file lives in /etc/log on the root volume of both the source and destination nodes. 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
replication check source activity

Format: type timestamp source destination event_info...

chk
replication check destination activity.

Format: type timestamp source destination event_info...

vol
volume-wide activity

Format: type timestamp volume event_info...

slk
softlock addition-deletion activity

Format: type timestamp softlock 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 node 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 node 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 node 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 check=#num, level={data|checksum}, {check|fix}, {quick|full} mode)
The beginning of a replication check or fix session. The session options are included in the parentheses. All options appear on the destination side log but only the "snapshots to check" 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)
The completion of a replication check or fix 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.

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.

Restore_resync_command (common snapshot) User issued snapvault restore -r command. The common snapshot for the resync operation is included in the parentheses.

Migrate_command
User issued snapmirror migrate command.

Request_check (snapshot_name)
A request for single snapshot during replication check session. This is source side log entry. Each snapshot being checked in a replication check session will have its entry. Name of snapshot is included in the parentheses.

Checking_snapshot source snapshot_name (timestamp, cpcount=num_2, snapid=id) to dest_snapshot_name (timestamp, cpcount=count, snapid=id) The beginning of a single snapshot comparison during replication check. It is logged on both source and destination.

Abort_check
replication check session for SnapMirror or SnapVault aborted. Reason of abort is included in the parentheses.

Abort_check_command
User issued replication check abort command. Corresponding log file entry appears with cmd type.

Data_differ ({block blk_num in file_path | VBN vbn})
Replication check found a data block mismatch. Either the block number and the inode path or Volume Block Number (VBN) is included in the parentheses.

Unique_in_src (entry_type for entry_path) Replication check 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) Replication check found an entry only present in the destination. The entry type and entry path are included in the parentheses.

Size_differ (path)
Replication check found a file size mismatch in specified inode. The inode path is included in the parentheses.

Type_differ (path)
Replication check found a inode type mismatch. The inode path is included in the parentheses.

UID_differ (path)
Replication check found a user ID mismatch for specified inode. The inode path is included in the parentheses.

GID_differ (path)
Replication check found a group ID mismatch for specified inode. The inode path is included in the parentheses.

Perm_differ (path)
Replication check found a permission or dosbit mismatch for specified inode. The inode path is included in the parentheses.

Atime_differ (path)
Replication check found a mismatch in the last access time for specified inode. The inode path is included in the parentheses.

Mtime_differ (path)
Replication check found a mismatch in the last modification time for specified inode. The inode path is included in the parentheses.

Ctime_differ (path)
Replication check found a mismatch in the last size/status change time for specified inode. The inode path is included in the parentheses.

Crtime_differ (path)
Replication check found a mismatch in the creation time for specified inode. The inode path is included in the parentheses.

Rdev_differ (path)
Replication check found a device number mismatch for specified inode. The inode path is included in the parentheses.

DOSbits_differ (path)
Replication check found a DOS bits mismatch for specified inode. The inode path is included in the parentheses.

ACL_differ (path)
Replication check found an NT or NFS V4 ACL mismatch for specified inode. The inode path is included in the parentheses.

Hardlink_differ (path)
Replication check found a hardlink for specified inode, but the inode on destination doesn't match between the links. The inode path is included in the parentheses.

Qtree_oplock_differ (path)
Replication check found oplock setting mismatch for a qtree. The qtree path is included in the parentheses.

Qtree_security_differ (path)
Replication check found security setting mismatch for a qtree. The qtree path is included in the parentheses.

Hole_uses_disk_space (path)
Replication check found unnecessary disk usage for specified inode, this however is not a mismatch. The inode path 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.

Snapshot_replace (snapshot name)
A SnapVault snapshot has been replaced after a SIS operation with a newer snapshot of the same name. The snapshot name is included in the parentheses.

FILER_REBOOTED
The node 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.

Softlock_add (operation)
A softlock is added. The operation that added the softlock is included in the parentheses.

Softlock_add_pending (operation)
A softlock is added as a pending softlock. The operation that added the softlock is included in the parentheses.

Softlock_delete (operation)
A softlock is deleted. The operation that deleted the softlock is included in the parentheses.

Softlock_delete_pending (operation) A pending softlock is deleted. The operation that deleted it is included in the parentheses.

Softlock_mark_pending (operation)
A softlock is marked as pending. The operation that marked it is included in the parentheses.

Resend log open fail
Opening of resend log which has checksum mismatches from last aborted VSM transfer, failed.

Logging checksum mismatch (@VBN)
Looging a checksum mismatch in resend log.

EXAMPLES

A typical entry in /etc/log/snapmirror looks like:
  dst Fri Jul 17 22:50:18 GMT node1:srcvol node2:dstvol Request (Update)

The above example shows an update request recorded by the destination side for a SnapMirror relationship from node:srcvol to node2:dstvol that happened at the recorded time.

A typical Replication check session in /etc/log/snapmirror on destination looks like:

  chk Wed Jan 19 01:07:39 GMT woolf:/vol/vol1 milton:/vol/vol1 Request (check)
  chk Wed Jan 19 01:07:39 GMT woolf:/vol/vol1 milton:/vol/vol1 Start (Snapshots to check = 2, level= data, check, full)
  chk Wed Jan 19 01:07:39 GMT woolf:/vol/vol1 milton:/vol/vol1 Checking_snapshot milton(0033587346)_vol1.5 (Jan 18...
  chk Wed Jan 19 01:07:48 GMT woolf:/vol/vol1 milton:/vol/vol1 Checking_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)

A typical Replication check 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 check = 2)
  scn Wed Jan 19 00:58:27 GMT woolf:/vol/vol1 milton:/vol/vol1 Request_check (milton(0033587346)_vol1.5)
  scn Wed Jan 19 00:58:27 GMT woolf:/vol/vol1 milton:/vol/vol1 Checking_snapshot milton(0033587346)_vol1.5 (Jan 18...
  scn Wed Jan 19 00:58:36 GMT woolf:/vol/vol1 milton:/vol/vol1 Request_check (nightly.0)
  scn Wed Jan 19 00:58:36 GMT woolf:/vol/vol1 milton:/vol/vol1 Checking_snapshot nightly.1 (Jan 18 00:00, cpcount =...
  scn Wed Jan 19 00:58:45 GMT woolf:/vol/vol1 milton:/vol/vol1 End

A typical softlock logging in /etc/log/snapmirror looks like:

  slk Wed May 10 03:06:15 GMT  state.softlock.vol1.0000011e.054.node1:vol3 Softlock_add (Transfer)
  slk Wed May 10 03:06:15 GMT  state.softlock.vol1.0000011b.054.node1:vol3 Softlock_delete (Transfer)
  slk Wed May 10 03:06:15 GMT  state.softlock.vol1.0000011b.054.node1:vol3 Softlock_delete (Revert)
  slk Wed May 10 03:06:15 GMT  state.softlock.vol1.0000011b.054.node1:vol3 Softlock_delete (Release)
  slk Wed May 10 03:06:15 GMT  state.softlock.vol1.0000011b.054.node1:vol3 Softlock_delete (Clean_softlocks)
  slk Wed May 10 03:06:15 GMT  state.softlock.vol1.0000011b.054.node1:vol3 Softlock_add (RSM_forward)
  slk Wed May 10 03:06:15 GMT  state.softlock.vol1.0000011b.054.node1:vol3 Softlock_delete (RSM_forward)
  slk Wed May 10 03:06:15 GMT  state.softlock.vol1.0000011b.054.node1:vol3 Softlock_delete (Snapmirror_destinations)
  slk Wed May 10 03:06:15 GMT  state.softlock.vol1.0000011b.054.node1:vol3 Softlock_delete_pending (Transfer)
  slk Wed May 10 03:06:15 GMT  state.softlock.vol1.0000011b.054.node1:vol3 Softlock_add_pending (Transfer)
  slk Wed May 10 03:06:15 GMT  state.softlock.vol1.0000011b.054.node1:vol3 Softlock_mark_pending (Transfer)

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) na_snapvault(1)


Table of Contents