Documentation

Disks

Disks can be Hard Disk Drives(HDDs), Solid State Drives(SSDs), USB drives, virtual disks from the hypervisor etc.. depending on your setup. Rockstor supports whole disks, but not partitions.

Disk related operations such as S.M.A.R.T monitoring, data importing etc.. can be managed from the Disks screen listed under the Storage tab of the Web-UI. At a first glance, an overview of disks currently or previously known to the system are displayed.

Table links from left to right:-

  • Drive Name - see that drive’s SMART data / status
  • Bulb Icon - to flash the drive’s activity light ie to identify its location
  • Pool Name - that pool’s specific details page
  • S.M.A.R.T - enable or disable for each device

Buttons:-

  • Rescan - the hardware for any supported drives, see Scan for new disks below
  • S.M.A.R.T - system wide custom configuration (advanced)
_images/disks_overview.png

The disks table can be sorted by individual columns by clicking the small up/down arrows displayed in each column header.

With a large numbers of disks the table will be paginated and the current page number will be displayed below the table along with Prev and Next buttons.

Scan for new disks

Clicking the Rescan button starts a scan for any new disks added to the system since the last scan. This is particularly useful if a drive has been added to the system since Rockstor was power-on ie hot plugged.

Existing whole disk BTRFS

If after scanning or after a Rockstor reinstall the system finds an existing whole disk BTRFS filesystem a small down arrow icon next to the drive name will indicate this. This down arrow can be used to import the discovered btrfs filesystem. In this situation there are two options:

or

Partitioned disks

Rockstor works only with whole disk drives that do not contain a partition table. If a disk has a partition table, it is suspected to have data and Rockstor doesn’t allow it’s usage until the partition table is explicitly wiped. Such disks are displayed with a little gear icon next to their name. Relevant help text is displayed upon mousing over this icon indicating the above restriction. See the next section Wiping a Partitioned Disk for the procedure.

_images/partitioned_disk.png

Wiping a Partitioned Disk

Before a partitioned or previously used disk can be deployed it’s partition table or existing whole disk filesystem needs to be wiped, as indicated by the help text above. Click on the gear icon and a popup confirmation dialog will be displayed. Upon confirmation, the entire disk will be wiped and ready for use as shown below.

Please note that whole disk btrfs filesystems can also be imported, see: Existing whole disk BTRFS

_images/disk_wipe_partition.png

Broken or removed disks

Rockstor detects when a disk drive goes offline (damaged or removed from the system) and marks it as such. This is indicated by a little trash icon next to the disk name and relevant help text is displayed upon mousing over this icon.

_images/disk_offline.png

In order to remove the disk from Rockstor click on the trash icon and a popup confirmation dialog is displayed. Upon confirmation, the disk will be removed as shown below.

_images/disk_remove.png
Dashboard  
   Pools