Readme and Release notes for release 5.1.0.21 LoadLeveler 5.1.0.21 LL_utils-5.1.0.21-x86_64-Linux-RHEL6 Readme

Readme file for:LL_utils-5.1.0.21-x86_64-Linux-RHEL6
Product/Component Release:5.1.0.21
Update Name:LL_utils-5.1.0.21-x86_64-Linux-RHEL6
Fix ID:LL_utils-5.1.0.21-x86_64-Linux-RHEL6
Publication Date:15 March 2016
Last modified date:15 March 2016

Online version of the readme file:http://www-01.ibm.com/support/docview.wss?rs=0&uid=isg400002575
Important: The most current version of the readme file can always be found online.

Contents

Download location
Prerequisites and co-requisites
Known issues
Known limitations

Installation information

Additional information
Copyright and trademark information



Download location

Below is a list of components, platforms, and file names that apply to this Readme file.

Fix Download for Linux
Product/Component Name:Platform:Fix:
LoadLevelerLinux 64-bit,x86_64 RHEL 6
LL_utils-5.1.0.21-x86_64-Linux-RHEL6





Prerequisites and co-requisites

None

Known issues



Known limitations



Installation information

Use these instructions to install the LoadLeveler update RPMs on IBM Systems running supported versions of Red Hat Enterprise Linux and SUSE Linux Enterprise Server.


  • - Read-me-first installation notes

    This installation procedure assumes that you are updating a machine running the full version of LoadLeveler.

    License RPM

    Do not proceed if the LoadL-full-license- < OS-ARCH > - < installed_license_version > license package is not installed. For example, if you are currently running LoadLeveler 4.1.x for Linux, you cannot install an update for LoadLeveler 5.1.x. You must first upgrade to LoadLeveler 5.1.0.3-0 before you can install an update package for a 5.1.0.X-0 release. Please contact your IBM marketing representative for information on how to obtain the appropriate LoadLeveler CD-ROM that has the license package.

    When uninstalling the "LoadL- < fileset > -full" RPM currently installed on your machine, do not uninstall the "LoadL-full-license" RPM for your currently installed LoadLeveler release. The "LoadL- < fileset > -full" update RPM has a dependency on the currently installed license RPM. Also, the LoadLeveler daemons will not start unless the license package is installed and you have accepted the terms and conditions of the license agreement.

    Submit-only machines

    The update steps for a LoadLeveler submit-only machine are similar to those associated with a machine running the full product. Simply replace the relevant "full" file names by their "so" counterparts. Also, on a submit-only machine there is no need to execute the llctl drain, llctl stop, or llctl start commands because LoadLeveler daemons do not run on a submit-only machine.

    File name conventions

    Download packages and RPMs for LoadLeveler updates use consistent file naming conventions. By looking at the components of the file name, you can determine which update package you will need to download based on the machine's architecture, Linux operating system, and the installed version of LoadLeveler.

    Example

    If your system is running scheduler and resource manager RHEL 6 with LoadLeveler 5.1.0.3-0 installed, and you want to download and install the LoadLeveler 5.1.0.4-0 update, then the file name components would be as follows:

    Download package:

    LL- < fileset > - < update_version > . < arch > . < OS-ARCH > .tar.gz
    Specifies the LL_scheduler-5.1.0.4-0.x86_64-Linux-RHEL6.tar.gz file
    Specifies the LL_resmgr-5.1.0.4-0.x86_64-Linux-RHEL6.tar.gz file

    Package RPMs:

    LoadL- < fileset > -full- < OS-ARCH > - < update_version > . < arch > .rpm
    Specifies the LoadL-scheduler-full-RH6-X86_64-5.1.0.4-0.x86_64.rpm file
    Specifies the LoadL-resmgr-full-RH6-X86_64-5.1.0.4-0.x86_64.rpm file

    LoadL-scheduler-so- < OS-ARCH > - < update_version > . < arch > .rpm
    Specifies the LoadL-scheduler-so-RH6-X86_64-5.1.0.4-0.x86_64.rpm file

    LoadL-utils- < OS-ARCH > - < update_version > . < arch > .rpm
    Specifies the LoadL-utils-RH6-X86_64-5.1.0.4-0.x86_64.rpm file

    LoadL-resmgr-kbdd- < OS-ARCH > - < update_version > . < arch > .rpm
    Specifies the LoadL-resmgr-kbdd-RH6-X86_64-5.1.0.4-0.x86_64.rpm file

    BLUE GENE SYSTEM ONLY:
    LoadL-scheduler-bluegene- < OS-ARCH > - < update_version > . < arch > .rpm
    Specifies the LoadL-scheduler-bluegene-RH6-PPC64-5.1.0.6-0.ppc64.rpm file

    Currently installed LoadLeveler and License RPMs:

    LoadL- < fileset > - < OS-ARCH > - < currently_installed_version >
    Specifies that LoadL-scheduler-full-RH6-X86_64-5.1.0.3-0 is installed
    Specifies that LoadL-resmgr-full-RH6-X86_64-5.1.0.3-0 is installed

    LoadL-full-license- < OS-ARCH > - < installed_license_version >
    Specifies the LoadL-full-license-RH6-X86_64-5.1.0.3-0 license

    where

    < fileset >

    The LoadLeveler scheduler or resource manager fileset.

    < OS-ARCH >

    The Linux Operating System and platform architecture of the machine where you are installing a LoadLeveler update package. For example, if you are upgrading an installation of LoadLeveler on a 64-bit AMD Opteron and Intel EM64T processors machine running RedHat 6, then < OS-ARCH > would be RH6-X86_64.

    < update_version >

    Specifies the version number of the LoadLeveler update package that you want to install on your system. For example, if you are updating to LoadLeveler 5.1.0.4-0, then the < update_version > is the number 5.1.0.4-0. The < update_version > appears in the file name of the package download (*.tar.gz file) and in the update RPMs in the package.

    < arch >

    Used in RPM file names. Specifies the platform architecture, where < arch > =
    x86_64 (64-bit IBM System x) or

    < base_version >

    Used only in the file name of the downloadable update package (gzipped tar file). Specifies the LoadLeveler Version/Release to which the update can be applied, for example, 5.1.X.

    < currently_installed_version >

    Specifies the version number of the current LoadLeveler release installed on your system.

    < installed_license_version >

    Specifices the license RPM for the base release (or a lower release) of the LoadLeveler version you are updating. For example, to install the LoadLeveler 5.1.0.4 update, you must have an installed license RPM for LoadLeveler on Linux.

  • - Installation procedure
    1. Change to the < UpdateDirectory > directory, that is, the directory where the *.tar.gz file for the LoadLeveler update resides and where you have write access:

      cd < UpdateDirectory >
    2. Extract the RPM files from the tar file:

      tar -xzvf LL- < fileset > - < update_version > . < arch > . < OS-ARCH > .tar.gz

      At the end of this step the files extracted from the archive should match the files listed in the Readme ("View" link) for the LoadLeveler update you downloaded.
    3. Verify that the LoadLeveler "license" RPM for the LoadLeveler version that you are updating is currently installed on this system:

      rpm -qa | grep LoadL

      The output of this command should be similar to the following:

      LoadL- < fileset > -full- < OS-ARCH > - < currently_installed_version >
      LoadL-full-license- < OS-ARCH > - < installed_license_version >
    4. If LoadLeveler resource manager fileset is running on this machine, enter the following command to "drain" the LoadL_schedd and LoadL_startd daemons on this machine and all other machines in the LoadLeveler cluster:

      llctl -g drain

      Note: To avoid potential incompatibility problems, all machines in the cluster should be upgraded to the same LoadLeveler update release before restarting the LoadLeveler daemons.
    5. Use the llstatus command to verify that the LoadL_schedd and LoadL_startd daemons are in "Drned" (drained) state, and then enter the following command to stop the LoadLeveler daemons:

      llctl -g stop
    6. To apply the update, use one of the following options:

      OPTION 1

      Uninstall the currently installed "LoadL- < fileset > -full" RPM and then install the "LoadL- < fileset > -full" update package by running the following commands:

      rpm -e LoadL- < fileset > -full- < OS-ARCH > - < currently_installed_version >
      rpm -ivh LoadL- < fileset > -full- < OS-ARCH > - < update_version > . < arch > .rpm

      For Blue Gene/Q only:
      Run these additional commands:
      rpm -e LoadL-scheduler-bluegene- < OS-ARCH > - < currently_installed_version >
      rpm -ivh LoadL-scheduler-bluegene- < OS-ARCH > - < update_version > . < arch > .rpm




      OPTION 2

      Use the -U option of the rpm command to apply the update directly:

      rpm -Uvh LoadL- < fileset > -full- < OS-ARCH > - < update_version > . < arch > .rpm

      For Blue Gene/Q only:
      Run this additional command:
      rpm -Uvh LoadL-scheduler-bluegene- < OS-ARCH > - < update_version > . < arch > .rpm

    7. Repeat step 6 for all the machines in the LoadLeveler cluster. On completion of this task, restart the LoadLeveler daemons with the following command:

      llctl -g start

    For further information, consult the LoadLeveler Library for the appropriate version of the LoadLeveler Linux Installation Guide.

  • - Setting up control groups on a diskless (or stateless) cluster for preemption, process tracking, workload management (WLM), and checkpoint/restart

    Control groups are used for preemption, process tracking, workload management (WLM), and checkpoint/restart. A control group file system must be configured and mounted in order to enable these functions. The /etc/cgconfig.conf file is used to define control groups, their attributes, and their mount points. On diskless systems the /etc/cgconfig.conf file should be part of the diskless image.

    Complete the following steps to setup control groups on a diskless cluster.

    1. Create the cgconfig.conf file in either an existing directory or a new directory in the /install/postscripts directory on the EMS management server.

      For example:
      mkdir -p /install/postscripts/admin_files
      vi /install/postscripts/admin_files/cgconfig.conf

      Note: Files and subdirectories under /install/postscripts on the EMS are copied to the /xcatpost directory on the compute nodes before the postscripts are run.

    2. If you plan to use checkpoint/restart or LoadLeveler process tracking and preemption, the first entry in the cgconfig.conf file must be:

      mount {ns = /cgroup/freezer;freezer = /cgroup/freezer;}

    3. If you plan to use WLM, include the following in the cgconfig.conf file:

      mount {
        cpu = /cgroup/cpu;
        cpuacct = /cgroup/cpuacct;
        memory = /cgroup/memory;
      }

      group LOADL {
        memory{
          memory.limit_in_bytes = ;
          memory.soft_limit_in_bytes = ;
          memory.memsw.limit_in_bytes = ;
       }
       cpu{}
       cpuacct{}
      }

    4. In a script that is configured in the xCAT database as a postscript for the compute nodes, add the following:

      cp /xcatpost/admin_files/cgconfig.conf /etc/cgconfig.conf /sbin/cgconfigparser -l /etc/cgconfig.conf

      where "admin_files" is the directory name you used in step 1.

      If you plan to use scheduling affinity, add the following lines to this script after invoking /sbin/cgconfigparser

      mkdir /dev/cpuset
      mount -t cpuset none /dev/cpuset



Additional information



Copyright and trademark information


http://www.ibm.com/legal/copytrade.shtml

Notices

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Microsoft, Windows, and Windows Server are trademarks of Microsoft Corporation in the United States, other countries, or both.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Other company, product, or service names may be trademarks or service marks of others.

THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION

The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version.

Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions: