From f5922480233b567a36ab2314d27bd684becc8348 Mon Sep 17 00:00:00 2001 From: Ryota MIBU Date: Fri, 11 Dec 2015 15:30:46 +0900 Subject: editorial fixes in apex docs - add gitignore entries - drop common files under docs/etc - fix documentation titles - fix doc8 violation (length of lines) - removal of '_sha1_' for doc tracking - removal of opnfv logo insertion Change-Id: Ib0b39704c115f896f62a8ed8ec52257fcf84d544 Signed-off-by: Ryota MIBU --- .gitignore | 5 ++ docs/etc/conf.py | 34 ------------ docs/etc/opnfv-logo.png | Bin 2829 -> 0 bytes docs/installation-instructions/index.rst | 25 ++------- .../installation-instructions.rst | 57 +++++++++++++-------- docs/release-notes/index.rst | 25 ++------- docs/release-notes/release-notes.rst | 14 ++--- 7 files changed, 50 insertions(+), 110 deletions(-) create mode 100644 .gitignore delete mode 100644 docs/etc/conf.py delete mode 100644 docs/etc/opnfv-logo.png diff --git a/.gitignore b/.gitignore new file mode 100644 index 00000000..33a0451b --- /dev/null +++ b/.gitignore @@ -0,0 +1,5 @@ +*~ +.*.sw? +/docs_build/ +/docs_output/ +/releng/ diff --git a/docs/etc/conf.py b/docs/etc/conf.py deleted file mode 100644 index c62a8610..00000000 --- a/docs/etc/conf.py +++ /dev/null @@ -1,34 +0,0 @@ -import datetime -import sys -import os - -try: - __import__('imp').find_module('sphinx.ext.numfig') - extensions = ['sphinx.ext.numfig'] -except ImportError: - # 'pip install sphinx_numfig' - extensions = ['sphinx_numfig'] - -# numfig: -number_figures = True -figure_caption_prefix = "Fig." - -source_suffix = '.rst' -master_doc = 'index' -pygments_style = 'sphinx' -html_use_index = False - -pdf_documents = [('index', u'Apex', u'Apex Project', u'OPNFV')] -pdf_fit_mode = "shrink" -pdf_stylesheets = ['sphinx','kerning','a4'] -#latex_domain_indices = False -#latex_use_modindex = False - -latex_elements = { - 'printindex': '', -} - -project = u'Apex: OPNFV Installer' -copyright = u'%s, OPNFV' % datetime.date.today().year -version = u'1.0.0' -release = u'1.0.0' diff --git a/docs/etc/opnfv-logo.png b/docs/etc/opnfv-logo.png deleted file mode 100644 index 1519503e..00000000 Binary files a/docs/etc/opnfv-logo.png and /dev/null differ diff --git a/docs/installation-instructions/index.rst b/docs/installation-instructions/index.rst index a199cf00..5c9f4bf3 100644 --- a/docs/installation-instructions/index.rst +++ b/docs/installation-instructions/index.rst @@ -1,16 +1,6 @@ -.. OPNFV Release Engineering documentation, created by - sphinx-quickstart on Tue Jun 9 19:12:31 2015. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. - -.. image:: ../etc/opnfv-logo.png - :height: 40 - :width: 200 - :alt: OPNFV - :align: left - -Apex Table of Contents -====================== +************************************** +OPNFV Installation instructions (Apex) +************************************** Contents: @@ -19,12 +9,3 @@ Contents: :maxdepth: 4 installation-instructions.rst - -Indices and tables -================== - -* :ref:`search` - -Revision: _sha1_ - -Build date: |today| diff --git a/docs/installation-instructions/installation-instructions.rst b/docs/installation-instructions/installation-instructions.rst index 46fcfaa1..564eb78f 100644 --- a/docs/installation-instructions/installation-instructions.rst +++ b/docs/installation-instructions/installation-instructions.rst @@ -131,8 +131,8 @@ The Jumphost requirements are outlined below: 3. libvirt virtualization support. -4. minimum 2 networks and maximum 6 networks, multiple NIC and/or VLAN combinations are supported. This is virtualized for a VM - deployment. +4. minimum 2 networks and maximum 6 networks, multiple NIC and/or VLAN combinations are supported. + This is virtualized for a VM deployment. 5. The Bramaputra Apex RPM. @@ -285,13 +285,17 @@ Install Bare Metal Jumphost Creating a Node Inventory File ------------------------------ -IPMI configuration information gathered in section `Execution Requirements (Bare Metal Only)`_ needs to be added to the ``instackenv.json`` file. +IPMI configuration information gathered in section `Execution Requirements (Bare Metal Only)`_ +needs to be added to the ``instackenv.json`` file. 1. Make a copy of ``/var/opt/opnfv/instackenv.json.example`` into root's home directory: ``/root/instackenv.json`` 2. Edit the file in your favorite editor. -3. The nodes dictionary contains a definition block for each baremetal host that will be deployed. 1 or more compute nodes and 3 controller nodes are required. (The example file contains blocks for each of these already). It is optional at this point to add more compute nodes into the dictionary. +3. The nodes dictionary contains a definition block for each baremetal host that will be deployed. + 1 or more compute nodes and 3 controller nodes are required. + (The example file contains blocks for each of these already). + It is optional at this point to add more compute nodes into the dictionary. 4. Edit the following values for each node: @@ -311,9 +315,11 @@ IPMI configuration information gathered in section `Execution Requirements (Bare Creating a Network Environment File ----------------------------------- -Network environment information gathered in section `Network Requirements`_ needs to be added to the ``network-environment.yaml`` file. +Network environment information gathered in section `Network Requirements`_ +needs to be added to the ``network-environment.yaml`` file. -1. Make a copy of ``/var/opt/opnfv/network-environment.yaml`` into root's home directory: ``/root/network-environment.yaml`` +1. Make a copy of ``/var/opt/opnfv/network-environment.yaml`` into root's home +directory: ``/root/network-environment.yaml`` 2. Edit the file in your favorite editor. @@ -322,7 +328,8 @@ Network environment information gathered in section `Network Requirements`_ need Running ``opnfv-deploy`` ------------------------ -You are now ready to deploy OPNFV! ``opnfv-deploy`` will use the instackenv.json and network-environment.yaml to deploy OPNFV. +You are now ready to deploy OPNFV! +``opnfv-deploy`` will use the instackenv.json and network-environment.yaml to deploy OPNFV. The names of these files are important. ``opnfv-deploy`` will look for ``instackenv.json`` and ``network-environment.yaml`` in the present working directory when it is run. @@ -330,7 +337,11 @@ Follow the steps below to execute: 1. execute ``opnfv-deploy -i /path/to/instackenv.json -n /path/to/network-environment.yaml`` -2. It will take about approximately 30 minutes to stand up instack, configure the deployment and execute the deployment. If something goes wrong during this part of the process, it is most likely a problem with the setup of your network or the information in your configuration files. You will also notice different outputs in your shell. +2. It will take about approximately 30 minutes to stand up instack, + configure the deployment and execute the deployment. + If something goes wrong during this part of the process, + it is most likely a problem with the setup of your network or the information in your configuration files. + You will also notice different outputs in your shell. 3. The message "Overcloud Deployed" will display when When the deployment is complete. Just above this message there will be a URL that ends in port http://:5000. This url is also the endpoint for the OPNFV Horizon Dashboard @@ -381,7 +392,8 @@ Once connected to the OPNFV Dashboard make sure the OPNFV target system is worki 1. In the left pane, click Compute -> Images, click Create Image. -2. Insert a name "cirros", Insert an Image Location ``http://download.cirros-cloud.net/0.3.4/cirros-0.3.4-x86_64-disk.img``. +2. Insert a name "cirros", Insert an Image Location + ``http://download.cirros-cloud.net/0.3.4/cirros-0.3.4-x86_64-disk.img``. 3. Select format "QCOW2", select Public, then click Create Image. @@ -393,7 +405,8 @@ Once connected to the OPNFV Dashboard make sure the OPNFV target system is worki 7. Now go to Project -> Compute -> Instances, click Launch Instance. -8. Enter Instance Name "first_instance", select Instance Boot Source "Boot from image", and then select Image Name "cirros". +8. Enter Instance Name "first_instance", select Instance Boot Source "Boot from image", + and then select Image Name "cirros". 9. Click Launch, status will cycle though a couple states before becoming "Active". @@ -424,21 +437,28 @@ Follow the instructions in the `Install Bare Metal Jumphost`_ section. Running ``opnfv-deploy`` ------------------------ -You are now ready to deploy OPNFV! ``opnfv-deploy`` has virtual deployment capability that includes all of the configuration nessesary to deploy OPNFV with no modifications. +You are now ready to deploy OPNFV! +``opnfv-deploy`` has virtual deployment capability that includes all of +the configuration nessesary to deploy OPNFV with no modifications. -If no modifications are made to the included configurations the target environment will deploy with the following architecture: +If no modifications are made to the included configurations the target environment +will deploy with the following architecture: - 1 Instack VM - - The option of 3 control and 2 compute VMs (HA Deploy / default) or 1 control and 1 compute VM (Non-HA deploy / pass -n) + - The option of 3 control and 2 compute VMs (HA Deploy / default) + or 1 control and 1 compute VM (Non-HA deploy / pass -n) - - 2 networks, one for provisioning, internal API, storage and tenant networking traffic and a second for the external network + - 2 networks, one for provisioning, internal API, + storage and tenant networking traffic and a second for the external network Follow the steps below to execute: 1. ``opnfv-deploy --virtual [ --no-ha ]`` -2. It will take approximately 30 minutes to stand up instack, define the target virtual machines, configure the deployment and execute the deployment. You will notice different outputs in your shell. +2. It will take approximately 30 minutes to stand up instack, + define the target virtual machines, configure the deployment and execute the deployment. + You will notice different outputs in your shell. 3. When the deployment is complete you will see "Overcloud Deployed" @@ -513,10 +533,3 @@ RDO Manager :Authors: Tim Rozet (trozet@redhat.com) :Authors: Dan Radez (dradez@redhat.com) :Version: 1.0 - -**Documentation tracking** - -Revision: _sha1_ - -Build date: _date_ - diff --git a/docs/release-notes/index.rst b/docs/release-notes/index.rst index 17436e2b..1f723960 100644 --- a/docs/release-notes/index.rst +++ b/docs/release-notes/index.rst @@ -1,16 +1,6 @@ -.. OPNFV Release Engineering documentation, created by - sphinx-quickstart on Tue Jun 9 19:12:31 2015. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. - -.. image:: ../etc/opnfv-logo.png - :height: 40 - :width: 200 - :alt: OPNFV - :align: left - -Apex Table of Contents -====================== +************************ +OPNFV Apex Release Notes +************************ Contents: @@ -19,12 +9,3 @@ Contents: :maxdepth: 4 release-notes.rst - -Indices and tables -================== - -* :ref:`search` - -Revision: _sha1_ - -Build date: |today| diff --git a/docs/release-notes/release-notes.rst b/docs/release-notes/release-notes.rst index 2e535412..cfb0db59 100644 --- a/docs/release-notes/release-notes.rst +++ b/docs/release-notes/release-notes.rst @@ -1,6 +1,6 @@ -============================================================================================= +============================================================================================ OPNFV Release Notes for the Bramaputra release of OPNFV when using Apex as a deployment tool -============================================================================================= +============================================================================================ .. contents:: Table of Contents @@ -65,7 +65,8 @@ node. - Documentation is built by Jenkins - .iso image is built by Jenkins -- Jenkins deploys a Bramaputra release with the Apex deployment toolchain baremetal, which includes 3 control+network nodes, and 2 compute nodes. +- Jenkins deploys a Bramaputra release with the Apex deployment toolchain baremetal, + which includes 3 control+network nodes, and 2 compute nodes. Release Data ============ @@ -220,10 +221,3 @@ http://wiki.opnfv.org/releases/bramaputra :Authors: Tim Rozet (trozet@redhat.com) :Authors: Dan Radez (dradez@redhat.com) :Version: 1.0.0 - -**Documentation tracking** - -Revision: _sha1_ - -Build date: _date_ - -- cgit 1.2.3-korg