Skip to content

Commit

Permalink
Replace 'web interface' with '|webui|'.
Browse files Browse the repository at this point in the history
  • Loading branch information
votdev committed Jan 17, 2018
1 parent d376c02 commit 5c950da
Showing 1 changed file with 6 additions and 8 deletions.
14 changes: 6 additions & 8 deletions various/filesystems.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ Filesystems


Overview
The filesystem section of the |omv| web interface is where you integrate disk volumes to be part of the server. Drives/filesystems that are not mounted through the web interface are not registered in the backend database, this means you cannot use volumes to create shared folders if they were not mounted properly. *This is very important*, users that come from an existing debian installation with filesystems already present in their fstab file will see that no volumes will be available for creating shared folders even if they are mounted. For the disks to be properly integrated is better that you delete all fstab lines execept rootfs and swap, reboot your server and start mounting the disks through the web interface.
The filesystem section of the |omv| |webui| is where you integrate disk volumes to be part of the server. Drives/filesystems that are not mounted through the |webui| are not registered in the backend database, this means you cannot use volumes to create shared folders if they were not mounted properly. *This is very important*, users that come from an existing debian installation with filesystems already present in their fstab file will see that no volumes will be available for creating shared folders even if they are mounted. For the disks to be properly integrated is better that you delete all fstab lines execept rootfs and swap, reboot your server and start mounting the disks through the |webui|.

The mount process acts like many other services in |omv|, first it writes a database entry in config.xml, this entry contains essential information:

Expand All @@ -12,7 +12,7 @@ Overview
- Target mount directory <dir>
- Filesystem options <opts>
- Filesystem type (ext3, ext4, etc) <type>

You can inspect a mntent entry in config.xml it should look like this:

.. code-block:: xml
Expand All @@ -28,7 +28,7 @@ Overview
<hidden>0</hidden>
</mntent>
With the mntent entry in config.xml, mkconf fstab script writes the appropiate line in ``/etc/fstab``. You can indentify entries in ``/etc/fstab`` created by the web interface by looking at «openmediavault» tags. Is important to mention to not alter the information in bewteen these tags. If you delete or modify a fstab option (noexec or quota for example) the next time you mount a new disk into the server, the mkconf will pipe the original value there again. If you need persistent change read :doc:`here </various/fs_env_vars>`. Finally the backend will proceed to mount the filesystem. After this the volume is ready for creating shared folders.
With the mntent entry in config.xml, mkconf fstab script writes the appropiate line in ``/etc/fstab``. You can indentify entries in ``/etc/fstab`` created by the |webui| by looking at «openmediavault» tags. Is important to mention to not alter the information in bewteen these tags. If you delete or modify a fstab option (noexec or quota for example) the next time you mount a new disk into the server, the mkconf will pipe the original value there again. If you need persistent change read :doc:`here </various/fs_env_vars>`. Finally the backend will proceed to mount the filesystem. After this the volume is ready for creating shared folders.

Resize
The resize button is used for exanding filesystems. This can ocurr if you decide to resize a disk partition or you have grown a RAID array.
Expand All @@ -45,7 +45,7 @@ Unmount
Disabled until you have deleted all shared folders asociated with that volume. Unmount will remove the entry from config.xml and /etc/fstab.

Supported Filesystems
|omv| supports the following filesystems that can be mounted through the web interface:
|omv| supports the following filesystems that can be mounted through the |webui|:


.. csv-table:: |omv| supported filesystems
Expand All @@ -65,11 +65,9 @@ Supported Filesystems

.. note::
BTRFS
- Creating multi device filesystems is not supported in the web interface. However you can add devices to your btrfs array in CLI and it will not present any problems.
- Creating multi device filesystems is not supported in the |webui|. However you can add devices to your btrfs array in CLI and it will not present any problems.
- No extra features of btrfs are available in the webui like snapshots or subvolumes. Additional subvolumes will have either be mounted outside of the OMV fstab tags or manually add mntent entries to config.xml or use advanced configuration

.. note::
ZFS
Support for zfs is available through `ZoL <http://zfsonlinux.org/>`_ an uses a third party plugin provided by omv-extras. The development of the plugin was done in conjunction with core of |omv|, so new code was added in the filesystem backend to improve support for zfs. The plugin registers datasets and pools in the internal database so you can create shared folders for zfs volumes. The creation of zvols is automatically recognized by |omv| so you can format them and mount them in the web interface. The iscsiplugin can also use these zvols block devices to export LUN's.


Support for zfs is available through `ZoL <http://zfsonlinux.org/>`_ an uses a third party plugin provided by omv-extras. The development of the plugin was done in conjunction with core of |omv|, so new code was added in the filesystem backend to improve support for zfs. The plugin registers datasets and pools in the internal database so you can create shared folders for zfs volumes. The creation of zvols is automatically recognized by |omv| so you can format them and mount them in the |webui|. The iscsiplugin can also use these zvols block devices to export LUN's.

0 comments on commit 5c950da

Please sign in to comment.