From 2228375b2ee2ac174381c156c35667fd06a2ef13 Mon Sep 17 00:00:00 2001 From: Loic Dachary Date: Tue, 25 Aug 2015 10:11:48 +0200 Subject: [PATCH] openstack: document common pitfalls and OpenStack tenant grants Signed-off-by: Loic Dachary --- README.rst | 31 +++++++++++++++++++++++++------ 1 file changed, 25 insertions(+), 6 deletions(-) diff --git a/README.rst b/README.rst index 1f5791cf3c..95913d7f95 100644 --- a/README.rst +++ b/README.rst @@ -330,10 +330,15 @@ using OpenStack virtual machines. Prerequisites ------------- -An OpenStack tenant with access to the nova and cinder API (for -instance http://entercloudsuite.com/). If the cinder API is not -available (for instance https://www.ovh.com/fr/cloud/), some jobs -won't run because they expect volumes attached to each instance. +An OpenStack tenant with access to the nova and cinder API. If the +cinder API is not available, some jobs won't run because they expect +volumes attached to each instance. + +Apply for an OpenStack account +------------------------------ + +* Send a mail to `Loic Dachary `_ +* Store the credentials sent to you in $HOME/openrc.sh Setup OpenStack at Enter Cloud Suite ------------------------------------ @@ -400,8 +405,10 @@ Usage $ openstack keypair create myself > myself.pem $ chmod 600 myself.pem -* Run the dummy suite (it does nothing useful but shows all works as - expected):: +* Run the dummy suite. It does nothing useful but shows all works as + expected. Note that the first time it is run, it can take a long + time (from a few minutes to half an hour or so) because it downloads + and uploads a cloud image to the OpenStack provider. :: $ teuthology-openstack --key-filename myself.pem --key-name myself --suite dummy Job scheduled with name ubuntu-2015-07-24_09:03:29-dummy-master---basic-openstack and ID 1 @@ -435,6 +442,18 @@ Usage --suite dummy --upload +Troubleshooting +--------------- + +Debian Jessie users may face the following error:: + + NameError: name 'PROTOCOL_SSLv3' is not defined + +The `workaround +`_ +suggesting to replace ``PROTOCOL_SSLv3`` with ``PROTOCOL_SSLv23`` in +the ssl.py has been reported to work. + Running the OpenStack backend integration tests ----------------------------------------------- -- 2.39.5