diff options
Diffstat (limited to 'doc/troubleshooting.rst')
-rw-r--r-- | doc/troubleshooting.rst | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/doc/troubleshooting.rst b/doc/troubleshooting.rst new file mode 100644 index 0000000..a183e95 --- /dev/null +++ b/doc/troubleshooting.rst @@ -0,0 +1,48 @@ +Troubleshooting +=============== + +Mount GlusterFS volume as non-root user +--------------------------------------- + +.. versionchanged:: 3.7.3 + GlusterFS versions prior to version **3.7.3** requires the following + additional steps to allow non-root users to mount the volume over libgfapi. + Following these steps is not required for recent versions i.e >= 3.7.3 + +One can follow the following steps to allow a non-root user to virtual mount +a GlusterFS volume over libgfapi. This requires a configuration change which +enables GlusterFS server to accept client connections from non-priveledged +ports. + +.. code-block:: console + + # gluster volume set <volname> server.allow-insecure on + # gluster volume stop <volname> + # gluster volume start <volname> + +Edit `/etc/glusterfs/glusterd.vol` or `/usr/local/etc/glusterfs/glusterd.vol` +and set: + +.. code-block:: aconf + + option rpc-auth-allow-insecure on + +Restart glusterd service: + +.. code-block:: console + + # service glusterd restart + +Further, use `chown` and/or `chmod` commands to change permissions on mount +point or required directories to allow non-root access to appropriate users. + +If you do not provide a custom location for log file, you might see an error +similar to the following during mount. + +.. code-block:: python + + LibgfapiException: glfs_set_logging(None, 7) failed: Permission denied + +In such case, provide a log file path that has appropriate write permissions +or change permission of default log location i.e `/var/log/glusterfs` or +`/usr/local/var/log/glusterfs` accordingly. |