Files
fuel-docs/pre-install-guide.rst
Meg McRoberts b5abe27025 Set up Planning Guide
I started with the "Preparing the MOS Deployment" table
The hardware setup steps have been moved to the Install Guide in another CM
Added a few issues that were not spelled out
Set up separate sections to hold the discussions for each issue.

"Network Topologies" cross-references architectural information in ref-arch
* Andrey Danin provided the "advice"
* Restructuring the network docs became necessary to make this work. To whit:

For Neutron, various structural modifications were required;
no substantive content modifications were made
* Added a couple headers and tags to ref-arch for Neutron topologies
* Deleted files from pre-install/0051-network-plan/topology:
  * 0710-neutron-topologies.rst -- header only, no longer required
  * 0720-neutron-vlan.rst -- duplicates info in ref-arch/neutron-intro/\
    0210-vlan.rst; this had a couple sentences at the end that weren't in
    ref-arch so I moved those over
  * 0730-neutron-gre.rst -- duplicates info in ref-arch/neutron-intro/\
    0220-gre.rst; this had a couple sentences at the end that weren't in
    ref-arch so I moved those over
  * 0760-neutron-vlan-plan.rst and 0780-neutron-gre-plan.rst were pulled
    into ref-arch/0260-neutron-config.rst.  Yes, this leaves one file with
    three headers in it but, when we deal with the content, these pieces
    need to be considered together
* pre-install/0051-network-plan/topology/0700-neutron.rst just sourced the
    above files so is deleted

For Nova, moved the nova-network topology info from pre-install to ref-arch
to parallel the Neutron section we set up there.
* The following files from pre-installation/0051-network-plan/topology/nova
  are now in reference-architecture/nova-intro and sourced from the
  6070-nova-topologies.rst file in reference-architecture.  Section titles
  are also modified to include "Nova-network" to improve readability:
  - 0620-nova-flat-dhcp.rst
  - 0630-nova-vlan.rst
  - 0659-nova-net-plan.rst
  - 0660-nova-plan-flatdhcp.rst
  - 0680-plan-vlan.rst
  - [ignore 0650-nova-assign-networks-to-nics.rst -- it is going to User Guide]
* Other files from this directory are disposed of as follows:
  - 0610-nova-topologies -- sourced ino ref-arch/6070-nova-topologies.rst
    (top file of nova section in ref-arch)
  - 0650-nova-assign-networks-to-nics.rst -- material is obsolete and done
    better in other files now included in user-guide.
* The following files from pre-install/0051-network-plan/0100-netconfig-options are deleted:
  - 0100-netconfig-options (header/intro info no longer needed)
  - 0110- (info pulled into
  - 0200 - sourced files below it that are moved and sourced elsewhere

The same sections that discussed the topologies had information about
routers and switches.  I'm not exactly sure where the best place is
for this but, for now, I'm putting it in ref-arch right after the write-up
about Public and Floating IPs.  Alas, that is in a different commit, and
that other commit creates a sub-directory where these files should go.
So, for now, I created two files in the main ref-arch directory; I will
move these into the proper place after everything is merged.
* 6030-router is based on install-guide/0070-networks/350-router.rst,
  with content also pulled in from pre-install/0051-network-plan/topology/\
  0900-routing-req.rst.  I did some rewriting but the content is unchanged.
  This includes a bunch of Fuel screen shots that I think are superfluous
  but I need to compare them to the rewritten User Guide; I may need to do
  some moving or xref'ing of information.
* 6034-switch.rst is renamed from install-guide/0070-networks/
  300-switch-config.rst.  I did a bit of editing but the content is
  unchanged.
* I had to tag the files with sample switch configurations so I could
  link to them.  I also prefaced each of those titles with either "Nova-network"
  or "Neutron".
* After the above, the following files are deleted:
  * pre-install/0051-network-plan/topology/0900-routing-req (included in
    new routing document)
  * pre-install/0051-network-plan/0200-topology-include.rst -- included files
    that are deleted or moved
  * pre-install/0051-network-plan.rst -- included files that are deleted
    or moved

ref-arch/0030-cluster-sizing.rst is deleted; its content was pulled into
pre-install/nodes-roles.rst.  I added a bit of intro material; the substantive
content is unchanged.

pages/pre-install-guide/4000-plan0summary.rst was a bogus file; is deleted

At Patch 6, I deleted the screen shots from 0060-quick-start-instart-fuel;
this info doesn't belong here anyhow.  I also right-aligned the diagrams in
the Examples and fixed the header levels for the examples at the end of the
document.

Change-Id: Ia4e68200bea2166d48d7691f80cc921459a337ff
2014-05-23 18:04:44 -07:00

186 B

Planning Guide

Planning Guide

local