From c7c3f125976b18ea3cdcf91e4e7e9718a30a1f77 Mon Sep 17 00:00:00 2001 From: Prashanth Pai Date: Mon, 24 Sep 2018 15:17:55 +0530 Subject: doc: Update install and troubleshoot guide * Mention that bindings have been tested with Python 3.x * Remove section about troubleshotting logging as it is disabled by default now. Change-Id: If7a4e398734efec2cc68e6abaec4510c554bff9e Signed-off-by: Prashanth Pai --- doc/install.rst | 4 ++-- doc/troubleshooting.rst | 17 +++-------------- 2 files changed, 5 insertions(+), 16 deletions(-) diff --git a/doc/install.rst b/doc/install.rst index b9cba12..25f14fe 100644 --- a/doc/install.rst +++ b/doc/install.rst @@ -5,7 +5,7 @@ Install libgfapi-python from yum/dnf repo: .. code-block:: console - $ sudo yum install python-glusterfs-api + $ sudo dnf install python-glusterfs-api OR @@ -27,4 +27,4 @@ Install libgfapi-python from source: .. note:: libgfapi-python bindings has been tested only against **Linux x86-64** and - Python versions **2.6** and **2.7** + Python versions **2.7** and **>=3.4**. diff --git a/doc/troubleshooting.rst b/doc/troubleshooting.rst index a183e95..6667c08 100644 --- a/doc/troubleshooting.rst +++ b/doc/troubleshooting.rst @@ -1,13 +1,13 @@ Troubleshooting =============== -Mount GlusterFS volume as non-root user ---------------------------------------- +Mount GlusterFS volume as non-root user (Glusterfs <3.7.3) +---------------------------------------------------------- .. 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 + 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 @@ -35,14 +35,3 @@ Restart glusterd service: 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. -- cgit