openstack-manuals/doc/install-guide/section_keystone-services.xml
Joseph Robinson ca395c88ec Editing Keystone Services
Edited the document for clarity: addressed punctuation
points in the keystone services section, and also added edits
to clarify the Identity Concepts section. Moved Content from the
Keystone Services section to the Identity Concepts
Section.

Change-Id: I94d21ba16f89ea2ba12166bab3f6893091bccbbf
Implements: blueprint installation-guide-improvements
2014-06-10 13:47:25 +10:00

59 lines
2.8 KiB
XML

<section xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="keystone-services"
version="5.0" os="rhel;centos;fedora;opensuse;sles;ubuntu">
<title>Define services and API endpoints</title>
<procedure>
<step>
<para>Register the identity service itself using the
<code>OS_SERVICE_TOKEN</code> environment variable, as set
previously, for authentication.</para>
</step>
<step>
<para>Create a service entry for the Identity Service:</para>
<screen><prompt>$</prompt> <userinput>keystone service-create --name=keystone --type=identity \
--description="OpenStack Identity"</userinput>
<computeroutput>+-------------+----------------------------------+
| Property | Value |
+-------------+----------------------------------+
| description | OpenStack Identity |
| id | 15c11a23667e427e91bc31335b45f4bd |
| name | keystone |
| type | identity |
+-------------+----------------------------------+</computeroutput></screen>
<para>The service ID is randomly generated and is different from
the one shown here.</para>
</step>
<step>
<para>Specify an API endpoint for the Identity Service by using
the returned service ID. When you specify an endpoint, you
provide URLs for the public API, internal API, and admin API.
In this guide, the <literal>controller</literal> host name is
used. Note that the Identity Service uses a different port for
the admin API.</para>
<screen><prompt>$</prompt> <userinput>keystone endpoint-create \
--service-id=$(keystone service-list | awk '/ identity / {print $2}') \
--publicurl=http://<replaceable>controller</replaceable>:5000/v2.0 \
--internalurl=http://<replaceable>controller</replaceable>:5000/v2.0 \
--adminurl=http://<replaceable>controller</replaceable>:35357/v2.0</userinput>
<computeroutput>+-------------+-----------------------------------+
| Property | Value |
+-------------+-----------------------------------+
| adminurl | http://controller:35357/v2.0 |
| id | 11f9c625a3b94a3f8e66bf4e5de2679f |
| internalurl | http://controller:5000/v2.0 |
| publicurl | http://controller:5000/v2.0 |
| region | regionOne |
| service_id | 15c11a23667e427e91bc31335b45f4bd |
+-------------+-----------------------------------+</computeroutput></screen>
</step>
</procedure>
<note>
<para>
You will need to create an additional endpoint for each service
added to your OpenStack environment. The sections of this guide
associated with the installation of each service include the
endpoint creation step specific to the service.
</para>
</note>
</section>