From 6c35e7777d3764a34389ac36b0de29d41bda3d29 Mon Sep 17 00:00:00 2001 From: Victor Hu Date: Mon, 11 Sep 2017 11:46:25 -0400 Subject: [PATCH 1/5] Create a skeleton outline for the reference implementation documentaton for CORAL --- docs/source/index.rst | 1 + .../references/coral/discovery/compute/index.rst | 9 +++++++++ .../references/coral/discovery/core_sw/index.rst | 2 ++ .../references/coral/discovery/edge_sw/index.rst | 2 ++ docs/source/references/coral/discovery/index.rst | 13 +++++++++++++ .../references/coral/discovery/mgmt_sw/index.rst | 2 ++ .../references/coral/discovery/mid_sw/index.rst | 2 ++ .../coral/discovery/servicenode/index.rst | 9 +++++++++ docs/source/references/coral/index.rst | 9 +++++++++ docs/source/references/coral/mn/configure/index.rst | 5 +++++ docs/source/references/coral/mn/index.rst | 12 ++++++++++++ docs/source/references/coral/mn/install.rst | 2 ++ docs/source/references/coral/mn/validate/index.rst | 6 ++++++ docs/source/references/index.rst | 9 +++++++++ docs/source/references/percs/index.rst | 5 +++++ 15 files changed, 88 insertions(+) create mode 100644 docs/source/references/coral/discovery/compute/index.rst create mode 100644 docs/source/references/coral/discovery/core_sw/index.rst create mode 100644 docs/source/references/coral/discovery/edge_sw/index.rst create mode 100644 docs/source/references/coral/discovery/index.rst create mode 100644 docs/source/references/coral/discovery/mgmt_sw/index.rst create mode 100644 docs/source/references/coral/discovery/mid_sw/index.rst create mode 100644 docs/source/references/coral/discovery/servicenode/index.rst create mode 100644 docs/source/references/coral/index.rst create mode 100644 docs/source/references/coral/mn/configure/index.rst create mode 100644 docs/source/references/coral/mn/index.rst create mode 100644 docs/source/references/coral/mn/install.rst create mode 100644 docs/source/references/coral/mn/validate/index.rst create mode 100644 docs/source/references/index.rst create mode 100644 docs/source/references/percs/index.rst diff --git a/docs/source/index.rst b/docs/source/index.rst index d507a22b7..0afdb7281 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -32,6 +32,7 @@ Table of Contents guides/install-guides/index.rst guides/admin-guides/index.rst advanced/index.rst + references/index.rst troubleshooting/index.rst developers/index.rst help.rst diff --git a/docs/source/references/coral/discovery/compute/index.rst b/docs/source/references/coral/discovery/compute/index.rst new file mode 100644 index 000000000..f685c63b8 --- /dev/null +++ b/docs/source/references/coral/discovery/compute/index.rst @@ -0,0 +1,9 @@ +Compute Nodes +============= + +.. toctree:: + :maxdepth: 2 + + discover.rst + validation.rst + diff --git a/docs/source/references/coral/discovery/core_sw/index.rst b/docs/source/references/coral/discovery/core_sw/index.rst new file mode 100644 index 000000000..725a8776c --- /dev/null +++ b/docs/source/references/coral/discovery/core_sw/index.rst @@ -0,0 +1,2 @@ +Core Switches +============= diff --git a/docs/source/references/coral/discovery/edge_sw/index.rst b/docs/source/references/coral/discovery/edge_sw/index.rst new file mode 100644 index 000000000..557313161 --- /dev/null +++ b/docs/source/references/coral/discovery/edge_sw/index.rst @@ -0,0 +1,2 @@ +Edge Switches +============= diff --git a/docs/source/references/coral/discovery/index.rst b/docs/source/references/coral/discovery/index.rst new file mode 100644 index 000000000..3d7984876 --- /dev/null +++ b/docs/source/references/coral/discovery/index.rst @@ -0,0 +1,13 @@ +Discovery +========= + +.. toctree:: + :maxdepth: 2 + + core_sw/index.rst + mgmt_sw/index.rst + mid_sw/index.rst + servicenode/index.rst + edge_sw/index.rst + compute/index.rst + diff --git a/docs/source/references/coral/discovery/mgmt_sw/index.rst b/docs/source/references/coral/discovery/mgmt_sw/index.rst new file mode 100644 index 000000000..57bc8d2ec --- /dev/null +++ b/docs/source/references/coral/discovery/mgmt_sw/index.rst @@ -0,0 +1,2 @@ +Management Switches +=================== diff --git a/docs/source/references/coral/discovery/mid_sw/index.rst b/docs/source/references/coral/discovery/mid_sw/index.rst new file mode 100644 index 000000000..8ef8bdacc --- /dev/null +++ b/docs/source/references/coral/discovery/mid_sw/index.rst @@ -0,0 +1,2 @@ +Mid Switches +============ diff --git a/docs/source/references/coral/discovery/servicenode/index.rst b/docs/source/references/coral/discovery/servicenode/index.rst new file mode 100644 index 000000000..23ff6169e --- /dev/null +++ b/docs/source/references/coral/discovery/servicenode/index.rst @@ -0,0 +1,9 @@ +Service Nodes +============= + +.. toctree:: + :maxdepth: 2 + + discover.rst + validation.rst + diff --git a/docs/source/references/coral/index.rst b/docs/source/references/coral/index.rst new file mode 100644 index 000000000..e95fca989 --- /dev/null +++ b/docs/source/references/coral/index.rst @@ -0,0 +1,9 @@ +CORAL +===== + +.. toctree:: + :maxdepth: 4 + + mn/index.rst + discovery/index.rst + diff --git a/docs/source/references/coral/mn/configure/index.rst b/docs/source/references/coral/mn/configure/index.rst new file mode 100644 index 000000000..801000b83 --- /dev/null +++ b/docs/source/references/coral/mn/configure/index.rst @@ -0,0 +1,5 @@ +Configure +========= + +.. toctree:: + :maxdepth: 2 diff --git a/docs/source/references/coral/mn/index.rst b/docs/source/references/coral/mn/index.rst new file mode 100644 index 000000000..426e330a6 --- /dev/null +++ b/docs/source/references/coral/mn/index.rst @@ -0,0 +1,12 @@ +Management Node - xCAT +====================== + +The Management Node should be installed with a RHEL Operating System. The following guides describe the process of installation, configuration and validation of xCAT on the Management Node. + +.. toctree:: + :maxdepth: 2 + + install.rst + configure/index.rst + validate/index.rst + diff --git a/docs/source/references/coral/mn/install.rst b/docs/source/references/coral/mn/install.rst new file mode 100644 index 000000000..87782b2f8 --- /dev/null +++ b/docs/source/references/coral/mn/install.rst @@ -0,0 +1,2 @@ +Install +======= diff --git a/docs/source/references/coral/mn/validate/index.rst b/docs/source/references/coral/mn/validate/index.rst new file mode 100644 index 000000000..8337700a0 --- /dev/null +++ b/docs/source/references/coral/mn/validate/index.rst @@ -0,0 +1,6 @@ +Validate +======== + +.. toctree:: + :maxdepth: 2 + diff --git a/docs/source/references/index.rst b/docs/source/references/index.rst new file mode 100644 index 000000000..3a5363335 --- /dev/null +++ b/docs/source/references/index.rst @@ -0,0 +1,9 @@ +Reference Implementation +======================== + +.. toctree:: + :maxdepth: 4 + + coral/index.rst + percs/index.rst + diff --git a/docs/source/references/percs/index.rst b/docs/source/references/percs/index.rst new file mode 100644 index 000000000..e60f08f29 --- /dev/null +++ b/docs/source/references/percs/index.rst @@ -0,0 +1,5 @@ +PERCS +===== + +See documentation here: https://sourceforge.net/p/xcat/wiki/XCAT_Power_775_Hardware_Management/ + From aaf49759ce7c679c2fcbe4b5f8a88707b72ea1ed Mon Sep 17 00:00:00 2001 From: Victor Hu Date: Mon, 11 Sep 2017 14:09:57 -0400 Subject: [PATCH 2/5] Create cross reference labels for the install guides --- docs/source/guides/install-guides/apt/index.rst | 2 ++ docs/source/guides/install-guides/yum/index.rst | 2 ++ docs/source/guides/install-guides/zypper/index.rst | 2 ++ 3 files changed, 6 insertions(+) diff --git a/docs/source/guides/install-guides/apt/index.rst b/docs/source/guides/install-guides/apt/index.rst index 2b8cc45d3..97c34885d 100644 --- a/docs/source/guides/install-guides/apt/index.rst +++ b/docs/source/guides/install-guides/apt/index.rst @@ -1,3 +1,5 @@ +.. _ubuntu_install_guide: + Installation Guide for Ubuntu Server LTS ======================================== diff --git a/docs/source/guides/install-guides/yum/index.rst b/docs/source/guides/install-guides/yum/index.rst index 37ae5033f..2ae2d97d3 100644 --- a/docs/source/guides/install-guides/yum/index.rst +++ b/docs/source/guides/install-guides/yum/index.rst @@ -1,3 +1,5 @@ +.. _rhel_install_guide: + Installation Guide for Red Hat Enterprise Linux =============================================== diff --git a/docs/source/guides/install-guides/zypper/index.rst b/docs/source/guides/install-guides/zypper/index.rst index 2a44ca0e3..253711f78 100644 --- a/docs/source/guides/install-guides/zypper/index.rst +++ b/docs/source/guides/install-guides/zypper/index.rst @@ -1,3 +1,5 @@ +.. _sles_install_guide: + Installation Guide for SUSE Linux Enterprise Server =================================================== From ee8ca37e00fff3bea37bb7268baa9b7669cbf104 Mon Sep 17 00:00:00 2001 From: Victor Hu Date: Mon, 11 Sep 2017 14:11:00 -0400 Subject: [PATCH 3/5] Add content to the xCAT install portion --- docs/source/references/coral/mn/index.rst | 4 ++-- docs/source/references/coral/mn/install.rst | 14 ++++++++++++++ 2 files changed, 16 insertions(+), 2 deletions(-) diff --git a/docs/source/references/coral/mn/index.rst b/docs/source/references/coral/mn/index.rst index 426e330a6..55f5cb559 100644 --- a/docs/source/references/coral/mn/index.rst +++ b/docs/source/references/coral/mn/index.rst @@ -1,5 +1,5 @@ -Management Node - xCAT -====================== +Management Node +=============== The Management Node should be installed with a RHEL Operating System. The following guides describe the process of installation, configuration and validation of xCAT on the Management Node. diff --git a/docs/source/references/coral/mn/install.rst b/docs/source/references/coral/mn/install.rst index 87782b2f8..92baff000 100644 --- a/docs/source/references/coral/mn/install.rst +++ b/docs/source/references/coral/mn/install.rst @@ -1,2 +1,16 @@ Install ======= + + +Prerequisite +------------ + +Install the following RPMs Management Node. They are used by various tools xCAT provides to assist with debugging/validation: :: + + yum -y install tcpdump pciutils bzip2 bind-utils + + +Install xCAT +------------ + +See :ref:`rhel_install_guide` for detailed xCAT installation instructions. From d48012bb8d9d6c41dd881232553572045842d296 Mon Sep 17 00:00:00 2001 From: Victor Hu Date: Tue, 12 Sep 2017 13:30:39 -0400 Subject: [PATCH 4/5] Add the outline for switch discovery --- .../references/coral/discovery/core_sw/discover.rst | 3 +++ .../references/coral/discovery/core_sw/index.rst | 11 ++++++++++- .../coral/discovery/core_sw/known_issues.rst | 2 ++ .../source/references/coral/discovery/core_sw/pre.rst | 4 ++++ .../references/coral/discovery/core_sw/vlan.rst | 2 ++ .../references/coral/discovery/edge_sw/discover.rst | 3 +++ .../references/coral/discovery/edge_sw/index.rst | 8 ++++++++ .../coral/discovery/edge_sw/known_issues.rst | 2 ++ .../source/references/coral/discovery/edge_sw/pre.rst | 4 ++++ .../references/coral/discovery/edge_sw/vlan.rst | 2 ++ .../references/coral/discovery/mgmt_sw/discover.rst | 3 +++ .../references/coral/discovery/mgmt_sw/index.rst | 9 +++++++++ .../coral/discovery/mgmt_sw/known_issues.rst | 2 ++ .../source/references/coral/discovery/mgmt_sw/pre.rst | 4 ++++ .../references/coral/discovery/mgmt_sw/vlan.rst | 2 ++ .../references/coral/discovery/mid_sw/discover.rst | 3 +++ .../references/coral/discovery/mid_sw/index.rst | 9 +++++++++ .../coral/discovery/mid_sw/known_issues.rst | 2 ++ docs/source/references/coral/discovery/mid_sw/pre.rst | 4 ++++ .../source/references/coral/discovery/mid_sw/vlan.rst | 2 ++ 20 files changed, 80 insertions(+), 1 deletion(-) create mode 100644 docs/source/references/coral/discovery/core_sw/discover.rst create mode 100644 docs/source/references/coral/discovery/core_sw/known_issues.rst create mode 100644 docs/source/references/coral/discovery/core_sw/pre.rst create mode 100644 docs/source/references/coral/discovery/core_sw/vlan.rst create mode 100644 docs/source/references/coral/discovery/edge_sw/discover.rst create mode 100644 docs/source/references/coral/discovery/edge_sw/known_issues.rst create mode 100644 docs/source/references/coral/discovery/edge_sw/pre.rst create mode 100644 docs/source/references/coral/discovery/edge_sw/vlan.rst create mode 100644 docs/source/references/coral/discovery/mgmt_sw/discover.rst create mode 100644 docs/source/references/coral/discovery/mgmt_sw/known_issues.rst create mode 100644 docs/source/references/coral/discovery/mgmt_sw/pre.rst create mode 100644 docs/source/references/coral/discovery/mgmt_sw/vlan.rst create mode 100644 docs/source/references/coral/discovery/mid_sw/discover.rst create mode 100644 docs/source/references/coral/discovery/mid_sw/known_issues.rst create mode 100644 docs/source/references/coral/discovery/mid_sw/pre.rst create mode 100644 docs/source/references/coral/discovery/mid_sw/vlan.rst diff --git a/docs/source/references/coral/discovery/core_sw/discover.rst b/docs/source/references/coral/discovery/core_sw/discover.rst new file mode 100644 index 000000000..20517215f --- /dev/null +++ b/docs/source/references/coral/discovery/core_sw/discover.rst @@ -0,0 +1,3 @@ +Discover Switches +================= + diff --git a/docs/source/references/coral/discovery/core_sw/index.rst b/docs/source/references/coral/discovery/core_sw/index.rst index 725a8776c..150400044 100644 --- a/docs/source/references/coral/discovery/core_sw/index.rst +++ b/docs/source/references/coral/discovery/core_sw/index.rst @@ -1,2 +1,11 @@ -Core Switches +Core Switches ============= + +.. toctree:: + :maxdepth: 2 + + pre.rst + discover.rst + vlan.rst + known_issues.rst + diff --git a/docs/source/references/coral/discovery/core_sw/known_issues.rst b/docs/source/references/coral/discovery/core_sw/known_issues.rst new file mode 100644 index 000000000..635383512 --- /dev/null +++ b/docs/source/references/coral/discovery/core_sw/known_issues.rst @@ -0,0 +1,2 @@ +Known Issues +============ diff --git a/docs/source/references/coral/discovery/core_sw/pre.rst b/docs/source/references/coral/discovery/core_sw/pre.rst new file mode 100644 index 000000000..0495d946d --- /dev/null +++ b/docs/source/references/coral/discovery/core_sw/pre.rst @@ -0,0 +1,4 @@ +Prerequisites +============= + + diff --git a/docs/source/references/coral/discovery/core_sw/vlan.rst b/docs/source/references/coral/discovery/core_sw/vlan.rst new file mode 100644 index 000000000..0867106da --- /dev/null +++ b/docs/source/references/coral/discovery/core_sw/vlan.rst @@ -0,0 +1,2 @@ +VLAN Configuration +================== diff --git a/docs/source/references/coral/discovery/edge_sw/discover.rst b/docs/source/references/coral/discovery/edge_sw/discover.rst new file mode 100644 index 000000000..20517215f --- /dev/null +++ b/docs/source/references/coral/discovery/edge_sw/discover.rst @@ -0,0 +1,3 @@ +Discover Switches +================= + diff --git a/docs/source/references/coral/discovery/edge_sw/index.rst b/docs/source/references/coral/discovery/edge_sw/index.rst index 557313161..2586ec2e9 100644 --- a/docs/source/references/coral/discovery/edge_sw/index.rst +++ b/docs/source/references/coral/discovery/edge_sw/index.rst @@ -1,2 +1,10 @@ Edge Switches ============= + +.. toctree:: + :maxdepth: 2 + + pre.rst + discover.rst + vlan.rst + known_issues.rst diff --git a/docs/source/references/coral/discovery/edge_sw/known_issues.rst b/docs/source/references/coral/discovery/edge_sw/known_issues.rst new file mode 100644 index 000000000..635383512 --- /dev/null +++ b/docs/source/references/coral/discovery/edge_sw/known_issues.rst @@ -0,0 +1,2 @@ +Known Issues +============ diff --git a/docs/source/references/coral/discovery/edge_sw/pre.rst b/docs/source/references/coral/discovery/edge_sw/pre.rst new file mode 100644 index 000000000..0495d946d --- /dev/null +++ b/docs/source/references/coral/discovery/edge_sw/pre.rst @@ -0,0 +1,4 @@ +Prerequisites +============= + + diff --git a/docs/source/references/coral/discovery/edge_sw/vlan.rst b/docs/source/references/coral/discovery/edge_sw/vlan.rst new file mode 100644 index 000000000..0867106da --- /dev/null +++ b/docs/source/references/coral/discovery/edge_sw/vlan.rst @@ -0,0 +1,2 @@ +VLAN Configuration +================== diff --git a/docs/source/references/coral/discovery/mgmt_sw/discover.rst b/docs/source/references/coral/discovery/mgmt_sw/discover.rst new file mode 100644 index 000000000..20517215f --- /dev/null +++ b/docs/source/references/coral/discovery/mgmt_sw/discover.rst @@ -0,0 +1,3 @@ +Discover Switches +================= + diff --git a/docs/source/references/coral/discovery/mgmt_sw/index.rst b/docs/source/references/coral/discovery/mgmt_sw/index.rst index 57bc8d2ec..c319c6883 100644 --- a/docs/source/references/coral/discovery/mgmt_sw/index.rst +++ b/docs/source/references/coral/discovery/mgmt_sw/index.rst @@ -1,2 +1,11 @@ Management Switches =================== + +.. toctree:: + :maxdepth: 2 + + pre.rst + discover.rst + vlan.rst + known_issues.rst + diff --git a/docs/source/references/coral/discovery/mgmt_sw/known_issues.rst b/docs/source/references/coral/discovery/mgmt_sw/known_issues.rst new file mode 100644 index 000000000..635383512 --- /dev/null +++ b/docs/source/references/coral/discovery/mgmt_sw/known_issues.rst @@ -0,0 +1,2 @@ +Known Issues +============ diff --git a/docs/source/references/coral/discovery/mgmt_sw/pre.rst b/docs/source/references/coral/discovery/mgmt_sw/pre.rst new file mode 100644 index 000000000..0495d946d --- /dev/null +++ b/docs/source/references/coral/discovery/mgmt_sw/pre.rst @@ -0,0 +1,4 @@ +Prerequisites +============= + + diff --git a/docs/source/references/coral/discovery/mgmt_sw/vlan.rst b/docs/source/references/coral/discovery/mgmt_sw/vlan.rst new file mode 100644 index 000000000..0867106da --- /dev/null +++ b/docs/source/references/coral/discovery/mgmt_sw/vlan.rst @@ -0,0 +1,2 @@ +VLAN Configuration +================== diff --git a/docs/source/references/coral/discovery/mid_sw/discover.rst b/docs/source/references/coral/discovery/mid_sw/discover.rst new file mode 100644 index 000000000..20517215f --- /dev/null +++ b/docs/source/references/coral/discovery/mid_sw/discover.rst @@ -0,0 +1,3 @@ +Discover Switches +================= + diff --git a/docs/source/references/coral/discovery/mid_sw/index.rst b/docs/source/references/coral/discovery/mid_sw/index.rst index 8ef8bdacc..985a1d35b 100644 --- a/docs/source/references/coral/discovery/mid_sw/index.rst +++ b/docs/source/references/coral/discovery/mid_sw/index.rst @@ -1,2 +1,11 @@ Mid Switches ============ + +.. toctree:: + :maxdepth: 2 + + pre.rst + discover.rst + vlan.rst + known_issues.rst + diff --git a/docs/source/references/coral/discovery/mid_sw/known_issues.rst b/docs/source/references/coral/discovery/mid_sw/known_issues.rst new file mode 100644 index 000000000..635383512 --- /dev/null +++ b/docs/source/references/coral/discovery/mid_sw/known_issues.rst @@ -0,0 +1,2 @@ +Known Issues +============ diff --git a/docs/source/references/coral/discovery/mid_sw/pre.rst b/docs/source/references/coral/discovery/mid_sw/pre.rst new file mode 100644 index 000000000..0495d946d --- /dev/null +++ b/docs/source/references/coral/discovery/mid_sw/pre.rst @@ -0,0 +1,4 @@ +Prerequisites +============= + + diff --git a/docs/source/references/coral/discovery/mid_sw/vlan.rst b/docs/source/references/coral/discovery/mid_sw/vlan.rst new file mode 100644 index 000000000..0867106da --- /dev/null +++ b/docs/source/references/coral/discovery/mid_sw/vlan.rst @@ -0,0 +1,2 @@ +VLAN Configuration +================== From 8f66479f1bc6f44f388d0d28b091a5d63b02f399 Mon Sep 17 00:00:00 2001 From: Victor Hu Date: Mon, 30 Oct 2017 14:10:27 -0400 Subject: [PATCH 5/5] Added section for known issues, reduce the level being displayed --- docs/source/references/coral/index.rst | 13 ++++++----- .../coral/known_issues/genesis_base.rst | 22 +++++++++++++++++++ .../references/coral/known_issues/index.rst | 7 ++++++ docs/source/references/index.rst | 4 +++- 4 files changed, 40 insertions(+), 6 deletions(-) create mode 100644 docs/source/references/coral/known_issues/genesis_base.rst create mode 100644 docs/source/references/coral/known_issues/index.rst diff --git a/docs/source/references/coral/index.rst b/docs/source/references/coral/index.rst index e95fca989..4639e3360 100644 --- a/docs/source/references/coral/index.rst +++ b/docs/source/references/coral/index.rst @@ -1,9 +1,12 @@ CORAL ===== -.. toctree:: - :maxdepth: 4 +CORAL stands for Collaboration of Oak Ridge, Argonne, and Livermore and is solution that IBM is building for the Department of Energy to superseed its current cluster of Supercomputers. - mn/index.rst - discovery/index.rst - + +.. toctree:: + :maxdepth: 2 + + known_issues/index.rst +.. mn/index.rst +.. discovery/index.rst diff --git a/docs/source/references/coral/known_issues/genesis_base.rst b/docs/source/references/coral/known_issues/genesis_base.rst new file mode 100644 index 000000000..adb57d762 --- /dev/null +++ b/docs/source/references/coral/known_issues/genesis_base.rst @@ -0,0 +1,22 @@ +xCAT Genesis Base +================= + +xCAT ships a ``xCAT-genesis-base`` package as part of xcat-deps. This is a light-weight diskless linux image based on Fedora (Fedora26, currently) that is used by xCAT to do hardware discovery. + +To support the Power9 hardware, changes are made to the kernel in the Red Hat Enterprise distribution that are not yet available in the Fedora kernels. Without that support, running the scripts in xCAT discovery caused segmentation faults described in this issue: https://github.com/xcat2/xcat-core/issues/3870 + +Work-around +----------- + +xCAT cannot ship a kernel based on RHEL distribution, so the customer needs to build a version of the ``xCAT-genesis-base`` on-site using a server running Red Hat Enterprise Linux. + +1. Download the latest timestamp version of the ``xCAT-genesis-builder`` RPM provided here: http://xcat.org/files/xcat/xcat-dep/2.x_Linux/beta/ + +2. Install the ``xCAT-genesis-builder`` RPM on a node that is installed with the RHEL version being deployed. + +3. Build the ``xCAT-genesis-base`` RPM: :: + + /opt/xcat/share/xcat/netboot/genesis/builder/buildrpm + +4. Install this package on top of the xCAT install and execute: ``mknb ppc64`` + diff --git a/docs/source/references/coral/known_issues/index.rst b/docs/source/references/coral/known_issues/index.rst new file mode 100644 index 000000000..359cd90de --- /dev/null +++ b/docs/source/references/coral/known_issues/index.rst @@ -0,0 +1,7 @@ +Known Issues +============ + +.. toctree:: + :maxdepth: 2 + + genesis_base.rst diff --git a/docs/source/references/index.rst b/docs/source/references/index.rst index 3a5363335..7a3d6402a 100644 --- a/docs/source/references/index.rst +++ b/docs/source/references/index.rst @@ -1,8 +1,10 @@ Reference Implementation ======================== +Reference documentation created for management of large clusters using xCAT. + .. toctree:: - :maxdepth: 4 + :maxdepth: 2 coral/index.rst percs/index.rst