Add the expansion instruction

The expansion.rst shows how to increase a new compute node when
other nodes are working.

JIRA: DOCS-159

Change-Id: I36366940a2b67256319dc2a362ff5e81c17be243
Signed-off-by: liyuenan <liyuenan@huawei.com>

2 files changed, 303 insertions, 0 deletions

diff --git a/docs/installationprocedure/expansion.rst b/docs/installationprocedure/expansion.rst
new file mode 100644
index 00000000..1ffdafbd
--- /dev/null
+++ b/docs/installationprocedure/expansion.rst
@@ -0,0 +1,302 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) by Weidong Shao (HUAWEI) and Justin Chi (HUAWEI)
+
+Expansion Guide
+===============
+
+Bare Metal Expansion
+--------------------
+
+Edit NETWORK File
+~~~~~~~~~~~~~~~~~
+
+The below file is the inventory template of deployment nodes:
+
+    "./deploy/conf/hardware_environment/huawei-pod1/network.yml"
+
+You can edit the network.yml which you had edited before the first deployment.
+
+NOTE:
+External subnet's ip_range should be changed as the first 6 IPs are already taken
+by the first deployment.
+
+Edit DHA File
+~~~~~~~~~~~~~
+
+The below file is the inventory template of deployment nodes:
+
+"./deploy/conf/hardware_environment/expansion-sample/hardware_cluster_expansion.yml"
+
+You can write your own IPMI IP/User/Password/Mac address/roles reference to it.
+
+        - name -- Host name for deployment node after installation.
+
+        - ipmiIP -- IPMI IP address for deployment node. Make sure it can access
+          from Jumphost.
+
+        - ipmiUser -- IPMI Username for deployment node.
+
+        - ipmiPass -- IPMI Password for deployment node.
+
+        - mac -- MAC Address of deployment node PXE NIC .
+
+**Set TYPE/FLAVOR and POWER TOOL**
+
+E.g.
+.. code-block:: yaml
+
+    TYPE: baremetal
+    FLAVOR: cluster
+    POWER_TOOL: ipmitool
+
+**Set ipmiUser/ipmiPass and ipmiVer**
+
+E.g.
+
+.. code-block:: yaml
+
+    ipmiUser: USER
+    ipmiPass: PASSWORD
+    ipmiVer: '2.0'
+
+**Assignment of roles to servers**
+
+E.g. Only increase one compute node
+
+.. code-block:: yaml
+
+    hosts:
+       - name: host6
+         mac: 'E8:4D:D0:BA:60:45'
+         interfaces:
+            - eth1: '08:4D:D0:BA:60:44'
+         ipmiIp: 172.16.131.23
+         roles:
+           - compute
+
+
+E.g. Increase two compute nodes
+
+.. code-block:: yaml
+
+    hosts:
+       - name: host6
+         mac: 'E8:4D:D0:BA:60:45'
+         interfaces:
+            - eth1: '08:4D:D0:BA:60:44'
+         ipmiIp: 172.16.131.23
+         roles:
+           - compute
+
+       - name: host6
+         mac: 'E8:4D:D0:BA:60:78'
+         interfaces:
+            - eth1: '08:4D:56:BA:60:83'
+         ipmiIp: 172.16.131.23
+         roles:
+           - compute
+
+Start Expansion
+~~~~~~~~~~~~~~~
+
+1. Edit add.sh
+
+Set OS version and OpenStack version for deployment nodes.
+    Compass4nfv Colorado supports three OS version based openstack mitaka.
+
+E.g.
+
+.. code-block:: bash
+
+    ########## Ubuntu14.04 Mitaka ##########
+    export OS_VERSION=trusty
+    export OPENSTACK_VERSION=mitaka
+
+    ########## Ubuntu16.04 Mitaka ##########
+    # export OS_VERSION=xenial
+    # export OPENSTACK_VERSION=mitaka_xenial
+
+    ########## Centos7 Mitaka ##########
+    # export OS_VERSION=centos7
+    # export OPENSTACK_VERSION=mitaka
+
+NOTE:
+The OS version and OpenStack version should be same as the first deployment.
+
+Set ISO image that you want to deploy
+
+E.g.
+
+.. code-block:: bash
+
+    # ISO_URL is your iso's absolute path
+    export ISO_URL=file:///home/compass/compass4nfv.iso
+    # or
+    # export ISO_URL=http://artifacts.opnfv.org/compass4nfv/colorado/opnfv-colorado.1.0.iso
+
+Set scenario that you want to expansion
+
+E.g.
+
+.. code-block:: bash
+
+    # DHA is your dha.yml's path
+    export DHA=./deploy/conf/hardware_environment/expansion-sample/hardware_cluster_expansion.yml
+
+    # NETWORK is your network.yml's path
+    export NETWORK=./deploy/conf/hardware_environment/huawei-pod1/network.yml
+
+Comment out VIRT_NUMBER when bare metal expansion
+
+E.g.
+
+.. code-block:: bash
+
+    #export VIRT_NUMBER=1
+
+Set jumpserver PXE NIC
+
+E.g.
+
+.. code-block:: bash
+
+    INSTALL_NIC=${INSTALL_NIC:-eth1}
+
+Check the environment variable.
+
+2. Run ``add.sh``
+
+.. code-block:: bash
+
+    ./add.sh
+
+Virtual Expansion
+-----------------
+
+Edit NETWORK File
+~~~~~~~~~~~~~~~~~
+
+The below file is the inventory template of deployment nodes:
+
+    "./deploy/conf/vm_environment/huawei-virtual1/network.yml"
+
+You can edit the network.yml which you had edited before the first deployment.
+
+NOTE:
+External subnet's ip_range should be changed as the first 6 IPs are already taken
+by the first deployment.
+
+Edit DHA File
+~~~~~~~~~~~~~
+
+The below file is the inventory template of deployment nodes:
+
+"./deploy/conf/vm_environment/virtual_cluster_expansion.yml"
+
+**Set TYPE and FLAVOR**
+
+E.g.
+
+.. code-block:: yaml
+
+    TYPE: virtual
+    FLAVOR: cluster
+
+**Assignment of roles to servers**
+
+E.g. Only increase one compute node
+
+.. code-block:: yaml
+
+    hosts:
+      - name: host6
+        roles:
+          - compute
+
+E.g. Increase two compute nodes
+
+.. code-block:: yaml
+
+    hosts:
+      - name: host6
+        roles:
+          - compute
+
+      - name: host7
+        roles:
+          - compute
+
+Start Expansion
+~~~~~~~~~~~~~~~
+
+1. Edit add.sh
+
+Set OS version and OpenStack version for deployment nodes.
+    Compass4nfv Colorado supports three OS version based openstack mitaka.
+
+E.g.
+
+.. code-block:: bash
+
+    ########## Ubuntu14.04 Mitaka ##########
+    export OS_VERSION=trusty
+    export OPENSTACK_VERSION=mitaka
+
+    ########## Ubuntu16.04 Mitaka ##########
+    # export OS_VERSION=xenial
+    # export OPENSTACK_VERSION=mitaka_xenial
+
+    ########## Centos7 Mitaka ##########
+    # export OS_VERSION=centos7
+    # export OPENSTACK_VERSION=mitaka
+
+NOTE:
+The OS version and OpenStack version should be same as the first deployment.
+
+Set ISO image that you want to deploy
+
+E.g.
+
+.. code-block:: bash
+
+    # ISO_URL is your iso's absolute path
+    export ISO_URL=file:///home/compass/compass4nfv.iso
+    # or
+    # export ISO_URL=http://artifacts.opnfv.org/compass4nfv/colorado/opnfv-colorado.1.0.iso
+
+Set scenario that you want to expansion
+
+E.g.
+
+.. code-block:: bash
+
+    # DHA is your dha.yml's path
+    export DHA=./deploy/conf/vm_environment/virtual_cluster_expansion.yml
+
+    # NETWORK is your network.yml's path
+    export NETWORK=./deploy/conf/vm_environment/huawei-virtual1/network.yml
+
+Set nodes number need to expansion
+
+E.g.
+
+.. code-block:: bash
+
+    export VIRT_NUMBER=1
+
+Comment out NIC when virtual expansion
+
+E.g.
+
+.. code-block:: bash
+
+    #INSTALL_NIC=${INSTALL_NIC:-eth1}
+
+Check the environment variable.
+
+2. Run ``add.sh``
+
+.. code-block:: bash
+
+    ./add.sh
diff --git a/docs/installationprocedure/index.rst b/docs/installationprocedure/index.rst
index 6416e35d..77439ae9 100644
--- a/docs/installationprocedure/index.rst
+++ b/docs/installationprocedure/index.rst
@@ -13,4 +13,5 @@ OPNFV(Colorado) Compass4nfv Installation Instructions
    installation.instruction.rst
    bmdeploy.rst
    vmdeploy.rst
+   expansion.rst
    references.rst