From e2563c1780865d0c1cd7cd8924f07e6da5833b29 Mon Sep 17 00:00:00 2001 From: huweihua Date: Mon, 19 Oct 2015 04:05:51 -0400 Subject: [PATCH] add some example --- .../mlnxofed_ib_install_v1_diskful.rst | 25 ++++++++++++ .../mlnxofed_ib_install_v1_diskless.rst | 29 +++++++++++++- .../mlnxofed_ib_install_v2_diskful.rst | 38 ++++++++++++++++--- .../mlnxofed_ib_install_v2_diskless.rst | 33 +++++++++++++--- .../mlnxofed_ib_install_v2_preparation.rst | 4 +- 5 files changed, 115 insertions(+), 14 deletions(-) diff --git a/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v1_diskful.rst b/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v1_diskful.rst index 3eb63a99c..37da6def7 100644 --- a/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v1_diskful.rst +++ b/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v1_diskful.rst @@ -21,6 +21,31 @@ Configuration for Diskful Installation chdef -t osimage -o --install-compute \ pkglist=/install/custom/install//compute...pkglist + Take RHEL 6.4 on x86_64 for example :: + + cp /opt/xcat/share/xcat/install/rh/compute.rhels6.x86_64.pkglist \ + /install/custom/install/rh/compute.rhels6.x86_64.pkglist + + Edit the ``/install/custom/install/rh/compute.rhels6.x86_64.pkglist`` and add below line + ``#INCLUDE:/opt/xcat/share/xcat/ib/netboot/rh/ib.rhels6.x86_64.pkglist#`` + + Then ``/install/custom/install/rh/compute.rhels6.x86_64.pkglist`` looks like below :: + + #Please make sure there is a space between @ and group name + #INCLUDE:/opt/xcat/share/xcat/ib/netboot/rh/ib.rhels6.x86_64.pkglist# + ntp + nfs-utils + net-snmp + rsync + yp-tools + openssh-server + util-linux-ng + + Then modify related osimage :: + + chdef -t osimage -o rhels6.4-x86_64-install-compute \ + pkglist=/install/custom/install/rh/compute.rhels6.x86_64.pkglist + 3. Install node :: nodeset osimage=--install-compute diff --git a/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v1_diskless.rst b/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v1_diskless.rst index e56a719b4..fd1173186 100644 --- a/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v1_diskless.rst +++ b/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v1_diskless.rst @@ -3,16 +3,34 @@ Configuration for Diskless Installation 1. Specify dependence package **[required for RHEL and SLES]** - a) Copy the pkglist to the custom directory :: + a) Copy a correct pkglist file **shipped by xCAT** according your environment to the ``/install/custom/netboot//`` directory :: cp /opt/xcat/share/xcat/netboot//compute...pkglist \ /install/custom/netboot//compute...pkglist b) Edit your ``/install/custom/netboot//.pkglist`` and add one line ``#INCLUDE:/opt/xcat/share/xcat/ib/netboot//ib...pkglist#`` + Take RHEL 6.4 on x86_64 for example :: + + cp /opt/xcat/share/xcat/netboot/rh/compute.rhels6.x86_64.pkglist \ + /install/custom/netboot/rh/compute.rhels6.x86_64.pkglist + + Edit the ``/install/custom/netboot/rh/compute.rhels6.x86_64.pkglist`` and add below line + ``#INCLUDE:/opt/xcat/share/xcat/ib/netboot/rh/ib.rhels6.x86_64.pkglist#`` + + Then ``/install/custom/netboot/rh/compute.rhels6.x86_64.pkglist`` looks like below :: + + #INCLUDE:/opt/xcat/share/xcat/ib/netboot/rh/ib.rhels6.x86_64.pkglist# + bash + nfs-utils + openssl + dhclient + ..... + + 2. Prepare postinstall scripts - a) Specify postinstall scripts:: + a) Specify postinstall script **shipped by xCAT** :: mkdir -p /install/custom/netboot// @@ -21,6 +39,13 @@ Configuration for Diskless Installation chmod +x /install/custom/netboot//.postinstall + Take RHEL 6.4 on x86_64 for example :: + + mkdir -p /install/custom/netboot/rh/ + cp /opt/xcat/share/xcat/netboot/rh/compute.rhels6.x86_64.postinstall \ + /install/custom/netboot/rh/ + chmod +x /install/custom/netboot/rh/compute.rhels6.x86_64.postinstall + b) Edit ``/install/custom/netboot//.postinstall`` and add below line in the end: :: installroot=$1 ofeddir=/install/post/otherpkgs///ofed/ \ diff --git a/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_diskful.rst b/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_diskful.rst index 6c09b4043..b51ae7299 100644 --- a/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_diskful.rst +++ b/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_diskful.rst @@ -7,20 +7,48 @@ Configuration for Diskful Installation 2. Specify dependence package **[required for RHEL and SLES]** - a) Copy a correct pkglist file shipped by xCAT according your environment to the ``/install/custom/install//`` directory :: + a) Copy a correct pkglist file **shipped by xCAT** according your environment to the ``/install/custom/install//`` directory, these pkglist files are located under ``/opt/xcat/share/xcat/install//`` :: cp /opt/xcat/share/xcat/install//compute...pkglist \ /install/custom/install//compute...pkglist - b) Edit your ``/install/custom/install//compute...pkglist`` and add below line:: - - #INCLUDE:/opt/xcat/share/xcat/ib/netboot//ib...pkglist# - + b) Edit your ``/install/custom/install//compute...pkglist`` and add one line + + ``#INCLUDE:/opt/xcat/share/xcat/ib/netboot//ib...pkglist#`` + + You can check directory ``/opt/xcat/share/xcat/ib/netboot//`` and choose one correct ``ib...pkglist`` according your environment. + + c) Make the related osimage use the customized pkglist :: chdef -t osimage -o --install-compute \ pkglist=/install/custom/install//compute...pkglist + + Take RHEL 6.4 on x86_64 for example :: + cp /opt/xcat/share/xcat/install/rh/compute.rhels6.x86_64.pkglist \ + /install/custom/install/rh/compute.rhels6.x86_64.pkglist + + Edit the ``/install/custom/install/rh/compute.rhels6.x86_64.pkglist`` and add below line + ``#INCLUDE:/opt/xcat/share/xcat/ib/netboot/rh/ib.rhels6.x86_64.pkglist#`` + + Then ``/install/custom/install/rh/compute.rhels6.x86_64.pkglist`` looks like below :: + + #Please make sure there is a space between @ and group name + #INCLUDE:/opt/xcat/share/xcat/ib/netboot/rh/ib.rhels6.x86_64.pkglist# + ntp + nfs-utils + net-snmp + rsync + yp-tools + openssh-server + util-linux-ng + + Then modify related osimage :: + + chdef -t osimage -o rhels6.4-x86_64-install-compute \ + pkglist=/install/custom/install/rh/compute.rhels6.x86_64.pkglist + 3. Install node :: nodeset osimage=--install-compute diff --git a/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_diskless.rst b/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_diskless.rst index 68b9a2960..14aefcf76 100644 --- a/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_diskless.rst +++ b/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_diskless.rst @@ -3,18 +3,34 @@ Configuration for Diskless Installation 1. Specify dependence package **[required for RHEL and SLES]** - a) Copy a correct pkglist file shipped by xCAT according your environment to the ``/install/custom/netboot//`` directory :: + a) Copy a correct pkglist file **shipped by xCAT** according your environment to the ``/install/custom/netboot//`` directory :: cp /opt/xcat/share/xcat/netboot//compute...pkglist \ /install/custom/netboot//compute...pkglist - b) Edit your ``/install/custom/netboot//.pkglist`` and add below line :: + b) Edit your ``/install/custom/netboot//.pkglist`` and add below line + ``#INCLUDE:/opt/xcat/share/xcat/ib/netboot//ib...pkglist#`` - #INCLUDE:/opt/xcat/share/xcat/ib/netboot//ib...pkglist# + Take RHEL 6.4 on x86_64 for example :: + + cp /opt/xcat/share/xcat/netboot/rh/compute.rhels6.x86_64.pkglist \ + /install/custom/netboot/rh/compute.rhels6.x86_64.pkglist + + Edit the ``/install/custom/netboot/rh/compute.rhels6.x86_64.pkglist`` and add below line + ``#INCLUDE:/opt/xcat/share/xcat/ib/netboot/rh/ib.rhels6.x86_64.pkglist#`` + + Then ``/install/custom/netboot/rh/compute.rhels6.x86_64.pkglist`` looks like below :: + + #INCLUDE:/opt/xcat/share/xcat/ib/netboot/rh/ib.rhels6.x86_64.pkglist# + bash + nfs-utils + openssl + dhclient + ..... 2. Prepare postinstall scripts - a) Specify postinstall scripts :: + a) Specify a correct postinstall script **shipped by xCAT** :: mkdir -p /install/custom/netboot// @@ -23,12 +39,19 @@ Configuration for Diskless Installation chmod +x /install/custom/netboot//.postinstall + Take RHEL 6.4 on x86_64 for example :: + + mkdir -p /install/custom/netboot/rh/ + cp /opt/xcat/share/xcat/netboot/rh/compute.rhels6.x86_64.postinstall \ + /install/custom/netboot/rh/ + chmod +x /install/custom/netboot/rh/compute.rhels6.x86_64.postinstall + b) Edit ``/install/custom/netboot//.postinstall`` and add below line in the end :: /install/postscripts/mlnxofed_ib_install \ -p /install// -i $1 -n genimage - + 3. Set the related osimage using the customized pkglist and compute.postinsall * [RHEL/SLES] :: diff --git a/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_preparation.rst b/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_preparation.rst index b0294be20..fcec74f83 100644 --- a/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_preparation.rst +++ b/docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_preparation.rst @@ -15,8 +15,8 @@ Copy **mlnxofed_ib_install.v2** into ``/install/postscripts`` and change name to chmod +x /install/postscripts/mlnxofed_ib_install -Some options of mlnxofed_ib_install should be assigned values when it's used. -These options are: +``mlnxofed_ib_install`` has some options, **'-p' is always needed**. +Below are the details of these options: * **-p**: [required]--the directory where the OFED iso file is located * **-m**: [optional]--the mlnxofed_ib_install invokes a script ``mlnxofedinstall`` shipped by Mellanox OFED iso. Use this option to pass arguments to the ``mlnxofedinstall``. You must include ``-end-`` at the completion of the options to distinguish the option list. if you don't pass any argument to ``mlnxofedinstall``, defualt value ``--without-32bit --without-fw-update --force`` will be passed to ``mlnxofedinstall`` by xCAT.