docs_in_draft:zfs [omv-extras.org]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
<html><center><span style="color:#b7620b;font-size:300%;">Incomplete Draft Document</span></center></html>
<html><center><span style="color:#b7620b;font-size:300%;">Not for public use</span></center></html>
{{ :underconstruction.jpg?400 |}}

\\
<html><center><strong>ZFS Plugin For OMV6</strong></center></html>

{{ :omvextras_logo4.jpg?400 |}}

====== ZFS Plugin For OMV7 ======
\\
\\

===== Summary =====

The ZFS plugin makes it easy for users to take advantage of ZFS, with an easy installation and making ZFS's more important features available within Openmediavault's GUI.  

==== What is ZFS? ====

ZFS (the Zettabyte File System) is the oldest of the "Copy on Write" file system.  It has been under continuous development since it introduced, with Solaris, in 2001.

The more important among ZFS' several features are as follows:

  *     Pooled storage (Built in logical volume management)
  *     **Snapshots**  (Creates file, folder, filesystem and volume histories.)
  *     Data **integrity verification** and, with zmirrors or with activation of the 2copies feature, **automatic repair**
  *     RAID-Z, Zmirror and other implementations of ZFS are the functional equivalents to legacy RAID, without legacy RAID drawbacks such as the "write hole" and silent data corruption.

Data integrity and repair, and data restoration (VIA snapshots) are among ZFS' more important features.

More detail information on capabilities and limits is available -> [[https://www.howtogeek.com/175159/an-introduction-to-the-z-file-system-zfs-for-linux/|here]].

<html>
<body>
  <table width="100%" border="0">
    <tr>
      <td colspan="2" style="background-color:#69A5FF;height:30px;">
        <strong><span style="color:#FFFFFF;font-size:110%;">&#160; Note</span></strong>
      </td>
    </tr>
    <tr>
      <td style="background-color:#E6FEFF;height:25px;width:380px;">
        While this external resource is informative, creating a ZFS pool on the command line, in accordance with external references, is not recommended.  This document will walk users through a ZFS installation process that is compatible with the ZFS plugin and Openmediavault. 
    </tr>
  </table>
</body>
</html>

===== Prerequisites =====

  * [[https://wiki.omv-extras.org/doku.php?id=misc_docs:omv_extras|OMV-Extras]] must be pre-installed.
  * [[https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html|PuTTY]] is an SSH client that will allow users to connect to their SBC, from a Windows client, and get on the command line.  PuTTY is installable on a Windows client.  


===== Installation =====

To get started with ZFS and to create an easy installation path to the most stable server possible, some preliminary setup, settings and adjustments are recommended.

==== Disable Backports: ====

=== General: ===
Linux backport kernels are released quickly to support the "latest and greatest - cutting edge hardware".  As a consequence the "userland" (software supported by the latest backport kernels) may not be complete.  ZFS, at times, may not be in the software repo's of backports kernels, immediately after their release.  This may result in a kernel upgrade where a server's ZFS pool(s) may disappear.  There are remedies for this but an ounce of prevention is worth a pound of cure. To avoid broken package issues it's best to use the mainline kernel, by disabling "backports". \\
\\
==== Install the Proxmox kernel: ====
\\
=== General: ===
Due to licensing conflicts, Debian does not build ZFS kernel modules into any of their kernels by default.  This may result in an extensive build process, during the installation of ZFS, which is prone to errors.  These issues can be avoided by using the Proxmox-Debian kernel which has ZFS kernel modules preinstalled by default.  As Proxmox kernel upgrades become available and are performed, the repo's for the Proxmox kernel will always have the required packages to support ZFS.  Further, since the Proxmox kernel is financially supported by the Proxmox project, the kernel is exhaustively tested before it's made available.  In the bottom line, using the Proxmox kernel decreases the possibility of an installation error while increasing overall server reliability and providing .   a default.     as   However, the Proxmox kernel



===== Configuration =====




===== Source Code =====

-> [[https://github.com/OpenMediaVault-Plugin-Developers/openmediavault-zfs|Source Code]]