diff options
author | 2016-01-31 19:19:36 +0100 | |
---|---|---|
committer | 2016-02-01 13:45:18 +0000 | |
commit | 5cfe9f9299ab1bc39401b11f780c1eef8e425677 (patch) | |
tree | f1b6abf2c46a219c90df1959cd303c1fcbee8f21 /docs/configguide/introduction.rst | |
parent | 13984a4de5090f961b2cf2c1923ffa72f1488343 (diff) |
Updating directory structure to add files to the central docs.
Moved the introduction and baremetal installation instructions to /configguide.
The files baremetal and introduction will be pulled into the central
config guide document for release. (A little local file name juggling
was required to accommodate the toolchain.)
Once merged this should be pulled into the configguide. Will work on a
patch for that now.
Change-Id: Ie270154d0c7ac418b693ac7cf6e1444a33023266
Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
Diffstat (limited to 'docs/configguide/introduction.rst')
-rw-r--r-- | docs/configguide/introduction.rst | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/docs/configguide/introduction.rst b/docs/configguide/introduction.rst new file mode 100644 index 00000000..af8e03b6 --- /dev/null +++ b/docs/configguide/introduction.rst @@ -0,0 +1,41 @@ +Introduction +============ + +This document describes the steps to install an OPNFV Bramaputra reference +platform, as defined by the Genesis Project using the Apex installer. + +The audience is assumed to have a good background in networking +and Linux administration. + +Preface +======= + +Apex uses the RDO Manager Open Source project as a server provisioning tool. +RDO Manager is the RDO Project implimentation of OpenStack's Triple-O project. +The Triple-O image based life cycle installation tool provisions an OPNFV +Target System (3 controllers, n number of compute nodes) with OPNFV specific +configuration provided by the Apex deployment tool chain. + +The Apex deployment artifacts contain the necessary tools to deploy and +configure an OPNFV target system using the Apex deployment toolchain. +These artifacts offer the choice of using the Apex bootable ISO +(``opnfv-apex-bramaputra.iso``) to both install CentOS 7 and the +nessesary materials to deploy or the Apex RPM (``opnfv-apex.rpm``) +which expects installation to a CentOS 7 libvirt enabled host. The RPM +contains a collection of configuration file, prebuilt disk images, +and the automatic deployment script (``opnfv-deploy``). + +An OPNFV install requires a "Jumphost" in order to operate. The bootable +ISO will allow you to install a customized CentOS 7 release to the Jumphost, +which includes the required packages needed to run ``opnfv-deploy``. +If you already have a Jumphost with CentOS 7 installed, you may choose to +skip the ISO step and simply install the (``opnfv-apex.rpm``) RPM. The RPM +is the same RPM included in the ISO and includes all the necessary disk +images and configuration files to execute an OPNFV deployment. Either method +will prepare a host to the same ready state for OPNFV deployment. + +``opnfv-deploy`` instantiates an RDO Manager Instack VM server using libvirt +as its provider. This VM is then configured and used to provision the +OPNFV target deployment (3 controllers, n compute nodes). These nodes can +be either virtual or bare metal. This guide contains instructions for +installing either method. |