TrueNAS SCALETrueCommand Version Documentation
This content follows TrueCommand 3.0 releases. Use the Product and Version selectors above to view content specific to TrueNAS software or major versions.

TrueCommand Snapshots

Viewing Snapshots

To view a list of snapshots for a system, click EXPLORE on the system widget (information card), then select the pool.

ExploreSystemSelectPool

Click Snapshots to see a list of snapshots for the root or pool-level dataset. To see a list of snapshots for any other dataset, click on the dataset, then on Snapshots.

ExploreSystemDatasetSnapshotList

The header displays the breadcrumb for the system, pool, and dataset. To return to the pool, click the down arrow beside the system name, then select the pool on the dropdown list.

Taking Snapshots

If the dataset does not have existing snapshots, a blue CREATE SNAPSHOTS button displays instead of a list of snapshots.

CreateSnapshotButtons

You can use this or the white CREATE SNAPSHOTS button under the pool/dataset path on the left-side panel. CREATE SNAPSHOTS displays two options:

  • Create One-time Snapshot to take a single snapshot
  • Create Snapshot Task to create a snapshot task that runs on a schedule

Creating a Single Snapshot

To create single snapshots:

Click EXPLORE on the system card found on the dashboard, then select a pool on that system.

Next, click on a dataset you want to snapshot, then click CREATE SNAPSHOTS.

CreateSnapshotsOptions

Select Create One-Time Snapshot to open the snapshot dialog.

CreateSnapshotDialog

Enter a name for the snapshot. Select Recursive if the dataset selected has other datasets nested under it and you want to include those in the snapshot.

Click OK.

Creating a Snapshot Task

To create snapshot tasks that occurs on a schedule:

Find the system card on the dashboard and click EXPLORE, then select a pool.

Next, click on a dataset you want to snapshot, then click CREATE SNAPSHOTS.

CreateSnapshotsOptions

Select Create Snapshot Task to open the Create Snapshot Task configuration screen. If you did not select a dataset in the pool, you can select one from the dropdown list in the Dataset section. Otherwise, this area is not editable.

CreateSnapshotTaskDataset

Set the schedule for the task. Select the frequency from the Period dropdown, the day of the week, the hour, and the minute you want to run the task.

CreateSnapshotTaskScheduleAndLifetime

Select the task lifetime. Enter a number in Lifetime Value, then select the unit from the Lifetime Unit dropdown list. Options are Hour, Day, Week, Month, and Year.

Click OK to save the task.

Timezones

When you create snapshot tasks, TrueCommand uses the system the dataset is mounted in to determine what timezone it uses.

For example, if you are in New York and the dataset is mounted to a system with a Los Angeles timezone, a snapshot task set to run at 12:00 P.M. runs at 3:00 P.M. your time.

To see what timezone a system is in, go to that TrueNAS system UI and navigate to System > General for CORE or System Settings > General in SCALE, then find the Localization widget or section.