From 8f46fbc0b5b862c191fb15d8b961e4aea42596ca Mon Sep 17 00:00:00 2001
From: "James E. Blair" <jeblair@redhat.com>
Date: Thu, 15 Sep 2016 14:21:26 -0700
Subject: [PATCH] launch: document using a virtualenv for launch-node

Change-Id: Ib275299f333e0b109c5e2d22b0d593a9ade0783b
---
 launch/README | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/launch/README b/launch/README
index b8e049b8a3..40a6a49128 100644
--- a/launch/README
+++ b/launch/README
@@ -12,8 +12,17 @@ and puppet groups for access to their respective keys::
 (Remember to log out and back into your shell if you add yourself
 to a group.)
 
+Launching a node currently requires a different version of ansible
+than what is generally used on the puppetmaster.  Set up a
+virtualenv::
+
+  virtualenv ~/launch-env/
+  . ~/launch-env/bin/activate
+  pip install ansible==2.1.1.0 shade==1.12.1
+
 To launch a node in the OpenStack CI account (production servers)::
 
+  . ~/launch-env/bin/activate
   export OS_CLOUD=openstackci-rax
   export OS_REGION=DFW
   export FLAVOR="8 GB Performance"
@@ -24,6 +33,7 @@ To launch a node in the OpenStack CI account (production servers)::
 
 To launch a node in the OpenStack Jenkins account (slave nodes)::
 
+  . ~/launch-env/bin/activate
   export OS_CLOUD=openstackjenkins-rax
   export OS_REGION=DFW
   export FQDN=slavename01.slave.openstack.org