add learnings from issue #1000 (#85)

troubleshooting.rst

@@ -2,37 +2,50 @@ Troubleshooting
 ===============
 
 
-* **Web interface has missing fields and/or items showing that have been uninstalled.**
+* **|omv| |webui| has missing fields and/or items showing that have been uninstalled.**
 
     Clear your browser cache.
 
-* **I mounted the drive using the command line or GUI tool and I can't pick that drive in the shared folder device dropdown.**
+* **The |omv| |webui| keeps rejecting my admin/user password.**
 
-    Never mount a drive with anything other than the |omv| |webui|. This creates the necessary database entries to populate the device dropdown.
+    If the password is correct then this is most likely caused by the rootfs partition being full. This command can help track which folders are the biggest :command:`df -hx --max-depth=1 /`
 
-* **I only see a few items in the web interface like the user section of Access Rights Management.**
+* **I have problem accessing the  |omv| |webui| with Firefox.**
+
+    Try the solution mentioned in the `Sencha ExtJS forum <https://www.sencha.com/forum/showthread.php?310206-ExtJ-6-doest-not-work-on-Linux-with-Firefox-45&p=1155250&viewfull=1#post1155250>`_ or the `Mozilla bugtracker <https://bugzilla.mozilla.org/show_bug.cgi?id=1301327>`_.
+
+* **I only see a few items in the  |omv| |webui| interface like the user section of Access Rights Management.**
 
     You did not login as the admin user. This is the only user that can access everything.
 
 * **I get an error every time I post in the forum especially if it is a long post and/or has links to external pages.**
 
     The error is deceiving. Please don't keep trying to post. The spam filter has flagged your post and it will need to be approved. Please be patient.
 
+* **I mounted the drive using the command line or GUI tool and I can't pick that drive in the shared folder device dropdown.**
+
+    Never mount a drive with anything other than the |omv| |webui|. This creates the necessary database entries to populate the device dropdown.
+
 * **Samba is slow.**
 
-    Read these threads - `Tuning Samba for more speed <http://forum.openmediavault.org/index.php/Thread/12986-Tunning-Samba-for-more-speed/>`_ and `Tuning Samba for more speed 2 <http://forum.openmediavault.org/index.php/Thread/14615-Tuning-Samba-for-more-speed-2//>`_
+    Read these threads 
+
+	- `read/write performance for SMB shares hosted on RPi4 <https://forum.openmediavault.org/index.php?thread/37285-rpi4-read-write-performance-for-smb-shares/&postID=260232#post260232>`_ 
+	- `Tuning Samba for more speed <http://forum.openmediavault.org/index.php/Thread/12986-Tunning-Samba-for-more-speed/>`_ (note: written for OMV 2.x)
+	- `Tuning Samba for more speed 2 <http://forum.openmediavault.org/index.php/Thread/14615-Tuning-Samba-for-more-speed-2//>`_ (note: written for OMV 2.x)
 
 * **Samba share password is refused from Windows 10.**
 
     To fix the problem you need to change the `Network Security LAN Manager authentication level <https://social.technet.microsoft.com/Forums/windows/en-US/8249ad4c-69aa-41ba-8863-8ecd7a7a4d27/samba-share-password-refused>`_.
 
-* **The |webui| keeps rejecting my admin/user password.**
 
-    If the password is correct then this is most likely caused by the rootfs partition being full. This command can help track which folders are the biggest :command:`df -hx --max-depth=1 /`
-
-* **I have problem accessing the web interface with Firefox.**
+* **How to troubleshoot an error caused by an "Option" parameter passed to a plug-in**
 
-    Try the solution mentioned in the `Sencha ExtJS forum <https://www.sencha.com/forum/showthread.php?310206-ExtJ-6-doest-not-work-on-Linux-with-Firefox-45&p=1155250&viewfull=1#post1155250>`_ or the `Mozilla bugtracker <https://bugzilla.mozilla.org/show_bug.cgi?id=1301327>`_.
+    To find the root cause, run the faulty systemd unit file yourself by executing:
+	# 
+	systemd restart <plug-in-daemon>
+
+	If output of <plug-in> is now more vebose, then you will get a hint on STDOUT. If not, then you need to run journalctl -f in parallel to get the syslog output. Admittedly, not really novice friendly, but it's really not possible to do it any other way. OMV always tries to be as error/debug friendly as possible; by default. 
 
 * **I am using JMicron drive enclosures and some of my drives are not appearing.**