path: root/
diff options
authorAkarsha <>2018-09-07 17:09:05 +0530
committerVijay Avuthu <>2018-09-12 06:21:18 +0000
commite6e53b5321b8e991eb23bb9d9d6626e7ac364e1e (patch)
treeeba5e8e6cbec6b2b7000d023e6685d1c1bc706f6 /
parent4c33c68e20a3b84e0e19a4a6c5cce6a9766f1042 (diff)
Modified existing doc
Change-Id: I84360dd73a951db5db6a574fb10ada57a1e7e1ad Signed-off-by: Akarsha <>
Diffstat (limited to '')
1 files changed, 25 insertions, 19 deletions
diff --git a/ b/
index b999f2d8d..371229e38 100644
--- a/
+++ b/
@@ -8,9 +8,10 @@ The Libraries/Modules/Tests in glusto-tests are written using the `glusto`
framework. TestCases in glusto-tests can we written/run using standard
PyUnit, PyTest or Nose methodologies as supported by `glusto` framework.
-Refer the [docs]( for info on `glusto`
-Issues need to be filed against the Github repo.
+Refer the [glusto-doc]( for info
+on `glusto` framework.
+Issues need to be filled against the
+[Github]( repo.
To automate/run glusto-tests we need to install the following packages:
@@ -49,40 +50,47 @@ How to install gdeploy:
- Install latest version of gdeploy from the following [link](
+To install glusto-tests dependencies:
+`python-docx` needs to be installed when we run IO's and validates on client node.
+To install run :
+ # curl "" -o ""
+ # python
+ # pip install --pre python-docx
How to run the test case:
-- Create config file containing info about the servers, clients, volumes,
- mounts. Please refer to example config file under tests directory in
- glusto-tests repo. The example config file is in yaml format and
- defines sections which provides info about the gluster cluster.
- We can use any `glusto` framework supported formats for writing the
- config files.
- Refer the following [link](
+- Create config file containing info about the servers, clients,
+ for example refer [config](,
+ this config file is enough to run all test cases. But if you need to override the default values of volumes,
+ mount.. etc which is passed in gluster_base_class, can be passed in config
+ file[config](
+ Refer the following for more info [link](
- glusto-tests are run using the `glusto` command available after installing
the glusto framework. The various options to run tests as provided by
glusto framework:
To run PyUnit tests:
# glusto -c 'config.yml' -d 'tests'
# glusto -c 'config.yml unittest_list.yml' -u
To run PyTest tests:
# glusto -c 'config.yml' --pytest='-v -x tests -m bvt'
To run Nose tests:
# glusto -c 'config.yml' --nosetests='-v -w tests'
- For more info refer the [docs](
+ For more info about running these tests, refer the [docs](
+- To know how to run glusto-tests from the scratch including creating OS, server, etc.. refer [link](
Writing tests in glusto-tests:
`tests` directory in glusto-tests contains testcases. One might want to create
a dir with feature name as the name of test directory under `tests` to add
-new testcases.
+new testcases. Testcases name should start with`test_`
TestCases in glusto-tests can we written using standard PyUnit, PyTest or Nose
methodologies as supported by `glusto` framework.
@@ -91,6 +99,8 @@ One can follow the [PyUnit](
or [PyTest]( docs to write PyTest tests,
or [Nose]( docs to write Nose tests.
+For more info how to write testcases [developing-guide](
Log file name and Log level can be passed as argument to glusto command while
@@ -105,7 +115,3 @@ Default log location is: `/tmp/glustomain.log`
Note: When using `glusto` via the Python Interactive Interpreter,
the default log location is `/tmp/glusto.log`.
-Refer to `docs/userguide/HOWTO` for a detailed information
-on how to install/setup/run/ report