From b4b817192924ea69f62ae865c4d4aa5ac3869c6a Mon Sep 17 00:00:00 2001 From: Julien Date: Fri, 29 Jul 2016 00:12:33 +0800 Subject: 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 --- docs/lab-description/lab_description.rst | 17 +++--- docs/lab-description/pod_description.rst | 95 ++++++++++++++++---------------- docs/lab-description/templates.rst | 2 +- 3 files changed, 57 insertions(+), 57 deletions(-) (limited to 'docs') diff --git a/docs/lab-description/lab_description.rst b/docs/lab-description/lab_description.rst index da84aa11..d36e8c6f 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 2d4047a8..856d5c22 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 c207cfa7..33cc5559 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 -- cgit 1.2.3-korg