Installation guide needs updating

On of the efforts to collect information for this manual: https://etherpad.openstack.org/p/Using_Ironic_to_launch_instances_on_real_hardware

Since https://bugs.launchpad.net/diskimage-builder/+bug/1291533 was fixed, there is no need of placing `tftpboot` directory in the root directory of TFTP

Also https://github.com/openstack-dev/devstack/blob/master/lib/ironic#L426 that line with could be removed entirely.

Vinay B S, hi! Youre assigned to the issue, could you give some status update on it? Our policy is to not have an issue assigned w/o patch for >7 days.

Hi Dmitry, I have been writing the instructions here: https://etherpad.openstack.org/p/Using_Ironic_to_launch_instances_on_real_hardware

It's almost in completion stage. Please review it and let me know if I need to make any changes.

Left a couple of comments, but it's much easier to comment in Gerrit, so I propose moving it there :) thank you for update.

Hi Vinay!

I wasn't aware you were working on this. In fact, I just sent an email to the mailing list calling for much the same thing (there's some overlap, but some things not covered by your etherpad).

As Dmitry suggested, please propose these changes via Gerrit -- even if it is not complete, in which case, you should mark it as a WIP (work in progress).

Also, in the future, a series of small changes that show the ongoing work you are doing is far preferrable to a single large "do it all at once" patch. This helps raise awareness from core reviewers of what you are doing, and shortens the feedback cycle in case there are course-corrections that need to be made early on.

Thanks for you work! I look forward to seeing the review soon :)

Hi Devananda,

This is my first bug fix and I was not completely aware of the procedure. It does make sense to commit a series of small changes instead of committing a big patch at the end. I'll add the patch of whatever changes I have done till now.
And I would like to document the other things you mentioned in the mail too, which I have not covered yet in the etherpad.

Thanks!

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

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

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

Hi Vinay,
I have not found the configuration for tftp-server. Will it be added soon?

Change abandoned by Vinay B S (<email address hidden>) on branch: master
Review: https://review.openstack.org/114887
Reason: Dependency issue. Will commit a new patch to replace this.

Change abandoned by Vinay B S (<email address hidden>) on branch: master
Review: https://review.openstack.org/114888
Reason: Dependency issue. Will commit a new patch

Change abandoned by Vinay B S (<email address hidden>) on branch: master
Review: https://review.openstack.org/114889
Reason: Dependency issue. Will commit a new patch

Change abandoned by Vinay B S (<email address hidden>) on branch: master
Review: https://review.openstack.org/114886
Reason: committing a new patch to resolve few dependency issues

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

Reviewed: https://review.openstack.org/118614
Committed: https://git.openstack.org/cgit/openstack/ironic/commit/?id=befe332e28a18a842777facc8f17fb7dc3fd68d6
Submitter: Jenkins
Branch: master

commit befe332e28a18a842777facc8f17fb7dc3fd68d6
Author: Vinay B S <email address hidden>
Date: Wed Sep 3 04:58:04 2014 -0700

    Adds instructions for deploying instances on real hardware

    The following sections have been added to the install-guide:

    1. Set of instructions for configuring Neutron to talk to baremetal.
       Flat networking is taken as the usecase. Instructions for using
       other types of networks will be added eventually.
    2. Set of instructions for adding the required images to glance.
       Includes instructions for creating the deploy and user images
       using disk-image builder.
    3. Set of instructions for creating the baremetal flavor and
       associating the deploy images to the flavor.
    4. Instruction for checking that the ipmitool on the openstack setup
       is able to control baremetal's power state.

    Change-Id: If45f0f32808308cf2d451a905ca7cd840c81c7d2
    Partial-Bug: 1323589

Reviewed: https://review.openstack.org/138864
Committed: https://git.openstack.org/cgit/openstack/ironic/commit/?id=4610c25c40cf0d45a0c9f890afd8f245d047f822
Submitter: Jenkins
Branch: master

commit 4610c25c40cf0d45a0c9f890afd8f245d047f822
Author: Chris Krelle <email address hidden>
Date: Wed Dec 3 13:11:16 2014 -0800

    Add info on creating a tftp map file

    This add instructions on how to create a tftp map file to the
    install-guide. Also remove hard coded section numbers from iPxe
    section.

    Partial-Bug: #1323589
    Change-Id: I0b5c36246f9170c512172929819b7d6a487804f4

Closing this bug now. Based on the initial title, it is simply too broad, and based on the initial description, much of that has been done already.

We should revisit this and file bugs for specific items which lack documentation, rather than a single catch-all that we'll never complete (good aspiration as it is).