PowerScale OneFS 9.8.0.0 Web Administration Guide

PDF

Snapshot naming patterns

If you schedule snapshots to be automatically generated, either according to a snapshot schedule or a replication policy, you must assign a snapshot naming pattern that determines how the snapshots are named. Snapshot naming patterns contain variables that include information about how and when the snapshot was created.

The following variables can be included in a snapshot naming pattern:

Table 1. VariablesThe following table describes each variable.
Variable	Description
%A	The day of the week.
%a	The abbreviated day of the week. For example, if the snapshot is generated on a Sunday, %a is replaced with `Sun`.
%B	The name of the month.
%b	The abbreviated name of the month. For example, if the snapshot is generated in September, %b is replaced with `Sep`.
%C	The first two digits of the year. For example, if the snapshot is created in 2014, %C is replaced with `20`.
%c	The time and day. This variable is equivalent to specifying `%a %b %e %T %Y`.
%d	The two-digit day of the month.
%e	The day of the month. A single-digit day is preceded by a blank space.
%F	The date. This variable is equivalent to specifying `%Y-%m-%d`.
%G	The year. This variable is equivalent to specifying `%Y`. However, if the snapshot is created in a week that has less than four days in the current year, the year that contains most of the days of the week is displayed. The first day of the week is calculated as Monday. For example, if a snapshot is created on Sunday, January 1, 2017, %G is replaced with `2016`, because only one day of that week is in 2017.
%g	The abbreviated year. This variable is equivalent to specifying `%y`. However, if the snapshot was created in a week that has less than four days in the current year, the year that contains most of the days of the week is displayed. The first day of the week is calculated as Monday. For example, if a snapshot is created on Sunday, January 1, 2017, %g is replaced with `16`, because only one day of that week is in 2017.
%H	The hour. The hour is represented on the 24-hour clock. Single-digit hours are preceded by a zero. For example, if a snapshot is created at 1:45 AM, %H is replaced with `01`.
%h	The abbreviated name of the month. This variable is equivalent to specifying `%b`.
%I	The hour as represented on the 12-hour clock. Single-digit hours are preceded by a zero. For example, if a snapshot is created at 1:45 PM, %I is replaced with `01`.
%j	The numeric day of the year. For example, if a snapshot is created on February 1, %j is replaced with `32`.
%k	The hour as represented on the 24-hour clock. Single-digit hours are preceded by a blank space.
%l	The hour as represented on the 12-hour clock. Single-digit hours are preceded by a blank space. For example, if a snapshot is created at 1:45 AM, %I is replaced with `1`.
%M	The two-digit minute.
%m	The two-digit month.
%p	`AM` or `PM`.
%{PolicyName}	The name of the replication policy that the snapshot was created for. This variable is valid only if you are specifying a snapshot naming pattern for a replication policy.
%R	The time. This variable is equivalent to specifying `%H:%M`.
%r	The time. This variable is equivalent to specifying `%I:%M:%S %p`.
%S	The two-digit second.
%s	The second represented in UNIX or POSIX time.
%{SrcCluster}	The name of the source cluster of the replication policy that the snapshot was created for. This variable is valid only if you are specifying a snapshot naming pattern for a replication policy.
%T	The time. This variable is equivalent to specifying `%H:%M:%S`
%U	The two-digit numerical week of the year. Numbers range from `00` to `53`. The first day of the week is calculated as Sunday.
%u	The numerical day of the week. Numbers range from `1` to `7`. The first day of the week is calculated as Monday. For example, if a snapshot is created on Sunday, %u is replaced with `7`.
%V	The two-digit numerical week of the year that the snapshot was created in. Numbers range from `01` to `53`. The first day of the week is calculated as Monday. If the week of January 1 is four or more days in length, then that week is counted as the first week of the year.
%v	The day that the snapshot was created. This variable is equivalent to specifying `%e-%b-%Y`.
%W	The two-digit numerical week of the year that the snapshot was created in. Numbers range from `00` to `53`. The first day of the week is calculated as Monday.
%w	The numerical day of the week that the snapshot was created on. Numbers range from `0` to `6`. The first day of the week is calculated as Sunday. For example, if the snapshot was created on Sunday, %w is replaced with `0`.
%X	The time that the snapshot was created. This variable is equivalent to specifying `%H:%M:%S`.
%Y	The year that the snapshot was created in.
%y	The last two digits of the year that the snapshot was created in. For example, if the snapshot was created in 2014, %y is replaced with `14`.
%Z	The time zone that the snapshot was created in.
%z	The offset from coordinated universal time (UTC) of the time zone that the snapshot was created in. If preceded by a plus sign, the time zone is east of UTC. If preceded by a minus sign, the time zone is west of UTC.
%+	The time and date that the snapshot was created. This variable is equivalent to specifying `%a %b %e %X %Z %Y`.
%%	Escapes a percent sign. For example, 100%% is replaced with `100%`.