keystone defining services page: improve text about URL values

[Jason Brittain]

On this doc page:

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

It describes creating endpoints for services, like this:

"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"

.. but it doesn't mention what the user should probably put for each of those URL values, nor whether they should be different for each of the services.. For example, when specifying the URLs (such as "publicurl"), it should mention that the URL's address cannot be "0.0.0.0", meaning any address that reaches the server, since the URL value is used to build URLs that are given out to other machines. It should also mention which of these URLs is likely used from outside the machine/VM, and which may just be used inside the machine/VM (so "localhost" or "127.0.0.1" could be valid there). How about port numbers? Is it okay for all of them to be the same port number? Even across services?

I think this page should show at least two endpoint-create commands (one for one service, one for another service) to demonstrate this more clearly.

[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