Install doc bugs from test scripts at https://github.com/otzoran/openstack-grizzly-installer/

[Anne Gentle]

https://github.com/otzoran/openstack-grizzly-installer/ tests the install guides on docs.openstack.org and has many notes about discrepancies. This doc bug is meant to gather those in one place to fix the Grizzly install guides and trunk install guides.

Identity install:
missing: in Doc apt-get keystone only - not python-keystone python-keystoneclient
Note on permissions:
 # keystone.conf is shipped as root:root 644 (in the ubuntu pack)
 # but /etc/keystone is keystone:keystone 700 so the files under it are protected from
 # unauthorized users

 New in grizzly:
 # By default Keystone will use ssl encryption between it and all of the other services.
 printf "Create the encryption certificates:\n"
 keystone-manage pki_setup
 chown -R keystone:keystone /etc/keystone/*

 service keystone restart

"--enabled true" isn't in the grizz doc for creating keystone tenants

the Doc names the default user = admin; confusion with role "admin" (which is hardcoded in
 # the json files!)
 #ADMIN_USER=u_Admin # defined in openstack.conf

In the Grizzly doc, there's a Doc mismatch between Install&Deploy vs. Basic-Install, regarding:
 # - port to use in OS_AUTH_URL (35357 in I&D, 5000 in B-I)
 # This should be 35357, as "administrative commands MUST be performed against the admin API port: 35357"
 # see http://docs.openstack.org/grizzly/openstack-compute/install/apt/content/verifying-identity-install.html
 # BUT in verifying glance, OS_AUTH_URL is assigned port 5000 ...
 # - naming of SERVICE_ENDPOINT: with or w/o OS_
 # - naming of ERVICE_TOKEN: with or w/o OS_
 # - name of the RC file: I&D uses "keystonerc", B-I uses "openrc" ...
 # - when RC file is created (and used): I&D creates it AFTER, for verifications; B-I BEFORE creating services.

Example nova.conf:
# OO: the doc is out-of-date, leave volume_api_class here, the rest has moved to cinder.conf
volume_api_class=nova.volume.cinder.API

Image install:
 # OO: The Instal&Deploy Doc has only "glance"; the list below isfrom Basic-Install
 # Basic-Install says: apt-get install glance glance-api glance-common python-glanceclient glance-registry
 # which is almost identical to Folson (that had also python-glance, omitted in Grizzly?)

 # OO: The note about "re-install the python-keystoneclient" is probably obsolete

Dashboard install:
# you must edit the template file _detail_vnc.html
# on 12.04 find it under
# /usr/share/pyshared/horizon/dashboards/nova/templates/nova/instances_and_volumes/instances/_detail_vnc.html
# Modify the width and height parameters
# <iframe src="{{ vnc_url }}" width="720" height="430"></iframe>
# DOC bug: file is here:
# /usr/share/pyshared/horizon/dashboards/nova/instances/templates/instances/_detail_vnc.html

Compute install:
 # Stop the nova- services prior to running db sync.
 # Otherwise your logs show errors because the database has not yet been populated

[Tom Fifield (fifieldt)]

pki bug also tracked in: https://bugs.launchpad.net/openstack-manuals/+bug/1163938

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/38375

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/38375
Committed: http://github.com/openstack/openstack-manuals/commit/a95e3733a566ce42815c7678e1fee70f8be204bc
Submitter: Jenkins
Branch: master

commit a95e3733a566ce42815c7678e1fee70f8be204bc
Author: annegentle <email address hidden>
Date: Tue Jul 23 16:13:27 2013 -0500

    Fixes to install guide and basic install guide.

    Fix bug 1199133

    Change-Id: Ief6fabc99886ef7946ab98b74ae592e63697f302

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: stable/grizzly
Review: https://review.openstack.org/38479

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/38479
Committed: http://github.com/openstack/openstack-manuals/commit/a6f6bae41372098f392e6d5fff6032d0a3d9c1a3
Submitter: Jenkins
Branch: stable/grizzly

commit a6f6bae41372098f392e6d5fff6032d0a3d9c1a3
Author: annegentle <email address hidden>
Date: Tue Jul 23 16:13:27 2013 -0500

    Cherry pick from https://review.openstack.org/#/c/38375/

    Fixes to install guide and basic install guide.
    Fix bug 1199133

    Change-Id: I2ff4cd28a7984a47c75de38f0f54c3eeb8a49f19

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: stable/grizzly
Review: https://review.openstack.org/39555

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/39555
Committed: http://github.com/openstack/openstack-manuals/commit/e7e60b4eebf0075ee8e32e077105dcc7366ef602
Submitter: Jenkins
Branch: stable/grizzly

commit e7e60b4eebf0075ee8e32e077105dcc7366ef602
Author: annegentle <email address hidden>
Date: Tue Jul 23 16:13:27 2013 -0500

    Cherry pick from https://review.openstack.org/#/c/38375

    Fixes to install guide and basic install guide.

    Fix bug 1199133

    Change-Id: I413251be6c1b1204fb76d8daa8d0218854a1ceca