Snapshot Schedules - Revision history

Qadmin: Rewrite from the product on 6.9.0: correct breadcrumbs and toolbar/tab names, correct Max Short Term Snapshots default (3, not 5) and remove the non-existent Resource Group field, document every Create/Modify tab, the real short/long-term retention algorithm with tags and expiration, Update Selections vs the CLI add/remove, Reclaim Orphaned Snapshots and Old Schedule ID, holds vs renaming for preserving a snapshot, atomicity and the schedule-prestart hook (QSTOR-12352)

2026-09-03T04:40:34Z

Rewrite from the product on 6.9.0: correct breadcrumbs and toolbar/tab names, correct Max Short Term Snapshots default (3, not 5) and remove the non-existent Resource Group field, document every Create/Modify tab, the real short/long-term retention algorithm with tags and expiration, Update Selections vs the CLI add/remove, Reclaim Orphaned Snapshots and Old Schedule ID, holds vs renaming for preserving a snapshot, atomicity and the schedule-prestart hook (QSTOR-12352)

Show changes

Qadmin: Fix CLI arg names: --days, --hours (am/pm), --offset-minutes, --volume-list, --share-list; fix snapshot revert/clone args; fix volume-list --show-snaps

2026-06-17T15:06:33Z

Fix CLI arg names: --days, --hours (am/pm), --offset-minutes, --volume-list, --share-list; fix snapshot revert/clone args; fix volume-list --show-snaps

← Older revision		Revision as of 15:06, 17 June 2026
Line 47:		Line 47:
	'''CLI — Calendar-based:'''		'''CLI — Calendar-based:'''
	<pre>		<pre>
	# Every Monday and Friday at ~~02:00~~ and ~~18:00~~, 15 minutes past the hour		# Every Monday and Friday at 2am and 6pm, 15 minutes past the hour
	qs snap-schedule-create \		qs snap-schedule-create \
	--name=daily-snap \		--name=daily-snap \
	--days~~-of-week~~=~~monday~~,~~friday~~ \		--days=mon,fri \
	--hours~~-of-day~~=2,18 \		--hours=2am,6pm \
	--offset=15		--offset-minutes=15
	</pre>		</pre>

Line 72:		Line 72:
	qs snap-schedule-create \		qs snap-schedule-create \
	--name=daily-snap \		--name=daily-snap \
	--days~~-of-week~~=~~monday~~,~~tuesday~~,~~wednesday~~,~~thursday~~,~~friday~~ \		--days=mon,tue,wed,thu,fri \
	--hours~~-of-day~~=2 \		--hours=2am \
	--volume-list=vol1,vol2 \		--volume-list=vol1,vol2 \
	--share-list=share1		--share-list=share1
Line 81:		Line 81:
	<pre>		<pre>
	# Add a volume to an existing schedule		# Add a volume to an existing schedule
	qs snap-schedule-add --schedule=daily-snap --volume=vol3		qs snap-schedule-add --schedule=daily-snap --volume-list=vol3

	# Add a share to an existing schedule		# Add a share to an existing schedule
	qs snap-schedule-add --schedule=daily-snap --share=share2		qs snap-schedule-add --schedule=daily-snap --share-list=share2

	# Remove a volume from a schedule		# Remove a volume from a schedule
	qs snap-schedule-remove --schedule=daily-snap --volume=vol3		qs snap-schedule-remove --schedule=daily-snap --volume-list=vol3
	</pre>		</pre>

Line 131:		Line 131:
	qs snap-schedule-create \		qs snap-schedule-create \
	--name=tiered-snap \		--name=tiered-snap \
	--days~~-of-week~~=~~monday~~,~~tuesday~~,~~wednesday~~,~~thursday~~,~~friday~~,~~saturday~~,~~sunday~~ \		--days=mon,tue,wed,thu,fri,sat,sun \
	--hours~~-of-day~~=0 \		--hours=12am \
	--max-snaps=7 \		--max-snaps=7 \
	--rc-dailies=30 \		--rc-dailies=30 \
Line 178:		Line 178:
	'''CLI:'''		'''CLI:'''
	<pre>		<pre>
	# Change to run at ~~3 AM~~ instead of ~~2 AM~~, increase retention to 14		# Change to run at 3am instead of 2am, increase retention to 14
	qs snap-schedule-modify \		qs snap-schedule-modify \
	--schedule=daily-snap \		--schedule=daily-snap \
	--hours~~-of-day~~=3 \		--hours=3am \
	--max-snaps=14		--max-snaps=14
	</pre>		</pre>
Line 261:		Line 261:

	'''Navigation:''' Storage Management → Storage Volumes → (right-click volume) → Revert to Snapshot → select snapshot		'''Navigation:''' Storage Management → Storage Volumes → (right-click volume) → Revert to Snapshot → select snapshot

			Pass the snapshot name as the <code>--volume</code> argument — the snapshot is identified by its own name, not a <code>--snapshot</code> parameter:

	'''CLI:'''		'''CLI:'''
	<pre>		<pre>
	qs volume-snapshot-revert --volume~~=vol1 --snapshot~~=vol1@GMT-2024.06.17-02.15.00		qs volume-snapshot-revert --volume=vol1@GMT-2024.06.17-02.15.00
	</pre>		</pre>

	=== Clone a Snapshot to a New Volume ===		=== Clone a Snapshot to a New Volume ===

	To access snapshot data without reverting, clone the snapshot to a new read-write volume:		To access snapshot data without reverting, clone the snapshot to a new read-write volume. As with revert, pass the snapshot name as <code>--volume</code>:

	'''Navigation:''' Storage Management → Storage Volumes → (right-click snapshot) → Clone		'''Navigation:''' Storage Management → Storage Volumes → (right-click snapshot) → Clone
