From: Andreas Dilger Date: Thu, 24 Nov 2016 21:08:01 +0000 (-0700) Subject: LUDOC-300 misc: cleanup references and obsolete text X-Git-Tag: 2.10.0~20 X-Git-Url: https://git.whamcloud.com/?a=commitdiff_plain;h=e5e0f290be2179ed9ad2a9390e7e8338f8f75ed4;p=doc%2Fmanual.git LUDOC-300 misc: cleanup references and obsolete text Remove references to specific Lustre release versions and supported Linux distros, since these are very version dependent and are better described in the release notes for each version. Fix up packages needed on the client and server. Remove obsolete LNDs from the supported list. Fix table and figure references to be on the table/figure itself and not on the title. Signed-off-by: Andreas Dilger Change-Id: I0bf3788f0ee8c32021b61386c6b69e0c47e64ade Reviewed-on: https://review.whamcloud.com/23944 Tested-by: Jenkins Reviewed-by: James Nunez Reviewed-by: Joseph Gmitter --- diff --git a/InstallingLustre.xml b/InstallingLustre.xml index 973dbc7..979f6f7 100644 --- a/InstallingLustre.xml +++ b/InstallingLustre.xml @@ -18,7 +18,7 @@ xml:id="installinglustre"> For hardware and system requirements and hardware configuration - information, see + information, see .
@@ -30,87 +30,9 @@ xml:id="installinglustre"> or directly from the source code. This chapter describes how to install the Lustre RPM packages. Instructions to install from source code are beyond the scope of this document, and can be found elsewhere online.</para> - <para>The Lustre RPM packages have been tested on the Linux distributions - listed in the table below.</para> - <para> - <table frame="all" xml:id="LustreTestMatrixTable"> - <title>Lustre Test Matrix - - - - - - - Lustre Release - Servers Tested - 1 - Clients Tested - - - - - - 2.0 - - - RHEL 5, CentOS 5 - - - RHEL 5, CentOS 5, SLES 11 SP0 - - - - - 2.1.x - - - RHEL 5, CentOS 5, RHEL 6, CentOS 6 - - - RHEL 5, CentOS 5, RHEL 6, CentOS 6, SLES 11 SP1 - - - - - 2.2 - - - RHEL 6, CentOS 6 - - - RHEL 5, CentOS 5, RHEL 6, CentOS 6, SLES 11 SP1 - - - - - 2.3 - - - RHEL 6.3, CentOS 6.3 - - - RHEL 6.3, CentOS 6.3, RHEL 5.8, CentOS 5.8, SLES 11 - SP1 - - - - 2.4.x - - RHEL 6.4, CentOS 6.4 - - - RHEL 6.4, CentOS 6.4, SLES 11 SP2, FC18 - - - - - - - - 1Red Hat Enterprise Edition (RHEL), CentOS - Enterprise Linux Distribution (CentOS), SUSE Linux Enterprise Server - (SLES), Fedora - *F18 Linux kernel (FC18). + The Lustre RPM packages are tested on current versions of Linux + enterprise distributions at the time they are created. See the release + notes for each version for specific details.
Software Requirements To install the Lustre software from RPMs, the following are @@ -120,14 +42,15 @@ xml:id="installinglustre"> Lustre server packages - . The required packages for Lustre servers are listed in - the table below, where - ver refers to the Linux kernel distribution - (e.g., 2.6.32-358.6.2.el6) and + . The required packages for Lustre 2.9 EL7 servers are + listed in the table below, where + ver refers to the Lustre release and + kernel version (e.g., 2.9.0-1.el7) and arch refers to the processor architecture - (e.g., x86_64). These packages are available in the + (e.g., x86_64). These packages are available in the - Lustre Releasesrepository. + Lustre Releases repository, and may differ depending on + your distro and version. Packages Installed on Lustre Servers @@ -143,65 +66,68 @@ xml:id="installinglustre"> - kernel- - ver - _lustre. - arch + kernel-ver_lustre.arch Linux kernel with Lustre software patches (often referred to as "patched kernel") - lustre- - ver - _lustre. - arch + lustre-ver.arch Lustre software command line tools - lustre-modules- - ver - _lustre. - arch + kmod-lustre-ver.arch Lustre-patched kernel modules - lustre-osd-ldiskfs- - ver - _lustre. - arch + kmod-lustre-osd-ldiskfs-ver.arch - Lustre back-end file system tools + Lustre back-end file system tools for ldiskfs-based + servers. + - lustre-zfs-ldiskfs- - ver - _lustre. - arch + lustre-osd-ldiskfs-mount-ver.arch + + Helper library for mount.lustre + and mkfs.lustre for ldiskfs-based servers. + + + + + kmod-lustre-osd-zfs-ver.arch Lustre back-end file system tools for ZFS. This is - an alternative to - lustre-osd-ldiskfs + an alternative to + lustre-osd-ldiskfs (kmod-spl and + kmod-zfs available separately). + + + + lustre-osd-zfs-mount-ver.arch + + Helper library for mount.lustre + and mkfs.lustre for ZFS-based servers + (zfs utilities available separately). + e2fsprogs - Utility to maintain Lustre back-end file - system + Utilities to maintain Lustre ldiskfs back-end file + system(s) + - lustre-tests- - ver - _lustre. - arch + lustre-tests-ver_lustre.arch Lustre I/O Kit benchmarking tools (Included in Lustre software as of @@ -216,12 +142,12 @@ xml:id="installinglustre"> Lustre client packages - . The required packages for Lustre clients are listed in - the table below, where + . The required packages for Lustre 2.9 EL7 clients are + listed in the table below, where ver refers to the Linux distribution (e.g., - 2.6.18-348.1.1.el5). These packages are available in the + 3.6.18-348.1.1.el5). These packages are available in the - Lustre Releasesrepository. + Lustre Releases repository.
Packages Installed on Lustre Clients @@ -237,27 +163,24 @@ xml:id="installinglustre"> - lustre-client-modules- - ver + kmod-lustre-client-ver.arch Patchless kernel modules for client - lustre-client- - ver - _lustre + lustre-client-ver.arch Client command line tools - lustre-client-tests- - ver + lustre-client-dkms-ver.arch - Lustre I/O Kit - (Included in Lustre software as of - release 2.2) + Alternate client RPM to kmod-lustre-client with + Dynamic Kernel Module Support (DKMS) installation. This + avoids the need to install a new RPM for each kernel update, + but requires a full build environment on the client. @@ -266,11 +189,11 @@ xml:id="installinglustre"> The version of the kernel running on a Lustre client must be the same as the version of the - lustre-client-modules- - ver package being installed. If the - kernel running on the client is not compatible, a kernel that is - compatible must be installed on the client before the Lustre file - system software is installed. + kmod-lustre-client-ver + package being installed, unless the DKMS package is installed. + If the kernel running on the client is not compatible, a kernel + that is compatible must be installed on the client before the + Lustre file system software is used. @@ -307,23 +230,6 @@ xml:id="installinglustre"> gni Gemini (Cray) - - Seastar - Cray - - - MX - Myrinet network - - - ra - RapidArray - *interconnect - - - Elan - Quadrics -
@@ -408,8 +314,8 @@ xml:id="installinglustre"> (Required) Disable Security-Enhanced Linux - *(SELinux) on all Lustre servers and - clients. + *(SELinux) on all Lustre servers + The Lustre software does not support SELinux. Therefore, the SELinux system extension must be disabled on all Lustre nodes. Also, make sure other security extensions (such as the Novell diff --git a/SystemConfigurationUtilities.xml b/SystemConfigurationUtilities.xml index 40915cc..033a363 100644 --- a/SystemConfigurationUtilities.xml +++ b/SystemConfigurationUtilities.xml @@ -2736,8 +2736,8 @@ lr_reader visible in multiple subdirectory mounts via hard links. Furthermore, it does not prevent the client from subsequently mounting the whole file system without a subdirectory being specified. -
- + <figure xml:id="understandinglustre.fig.fileset"> + <title> <indexterm> <primary>Lustre</primary> <secondary>fileset</secondary> diff --git a/UnderstandingFailover.xml b/UnderstandingFailover.xml index b91a616..09d57dc 100644 --- a/UnderstandingFailover.xml +++ b/UnderstandingFailover.xml @@ -210,9 +210,8 @@ xml:id="understandingfailover"> configured in a quasi active/active configuration, with each MDS managing metadata for a subset of the Lustre file system.</para> </note> - <figure> - <title xml:id="understandingfailover.fig.configmdt">Lustre failover - configuration for a active/passive MDT +
+ Lustre failover configuration for a active/passive MDT @@ -233,9 +232,8 @@ xml:id="understandingfailover"> release 2.4. MDTs can be setup as an active/active failover configuration. A failover cluster is built from two MDSs as shown in . -
- Lustre failover - configuration for a active/active MDTs +
+ Lustre failover configuration for a active/active MDTs OSSs configured as a failover pair must have shared disks/RAID. -
- Lustre failover - configuration for an OSTs +
+ Lustre failover configuration for an OSTs All servers must be upgraded at the same time, while some or - all clients may be upgraded. + all clients may be upgraded independently of the servers. All servers must be be upgraded to a Linux kernel supported by - the Lustre software. See the Linux Test Matrix at - for a list of tested Lustre - distributions. + the Lustre software. See the Lustre Release Notes for your Lustre + version for a list of tested Linux distributions. - Clients to be upgraded to the Lustre software release 2.4 or - higher must be running a compatible Linux distribution. See the Linux - Test Matrix at - for a list of tested Linux - distributions. + Clients to be upgraded must be running a compatible Linux + distribution as described in the Release Notes. @@ -210,16 +204,12 @@ xml:id="upgradinglustre"> Upgrade the Linux operating system on all servers to a compatible - (tested) Linux distribution and reboot. See the Linux Test Matrix at - . + (tested) Linux distribution and reboot. Upgrade the Linux operating system on all clients to Red Hat Enterprise Linux 6 or other compatible (tested) distribution and - reboot. See the Linux Test Matrix at - . + reboot. Download the Lustre server RPMs for your platform from the diff --git a/UserUtilities.xml b/UserUtilities.xml index 8a2a2a3..a596173 100644 --- a/UserUtilities.xml +++ b/UserUtilities.xml @@ -926,8 +926,8 @@ lfs help
-
- Examples +
+ Examples Creates a file striped on two OSTs with 128 KB on each stripe.