Needed Doc Improvement: OpenStack Installation Guide for Ubuntu 12.04 (LTS) and Debian 7.0  - havana

Bug #1245968 reported by Glenn Baxter
14
This bug affects 2 people
Affects Status Importance Assigned to Milestone
openstack-manuals
Won't Fix
High
Lana

Bug Description

The entire Guide does not do a good job of identifying what is to be applied to the controller node vs to the compute node. (It is better than past, for sure, but still needs improvement). Someone needs to try to follow the directions from a ground install, and see that they do not presently funtion "as-is" because people do not know to which node to the directions always apply.

Best: Please craft a seperate chapter that shows everything needed from a ground install of Ununtu 12.04 LTS to build a controller node. Do the same for a compute node. Add an another chapter describing how to add Cinder to the compute node.

Not Ideal: In every section of the book, but particularly chapter five, be very specific about what has to be done on the controller node and what has to be done on the compute node.

FIX: Please eliminate ANY references to copying files (or relying upon them being copied) between the controller and the compute node. This is not a good practice.

Cheers,

Glenn
-----------------------------------
Built: 2013-10-29T08:14:46 00:00
git SHA: 94bf634bf30583652739a63d16f16fa8313ccf71
URL: http://docs.openstack.org/havana/install-guide/install/apt/content/ch_nova.html
source File: file:/home/jenkins/workspace/openstack-install-deploy-guide-ubuntu/doc/install-guide/ch_nova.xml
xml:id: ch_nova

Lana (loquacity)
Changed in openstack-manuals:
assignee: nobody → Lana (loquacity)
tags: added: install-guide
Changed in openstack-manuals:
status: New → Confirmed
importance: Undecided → High
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to openstack-manuals (master)

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

Changed in openstack-manuals:
status: Confirmed → In Progress
Revision history for this message
OpenStack Infra (hudson-openstack) wrote :

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

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to openstack-manuals (master)

Reviewed: https://review.openstack.org/55783
Committed: http://github.com/openstack/openstack-manuals/commit/7d39198c1f5dd05af6d4b368c78f4fee3532a99d
Submitter: Jenkins
Branch: master

commit 7d39198c1f5dd05af6d4b368c78f4fee3532a99d
Author: Lana Brindley <email address hidden>
Date: Mon Nov 11 14:55:02 2013 +1000

    Removed instructions to copy .conf files

    Bug 1247323 states a requirement to remove the
    instructions to copy .conf files between the controller and compute
    nodes. Bug 1245968 mentions this as a possible cause of the issue.
    This patch progresses both bugs, but resolves neither. Also fixes for
    some minor layout and wording issues.

    Change-Id: Ia92fbaf9152df561aa38dac4c91e9f38bd425964
    backport: havana
    Partial-Bug: #1247323
    Partial-Bug: #1245968

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to openstack-manuals (stable/havana)

Fix proposed to branch: stable/havana
Review: https://review.openstack.org/56137

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to openstack-manuals (stable/havana)

Reviewed: https://review.openstack.org/56137
Committed: http://github.com/openstack/openstack-manuals/commit/0bb7f55597714fc04970440f288c148087116fdb
Submitter: Jenkins
Branch: stable/havana

commit 0bb7f55597714fc04970440f288c148087116fdb
Author: Lana Brindley <email address hidden>
Date: Mon Nov 11 14:55:02 2013 +1000

    Removed instructions to copy .conf files

    Bug 1247323 states a requirement to remove the
    instructions to copy .conf files between the controller and compute
    nodes. Bug 1245968 mentions this as a possible cause of the issue.
    This patch progresses both bugs, but resolves neither. Also fixes for
    some minor layout and wording issues.

    Change-Id: Ia92fbaf9152df561aa38dac4c91e9f38bd425964
    backport: havana
    Partial-Bug: #1247323
    Partial-Bug: #1245968
    (cherry picked from commit 7d39198c1f5dd05af6d4b368c78f4fee3532a99d)

tags: added: in-stable-havana
Revision history for this message
Lana (loquacity) wrote :

This will be addressed as part of the larger Icehouse planning.

Changed in openstack-manuals:
status: In Progress → Won't Fix
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Duplicates of this bug

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.