Update the Pharos template 49/17749/1
authorJulien <zhang.jun3g@zte.com.cn>
Thu, 28 Jul 2016 16:12:33 +0000 (00:12 +0800)
committerJulien <zhang.jun3g@zte.com.cn>
Thu, 28 Jul 2016 23:04:13 +0000 (07:04 +0800)
Reduce the width of table for easier reading,
Update the minor char changes

JIRA: PHAROS-29

Change-Id: I7a3fe8dd73a46d7866c022fbbd93f41d373eeef0
Signed-off-by: Julien <zhang.jun3g@zte.com.cn>
docs/lab-description/lab_description.rst
docs/lab-description/pod_description.rst
docs/lab-description/templates.rst

index da84aa1..d36e8c6 100644 (file)
@@ -17,11 +17,11 @@ Add an summary of what your lab hosts, its focus areas and purpose
 Lab Resources
 -------------
 
-+----------------+----------------+----------------+----------------+----------------+----------------+----------------+
-| POD Name       | Project(s)     | Project Lead(s)| Email(s)       |  POD Role      |  Status        | Notes          |
-+----------------+----------------+----------------+----------------+----------------+----------------+----------------+
-| POD1           |  project name  | John Doe       | john@abc.com   |  CI: stable    |  Active        |                |
-+----------------+----------------+----------------+----------------+----------------+----------------+----------------+
++----------+--------------+-----------------+--------------+-------------+---------+-------+
+| POD Name | Project(s)   | Project Lead(s) | Email(s)     |  POD Role   |  Status | Notes |
++----------+--------------+-----------------+--------------+-------------+---------+-------+
+| POD1     | Project Name | John Doe        | john@abc.com |  CI: stable |  Active |       |
++----------+--------------+-----------------+--------------+-------------+---------+-------+
 
 * **POD Name:** Use consistent naming / numbering to avoid confusion. Hyperlinked to POD description.
 * **POD Role:** CI stable, CI latest, Dev/test, Stand-alone, Virtual, ...
