README warn against virtualenv --system-site-packages 28/9428/2
authorGabriel Ganne <>
Wed, 15 Nov 2017 13:35:27 +0000 (14:35 +0100)
committerPeter Mikus <>
Wed, 20 Dec 2017 15:50:07 +0000 (15:50 +0000)
If using --system-site-packages, some system python modules may conflict
with the ones required. For example, the python modules paramiko and gssapi
conflict: if you have both, then "import paramiko" will fail while looking
for gssapi exceptions.

Also rename the sample topology to use the *.example available the
available topologies. "topology.yaml.example" does not exist.

Change-Id: I816177f305ad6f4675c12c64d49d04f075bee817
Signed-off-by: Gabriel Ganne <>

diff --git a/README b/README
index 2b4fbce..343e3bb 100644 (file)
--- a/README
+++ b/README
@@ -2,13 +2,18 @@
  - install virtualenv
  - generate environment using virtualenv:
     # cd $ROOT
-    # virtualenv --system-site-packages env
+    # virtualenv env
     # source env/bin/activate
  - install python requirements for this project by executing:
     # pip install -r requirements.txt
  - make sure user mentioned in has NOPASSWD sudo access to
+You can alternatively create the virtualenv with the flag --system-site-packages
+It give access to the global site-packages dir to the virtual environment, which
+is faster, but you may end up with some conflicts.
@@ -16,7 +21,7 @@
 export PYTHONPATH=.
 # create topology, edit ip addresses
-cp topologies/available/topology.yaml.example topologies/available/topology.yaml
+cp topologies/available/3_node_hw_topo1.yaml.example topologies/available/topology.yaml
 ln -s ../available/topology.yaml topologies/enabled/topology.yaml
 pybot -L TRACE -v TOPOLOGY_PATH:topologies/enabled/topology.yaml tests

©2016 a Linux Foundation Collaborative Project. All Rights Reserved.
Linux Foundation is a registered trademark of The Linux Foundation. Linux is a registered trademark of Linus Torvalds.
Please see our privacy policy and terms of use.