xCAT/xcat-core
2
0
Fork 0
mirror of https://github.com/xcat2/xcat-core.git synced 2025-05-30 01:26:38 +00:00
Code Issues Releases Wiki Activity

Added section for known issues, reduce the level being displayed

Browse Source
This commit is contained in:
Victor Hu 2017-10-30 14:10:27 -04:00
parent d48012bb8d
commit 8f66479f1b
4 changed files with 40 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
docs/source/references/coral/index.rst
View File

@ -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

22
docs/source/references/coral/known_issues/genesis_base.rst Normal file
View File

@ -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``

7
docs/source/references/coral/known_issues/index.rst Normal file
View File

@ -0,0 +1,7 @@
Known Issues
============
.. toctree::
:maxdepth: 2
genesis_base.rst

4
docs/source/references/index.rst
View File

@ -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