Skip to content

Commit

Permalink
Continue to add content.
Browse files Browse the repository at this point in the history
Signed-off-by: Volker Theile <volker.theile@openmediavault.org>
  • Loading branch information
votdev committed Jan 16, 2018
1 parent 4272675 commit a2ff10f
Show file tree
Hide file tree
Showing 4 changed files with 30 additions and 34 deletions.
39 changes: 18 additions & 21 deletions FAQ.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,10 @@ What is OMV?
OMV is an abbreviation of |omv|


Is OpenMediaVault a fork of FreeNAS?
Is |omv| a fork of FreeNAS?
No

Does OpenMediaVault have drivers for my hardware?
Does |omv| have drivers for my hardware?
All module drivers are provided by the Debian standard kernel of oldstable release 8.9 (aka Jessie). This distribution ships with kernel 3.16 by default. You can optionally install the backport kernel 4.9. If your hardware is supported under Debian Jessie then is supported under OMV.
The Jessie backport kernel 4.9 is the default kernel used by Stretch (Debian 9.3) at the moment, so it provides support for newer hardware.

Expand All @@ -29,49 +29,49 @@ I´ve lost the WebInterface password. How do I reset it?
Simply connect via ssh to your server or login locally on your machine and type in: omv-firstaid . There is an option to reset your password. More information about [[openmediavault:features:omv-firstaid|omv-firstaid]]

Can I backup or restore and existing OpenMediaVaut configuration?
No. You can keep the file :file:`/etc/openmediavault/config.xml` for references purposes if you decide to go for a clean re-install
No. You can keep the file :file:`/etc/openmediavault/config.xml` for references purposes if you decide to go for a clean re-install

What is the default HTTP engine of OpenMediaVault?
What is the default HTTP engine of |omv|?
NGINX. The last version of OMV with Apache was 0.5 Sardoukar.

Can I use Apache as HTTP engine?
You can use it but is not supported. Eventually every openmediavault package upgrade will activate NGINX again leaving you with a broken webUI. You can run a parallel Apache instance to Nginx just make sure the ports are different otherwise your OMV webUI will not work.
You can use it but is not supported. Eventually every |omv| package upgrade will activate NGINX again leaving you with a broken webUI. You can run a parallel Apache instance to Nginx just make sure the ports are different otherwise your OMV webUI will not work.

How can use the default http engine to hold my own web page?
Do not modify OpenMediaVault default nginx files. Read `Nginx <http://nginx.org/en/docs/|documentation>`_. You can place your website configurations at :file:`/etc/nginx/sites-available,enabled`.
Do not modify |omv| default nginx files. Read `Nginx <http://nginx.org/en/docs/|documentation>`_. You can place your website configurations at :file:`/etc/nginx/sites-available,enabled`.

Why does the system rewrites a configuration file(s) that I have manually edited?
OMV takes full control of some system services. This services include monit, ntp, samba, network, proftpd, nginx, php5-fpm, etc.

How can I modify an internal value of some service OpenMediaVault has control of?
How can I modify an internal value of some service |omv| has control of?
Read :doc:`here <various/advancedsettings>` for advanced configurations.

How can I modify or add a network configuration of :file:`/etc/network/interfaces` with some custom options the webUI does not provide?
The interfaces file is controlled by OpenMediaVault. To add network interfaces that are not configurable through the webGUI or other options not present, you need to use :doc:`advanced settings <various/advancedsettings>`
The interfaces file is controlled by |omv|. To add network interfaces that are not configurable through the webGUI or other options not present, you need to use :doc:`advanced settings <various/advancedsettings>`.

Why my disks mount paths have a long alphanumeric number?
The long number is called UUID, it is used by fstab to mount disks. This number is unique per filesystem (or at least unlikely possible that another filesystem comes with an identical one). This helps maintaing the mount points. The old linux way (sda1, sdb1, etc) is not guaranteed that /sda1 is the same disk on next reboot. If you have trouble identiying them in terminal, you can always create a pool with symlinks to each file system with easy to remember names.
The long number is called UUID, it is used by fstab to mount disks. This number is unique per filesystem (or at least unlikely possible that another filesystem comes with an identical one). This helps maintaing the mount points. The old linux way (sda1, sdb1, etc) is not guaranteed that /sda1 is the same disk on next reboot. If you have trouble identiying them in terminal, you can always create a pool with symlinks to each file system with easy to remember names.

This behaviour has been deprecated now in current omv releases including stable (Jessie). The default creation of mount paths is documented `here <https://github.com/openmediavault/openmediavault/blob/20ec529737e6eca2e1f98d0b3d1ade16a3c338e1/deb/openmediavault/usr/share/openmediavault/engined/rpc/filesystemmgmt.inc#L823-L833>`_
This behaviour has been deprecated now in current omv releases including stable (Jessie). The default creation of mount paths is documented `here <https://github.com/openmediavault/openmediavault/blob/20ec529737e6eca2e1f98d0b3d1ade16a3c338e1/deb/openmediavault/usr/share/openmediavault/engined/rpc/filesystemmgmt.inc#L823-L833>`_.

I don't have a data disk, and I want to use my OS disk for storing data?
The default behaviour of OpenMediaVault is to act as NAS server, that means OS files are separated from data disks.
The default behaviour of |omv| is to act as NAS server, that means OS files are separated from data disks.

