summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorJulien <zhang.jun3g@zte.com.cn>2016-07-29 00:12:33 +0800
committerJulien <zhang.jun3g@zte.com.cn>2016-07-29 07:04:13 +0800
commitb4b817192924ea69f62ae865c4d4aa5ac3869c6a (patch)
treefe89c1225e4d6b55943b9ec3a7958840dc6ef2f1 /docs
parent7ae1f204de947a3c12804c04f32e20d45eb99eba (diff)
Update the Pharos template
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>
Diffstat (limited to 'docs')
-rw-r--r--docs/lab-description/lab_description.rst17
-rw-r--r--docs/lab-description/pod_description.rst95
-rw-r--r--docs/lab-description/templates.rst2
3 files changed, 57 insertions, 57 deletions
diff --git a/docs/lab-description/lab_description.rst b/docs/lab-description/lab_description.rst
index da84aa1..d36e8c6 100644
--- a/docs/lab-description/lab_description.rst
+++ b/docs/lab-description/lab_description.rst
@@ -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
diff --git a/docs/lab-description/pod_description.rst b/docs/lab-description/pod_description.rst
index 2d4047a..856d5c2 100644
--- a/docs/lab-description/pod_description.rst
+++ b/docs/lab-description/pod_description.rst
@@ -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
diff --git a/docs/lab-description/templates.rst b/docs/lab-description/templates.rst
index c207cfa..33cc555 100644
--- a/docs/lab-description/templates.rst
+++ b/docs/lab-description/templates.rst
@@ -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