@@ -43,7 +43,8 @@ Describe lab remote access setup (typically VPN, also link speed, any known rest
 Remote Access Procedure
 -----------------------
 
-Define lab process for requesting access to the lab (e.g. VPN guide, how to modify BIOS settings, etc.)
+Define lab process for requesting access to the lab (e.g. VPN guide,
+how to modify BIOS settings, etc.)
 
 
 Lab Documentation
@@ -55,8 +56,8 @@ List lab specific documents here
 Lab Topology
 ------------
 
-Provide a diagram showing the network topology of lab including lights-out network. Any security sensitive details should
-not be exposed publically. The following diagram is an example only.
+Provide a diagram showing the network topology of lab including lights-out network. Any security
+sensitive details should not be exposed publically. The following diagram is an example only.
 
 .. image:: ./images/lab_topology_example.jpg
    :alt: Lab diagram not found
index 2d4047a..856d5c2 100644 (file)
@@ -26,67 +26,66 @@ Server Specifications
 
 **Jump Host**
 
-+--------------+---------+-------+---------------+--------------+--------+-----------+---------------------+-------------------+-------------------+-------+
-|              |         |       |               |              |        | Local     | Lights-out network  | 1GbE: NIC#/IP     | 10GbE: NIC#/IP    |       |
-|  Hostname    |  Vendor | Model | Serial Number |  CPUs        | Memory | storage   | (IPMI): IP/MAC, U/P | MAC/VLAN/Network  | MAC/VLAN/Network  | Notes |
-+--------------+---------+-------+---------------+--------------+--------+-----------+---------------------+-------------------+-------------------+-------+
-| pod2-jp-jump |  Dell   | R730  | ABCDEF007     |  2 x E5-2699 |  64 GB | 240GB SSD | 10.10.10.10         | IF0: 10.2.117.36  | IF2: 10.2.12.1    |       |
-|              |         |       |               |              |        | 1 TB SATA | 00:1E:67:D4:36:9A   | 00:1E:67:4F:B7:B1 | 00:1E:67:4F:B7:B4 |       |
-|              |         |       |               |              |        |           | root/root           | VLAN 984          | VLAN 202          |       |
-|              |         |       |               |              |        |           |                     | Public            | Private           |       |
-|              |         |       |               |              |        |           |                     | IF1: 10.2.1.1     | IF3: 10.2.13.1    |       |
-|              |         |       |               |              |        |           |                     | 00:1E:67:4F:B7:B2 | 00:1E:67:4F:B7:B5 |       |
-|              |         |       |               |              |        |           |                     | VLAN 201          | VLAN 203          |       |
-|              |         |       |               |              |        |           |                     | Admin             | Storage           |       |
-+--------------+---------+-------+---------------+--------------+--------+-----------+---------------------+-------------------+-------------------+-------+
++----------+--------+-------+---------------+-----------+--------+-----------+---------------------+-------------------+-------------------+-------+
+|          |        |       |               |           |        | Local     | Lights-out network  | 1GbE: NIC#/IP     | 10GbE: NIC#/IP    |       |
+| Hostname | Vendor | Model | Serial Number | CPUs      | Memory | Storage   | (IPMI): IP/MAC, U/P | MAC/VLAN/Network  | MAC/VLAN/Network  | Notes |
++----------+--------+-------+---------------+-----------+--------+-----------+---------------------+-------------------+-------------------+-------+
+| jump     | Dell   | R730  | ABCDEF007     | E5-2699x2 | 64 GB  | 240GB SSD | 10.10.10.10         | IF0: 10.2.117.36  | IF2: 10.2.12.1    |       |
+|          |        |       |               |           |        | 1 TB SATA | 00:1E:67:D4:36:9A   | 00:1E:67:4F:B7:B1 | 00:1E:67:4F:B7:B4 |       |
+|          |        |       |               |           |        |           | root/root           | VLAN 984          | VLAN 202          |       |
+|          |        |       |               |           |        |           |                     | Public            | Private           |       |
+|          |        |       |               |           |        |           |                     | IF1: 10.2.1.1     | IF3: 10.2.13.1    |       |
+|          |        |       |               |           |        |           |                     | 00:1E:67:4F:B7:B2 | 00:1E:67:4F:B7:B5 |       |
+|          |        |       |               |           |        |           |                     | VLAN 201          | VLAN 203          |       |
+|          |        |       |               |           |        |           |                     | Admin             | Storage           |       |
++----------+--------+-------+---------------+-----------+--------+-----------+---------------------+-------------------+-------------------+-------+
 
 
 **Compute Nodes**
 
-
-+---------------+---------+-------+---------------+-------+--------+---------+---------------------+------------------+------------------+-------+
-|               |         |       |               |       |        | Local   | Lights-out network  | 1GbE: NIC#/IP    | 10GbE: NIC#/IP   |       |
-|  Hostname     |  Vendor | Model | Serial Number |  CPUs | Memory | storage | (IPMI): IP/MAC, U/P | MAC/VLAN/Network | MAC/VLAN/Network | Notes |
-+---------------+---------+-------+---------------+-------+--------+---------+---------------------+------------------+------------------+-------+
-| pod2-jp-node1 |         |       |               |       |        |         |                     |                  |                  |       |
-|               |         |       |               |       |        |         |                     |                  |                  |       |
-|               |         |       |               |       |        |         |                     |                  |                  |       |
-+---------------+---------+-------+---------------+-------+--------+---------+---------------------+------------------+------------------+-------+
-| pod2-jp-node2 |         |       |               |       |        |         |                     |                  |                  |       |
-|               |         |       |               |       |        |         |                     |                  |                  |       |
-|               |         |       |               |       |        |         |                     |                  |                  |       |
-+---------------+---------+-------+---------------+-------+--------+---------+---------------------+------------------+------------------+-------+
-| pod2-jp-node3 |         |       |               |       |        |         |                     |                  |                  |       |
-|               |         |       |               |       |        |         |                     |                  |                  |       |
-|               |         |       |               |       |        |         |                     |                  |                  |       |
-+---------------+---------+-------+---------------+-------+--------+---------+---------------------+------------------+------------------+-------+
-| pod2-jp-node4 |         |       |               |       |        |         |                     |                  |                  |       |
-|               |         |       |               |       |        |         |                     |                  |                  |       |
-|               |         |       |               |       |        |         |                     |                  |                  |       |
-+---------------+---------+-------+---------------+-------+--------+---------+---------------------+------------------+------------------+-------+
-| pod2-jp-node5 |         |       |               |       |        |         |                     |                  |                  |       |
-|               |         |       |               |       |        |         |                     |                  |                  |       |
-|               |         |       |               |       |        |         |                     |                  |                  |       |
-+---------------+---------+-------+---------------+-------+--------+---------+---------------------+------------------+------------------+-------+
++----------+--------+-------+---------------+------+--------+---------+---------------------+------------------+------------------+-------+
+|          |        |       |               |      |        | Local   | Lights-out network  | 1GbE: NIC#/IP    | 10GbE: NIC#/IP   |       |
+| Hostname | Vendor | Model | Serial Number | CPUs | Memory | Storage | (IPMI): IP/MAC, U/P | MAC/VLAN/Network | MAC/VLAN/Network | Notes |
++----------+--------+-------+---------------+------+--------+---------+---------------------+------------------+------------------+-------+
+| node1    |        |       |               |      |        |         |                     |                  |                  |       |
+|          |        |       |               |      |        |         |                     |                  |                  |       |
+|          |        |       |               |      |        |         |                     |                  |                  |       |
++----------+--------+-------+---------------+------+--------+---------+---------------------+------------------+------------------+-------+
+| node2    |        |       |               |      |        |         |                     |                  |                  |       |
+|          |        |       |               |      |        |         |                     |                  |                  |       |
+|          |        |       |               |      |        |         |                     |                  |                  |       |
++----------+--------+-------+---------------+------+--------+---------+---------------------+------------------+------------------+-------+
+| node3    |        |       |               |      |        |         |                     |                  |                  |       |
+|          |        |       |               |      |        |         |                     |                  |                  |       |
+|          |        |       |               |      |        |         |                     |                  |                  |       |
++----------+--------+-------+---------------+------+--------+---------+---------------------+------------------+------------------+-------+
+| node4    |        |       |               |      |        |         |                     |                  |                  |       |
+|          |        |       |               |      |        |         |                     |                  |                  |       |
+|          |        |       |               |      |        |         |                     |                  |                  |       |
++----------+--------+-------+---------------+------+--------+---------+---------------------+------------------+------------------+-------+
+| node5    |        |       |               |      |        |         |                     |                  |                  |       |
+|          |        |       |               |      |        |         |                     |                  |                  |       |
+|          |        |       |               |      |        |         |                     |                  |                  |       |
++----------+--------+-------+---------------+------+--------+---------+---------------------+------------------+------------------+-------+
 
 VPN Users
 ---------
 
-+--------------+--------------+--------------+--------------+--------------+
-| Name         | Email        | Project      | Role         | Notes        |
-+--------------+--------------+--------------+--------------+--------------+
-| joe user     | ju@gmail.com | Pharos       | contributer  | CI support   |
-+--------------+--------------+--------------+--------------+--------------+
++----------+--------------+---------+-------------+------------+
+| Name     | Email        | Project | Role        | Notes      |
++----------+--------------+---------+-------------+------------+
+| joe user | ju@gmail.com | Pharos  | contributer | CI support |
++----------+--------------+---------+-------------+------------+
 
 
 Firewall Rules
 --------------
 
-+--------------+--------------+--------------+
-| Port(s)      | Service      | Note         |
-+--------------+--------------+--------------+
-| 22, 43, 80   | Jenkins CI   |              |
-+--------------+--------------+--------------+
++------------+------------+-------+
+| Port(s)    | Service    | Notes |
++------------+------------+-------+
+| 22, 43, 80 | Jenkins CI |       |
++------------+------------+-------+
 
 
 POD Topology
index c207cfa..33cc555 100644 (file)
@@ -9,7 +9,7 @@ Pharos Templates and Configuration Files
 ****************************************
 
 Lab and POD templates are provided to help lab owners document capabilities, configurations and
-network topologies.  Compute, network and storage specifications with network topology details are
+network topologies. Compute, network and storage specifications with network topology details are
 required to help developers use lab resources efficiently while minimizing support needs. This also
 greatly assists with troubleshhoting. It is the responsibility of the lab owner to keep individual
 lab documents updated and determine appropriate level of detail that is exposed publically through