bcf5a7cb3a
This adds a small glossary to the Install Guide. The glossary is produced from all entries that use <firstterm> or <glossterm> and which are in the global glossary (see file glossary/gloss-terms.xml). I (dcramer) have patched this to work if built against https://review.openstack.org/68416, which fixes the problem where the glossary wasn't populated in the pdf. Updates to clouddocs-maven-plugin 1.13.0 that has dcramer's fix. Change-Id: I357265ea99a7e9b0f4004ef529a2043605e8b2ec
71 lines
3.4 KiB
XML
71 lines
3.4 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>
|
|
<para>So that the Identity Service can track which OpenStack services are
|
|
installed and where they are located on the network, you must register each
|
|
service in your OpenStack installation. To register a service, run these
|
|
commands:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><command>keystone service-create</command>. Describes the
|
|
service.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><command>keystone endpoint-create</command>. Associates
|
|
<glossterm baseform="API endpoint">API endpoints</glossterm>
|
|
with the service.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>You must also register the Identity Service itself. Use the
|
|
<code>OS_SERVICE_TOKEN</code> environment variable, as set previously, for
|
|
authentication.</para>
|
|
<procedure>
|
|
<step>
|
|
<para>Create a service entry for the Identity Service:</para>
|
|
<screen><prompt>#</prompt> <userinput>keystone service-create --name=keystone --type=identity \
|
|
--description="Keystone Identity Service"</userinput>
|
|
<computeroutput>+-------------+----------------------------------+
|
|
| Property | Value |
|
|
+-------------+----------------------------------+
|
|
| description | Keystone Identity Service |
|
|
| 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=<replaceable>the_service_id_above</replaceable> \
|
|
--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>
|