ZTE SH Lab documents

Add ZTE SH Lab information into documents

JIRA: PHAROS-228

Change-Id: I4d9594b0a1a127cef5118bdb2a1f343185f97cb5
Signed-off-by: Julien-zte <zhang.jun3g@zte.com.cn>

7 files changed, 303 insertions, 1 deletions

diff --git a/docs/index.rst b/docs/index.rst
index 47a09bbb..9a8530a8 100755
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -26,7 +26,7 @@ OPNFV Community Lab Infrastructure
    ./labs/OOL.rst
    ./labs/orange-paris-lab/orange_paris.rst
    ./labs/spirent.rst
-
+   ./labs/zte-sh-lab/zte-sh.rst
 
 Indices
 =======
diff --git a/docs/labs/zte-sh-lab/images/zte_sh_lab_topology.png b/docs/labs/zte-sh-lab/images/zte_sh_lab_topology.png
new file mode 100644
index 00000000..5c2576df
--- /dev/null
+++ b/docs/labs/zte-sh-lab/images/zte_sh_lab_topology.png
diff --git a/docs/labs/zte-sh-lab/images/zte_sh_pod3_topology.png b/docs/labs/zte-sh-lab/images/zte_sh_pod3_topology.png
new file mode 100644
index 00000000..592b6077
--- /dev/null
+++ b/docs/labs/zte-sh-lab/images/zte_sh_pod3_topology.png
diff --git a/docs/labs/zte-sh-lab/lab_description.rst b/docs/labs/zte-sh-lab/lab_description.rst
new file mode 100644
index 00000000..bb125f1e
--- /dev/null
+++ b/docs/labs/zte-sh-lab/lab_description.rst
@@ -0,0 +1,85 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) 2016 OPNFV.
+
+.. _pharos_lab:
+
+************************
+ZTE SH Lab Specification
+************************
+
+
+Introduction
+------------
+
+ZTE SH Pharos lab currently has one POD available in Shanghai. The POD has 5 servers, 3 controller
+nodes and 2 computer nodes. It is dedicatedly used for baremetal CI. The POD is supposed to support
+scenarios related with performance enhancement projects, such as KVM, OVS, FDS, etc.
+
+Scenarios planned are list here:
+
+- os-nosdn-kvm-ha
+- os-nosdn-kvm_ovs-ha
+
+Scenarios are defined in
+`Colorado Scenario Status <https://wiki.opnfv.org/display/SWREL/Colorado+Scenario+Status>`_
+
+
+Lab Resources
+-------------
+
++----------+------------+-----------+-------------------------+------------+--------+---------+
+| POD Name | Project(s) | PTL(s)    | Email(s)                | POD Role   | Status | Notes   |
++----------+------------+-----------+-------------------------+------------+--------+---------+
+| POD3     | FUEL       | Gregory   | gelkinbard@mirantis.com | CI: latest | Active | NFV-KVM |
+|          |            | Elkinbard |                         |            |        | OVSNFV  |
++----------+------------+-----------+-------------------------+------------+--------+---------+
+
+- `POD3 wiki page <https://wiki.opnfv.org/display/pharos/ZTE+SH+Testlab>`_
+- `POD3 jenkins slave <https://build.opnfv.org/ci/computer/zte-pod3/>`_
+
+
+Acceptable Usage Policy
+-----------------------
+
+Resources located in OPNFV ZTE SH lab shall only be used for CI, infra setup/configuration and
+troubleshooting purposes. No development work is allowed in this Lab.
+
+
+Remote Access Infrastructure
+----------------------------
+
+ZTE SH lab provide the OpenVPN access for you.
+
+
+Remote Access Procedure
+-----------------------
+
+Access to this environment can be granted by sending an e-mail to: **yangyang1@zte.com.cn**.
+
+Subject: opnfv zte-pod3 access.
+
+The following information should be provided in the request:
+
+::
+
+    Full name:
+    E-mail:
+    Organization:
+    Why is access needed:
+    How long is access needed:
+    What sepcific Host will be accessed:
+    What support is needed from zte admin:
+
+Once access requirment is approved, the instructions for setting up VPN access will be send to you by mail.
+
+
+Lab Documentation
+-----------------
+
+
+Lab Topology
+------------
+
+.. image:: ./images/zte_sh_lab_topology.png
+   :alt: Lab diagram not found
diff --git a/docs/labs/zte-sh-lab/pod3_description.rst b/docs/labs/zte-sh-lab/pod3_description.rst
new file mode 100644
index 00000000..fdc32d16
--- /dev/null
+++ b/docs/labs/zte-sh-lab/pod3_description.rst
@@ -0,0 +1,155 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) 2016 OPNFV.
+
+.. _pharos_pod:
+
+*************************
+ZTE SH POD3 Specification
+*************************
+
+
+Introduction
+------------
+
+POD3(means ZTE-POD3) uses Fuel as the installer and performs os-nosdn-kvm-ha CI latest verification.
+Feature projects like NFV-KVMV, OVSNFV will be run in this POD.
+
+
+Additional Requirements
+-----------------------
+
+
+Server Specifications
+---------------------
+
+**Jump Host**
+
++----------+--------+-------+---------------+-----------+--------+-----------+-------------------+------------------+-------+
+|          |        |       |               |           | Memory | Local     | 1GbE: NIC#/IP     | 10GbE: NIC#/IP   |       |
+| Hostname | Vendor | Model | Serial Number | CPUs      | (GB)   | Storage   | MAC/VLAN/Network  | MAC/VLAN/Network | Notes |
++----------+--------+-------+---------------+-----------+--------+-----------+-------------------+------------------+-------+
+| Frog     | ZTE    | R5300 | 210077307607  | E5-2609x2 | 32     | 600GB SAS | IF0: 10.20.0.1    |                  |       |
+|          |        |       |               |           |        | 2TB HDD   | 74:4a:a4:00:21:0b |                  |       |
+|          |        |       |               |           |        |           | vlan 100/PXE      |                  |       |
+|          |        |       |               |           |        |           |                   |                  |       |
++----------+--------+-------+---------------+-----------+--------+-----------+-------------------+------------------+-------+
+
+
+**Compute Nodes**
+
++----------+--------+-------+---------------+-----------+--------+-----------+---------------------+------------------+----------------------+-------+
+|          |        |       |               |           | Memory | Local     | Lights-out network  | 1GbE: NIC#/IP    | 10GbE: NIC#/IP       |       |
+| Hostname | Vendor | Model | Serial Number | CPUs      | (GB)   | Storage   | (IPMI): IP/MAC, U/P | MAC/VLAN/Network | MAC/VLAN/Network     | Notes |
++----------+--------+-------+---------------+-----------+--------+-----------+---------------------+------------------+----------------------+-------+
+| node1    | ZTE    | E9000 | 289016500203  | E5-2670x2 | 64     | 600GB HDD | 192.168.1.32        |                  | enp2s0f0:            |       |
+|          |        |       |               |           |        |           | 0c:12:62:e4:bf:de   |                  | 74:4a:a4:00:0b:85    |       |
+|          |        |       |               |           |        |           | zteroot/superuser   |                  | vlan 100/ Admin(PXE) |       |
+|          |        |       |               |           |        |           |                     |                  | enp2s0f1:            |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:0b:86    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 101/ mgmt       |       |
+|          |        |       |               |           |        |           |                     |                  | enp132s0f0:          |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:0b:87    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 102/ storage    |       |
+|          |        |       |               |           |        |           |                     |                  | enp132s0f1:          |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:0b:88    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 103/ public     |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 1020/ private   |       |
++----------+--------+-------+---------------+-----------+--------+-----------+---------------------+------------------+----------------------+-------+
+| node2    | ZTE    | E9000 | 289016500197  | E5-2670x2 | 64     | 600GB HDD | 192.168.1.33        |                  | enp2s0f0:            |       |
+|          |        |       |               |           |        |           | 0C:12:62:E4:C0:33   |                  | 74:4a:a4:00:5c:5d    |       |
+|          |        |       |               |           |        |           | zteroot/superuser   |                  | vlan 100/ Admin(PXE) |       |
+|          |        |       |               |           |        |           |                     |                  | enp2s0f1:            |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:5c:5e    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 101/ mgmt       |       |
+|          |        |       |               |           |        |           |                     |                  | enp132s0f0:          |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:5c:5f    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 102/ storage    |       |
+|          |        |       |               |           |        |           |                     |                  | enp132s0f1:          |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:5c:60    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 103/ public     |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 1020/ private   |       |
++----------+--------+-------+---------------+-----------+--------+-----------+---------------------+------------------+----------------------+-------+
+| node3    | ZTE    | E9000 | 289016500003  | E5-2670x2 | 64     | 600GB HDD | 192.168.1.34        |                  | enp2s0f0:            |       |
+|          |        |       |               |           |        |           | 74:4A:A4:00:30:93   |                  | 74:4a:a4:00:5c:35    |       |
+|          |        |       |               |           |        |           | zteroot/superuser   |                  | vlan 100/ Admin(PXE) |       |
+|          |        |       |               |           |        |           |                     |                  | enp2s0f1:            |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:5c:36    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 101/ mgmt       |       |
+|          |        |       |               |           |        |           |                     |                  | enp132s0f0:          |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:5c:37    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 102/ storage    |       |
+|          |        |       |               |           |        |           |                     |                  | enp132s0f1:          |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:5c:38    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 103/ public     |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 1020/ private   |       |
++----------+--------+-------+---------------+-----------+--------+-----------+---------------------+------------------+----------------------+-------+
+| node4    | ZTE    | E9000 | 289016500105  | E5-2670x2 | 64     | 600GB HDD | 192.168.1.35        |                  | enp2s0f0:            |       |
+|          |        |       |               |           |        |           | 0C:12:62:E4:C0:42   |                  | 74:4a:a4:00:5c:69    |       |
+|          |        |       |               |           |        |           | zteroot/superuser   |                  | vlan 100/ Admin(PXE) |       |
+|          |        |       |               |           |        |           |                     |                  | enp2s0f1:            |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:5c:6a    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 101/ mgmt       |       |
+|          |        |       |               |           |        |           |                     |                  | enp132s0f0:          |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:5c:6b    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 102/ storage    |       |
+|          |        |       |               |           |        |           |                     |                  | enp132s0f1:          |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:5c:6c    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 103/ public     |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 1020/ private   |       |
++----------+--------+-------+---------------+-----------+--------+-----------+---------------------+------------------+----------------------+-------+
+| node5    | ZTE    | E9000 | 289016500195  | E5-2670x2 | 64     | 600GB HDD | 192.168.1.36        |                  | enp2s0f0:            |       |
+|          |        |       |               |           |        |           | 74:4A:A4:00:30:43   |                  | 74:4a:a4:00:5c:6d    |       |
+|          |        |       |               |           |        |           | zteroot/superuser   |                  | vlan 100/ Admin(PXE) |       |
+|          |        |       |               |           |        |           |                     |                  | enp2s0f1:            |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:5c:6e    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 101/ mgmt       |       |
+|          |        |       |               |           |        |           |                     |                  | enp132s0f0:          |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:5c:6f    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 102/ storage    |       |
+|          |        |       |               |           |        |           |                     |                  | enp132s0f1:          |       |
+|          |        |       |               |           |        |           |                     |                  | 74:4a:a4:00:5c:70    |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 103/ public     |       |
+|          |        |       |               |           |        |           |                     |                  | vlan 1020/ private   |       |
++----------+--------+-------+---------------+-----------+--------+-----------+---------------------+------------------+----------------------+-------+
+
+**Subnet allocations**
+
++----------------+--------------+----------------+------------+-----------------+
+| Network name   | Address      | Mask           | Gateway    | VLAN id         |
++----------------+--------------+----------------+------------+-----------------+
+| Public         | 172.10.0.0   |  255.255.255.0 | 172.10.0.1 | 103             |
++----------------+--------------+----------------+------------+-----------------+
+| Fuel Admin/PXE | 10.20.0.0    |  255.255.255.0 | 10.20.0.1  | native valn 100 |
++----------------+--------------+----------------+------------+-----------------+
+| Fuel Mangement | 192.168.11.0 |  255.255.255.0 |            | 101             |
++----------------+--------------+----------------+------------+-----------------+
+| Fuel Storage   | 192.168.12.0 |  255.255.255.0 |            | 102             |
++----------------+--------------+----------------+------------+-----------------+
+
+
+VPN Users
+---------
+
++--------------+--------------+--------------+--------------+--------------+
+| Name         | Email        | Project      | Role         | Notes        |
++--------------+--------------+--------------+--------------+--------------+
+|              |              |              |              |              |
++--------------+--------------+--------------+--------------+--------------+
+
+
+Firewall Rules
+--------------
+
++---------------+---------+------+
+| Port(s)       | Service | Note |
++---------------+---------+------+
+| 5000(OpenVPN) | Jenkins |      |
++---------------+---------+------+
+
+
+POD Topology
+------------
+
+.. image:: ./images/zte_sh_pod3_topology.png
+   :alt: POD diagram not found
diff --git a/docs/labs/zte-sh-lab/pod3_inventory.yaml b/docs/labs/zte-sh-lab/pod3_inventory.yaml
new file mode 100644
index 00000000..061c07cb
--- /dev/null
+++ b/docs/labs/zte-sh-lab/pod3_inventory.yaml
@@ -0,0 +1,47 @@
+nodes:
+   - name: node1
+     tags: control
+     arch: "x86_64"
+     mac_address: "74:4a:a4:00:0b:85"
+     power:
+       type: ipmi
+       address: 192.168.1.32 
+       user: zteroot
+       pass: superuser
+   - name: node2
+     tags: control
+     arch: "x86_64"
+     mac_address: "74:4a:a4:00:5c:5d"
+     power:
+       type: ipmi
+       address: 192.168.1.33
+       user: zteroot
+       pass: superuser
+   - name: node3
+     tags: control
+     arch: "x86_64"
+     mac_address: "74:4a:a4:00:5c:35"
+     power:
+       type: ipmi
+       address: 192.168.1.34
+       user: zteroot
+       pass: superuser
+   - name: node4
+     tags: compute
+     arch: "x86_64"
+     mac_address: "74:4a:a4:00:5c:69"
+     power:
+       type: ipmi
+       address: 192.168.1.35
+       user: zteroot
+       pass: superuser
+   - name: node5
+     tags: compute
+     arch: "x86_64"
+     mac_address: "74:4a:a4:00:5c:6d"
+     power:
+       type: ipmi
+       address: 192.168.1.36
+       user: zteroot
+       pass: superuser
+
diff --git a/docs/labs/zte-sh-lab/zte-sh.rst b/docs/labs/zte-sh-lab/zte-sh.rst
new file mode 100644
index 00000000..e48c21d4
--- /dev/null
+++ b/docs/labs/zte-sh-lab/zte-sh.rst
@@ -0,0 +1,15 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) 2016 OPNFV.
+
+.. Top level of Pharos templates and configuration files
+
+*************************************
+ZTE SH Pharos Lab Configuration Files
+*************************************
+
+
+.. toctree::
+
+   ./lab_description.rst
+   ./pod3_description.rst