IBM Platform LSF 9.1.1 Fix 366033 Readme File

Abstract

P101387. Fix to introduce a retry mechanism to the LSF 9.1.1 GP integration for Rational ClearCase if there is a failure in the ClearCase daemon wrapper.

Description

Readme documentation for IBM Platform LSF 9.1.1 Fix 366033 including installation-related instructions, prerequisites and co-requisites, and list of fixes.

This fix addresses the following issue:

a) In the LSF ClearCase daemon wrapper, the cleartool setview command creates a process that is set to a specified ClearCase view for sbatchd daemons. If the setview command fails, the sbatchd daemons cannot start and the job fails or exits. This fix adds a retry mechanism to resolve the cleartool setview command failure. Two environment variables can be set to control the retry mechanism:
LSF_CLEARCASE_WRAPPER_RETRY: The maximum times daemon wrapper will retry in case of failure.
LSF_CLEARCASE_WRAPPER_RETRY_INTERVAL: The time interval, in seconds, between retries.


b) To help debug ClearCase issues, the daemon wrapper captures and logs the ClearCase stdout and stderr streams when the daemon wrapper debug feature is enabled.

c) To reduce the load on the ClearCase server process, you can now configure the daemon wrapper to skip running the checkView function (that is, "cleartool lsview") during a job's post-execution phase by setting the environment variable NOCHECKVIEW_POSTEXEC.

Readme file for: IBM® Platform LSF

Product/Component Release: 9.1.1

Update Name: Fix 366033

Fix ID: LSF-9.1.1-build366033

Publication date: 22 September 2015

Last modified date: 22 September 2015

Contents:

1.     List of fixes

2.     Download location

3.     Products or components affected

4.     System requirements

5.     Installation and configuration

6.     List of files

7.     Product notifications

8.     Copyright and trademark information

1.   List of fixes

P101387

2.   Download Location

Download Fix 366033 from the following location: http://www.ibm.com/eserver/support/fixes/

3.   Products or components affected

Affected components include: LSF/daemons.wrap

4.   System requirements

Linux2.6-glibc2.3-x86_64

5.   Installation and configuration

5.1          Before installation

 (LSF_TOP=Full path to the top-level installation directory of LSF.)

1)    Log on to the LSF master host as root

2)    Set your environment:

-      For csh or tcsh: % source LSF_TOP/conf/cshrc.lsf

-      For sh, ksh, or bash: $ . LSF_TOP/conf/profile.lsf

5.2          Installation steps

1)    Go to the patch install directory: cd $LSF_ENVDIR/../9.1/install/

2)    Copy the patch file to the install directory $LSF_ENVDIR/../9.1/install/

3)    Run patchinstall: ./patchinstall <patch>

5.3          After installation

1)   To enable the retry mechanism (assuming that CLEARCASE_ROOT and LSF_DAEMON_WRAP are defined correctly), set the environment variables LSF_CLEARCASE_WRAPPER_RETRY and LSF_CLEARCASE_WRAPPER_RETRY_INTERVAL:

- csh or tcsh: setenv LSF_CLEARCASE_WRAPPER_RETRY retry_limit

                     setenv LSF_CLEARCASE_WRAPPER_RETRY_INTERVAL interval_in_seconds

- sh, ksh, or bash: export LSF_CLEARCASE_WRAPPER_RETRY=retry_limit

                      export LSF_CLEARCASE_WRAPPER_RETRY_INTERVAL=interval_in_seconds

To disable this feature, remove the environment variable as follows:

- csh or tcsh: unsetenv LSF_CLEARCASE_WRAPPER_RETRY

                      unsetenv LSF_CLEARCASE_WRAPPER_RETRY_INTERVAL

- sh, ksh, or bash: unset LSF_CLEARCASE_WRAPPER_RETRY

                              unset LSF_CLEARCASE_WRAPPER_RETRY_INTERVAL

2) To log the ClearCase stdout/stderr streams, enable the daemon wrapper debug mode by setting the DAEMON_WRAP_DEBUG environment variable as follows:

- csh or tcsh: setenv DAEMON_WRAP_DEBUG 1

- sh, ksh, or bash: export DAEMON_WRAP_DEBUG=1

To disable this feature, remove the environment variable as follows:

- csh or tcsh: unsetenv DAEMON_WRAP_DEBUG

- sh, ksh, or bash: unset DAEMON_WRAP_DEBUG

3) To enable the daemon wrapper to skip running checkView (that is, "cleartool lsview") in the job's post-execution phase, set the environment variable NOCHECKVIEW_POSTEXEC environment variable as follows:

- csh or tcsh: setenv NOCHECKVIEW_POSTEXEC 1

- sh, ksh, or bash: export NOCHECKVIEW_POSTEXEC=1

To disable this feature, remove the environment variable as follows:

- csh or tcsh: unsetenv NOCHECKVIEW_POSTEXEC

- sh, ksh, or bash: unset NOCHECKVIEW_POSTEXEC

5.4          Uninstallation

To roll back a patch:

1)    Log on to the LSF master host as root

2)    Run ./patchinstall -r <patch>

6.   List of files

daemons.wrap

7.   Product notifications

To receive information about product solution and patch updates automatically, subscribe to product notifications on the My notifications page (www.ibm.com/support/mynotifications) on the IBM Support website (support.ibm.com). You can edit your subscription settings to choose the types of information you want to get notification about, for example, security bulletins, fixes, troubleshooting, and product enhancements or documentation changes.

8.   Copyright and trademark information

© Copyright IBM Corporation 2015

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

IBM®, the IBM logo and ibm.com® are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.