From 1f745dccb6623fbc6ab0f6b0965f90d622f33cdf Mon Sep 17 00:00:00 2001 From: Sergey Lukjanov Date: Sun, 26 May 2013 11:28:32 +0400 Subject: [PATCH] Small docs improvements. * 'sphinxcontrib-httpdomain' added to test-requires * info about how to add Savanna endpoints to Keystone added Change-Id: I782096ca3471cbdabcc048c79a7198cb630a6c64 --- doc/source/index.rst | 1 - doc/source/quickstart.rst | 34 ++++++++++++++++++++++++++++++++++ tools/test-requires | 1 + 3 files changed, 35 insertions(+), 1 deletion(-) diff --git a/doc/source/index.rst b/doc/source/index.rst index 113f79a9..19a3e5f0 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -9,7 +9,6 @@ Useful links overview architecture devref/index - installation.guide quickstart * `Savanna wiki `_ diff --git a/doc/source/quickstart.rst b/doc/source/quickstart.rst index cecb8b78..9ba6fe71 100644 --- a/doc/source/quickstart.rst +++ b/doc/source/quickstart.rst @@ -292,3 +292,37 @@ and you actually could access them via browser "jobtracker": "http://JobTracker_IP:50030" Congratulations! Now you have Hadoop cluster ready on the OpenStack cloud! + +5. Keystone endpoints setup +--------------------------- + +To use CLI tools, such as OpenStack's python clients, we should specify +environment variables with addresses and credentials. Let's mind that we have +keystone at `127.0.0.1:5000` with tenant `admin`, credentials `admin`:`nova` +and Savanna API at `127.0.0.1:8080`. Here is a list of commands to set env: + +.. sourcecode:: bash + + export OS_AUTH_URL=http://127.0.0.1:5000/v2.0/ + export OS_TENANT_NAME=admin + export OS_USERNAME=admin + export OS_PASSWORD=nova + +We should create service in Keystone: + +.. sourcecode:: bash + + keystone service-create --name=savanna --type=mapreduce --description="Savanna Elastic Hadoop Service" + +And then we should create endpoint for created service: + +.. sourcecode:: bash + + keystone endpoint-create \ + --region RegionOne \ + --service-id= \ + --publicurl="http://127.0.0.1:8080/v0.2/%(tenant_id)s" \ + --internalurl="http://127.0.0.1:8080/v0.2/%(tenant_id)s" \ + --adminurl="http://127.0.0.1:8080/v0.2/%(tenant_id)s" + +Now Keystone know endpoints of service `mapreduce`. diff --git a/tools/test-requires b/tools/test-requires index ff913a60..a0fe9722 100644 --- a/tools/test-requires +++ b/tools/test-requires @@ -7,4 +7,5 @@ nose openstack.nose_plugin>=0.7 pylint==0.25.2 sphinx>=1.1.2 +sphinxcontrib-httpdomain unittest2