Get a Quote     (408) 943-4100               TrueNAS Discord      VendOp_Icon_15x15px   Commercial Support Toggle between Light and Dark mode

Storage Dashboard Screen

  9 minute read.

Last Modified 2022-12-09 08:45 -0500

SCALE Bluefin introduces the new Storage Dashboard screen that is designed to help users configure and manage storage resources such as pools (VDEVs), datasets, and disks, and to keep the pool healthy (scrub). This dashboard uses widgets to organize functions directly or indirectly related to storage resources.

The Storage Dashboard displays the No Pools screen with a Create Pool button in the center of the screen until you add a pool.

StorageDashboardNoPools

Both the Create Pool button on the top right and at the center of the screen open the Create Pool > Pool Manager configuration screen.

After adding a pool, the screen displays five widgets. The Unassigned Disks widget remains at the top of the dashboard and the other four are a set that display for each pool created on the system.

StorageDashboardWithPool

Import at the top of the dashboard opens the Import Pool screen.

Disks at the top of the dashboard opens the Disks screen. The Manage Disks button on the Disk Health widget opens the same Disks screen.

Export/Disconnect opens the Export/disconnect pool window that allows you to either completely remove a pool and deleted all the contents of that pool, or to export the pool to the server and disconnect it in TrueNAS SCALE.

Expand opens the Expand pool dialog. Use to expand the selected pool to fit all available disk space.

Pool Status

Each widget in the set of four pool widgets includes a color-coded icon just to the right of the header that indicates the status of the pool as healthy (green checkmark), offline (orange triangle), or in a warning state (purple warning sign).

StoragePoolWidgetsDegradedState

This same information displays on both the Storage widget and a pool widget you can add to the Dashboard.

Storage Dashboard Widgets

The Storage Dashboard widgets organize storage and related functions for each pool.

The Unassigned Disks widget remains at the top of the dashboard and provides the number of available disks on the system to use in pools. Each pool has a set of four widgets: Topology for managing pool virtual devices or VDEVs, Usage for managing datasets and zvols, ZFS Health for managing pool health and pool functions like scrub and auto TRIM, and Disk Health for managing disks and disk health. Each set of pool widgets provides access to screens for each storage type with the information for the pool pre-selected. For example, Manage Devices on the Topology widget opens the Devices screen with the VDEVs configured for that pool and not all pools on the system.

Unassigned Disks Widget

The Unassigned Disks widget displays the number of disks available on your system to use in pools. The disk count includes disks assigned in an exported pool. If you attempt to use a disk assigned in an exported pool a warning message displays that prompts you to select a different disk.

To see information on each disk on the system, click Manage Disks on the Disk health widget.

StorageDashboardUnassignedDisksWidget

Add To Pool opens the Add to Pool window.

Add To Pool Window

The Add to Pool window allows you to select a disk or disks to add to either a new pool or an existing pool.

AddToPoolWindow

The Unassigned Disks area displays the amount of storage and the number of disks that provide that storage.

The Add Disks To area includes two radio buttons:

New Pool opens the Create Pool > Pool Manager screen. Existing Pool opens the Add VDevs to Pool > Pool Manager screen.

AddToPool-ExistingWindow

Add Disks opens the Pool Manager screen for the radio button option you selected, Create Pool to add a new VDEV or Add to a Pool where you can add to the existing VDEV.

Topology Widget

The Topology widget provides information on VDEVS configured on the system and the status of the pool.

The widget lists each VDEV type (data, metadata, log, cache, spare, and dedup). A Data VDEV includes the data type (stripe, mirror, RAID, or mixed configuration), the number of disks (wide), and the storage capacity of that VDEV.

StorageDashboardTopologyWidget

Manage Devices opens the Devices screen where you can add or manage existing VDEVs.

Usage Widget

The Usage widget provides information on the space configured datasets use and the status of pool usage.

The widget includes a donut chart that illustrates the percentage of space used on the pool. This color-coded graph displays space usage in the 0-80% range in blue indicates and anything above 80% in red. A warning displays below this donut graph when usage is above 80%. Usable Capacity details the selected pool space statistics by Used, Available, and Used by Snapshots.

StorageDashboardUsageWidget

View Disk Space Reports opens the pool usage reports for the selected pool.

Manage Datasets opens the Datasets screen that shows the datasets configured for the pool that owns this widget.

ZFS Health Widget

The ZFS Health widget provides information on the health of the pool.

