Both sides previous revision Previous revision Next revision | Previous revision Next revisionBoth sides next revision |
docs_in_draft:utilities_bckup_maint [2022/12/13 00:12] – [Openmediavault’s Plugins] crashtest | docs_in_draft:utilities_bckup_maint [2022/12/13 00:42] – [Rsync Drive Copy Errors] crashtest |
---|
Still more were created by openmediavault plugin developers, such as Remote Mount, the flash-memory plug-in, backup plugins, and more.\\ | Still more were created by openmediavault plugin developers, such as Remote Mount, the flash-memory plug-in, backup plugins, and more.\\ |
\\ | \\ |
Many plugins are integrations of third party packages such as [[http://www.snapraid.it/|SNAPRAID]], [[https://github.com/trapexit/mergerfs#name|MergerFS]], etc. While questions or issues regarding the **integration of plugin’s**, into openmediavault, are of interest to openmediavault’s developers, questions regarding the **operation** of the base software package are best directed to the application’s supporting web site.\\ | Many plugins are integrations of third party packages such as [[http://www.snapraid.it/|SNAPRAID]], [[https://github.com/trapexit/mergerfs#name|MergerFS]], etc. While questions or issues regarding the **integration of plugin’s**, into openmediavault, are of interest to openmediavault’s developers, questions regarding the **operation** of the base software package are best directed to an external application’s supporting web site.\\ |
| |
==== Dockers - General ==== | ==== Dockers - General ==== |
| |
While Dockers are an avenue toward adding extensive functionality to openmediavault, they are an advanced topic that may prove to be frustrating for beginners. To get started, beginners should consider installing Docker, then Portainer, as found under System, OMV-Extras. While it’s command line oriented, this [[https://docker-curriculum.com/|Docker Tutorial]] is very helpful for understanding basic concepts. User authored Docker - How To’s can be found on the openmediavault forum in the [[https://forum.openmediavault.org/index.php?board/29-guides/|Guides section]]. In addition, there’s a forum section dedicated to [[https://forum.openmediavault.org/index.php?board/39-docker/|Docker issues and questions]]. | While Dockers are an avenue toward adding //extensive// functionality to openmediavault, they are an advanced topic that may prove to be frustrating for beginners. To get started, beginners should consider installing Docker, then Portainer, as found under System, OMV-Extras. While it’s command line oriented, this [[https://docker-curriculum.com/|Docker Tutorial]] is very helpful for understanding basic concepts. User authored Docker - How To’s can be found on the openmediavault forum in the [[https://forum.openmediavault.org/index.php?board/29-guides/|Guides section]]. In addition, there’s a forum section dedicated to [[https://forum.openmediavault.org/index.php?board/39-docker/|Docker issues and questions]]. |
| |
=== So, What is a “Docker”? === | === So, What is a “Docker”? === |
[[https://docs.portainer.io/user/home|Portainer]] and [[https://yacht.sh/|Yacht]] are Docker control utilities that provide a GUI for storing Docker images and configuring the various parameters associated with a Docker Container.\\ | [[https://docs.portainer.io/user/home|Portainer]] and [[https://yacht.sh/|Yacht]] are Docker control utilities that provide a GUI for storing Docker images and configuring the various parameters associated with a Docker Container.\\ |
\\ | \\ |
Portainer and Yacht have their individual strengths and weaknesses. While users are encouraged to investigate both but, for the purposes of this document, a walk through of installing Portainer is provided.\\ | Portainer and Yacht have their individual strengths and weaknesses. Users are encouraged to investigate both but, for the purposes of this document, a walk through for installing Portainer is provided.\\ |
\\ | \\ |
---- | ---- |
Under **System**, **OMV-Extras**, **Portainer**: | Under **System**, **OMV-Extras**, **Portainer**: |
| |
<html><center><b>Click the **install** button.</b></center></html> | <html><center>Click the <b>install</b> button.</center></html> |
| |
{{ :docs_in_draft:omv6-maint-25.jpg?600 |}} | {{ :docs_in_draft:omv6-maint-25.jpg?600 |}} |
With a successful install the **Status** line will report; **Up X seconds** (or minutes, etc.)\\ | With a successful install the **Status** line will report; **Up X seconds** (or minutes, etc.)\\ |
\\ | \\ |
----\\\ | ---- |
| \\ |
Click on **Open Web**.\\ | Click on **Open Web**.\\ |
\\ | \\ |
<tr> | <tr> |
<td style="background-color:#E6FEFF;height:25px;width:380px;"> | <td style="background-color:#E6FEFF;height:25px;width:380px;"> |
If the portainer web page doesn't open in a new browser tab, note that some browsers may block "popups". Configure your web browser to allow your server to create new popup windows. | Some browsers may block "popups". If the portainer web page doesn't open in a new browser tab, configure your web browser to allow your server to create new popup windows. |
</tr> | </tr> |
</table> | </table> |
When a password is entered and confirmed, the Portainer page will change to **Quick Setup**.\\ | When a password is entered and confirmed, the Portainer page will change to **Quick Setup**.\\ |
\\ | \\ |
<html><center>From the left hand menu, click on the "<b>Home</b>" bar. Then on the right, under <b>Environments</b>, click on "<b>Local</b>".</center></html> | <html><center>From the left hand menu, click on the "<b>Home</b>" bar. Then, on the right under <b>Environments</b>, click on "<b>Local</b>".</center></html> |
\\ | \\ |
| |
**First:**\\ | **First:**\\ |
\\ | \\ |
When installing a Docker, for the greatest chance of success, it is suggested that users follow the guidance provided in Guides Section of the openmediavault forum.\\ | When installing a Docker, for the greatest chance of success, it is suggested that users follow the guidance provided in [[https://forum.openmediavault.org/index.php?board/29-guides/|Guides Section]] of the openmediavault forum.\\ |
\\ | \\ |
**Second:**\\ | **Second:**\\ |
**Third:**\\ | **Third:**\\ |
\\ | \\ |
To increase the chance of success, when attempting to install a Docker without a guide, look for the more popular Dockers with the highest number of “pulls” on the Docker Hub. (hub.docker.com) There are good reasons why these Dockers are broadly popular – they tend to work.\\ | To increase the chance of success, when attempting to install a Docker without a guide, look for the more popular Dockers with the highest number of “pulls” on the Docker Hub. [[https://hub.docker.com/search/type=image&image_filter=official?q=|(hub.docker.com)]] There are good reasons why these Dockers are broadly popular – they tend to work.\\ |
\\ | \\ |
**Forth:**\\ | **Forth:**\\ |
First search the forum. In many cases, user problems can be resolved with a few searches and a bit of reading. Second, look at the dates of posts and the version of openmediavault referenced. Posts that are 3 or more years old may not apply to the current openmediavault version.\\ | First search the forum. In many cases, user problems can be resolved with a few searches and a bit of reading. Second, look at the dates of posts and the version of openmediavault referenced. Posts that are 3 or more years old may not apply to the current openmediavault version.\\ |
\\ | \\ |
If posting a problem on the forum, start at the forum index , and look for the category that looks to be appropriate for the post. Along with an explanation of the the issue, the openmediavault version, the appropriate logs and command line output, if known, and the hardware platform in use are the absolute minimums required. Realize that, without information, even the most experienced users, Moderators, and / or Developers will not be able to provide assistance.\\ | If posting a problem on the forum, start at the [[https://forum.openmediavault.org/|forum index]], and look for the category that looks to be appropriate for the post. Along with an explanation of the the issue, the openmediavault version, the appropriate logs and command line output, if known, and the hardware platform in use are the absolute minimums required. Realize that, without information, even the most experienced users, Moderators, and / or Developers will not be able to provide assistance.\\ |
\\ | \\ |
* Ask the right questions. For beginners, this can be deceptively difficult. There’s some “straight forward” guidance on this topic here → [[http://www.catb.org/~esr/faqs/smart-questions.html#idm368|Ask the right questions]].\\ | * Ask the right questions. For beginners, this can be deceptively difficult. There’s some “straight forward” guidance on this topic here → [[http://www.catb.org/~esr/faqs/smart-questions.html#idm368|Ask the right questions]].\\ |
**Solution 1:**\\ | **Solution 1:**\\ |
\\ | \\ |
Turn the quota service off. | Turn the quota service off.\\ |
\\ | \\ |
<html><tt><span style="color:#fa502c>"sudo /etc/init.d/quota stop</span></tt></html> | <html><tt><span style="color:#fa502c">sudo /etc/init.d/quota stop</span></tt></html>\\ |
\\ | \\ |
(In the following examples, substitute the appropriate UUID's for the source and destination drives in the Rsycn command line.) | (In the following examples, substitute the appropriate UUID's for the source and destination drives in the Rsycn command line.)\\ |
\\ | \\ |
<html><tt><span style="color:#fa502c">sudo quotaoff --user --group /srv/dev-disk-by-uuid-3bdb3de5-218b-4930-bb61-05cda64f8c6b</span></tt></html> | <html><tt><span style="color:#fa502c">sudo quotaoff --user --group /srv/dev-disk-by-uuid-3bdb3de5-218b-4930-bb61-05cda64f8c6b</span></tt></html> |
''''\\ | ''''\\ |
\\ | \\ |
Optionally, delete the files <html><tt><span style="color:#fa502c"aquota.group</span></tt></html> and <html><tt><span style="color:#fa502c"aquota.user</span></tt></html> from the source and destination drives.\\ | Optionally, delete the files <html><tt><span style="color:#fa502c">aquota.group</span></tt></html> and <html><tt><span style="color:#fa502c">aquota.user</span></tt></html> from the source and destination drives.\\ |
\\ | \\ |
**Solution 2:**\\ | **Solution 2:**\\ |
A full command line example: | A full command line example: |
| |
<html><tt><span style="color:#fa502c">rsync -av --delete --exclude='aquota.group' --exclude='aquota.user' /source-drive/ /destination-drive/</span></tt></html> | <html><tt><span style="color:#fa502c">rsync -av --delete --exclude='aquota.user' --exclude='aquota.group' /source-drive/ /destination-drive/</span></tt></html> |
| |
---- | ---- |