From 728a66ed238abe999b8f1b8bee30ff1dc3017eb8 Mon Sep 17 00:00:00 2001 From: Zhijiang Date: Tue, 7 Feb 2017 00:43:12 -0500 Subject: Add basic installation guide docs Change-Id: I9ecb49ceee687b6488f8635544e46e854989d6a5 Signed-off-by: Zhijiang --- docs/installationprocedure/bmdeploy.rst | 7 + docs/installationprocedure/index.rst | 22 +-- docs/installationprocedure/installation_guide.rst | 168 ++++++++++++++++++++++ docs/installationprocedure/instruction.rst | 15 -- docs/installationprocedure/introduction.rst | 24 ++++ docs/installationprocedure/vmdeploy.rst | 123 ++++++++++++++++ 6 files changed, 333 insertions(+), 26 deletions(-) create mode 100644 docs/installationprocedure/bmdeploy.rst create mode 100644 docs/installationprocedure/installation_guide.rst delete mode 100644 docs/installationprocedure/instruction.rst create mode 100644 docs/installationprocedure/introduction.rst create mode 100644 docs/installationprocedure/vmdeploy.rst diff --git a/docs/installationprocedure/bmdeploy.rst b/docs/installationprocedure/bmdeploy.rst new file mode 100644 index 00000000..76d02ba6 --- /dev/null +++ b/docs/installationprocedure/bmdeploy.rst @@ -0,0 +1,7 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Installation Guide (Bare Metal Deployment) +========================================== + +TODO diff --git a/docs/installationprocedure/index.rst b/docs/installationprocedure/index.rst index 76ee5c09..f88c8a5f 100644 --- a/docs/installationprocedure/index.rst +++ b/docs/installationprocedure/index.rst @@ -1,16 +1,16 @@ -.. This document is protected/licensed under the following conditions -.. (c) Sun Jing (ZTE corporation) -.. Licensed under a Creative Commons Attribution 4.0 International License. -.. You should have received a copy of the license along with this work. -.. If not, see . +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 -***************************** -Release notes for Daisy4nfv -***************************** +******************************************************** +OPNFV(Danube) Daisy4nfv Installation Guide +******************************************************** .. toctree:: - :numbered: - :maxdepth: 2 + :numbered: + :maxdepth: 4 - instruction.rst + introduction.rst + installation_guide.rst + bmdeploy.rst + vmdeploy.rst diff --git a/docs/installationprocedure/installation_guide.rst b/docs/installationprocedure/installation_guide.rst new file mode 100644 index 00000000..fbcd8396 --- /dev/null +++ b/docs/installationprocedure/installation_guide.rst @@ -0,0 +1,168 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Daisy4nfv configuration +======================= + +This document provides guidelines on how to install and configure the Danube +release of OPNFV when using Daisy as a deployment tool including required +software and hardware configurations. + +Installation and configuration of host OS, OpenStack etc. can be supported by +Daisy on Virtual nodes and Bare Metal nodes. + +The audience of this document is assumed to have good knowledge in +networking and Unix/Linux administration. + +Prerequisites +------------- + +Before starting the installation of the Danube release of OPNFV, some plannings +must be done. + + +Retrieving the installation bin image +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +First of all, the installation bin which includes packages of Daisy, OS, +OpenStack, and so on is needed for deploying your OPNFV environment. + +The stable release bin image can be retrieved via `OPNFV software download page `_ + +The daily build bin image can be retrieved via OPNFV artifacts repository: + +http://artifacts.opnfv.org/daisy.html + +NOTE: Search the keyword "daisy/Danube" to locate the bin image. + +E.g. +daisy/opnfv-gerrit-27155.bin + +The git url and sha1 of bin image are recorded in properties files. +According to these, the corresponding deployment scripts can be retrieved. + + +Retrieve the deployment scripts +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +To retrieve the repository of Daisy on Jumphost use the following command: + +- git clone https://gerrit.opnfv.org/gerrit/daisy + +To get stable Danube release, you can use the following command: + +- git checkout danube.1.0 + + +Setup Requirements +------------------ + +If you have only 1 Bare Metal server, Virtual deployment is recommended. if you have more +than 3 servers, the Bare Metal deployment is recommended. The minimum number of +servers for each role in Bare metal deployment is listed down below. + ++------------+-----------------------+ +| **Role** | **Number of Severs** | +| | | ++------------+-----------------------+ +| Jump Host | 1 | +| | | ++------------+-----------------------+ +| Controller | 1 | +| | | ++------------+-----------------------+ +| Compute | 1 | +| | | ++------------+-----------------------+ + + +Jumphost Requirements +~~~~~~~~~~~~~~~~~~~~~ + +The Jumphost requirements are outlined below: + +1. CentOS 7.2 (Pre-installed). + +2. Root access. + +3. Libvirt virtualization support(For virtual deployment). + +4. Minimum 1 NIC(or 2 NICs for virtual deployment). + + - PXE installation Network (Receiving PXE request from nodes and providing OS provisioning) + + - IPMI Network (Nodes power control and set boot PXE first via IPMI interface) + + - Internet access (For getting latest OS updates) + + - External Interface(For virtual deployment, exclusively used by instance traffic to access the rest of the Internet) + +5. 16 GB of RAM for a Bare Metal deployment, 64 GB of RAM for a Virtual deployment. + +6. CPU cores: 32, Memory: 64 GB, Hard Disk: 500 GB, (Virtual deployment needs 1 TB Hard Disk) + + +Bare Metal Node Requirements +---------------------------- + +Bare Metal nodes require: + +1. IPMI enabled on OOB interface for power control. + +2. BIOS boot priority should be PXE first then local hard disk. + +3. Minimum 1 NIC for Compute nodes, 2 NICs for Controller nodes. + + - PXE installation Network (Broadcasting PXE request) + + - IPMI Network (Receiving IPMI command from Jumphost) + + - Internet access (For getting latest OS updates) + + - External Interface(For virtual deployment, exclusively used by instance traffic to access the rest of the Internet) + + + + +Network Requirements +-------------------- + +Network requirements include: + +1. No DHCP or TFTP server running on networks used by OPNFV. + +2. 2-7 separate networks with connectivity between Jumphost and nodes. + + - PXE installation Network + + - IPMI Network + + - Internet access Network + + - OpenStack Public API Network + + - OpenStack Private API Network + + - OpenStack External Network + + - OpenStack Tenant Network(currently, VxLAN only) + + +3. Lights out OOB network access from Jumphost with IPMI node enabled (Bare Metal deployment only). + +4. Internet access Network has Internet access, meaning a gateway and DNS availability. + +5. OpenStack External Network has Internet access too if you want instances to access the Internet. + +Note: **All networks except OpenStack External Network can share one NIC(Default configuration) or use an exclusive** +**NIC(Reconfigurated in network.yml).** + + +Execution Requirements (Bare Metal Only) +---------------------------------------- + +In order to execute a deployment, one must gather the following information: + +1. IPMI IP addresses of the nodes. + +2. IPMI login information for the nodes (user/password). diff --git a/docs/installationprocedure/instruction.rst b/docs/installationprocedure/instruction.rst deleted file mode 100644 index 795f6028..00000000 --- a/docs/installationprocedure/instruction.rst +++ /dev/null @@ -1,15 +0,0 @@ - -.. This document is protected/licensed under the following conditions -.. (c) Sun Jing (ZTE corporation) -.. Licensed under a Creative Commons Attribution 4.0 International License. -.. You should have received a copy of the license along with this work. -.. If not, see . - - -======== -Abstract -======== - -This document compiles the release notes for the D 2.0 release of -OPNFV when using Daisy4nfv as a deployment tool. - diff --git a/docs/installationprocedure/introduction.rst b/docs/installationprocedure/introduction.rst new file mode 100644 index 00000000..12a3f1db --- /dev/null +++ b/docs/installationprocedure/introduction.rst @@ -0,0 +1,24 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International Licence. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) by Weidong Shao (HUAWEI) and Justin Chi (HUAWEI) + +Abstract +======== + +This document describes how to install the Danube release of OPNFV when using +Daisy4nfv as a deployment tool covering it's limitations, dependencies and +required resources. + +Version history +=============== + ++--------------------+--------------------+--------------------+---------------------------+ +| **Date** | **Ver.** | **Author** | **Comment** | +| | | | | ++--------------------+--------------------+--------------------+---------------------------+ +| 2017-02-07 | 0.0.1 | Zhijiang Hu | Initial version | +| | | (ZTE) | | ++--------------------+--------------------+--------------------+---------------------------+ + + + diff --git a/docs/installationprocedure/vmdeploy.rst b/docs/installationprocedure/vmdeploy.rst new file mode 100644 index 00000000..bf44c1f9 --- /dev/null +++ b/docs/installationprocedure/vmdeploy.rst @@ -0,0 +1,123 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International Licence. +.. http://creativecommons.org/licenses/by/4.0 + +Installation Guide (Virtual Deployment) +======================================= + +Nodes Configuration (Virtual Deployment) +---------------------------------------- + +The below file is the inventory template of deployment nodes: + +"./deploy/conf/vm_environment/zte-virtual1/network.yml" + +You can write your own address/roles reference into it. + + - name -- Host name for deployment node after installation. + + - roles -- Components deployed. + +**Set TYPE and FLAVOR** + +E.g. + +.. code-block:: yaml + + TYPE: virtual + FLAVOR: cluster + +**Assignment of different roles to servers** + +E.g. OpenStack only deployment roles setting + +.. code-block:: yaml + + hosts: + - name: host1 + roles: + - controller + - ha + + - name: host2 + roles: + - compute + +NOTE: +IF YOU SELECT MUTIPLE NODES AS CONTROLLER, THE 'ha' role MUST BE SELECT, TOO. + +E.g. OpenStack and ceph deployment roles setting + +.. code-block:: yaml + + hosts: + - name: host1 + roles: + - controller + - ha + - ceph-adm + - ceph-mon + + - name: host2 + roles: + - compute + +Network Configuration (Virtual Deployment) +------------------------------------------ + +Before deployment, there are some network configuration to be checked based +on your network topology. The default network configuration file for Daisy is +"daisy/deploy/config/vm_environment/zte-virtual1/network.yml". +You can write your own reference into it. + +**The following figure shows the default network configuration.** + +.. code-block:: console + + +--+ + | | + +------------+ | | + | Jumphost +------+ | + +------------+ | | + | | + | | + | | + +------------+ | | + +--------+ Controller +------+ | + | +------------+ | | + | | | + | | | + | | | + | +------------+ | | + | | Compute1 +------+ | + | +------------+ | | + | | | + | | | + | | | + | +------------+ | | + | | Compute2 +------+ | + | +------------+ | | + | | | + | | | + | | | + | | | + | ++-+ + | ^ + | | + | | + ++--------------------------+ | + | External Network | | + +---------------------------+ | + +-----------------------+---+ + | Installation Network | + | Public/Private API | + | Internet Access | + | Tenant Network | + +---------------------------+ + + +Start Deployment (Virtual Deployment) +------------------------------------- + +TODO + + -- cgit 1.2.3-korg