Current install documentation does not work

[Richard Jones]

The docs currently (as of this report) at http://docs.openstack.org/developer/devstack/ include a number of steps that do not work under Ubuntu at least:

- the local.conf is in the wrong place,
- the devstack checkout is owned by root, in a directory that is inaccessible to the stack user created by the instructions

I recommend that the instructions be altered to:

- perform the stack user creation first
- su - stack
- git checkout
- cd devstack
- create local.conf
- ./stack.sh

[Hanxi Liu (hanxi-liu)]

You should create the local.conf yourself and add service according to you needs. You also can cp the local file from sample/local.conf to top directory in devstack. It doesn't matter that there isn't local.conf in top directory.
Btw, I am not clear what you want to do with checkout?

[Richard Jones (r1chardj0n3s)]

Hi, I am aware of what steps needed to be taken to address the errors in the documentation, thanks :-)

I'd just like the docs corrected for people who are perhaps attempting to devstack for the first time, and run into issues which will be raised if they try to follow the docs as they are now.

[Richard Jones (r1chardj0n3s)]

Sorry, I didn't explicitly address your question: to fix the issues (permissions, location) with the checkout, I recommend the docs be altered to the sequence I indicate in my original bug report.

[Sharat Sharma (sharat-sharma)]

Hi Richard Jones,

I agree with the explanation and the bug is valid according to me. Though not a critical one, its certainly in the wishlist.

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/380944
Committed: https://git.openstack.org/cgit/openstack-dev/devstack/commit/?id=89a855f784644f2c4d88331a0d29f85e5fcd741c
Submitter: Jenkins
Branch: master

commit 89a855f784644f2c4d88331a0d29f85e5fcd741c
Author: Sharat Sharma <email address hidden>
Date: Mon Oct 3 12:10:23 2016 +0530

    Changed the order of steps in the devstack install document

    The order of the steps were a bit confusing for the first timers
    in the devstack document. So, changed the order of installation
    steps to make it clear.

    Change-Id: Ifaa051887dab95719b9ca5d1b2fbe2f5f549d269
    Closes-Bug: #1627939