From b954567cde59d3e2bc228b9c38d6c99bd391b284 Mon Sep 17 00:00:00 2001 From: liyuenan Date: Tue, 13 Sep 2016 16:41:31 +0800 Subject: 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 --- docs/installationprocedure/expansion.rst | 302 +++++++++++++++++++++++++++++++ docs/installationprocedure/index.rst | 1 + 2 files changed, 303 insertions(+) create mode 100644 docs/installationprocedure/expansion.rst (limited to 'docs') 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 -- cgit 1.2.3-korg