The details on the widget include Pool Status as online or offline, Total ZFS Errors count of the number of ZFS errors, Scheduled Scrub Task as set or not, and Auto TRIM as on or off.

StorageDashboardZFSHealthWidget

View all Scrub Tasks opens the Data Protections > Scrub Tasks details screen that lists all scheduled scrub tasks and allows you to add a new task or edit an existing task.

Scrub opens the Scrub Pool dialog.

Edit Auto TRIM opens the dialog that allows you to set Auto TRIM on or off.

Scrub Pool Dialog

The Scrub Pool dialog allows you to perform an unscheduled scrub task. Scrub Pool initiates a check on pool data integrity.

If TrueNAS detects any problems during the scrub, it either corrects them automatically or generates an alert in the web interface.

By default, TrueNAS automatically checks every pool to verify it is on a reoccurring scrub schedule.

To schedule a single or a regular pool scrub operation, click View All Scrub Tasks to open the Data Protections > Scrub Tasks details screen where you can add or manage scrub tasks configured on your system.

ScrubPoolDialog

Confirm activates the Start Scrub button.

Auto TRIM Dialog

Edit Auto TRIM opens the dialog that allows you to set auto TRIM.

When enabled, Auto TRIM allows TrueNAS to periodically review data blocks to identify which empty blocks of obsolete blocks it can delete. Leave unselected to incorporate day block overwrites when a device write is started (default).

PoolOptionsAuotTRIM

For more details about TRIM in ZFS, see the autotrim property description in zpool.8.

Select Confirm to activate Save.

Disk Health Widget

The Disk Health widget provides information on the health of the disks in a pool.

The details on the widget include the non-dismissed disk temperature alerts for highest, lowest, and average temperature, and any failed S.M.A.R.T. tests.

StorageDashboardDiskHealthWidget

Manage Disks opens the Storage > Disk screen.

View Reports opens the Report screen for the disks in the selected pool.

View all S.M.A.R.T. Tests opens the Data Protection > S.M.A.R.T. Tests screen.

Pool Manager Screens

The Pool Manager(/scale/scaleuireference/storage/pools/poolmanagerscreens/) configuration screen displays after clicking Create Pool on the Storage Dashboard or Add VDEV on the Devices screen.

The Create Pool button opens the Create Pool screen with the Pool Manager configuration screen.

Add VDEV on the Devices screen opens the Add Vdevs to Pool screen with the Pool Manager configuration screen for the selected pool.

Import Pool Screen

The Import Pool button opens the Import Pool screen.

ImportPoolScreen

Select a pool from the Pool dropdown list TrueNAS detects as present on the system but that is not yet connected in TrueNAS.

Import starts the process to connect the pool in TrueNAS and bring it into SCALE. Import also reconnects pools after users reinstall or upgrade their TrueNAS system.

Export/Disconnect Window

Export/Disconnect opens the Export/disconnect pool: poolname window that allows users to export, disconnect, or delete a pool.

The Export/disconnect pool window includes a warning that states data becomes unavailable after an export and that selecting Destroy Data on this pool destroys data on the pool disks.

Exporting/disconnecting can be a destructive process! Back up all data before performing this operation. You might not be able to recover data lost through this operation.

ExportDisconnectPoolWindow

If a share uses the pool this window displays the share type (for example, SMB share, etc.) affected by the export/disconnect operation.

Disks in an exported pool become available to use in a new pool but remain marked as used by an exported pool. If you select a disk used by an exported pool to use in a new pool the system displays a warning message about the disk.

Setting Description
Destroy data on this pool? Select to erase all data on the pool. After selecting this a field displays there you type the name of the pool to confirm the operation before the Export/Disconnect button activates.
Delete configuration of shares that use this pool Enabled by default to remove the share connection to this pool. Exporting or disconnecting the pool deletes the configuration of shares using this pool. You must reconfigure the shares affected by this operation.
Confirm Export/Disconnect Required option. Select to confirm the operation and accept the warnings displayed. Activates the Export/Disconnect button.

Export/Disconnect executes the process and begins the pool export or disconnect. A status window displays with progress. When complete, a final dialog displays stating the export/disconnect completed successfully.

Expand Dialog

Select Expand Pool to increase the pool size to match all available disk space. Users with pools using virtual disks use this option to resize these virtual disks apart from TrueNAS.

ExpandPoolDialog

Related Content

Related VDEV Articles

Related Storage Articles