Array Devices

Colored Status Indicator the significance of the color indicator at the beginning of each line in Array Devices is as follows:

Normal operation, device is active.

Device is in standby mode (spun-down).

Device contents emulated.

Device is disabled, contents emulated.

New device.

No device present, position is empty.

Identification is the signature that uniquely identifies a storage device. The signature includes the device model number, serial number, linux device id, and the device size.

Temp. (temperature) is read directly from the device. You configure which units to use on the Display Preferences page. We do not read the temperature of spun-down hard drives since this typically causes them to spin up; instead we display the * symbol. We also display the * symbol for SSD and Flash devices, though sometimes these devices do report a valid temperature, and sometimes they return the value 0.

Size, Used, Free reports the total device size, used space, and remaining space for files. These units are also configured on the Display Preferences page. The amount of space used will be non-zero even for an empty disk due to file system overhead.

Note: for a multi-device cache pool, this data is for the entire pool as returned by btrfs.

Reads, Writes are a count of I/O requests sent to the device I/O drivers. These statistics may be cleared at any time, refer to the Array Status section below.

Errors counts the number of unrecoverable errors reported by the device I/O drivers. Missing data due to unrecoverable array read errors is filled in on-the-fly using parity reconstruct (and we attempt to write this data back to the sector(s) which failed). Any unrecoverable write error results in disabling the disk.

FS indicates the file system detected in partition 1 of the device.

View column contains a folder icon indicating the device is mounted. Click the icon to browse the file system.

If "Display array totals" is enable on the Display Preferences page, a Total line is included which provides a tally of the device statistics, including the average temperature of your devices.

The Array must be Stopped in order to change Array device assignments.

An unRAID array consists of a single Parity disk and a number of Data disks. The Data disks are exclusively used to store user data, and the Parity disk provides the redundancy necessary to recover from any singe disk failure.

Since data is not striped across the array, the Parity disk must be as large, or larger than the largest Data disk. Parity should also be your highest performance drive.

Each Data disk has its own file system and can be exported as a separate share.

Click on the Device name to configure individual device settings and launch certain utilities.

Cache Devices

Colored Status Indicator the significance of the color indicator at the beginning of each line in Cache Devices is as follows:

Normal operation, device is active.

Device is in standby mode (spun-down).

New device.

No device present, position is empty.

Cache is a device, or device pool, outside the unRAID array. It may be exported for network access just like an Array device. Being outside the unRAID array results in significantly faster write access.

There are two ways to configure the Cache:

  1. As a single device, or
  2. As a multi-device pool.

When configured as a single device you may format the device using any supported file system (btrfs, reiserfs, or xfs). This configuration offers the highest performance, but at the cost of no data protection - if the single Cache device fails all data contained on it may be lost.

When configured as a multi-device pool, unRAID OS will automatically select btrfs-raid1 format (for both data and meta-data). btrfs permits any number of devices to be added to the pool and each copy of data is guaranteed to be written to two different devices. Hence the pool can withstand a single-disk failure without losing data.

When User Shares are enabled, user shares may be configured to automatically make use of the Cache in order to speed up writes. A special background process called the mover can be scheduled to run periodically to move user share files off the Cache and onto the Array.

Boot Device

Vital array configuration is maintained on the USB Flash device; for this reason, it must remain plugged in to your server. Click on Flash to see the GUID and registration information, and to configure export settings. Since the USB Flash device is formatted using FAT file system, it may only be exported using SMB protocol.

Unassigned Devices
DeviceIdentificationTempFSSizeOpen filesUsedFreeAuto mountLogScript

Hover your mouse over an any active area on the UD page and a tool tip will show you what clicking that area does.

You can mount USB devices, sata drives, Remote SMB/NFS shares, and Iso Files with unassigned devices. Any devices with the auto mount switch on will be mounted when the array is started. XFS and EXT4 formatted drives are mounted with discard (trim) for SSD drives. All drives and SMB/NFS Mounts are unmounted when the array is stopped on the 'unmounting_disks' event.

If you want to share your drive, you can turn on the Share switch. The default for Remote SMB shares is Public read/write access. Enable SMB Security by user in the Unassigned Devices Settings. NFS shares are exported and access is read/write. The export of NFS devices is enabled in the Unassigned Devices settings. You can also enable a common script that will be executed on every disk mount. In order to share any UD device, sharing needs to be enabled in the UD Settings and the switch turned on to share the particular device.

Additional options are available when you click on the device identification. When the disk is unmounted, the mount name of the device can be changed. A disk can be formatted and an fsck run to check the disk.

UD has a destructive mode that allows deleting disk partitions and formatting disks. If Destructive Mode is not turned on in the UD Settings, you WILL NOT be able to format a disk. Go the the Settings page and scroll to the bottom to see the UD settings. To format a disk:

  • Destructive mode must be enabled.
  • Disk must have all partitions removed. Unmount disk, click on the serial number, and click on all red-X to delete partitions.
  • If the disk has been precelared and shows a grayed 'Format' button, click on the disk serial number, then click on the red-X to delete the preclear status file.
  • Unassigned devices includes scripts that are used for mounting and unmounting devices and SMB mounts. These scripts can be used from the command line if necessary.

    Unassigned devices script:

  • '/usr/local/sbin/rc.unassigned mount auto' - all devices and SMB mounts set to auto mount will be mounted.
  • '/usr/local/sbin/rc.unassigned umount auto' - all devices and SMB mounts set to auto mount will be unmounted.
  • '/usr/local/sbin/rc.unassigned umount all' - all devices and SMB mounts are unmounted in preparation for shutting down the array.
  • Switch the 'Complete' button to change the web page to just show hardware devices. Switch the 'Simple' switch to switch back to the full web display.

    Click on the 'Download Log' button to download a zip file copy of the unassigned devices log.

    Array Operation

    Started, array unprotectedStarted Stop will take the array off-line.
    Yes I want to do this
    Check will start Read-Check of all data disks.
    Spin Down will immediately spin down all disks.
    Spin Up will immediately spin up all disks.
    Clear Statistics will immediately clear all disk statistics.
    Array must be Stopped to Reboot.
    Array must be Stopped to Power down.
    Click to invoke the Mover.

    Colored Status Indicator the significance of the color indicator of the Array is as follows:

    Array is Started and Parity is valid.

    Array is Stopped, Parity is valid.

    Array is Started, but Parity is invalid.

    Array is Stopped, Parity is invalid.