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