Line 275:		Line 277:
	'''CLI:'''		'''CLI:'''
	<pre>		<pre>
	qs volume-clone --volume~~=vol1 --snapshot~~=vol1@GMT-2024.06.17-02.15.00 --name=vol1-clone		qs volume-clone --volume=vol1@GMT-2024.06.17-02.15.00 --name=vol1-clone
	</pre>		</pre>

Line 308:		Line 310:
	'''Navigation:''' Storage Management → Storage Volumes → (expand volume) → Snapshots		'''Navigation:''' Storage Management → Storage Volumes → (expand volume) → Snapshots

	'''CLI:'''		'''CLI (shares):'''
	<pre>		<pre>
	qs ~~volume~~-list --~~show~~-~~snaps --volume~~=~~vol1~~		qs share-list --include-snapshots=true
	</pre>		</pre>

			For volumes, snapshots appear as child entries in the WUI under the parent volume. There is no CLI filter for volume snapshots — use <code>volume-list</code> and look for entries where <code>Is Snapshot</code> is true.

	== CLI Quick Reference ==		== CLI Quick Reference ==

Qadmin: Full rewrite: schedule types, retention tiers, CLI reference, recovery procedures, troubleshooting

2026-06-17T03:35:24Z

Full rewrite: schedule types, retention tiers, CLI reference, recovery procedures, troubleshooting

Show changes

Qadmin: /* Select Volumes & Shares */

2023-12-19T23:01:10Z

Select Volumes & Shares

← Older revision		Revision as of 23:01, 19 December 2023
Line 18:		Line 18:

	===Select Volumes & Shares===		===Select Volumes & Shares===
			Select the volumes and shares to be associated with the schedule. '''Note:''' at least one volume or share must be selected.

	[[File:Create Snapshot Schedule - Select Vols & Shrs.jpg\|512px]]		[[File:Create Snapshot Schedule - Select Vols & Shrs.jpg\|512px]]

Qadmin: /* Schedule Interval */

2023-12-19T23:00:08Z

Schedule Interval

← Older revision		Revision as of 23:00, 19 December 2023
Line 13:		Line 13:

	===Schedule Interval===		===Schedule Interval===
			Choose the day/hour for snapshots.

	[[File:Create Snapshot Schedule - Intvl.jpg\|512px]]		[[File:Create Snapshot Schedule - Intvl.jpg\|512px]]

Qadmin: /* General */

2023-12-19T22:59:17Z

General

← Older revision		Revision as of 22:59, 19 December 2023
Line 8:		Line 8:

	===General===		===General===
			Snapshots schedules maintain a rotating snapshot history for the specified Storage Volumes and Network Shares to facilitate easy data recovery.

	[[File:Create Snapshot Schedule - General.jpg\|412px]]		[[File:Create Snapshot Schedule - General.jpg\|412px]]

Qadmin: /* General */

2023-12-19T22:58:23Z

General

← Older revision		Revision as of 22:58, 19 December 2023
Line 8:		Line 8:

	===General===		===General===
	[[File:Create Snapshot Schedule - General.jpg\|412px~~\|thumb\|Create a Snapshot Schedule.~~]]		[[File:Create Snapshot Schedule - General.jpg\|412px]]


	===Schedule Interval===		===Schedule Interval===

Qadmin at 22:58, 19 December 2023

2023-12-19T22:58:00Z

← Older revision		Revision as of 22:58, 19 December 2023
Line 6:		Line 6:

	One may configure multiple snapshot schedules with any number of Storage Volumes and Network Shares from any number of systems in a storage grid. Volumes and Shares may also be associated with multiple Snapshot Schedules each maintaining independent snapshot rotations. For storage volumes and network shares containing critical data one should create a Snapshot Schedule that will create snapshots at least once a day. A second schedule that creates weekly snapshots is also recommended.		One may configure multiple snapshot schedules with any number of Storage Volumes and Network Shares from any number of systems in a storage grid. Volumes and Shares may also be associated with multiple Snapshot Schedules each maintaining independent snapshot rotations. For storage volumes and network shares containing critical data one should create a Snapshot Schedule that will create snapshots at least once a day. A second schedule that creates weekly snapshots is also recommended.

			===General===
			[[File:Create Snapshot Schedule - General.jpg\|412px\|thumb\|Create a Snapshot Schedule.]]

Qadmin: /* Long Term Retention Rules */

2023-12-19T22:52:17Z

Long Term Retention Rules

← Older revision		Revision as of 22:52, 19 December 2023
Line 14:		Line 14:
	[[File:Create Snapshot Schedule - Select Vols & Shrs.jpg\|512px]]		[[File:Create Snapshot Schedule - Select Vols & Shrs.jpg\|512px]]

	===~~Long Term Retention Rules~~===		===Snapshot Settings===
	Snapshots schedules automatically expire the oldest snapshot once the specified maximum retained snapshots setting has been reached.		Snapshots schedules automatically expire the oldest snapshot once the specified maximum retained snapshots setting has been reached.

	[[File:Create Snapshot Schedule - Snap Set.jpg\|512px]]		[[File:Create Snapshot Schedule - Snap Set.jpg\|512px]]

Qadmin: /* Long Term Retention Rules */

2023-12-19T22:50:27Z

Long Term Retention Rules

← Older revision		Revision as of 22:50, 19 December 2023
Line 17:		Line 17:
	Snapshots schedules automatically expire the oldest snapshot once the specified maximum retained snapshots setting has been reached.		Snapshots schedules automatically expire the oldest snapshot once the specified maximum retained snapshots setting has been reached.

	[[File:Create Snapshot Schedule - ~~Long Term Retention Rules~~.jpg\|512px]]		[[File:Create Snapshot Schedule - Snap Set.jpg\|512px]]