You can use partitions in the same disk you use for OS and the system will recognise the partitions for formatting, mounting and to create shared folders.
You can use partitions in the same disk you use for OS and the system will recognise the partitions for formatting, mounting and to create shared folders.

The current installer does not provide access to the partition manager, so you need to use a plain Debian iso then install OpenMediaVault on top and acommodate the partitions, or resize the partition after installing using Gparted or SystemRescueCd.
The current installer does not provide access to the partition manager, so you need to use a plain Debian iso then install |omv| on top and acommodate the partitions, or resize the partition after installing using Gparted or SystemRescueCd.

Can I install OpenMediaVault on top a running Debian system?
Can I install |omv| on top a running Debian system?
Yes, but is not recommended that the running OS has a desktop environment installed.

Which are the files that should not be edited by the user?
There are several services that OpenMediaVault takes control of, The recommended list is here.
There are several services that |omv| takes control of, The recommended list is here.

What is the permissions/ownership of folders in OMV created by shared folders?
The default is folders in ''2775'' mode, with ''root:users'' ownership. This means all users created in the webUI can read, write to folders created by the system in the data drives using the default.

Why are my filesystems mounted as noexec?
This is a security measure to avoid the placement of malicious scripts in the shared folders. This will prevent any script execution in those paths, including compiling packages and binaries.
This is a security measure to avoid the placement of malicious scripts in the shared folders. This will prevent any script execution in those paths, including compiling packages and binaries.

If you need to remove the noexc flag, you need to use advanced settings.

Expand All @@ -81,11 +81,8 @@ I need to delete a shared folder, why the delete button is greyed/disabled?
What is the :file:`omv-mkconf` command for?
:file:`omv-mkconf` is a terminal console command that is used by the backend of OMV to pipe directives and values to service configuration files. The arguments that omv-mkconf accepts are related to the name of the service it configures. Type ''omv-mkconf'' in terminal, press TAB key, and the terminal will display all available arguments.

I want to experiment with OpenMediaVault or make changes to the code
As a true open source system you can do whatever you want with it. The recommendation is you don't do it in your home appliance server to avoid breaking the web interface. The best thing to do is to use a Virtual Machine. In [[http://sourceforge.net/projects/openmediavault/files/vm/VirtualBox%20images/|Sourceforge]] you can find a preconfigured OpenMediaVault virtual disk ready to launch.
I want to experiment with |omv| or make changes to the code
As a true open source system you can do whatever you want with it. The recommendation is you don't do it in your home appliance server to avoid breaking the web interface. The best thing to do is to use a Virtual Machine. In `Sourceforge <http://sourceforge.net/projects/openmediavault/files/vm/VirtualBox%20images/>`_ you can find a preconfigured OpenMediaVault virtual disk ready to launch.

What is the ''omv-update'' and ''omv-release-upgrade'' do?
Information about those commands are in the update/upgrade section



8 changes: 3 additions & 5 deletions plugins.rst
Original file line number Diff line number Diff line change
@@ -1,12 +1,10 @@
Plugins
=============
=======

The following is the list of official plugins by |omv|.

* **CLAMAV**: Provides antivirus scan for folders

* **ClamAV**: Provides antivirus scan for folders
* **Route**: Add static routes

* **iSCSITarget**: Control panel for sharing block devices in the network.
* **Forked-daap**: Provides a daap protocol music server
* **LDAP**: Integrates the user management panel with a LDAP server
Expand All @@ -16,4 +14,4 @@ The following is the list of official plugins by |omv|.
* **NUT**: Controlling and configuring UPS. The driver support is based on NUT
* **USB Backup**: Backup internal data to external disks on scheduled basis or on plug drive event (via UDEV)

An overview of the third party plugin list can be found here
An overview of the third party plugin list can be found `here <http://www.omv-extras.org/>`_.
5 changes: 1 addition & 4 deletions releases.rst
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@

Releases
=============
========


.. csv-table:: |omv| historical releases
Expand All @@ -15,5 +14,3 @@ Releases
2.0,Stoneburner,Debian 7,EOL,Jun 2015
3.0,Erasmus,Debian 8, Current, Jun 2016
4.0,Arrakis,Debian 9,In Development,Q2 2018 (Estimate)


12 changes: 8 additions & 4 deletions support.rst
Original file line number Diff line number Diff line change
@@ -1,12 +1,16 @@
Support
=============
=======

At present there are two ways of getting support, both of them are done by the community. The current support channels are:
At present there are two ways of getting support, both of them are done by the
community. The current support channels are:

|omv| `forums <http://forums.openmediavault.org/>`_.

There is also the official IRC channel more info :doc:`here <various/irc>`

Since last year there is also a discord group. You can get access by clicking `here <https://discord.gg/ZjknBdg>`_.
Since last year there is also a discord group. You can get access by clicking
`here <https://discord.gg/ZjknBdg>`_.

Make sure you provide as much information as you can when posting in the forum and describing your problem. If you have an error in the webUI make sure you take screenshots of the backtrace, to identify properly what's failing.
Make sure you provide as much information as you can when posting in the forum
and describing your problem. If you have an error in the webUI make sure you
take screenshots of the backtrace, to identify properly what's failing.

0 comments on commit a2ff10f

Please sign in to comment.