Install docs should show example output of nova endpoints

[Jason Brittain]

To a newbie like myself, when installing a new installation, it is easy to get many configuration settings wrong because the installation docs do not show example endpoint-create commands, nor example output of the "nova endpoints" command. If the endpoints aren't all configured, or if they're configured slightly incorrectly, the openstack doesn't all work properly, failing with cryptic error messages, and it is difficult to understand what to change. This is a critical part of installing openstack, and the docs don't show it. Before the user gets to the spot in the instructions where they're creating and configuring endpoints, it should show the output of nova endpoints, and say that these URLs must be *exact*, except for the hostname. The port numbers are reconfigurable, but the docs should warn the user that the default values are in numerous config files, and each one would need to be edited and modified if you don't want to use the default port number.

[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

[Jason Brittain (jason-brittain)]

The configuration example for the ec2 endpoint on this page shows an incorrect configuration:

http://docs.openstack.org/trunk/openstack-compute/install/content/keystone-service-endpoint-create.html

Scroll all the way to the bottom, and look at the very last text table. This is what it currently shows:

+-------------+--------------------------------------------+
| Property | Value |
+-------------+--------------------------------------------+
| adminurl | http://192.168.206.130:8773/services/Cloud |
| id | d2a3d7490c61442f9b2c8c8a2083c4b6 |
| internalurl | http://192.168.206.130:8773/services/Cloud |
| publicurl | http://192.168.206.130:8773/services/Admin |
| region | RegionOne |
| service_id | 7d5258c490144c8c92505267785327c1 |
+-------------+--------------------------------------------+

Specifically, the publicurl field points to the Admin URL, and the adminurl field points to the public URL. Luckily, the command line showing how to configure it correctly sets them.