keystone endpoint-create docs incomplete and incorrect

[Lorin Hochstein]

The documentation how to define the keystone endpoint services doesn't have enough detail to tell a user how to set up endpoings for nova, ec2, glance, (swift) and keystone, and the example is incorrect.

http://docs.openstack.org/trunk/openstack-compute/install/content/defining-services.html

The example says:

Next, create an endpoint for each service you just created using the id values returned by each service-create command. Here's an example for the nova service endpoint.

keystone --token 012345SECRET99TOKEN012345 --endpoint http://192.168.206.130:35357/v2.0 endpoint-create \
                       --region RegionOne \
                       --service_id=abc0f03c02904c24abdcc3b7910e2eed \
                       --publicurl http://192.168.206.130:5000/v2 \
                       --adminurl http://192.168.206.130:5000/v2 \
                       --internalurl http://192.168.206.130:5000/v2

The nova service runs on port 8774 by default, not 5000 (that's keystone). I'm not sure what this should actually be.

Better would probably be to follow the directions here (and used in devstack) to template-based services:

http://www.hastexo.com/resources/docs/installing-openstack-essex-4-ubuntu-1204-precise-pangolin/step-3-install-and-configur

[Lorin Hochstein (lorinh)]

See also #965868

[Anne Gentle (annegentle)]

So the Hastexo doc is great for a starting point, and works well for fast proof-of-concepts, but for reliability, high availability, and redundancy of the data - all those can be set up easily with MySQL in a production environment. The install /deploy guide is meant for the production environments, not proof of concepts.

I do want Hastexo to bring their document under the OpenStack docs umbrella, it definitely has a place.

[Lorin Hochstein (lorinh)]

I added a comment on the Hastexo blog entry about this.

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/6093
Committed: http://github.com/openstack/openstack-manuals/commit/5ea4bd569e70b22f8712554ca433520db6ac40ca
Submitter: Jenkins
Branch: master

commit 5ea4bd569e70b22f8712554ca433520db6ac40ca
Author: annegentle <email address hidden>
Date: Mon Apr 2 10:53:25 2012 -0500

    Fix bug 957618, remove nova-manage image

    * Minor markup changes as well to remove <literallayout >
    * Should pick up more changed to "creating custom images" from CSS OSS team after 12.04 Ubuntu is released this month
    * Fix bug 969598, show more endpoint creation examples
    * Fix bug 968679, fix example, provide info about ports for each service
    * Fix bug 965868, improve text about URL values for endpoints and services

    Change-Id: Iab3c905f35b1c158e6d924ac8cf41c87e59d123c