From 402d8918792b52ee4d033b253f46de8118c1f8c6 Mon Sep 17 00:00:00 2001 From: Tziporet Koren Date: Tue, 15 Jan 2008 16:19:19 +0200 Subject: [PATCH] Updated Software requirements and installation notes. Signed-off-by: Vladimir Sokolovsky --- OFED_Installation_Guide.txt | 64 ++++++++++++++++++++----------------- README.txt | 51 ++++++++--------------------- 2 files changed, 48 insertions(+), 67 deletions(-) diff --git a/OFED_Installation_Guide.txt b/OFED_Installation_Guide.txt index e371c5e..c42643f 100644 --- a/OFED_Installation_Guide.txt +++ b/OFED_Installation_Guide.txt @@ -40,10 +40,10 @@ General Notes: the old packages. 2) When installing OFED on an entire [homogeneous] cluster, a common - strategy is to build the software only once (perhaps on a shared - file system such as NFS). The resulting RPMs can then be installed - on all nodes in the cluster using any cluster-aware tools (such as - pdsh). + strategy is to install the software on one of the cluster nodes + (perhaps on a shared file system such as NFS). The resulting RPMs, + created under OFED-1.3/RPMS directory, can then be installed on all + nodes in the cluster using any cluster-aware tools (such as pdsh). ============================================================================== 2. OFED Package Contents @@ -53,7 +53,7 @@ The OFED Distribution package generates RPMs for installing the following: o OpenFabrics core and ULPs: - HCA drivers (mthca, mlx4, ipath, ehca) - - iWARP driver (cxgb3, nes) + - iWARP driver (cxgb3, nes) - core - Upper Layer Protocols: IPoIB, SDP, SRP Initiator, iSER Initiator RDS, qlgc_vnic and uDAPL @@ -96,8 +96,7 @@ OS Distribution Required Packages General: o Common to all gcc, glib, glib-devel, glibc, glibc-devel, glibc-devel-32bit (to build 32-bit libraries on x86_86 - and ppc64), - zlib-devel, automake, autoconf, libtool. + and ppc64), zlib-devel o RedHat, Fedora kernel-devel, rpm-build o SLES 9.0 kernel-source, udev, rpm o SLES 10.0 kernel-source, rpm @@ -109,15 +108,20 @@ Specific Component Requirements: o Mvapich a Fortran Compiler (such as gcc-g77) o Mvapich2 libstdc++-devel, sysfsutils (SuSE), libsysfs-devel (RedHat5.0, Fedora C6) -o Open MPI libstdc++-devel, sysfsutils (SuSE), - libsysfs-devel (RedHat5.0, Fedora C6) +o Open MPI libstdc++-devel o ibutils tcl-8.4, tcl-devel-8.4, tk, libstdc++-devel o tvflash pciutils-devel -o mstflint libstdc++-devel (32-bit on ppc64) +o mstflint libstdc++-devel (32-bit on ppc64), gcc-c++ Note: The installer will warn you if you attempt to compile any of the above packages and do not have the prerequisites installed. +*** Important Note for open-iscsi users: + Installing iSER as part of OFED installation will also install open-iscsi. + Before installing OFED, please uninstall any open-iscsi version that may + be installed on your machine. Installing OFED with iSER support while + another open-iscsi version is already installed will cause the installation + process to fail. ============================================================================== 4. How to Download and Extract the OFED Distribution @@ -171,37 +175,37 @@ Note: The installer will warn you if you attempt to compile any of the 3) Install script usage: - ./install.pl [-c |--all|--hpc|--basic] - [-n|--net ] - - --all|--hpc|--basic Install all,hpc or basic packages - correspondingly - -c|--config Example of the config file can be found - under docs - -l|--prefix Set installation prefix; default is /usr - -p|--print-available Print available packages for current - platform and create the ofed.conf file - -k|--kernel Default: use the kernel installed on the - system - -s|--kernel-sources Default: - /lib/modules/'uname -r'/build - --build32 Build 32-bit libraries. Relevant for - x86_64 and ppc64 platforms - -v|-vv|-vvv Set verbosity level - -q Set quiet - no messages will be printed - + Usage: ./install.pl [-c |--all|--hpc|--basic] [-n|--net ] + + -c|--config . Example of the config file can + be found under docs. + -l|--prefix Set installation prefix. + -p|--print-available Print available packages for current platform. + And create corresponding ofed.conf file. + -k|--kernel . Default on this system: $(uname -r) + -s|--kernel-sources . Default on this + system: /lib/modules/$(uname -r)/build + --build32 Build 32-bit libraries. Relevant for x86_64 and + ppc64 platforms + --without-depcheck Skip Distro's libraries check + -v|-vv|-vvv. Set verbosity level + -q. Set quiet - no messages will be printed + + --all|--hpc|--basic Install all,hpc or basic packages + correspondingly Notes: ------ a. It is possible to rename and/or edit the ofed.conf and ofed_net.conf files. Thus it is possible to change user choices (observing the original format). See examples of ofed.conf and ofed_net.conf under OFED-X.X.X/docs. + Run './install.pl -p' to get ofed.conf with all available packages included. b. To make debugging kernel issues easier, it is recommended to set the following environment variable before building OFED: export OPENIB_KERNEL_EXTRA_CFLAGS=-g This will attach debug info to generated kernel binaries without affecting - their speed. + their speed. Currently, set by default. c. Important note for open-iscsi users: Installing iSER as part of the OFED installation will also install diff --git a/README.txt b/README.txt index 65aed35..f2b23c3 100644 --- a/README.txt +++ b/README.txt @@ -16,11 +16,10 @@ This document includes the following sections: 1. HW and SW Requirements 2. OFED Package Contents -3. A Note on the Installation Process -4. Installing OFED -5. Starting and Verifying the IB Fabric -6. MPI (Message Passing Interface) -7. Related Documentation +3. Installing OFED Software +4. Starting and Verifying the IB Fabric +5. MPI (Message Passing Interface) +6. Related Documentation OpenFabrics Home Page: http://www.openfabrics.org @@ -53,8 +52,7 @@ OS Distribution Required Packages General: o Common to all gcc, glib, glib-devel, glibc, glibc-devel, glibc-devel-32bit (to build 32-bit libraries on x86_86 - and ppc64), - zlib-devel, automake, autoconf, libtool. + and ppc64), zlib-devel o RedHat, Fedora kernel-devel, rpm-build o SLES 9.0 kernel-source, udev, rpm o SLES 10.0 kernel-source, rpm @@ -66,16 +64,14 @@ Specific Component Requirements: o Mvapich a Fortran Compiler (such as gcc-g77) o Mvapich2 libstdc++-devel, sysfsutils (SuSE), libsysfs-devel (RedHat5.0, Fedora C6) -o Open MPI libstdc++-devel, sysfsutils (SuSE), - libsysfs-devel (RedHat5.0, Fedora C6) +o Open MPI libstdc++-devel o ibutils tcl-8.4, tcl-devel-8.4, tk, libstdc++-devel o tvflash pciutils-devel -o mstflint libstdc++-devel (32-bit on ppc64) +o mstflint libstdc++-devel (32-bit on ppc64), gcc-c++ Note: The installer will warn you if you attempt to compile any of the above packages and do not have the prerequisites installed. - *** Important Note for open-iscsi users: Installing iSER as part of OFED installation will also install open-iscsi. Before installing OFED, please uninstall any open-iscsi version that may @@ -111,24 +107,7 @@ The OFED Distribution package generates RPMs for installing the following: o Documentation - -3. A Note on the Installation Process -===================================== - -The OFED build process can take up to 40 minutes. If you are planning to -install the OFED package on a multi-node cluster, it is recommended to build -OFED RPMs once into a shared directory, and use the created RPMs in order to -install the package on the rest of the cluster machines. - -To build the OFED package run install.pl on one machine and this will build -the RPMs. - -To install the package, use the install.pl script. When installing from scratch, -install.pl will first build the RPMs, then install them onto the local machine. -If the RPMs already exist, the install.pl script will simply install them onto -the local machine without re-building them. - -4. Installing OFED Software +3. Installing OFED Software ============================ The default installation directory is: /usr @@ -156,7 +135,7 @@ Notes: using the ofed_info utility -5. Starting and Verifying the IB Fabric +4. Starting and Verifying the IB Fabric ======================================= 1) If you rebooted your machine after the installation process completed, @@ -173,12 +152,10 @@ Notes: Example: sminfo: sm lid 0x1 sm guid 0x2c9010b7c2ae1, activity count 20 priority 1 - To check if OpenSM is running on the management node, enter: /etc/init.d/opensmd status - To start OpenSM, enter: /etc/init.d/opensmd start + To check if OpenSM is running on the management node, enter: /etc/init.d/opensm status + To start OpenSM, enter: /etc/init.d/opensm start - Note: OpenSM parameters can be set via the file /etc/opensm.conf. - Note: OpenSM can be configured to run upon boot by setting 'ONBOOT=yes' - in /etc/opensm.conf. + Note: OpenSM parameters can be set via the file /etc/sysconfig/opensm. 4) Verify the status of ports by using ibv_devinfo: all connected ports should report a "PORT_ACTIVE" state. @@ -203,7 +180,7 @@ Notes: The default 'stack_prefix' is /usr -6. MPI (Message Passing Interface) +5. MPI (Message Passing Interface) ================================== In Step 2 of the main menu of install.pl, options 2, 3 and 4 can @@ -223,7 +200,7 @@ Please see MPI_README.txt for more details on each MPI package and how to run the tests. -8. Related Documentation +6. Related Documentation ======================== 1) Release Notes for OFED Distribution components are to be found under OFED-1.3/docs and, after the package installation, under -- 2.46.0