summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorZhijiang <hu.zhijiang@zte.com.cn>2017-02-07 00:43:12 -0500
committerZhijiang <hu.zhijiang@zte.com.cn>2017-02-07 07:59:03 -0500
commit728a66ed238abe999b8f1b8bee30ff1dc3017eb8 (patch)
tree1c34dd2c7f94a1f37345c9a1d1b15296289ec5cd
parent35d0a0c0274dd7a298d691f0afcd8e745ef9f641 (diff)
Add basic installation guide docs
Change-Id: I9ecb49ceee687b6488f8635544e46e854989d6a5 Signed-off-by: Zhijiang <hu.zhijiang@zte.com.cn>
-rw-r--r--docs/installationprocedure/bmdeploy.rst7
-rw-r--r--docs/installationprocedure/index.rst22
-rw-r--r--docs/installationprocedure/installation_guide.rst168
-rw-r--r--docs/installationprocedure/instruction.rst15
-rw-r--r--docs/installationprocedure/introduction.rst24
-rw-r--r--docs/installationprocedure/vmdeploy.rst123
6 files changed, 333 insertions, 26 deletions
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 <http://creativecommons.org/licenses/by/4.0/>.
+.. 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 <https://www.opnfv.org/software>`_
+
+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 <http://creativecommons.org/licenses/by/4.0/>.
-
-
-========
-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
+
+