(Sorry for the inconvenience)
The PC-BSD® Disk Manager can be used to manage ZFS pools and datasets as well as the disks attached to the system. To access this utility, use Control Panel → Disk Manager or type pc-su pc-zmanager from within an xterm. You will need to input your password in order to access this utility.
Managing ZFS Datasets
As seen in the example in Figure 8.13a, the utility will open in the “ZFS Filesystems” tab and will display the system's ZFS datasets, the amount of space available to each dataset, and the amount of space each dataset is using.
Figure 8.13a: Viewing the System's ZFS Datasets
The name of the pool in this example is tank. If the system has multiple pools, click the green arrow to select the desired pool.
If you right-click the pool name, the following options are available:
- Create new dataset: Figure 8.13b shows the options that are available when you create a new dataset.
- Create a clone dataset:
- Take a snapshot: will prompt for the name of the snapshot. The field is pink to remind you to type the snapshot name in immediately after the pool name and @ symbol. In this example, tank@ will be displayed in the name field. An example snapshot name could be tank@snapshot1 or tank@201312031353 to denote the date and time the snapshot was created. The snapshot creation will be instantaneous and the new snapshot will be added to the list of datasets and will have a camera icon. Click the entry for the snapshot entry if you wish to rename it, clone it, destroy it, rollback the system to that point in time, or edit its properties. If you forget when you made the snapshot, pick "Edit properties" from the snapshot's right-click menu as it will show its "creation" property.
- Edit properties: allows you modify the ZFS properties for the pool, as seen in the example shown in Figure 8.13c. The available options depend upon the property being modified. The options which are read-only will have a red minus sign icon next to them. ZFS options are described in man zfs and you should not change any options unless you are familiar with the ramifications of doing so.
Figure 8.13b: Creating a New ZFS Dataset
When creating a new dataset, the following options are available. Again, these options are described in man zfs and you should not change any options unless you are familiar with the ramifications of doing so.
- Name: this field is pink as a reminder to type in the dataset name immediately after the trailing "/" of the displayed pool name.
- Prevent auto mount: if the box is checked, the dataset will not be mounted at boot time and must instead be manually mounted as needed.
- Mountpoint: choices are none, legacy, or [path].
- Force UTF-8 only: if checked, you will not be able to save any filenames that are not in the UTF-8 character code set.
- Unicode normalization: if checked, indicate whether unicode normalization should occur when comparing filenames, and if so, which normalization algorithm to use. Choices are none, formD, or formKCF.
- Copies: if checked, indicates the number of copies (0 to 3) of data to store in the dataset. The copies are in addition to any redundancy and are stored on different disks when possible.
- Deduplication: enables deduplication. Do not enable this option if the system has less than the minimum recommended 5GB of RAM per TB of storage to be deduplicated.
- Compression: if checked and a compression algorithm is selected in the drop-down menu, data will automatically be compressed as it is written and uncompressed as it is read. The algorithm determines the amount and speed of compression, where typically increased compression results in decreased speed. The zle algorithm is recommended as it provides very good compression at near real-time speed.
Figure 8.13c: Editing the Pool's ZFS Properties
Managing the ZFS Pool
To view the status of the ZFS pools and the disk(s) in the pool, click the "ZFS Pools" tab. In the example, shown in Figure 8.13d, the ZFS pool named tank was created from one disk. The state of "Online" indicates that the pool is healthy.
Figure 8.13d: Viewing the Status of the ZFS Pool