summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
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 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