IBM Spectrum Data Manager for LSF 10.1 Fix 600223 Readme

Abstract
P104095. This patch resolves an issue with the Data Manager (DM) bstage command failing because the command could not verify the host component of a file’s location.

Description
Readme documentation for IBM Spectrum Data Manager for LSF 10.1 Fix 600223 including installation-related instructions, prerequisites and co-requisites, and list of fixes.

This fix addresses the following issue:

Resolves an issue with the DM bstage command failing because the command could not verify the host component of a file’s location.

A file’s location might specify a host followed by a colon ‘:’ followed by a path. The path could also contain a colon ‘:’. The bstage command needed to determine if the optional host component was being specified or not. It originally did this by performing a DNS lookup. If this succeeded it assumed the user wanted to specify a host. If it failed it assumed the user wanted to only specify a path. The use of a DNS lookup was inappropriate because this imposed a dependency that all hosts within a cluster must have visibility of any potential file source host.

The bstage command will no longer do a DNS lookup, but instead verify that the potential hostname is appropriately formatted. When doing a 'bstage in' a host can potentially be specified as part of the source, and since the source file path must be absolute it is always clear if the colon ':' delimits a host or is part of the path. When doing a bstage out it is not always clear in the destination if the colon ':' is a delimiter or part of the path. This is because the path can be relative. To help resolve this a new option -nohost. This is only for bstage out when -dst is used. This tells the bstage command that the colon ':' is part of the path and is not intended as host delimiter. If the optiion is not specified the command assumes the colon ':' is meant as a host delimiter.

The usage of the `bstage out` command is now:

bstage out -src file_path/file_name [-dst [host_name:]path[/file_name]] [-link]

bstage out -src file_path/file_name [-dst path[/file_name] -nohost] [-link]

bstage out -src folder_path/ [-dst [host_name:]path[/file_name]] [-link]

bstage out -src file_path/file_name -tag tag_name [-link | -g user_group_name]

Readme file for: IBM® Spectrum Data Manager for LSF
Product/Component Release: 10.1
Update Name: Fix 600223
Fix ID: lsf-dm-10.1-build600223
Publication date: 24 February 2021
Last modified date: 24 February 2021

Contents:

1. List of fixes

2. Download location

3. Product notifications

4. Products or components affected

5. System requirements

6. Installation and configuration

7. List of files

8. Copyright and trademark information

1. List of fixes

P104095

2. Download Location

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

3. Product notifications

To receive information about product solution and patch updates automatically, subscribe to product notifications on the My notifications page http://www.ibm.com/support/mynotifications/ on the IBM Support website (http://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.

4. Products or components affected

Affected components include:

Data Manager/bstage

5. System requirements

lnx26-x64
lnx310-ppc64le
lnx310-x64

6. Installation and configuration

6.1 Before installation

Before applying this patch, you must ensure that IBM Spectrum LSF 10.1 and IBM Spectrum Data Manager for LSF has been installed.

(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

6.2 Installation steps

1)    Go to the patch install directory: cd $LSF_ENVDIR/../10.1/install/
2)    Copy the patch file to the install directory $LSF_ENVDIR/../10.1/install/
3)    Run patchinstall: ./patchinstall <patch>

6.3 After installation

Not applicable.

6.4 Uninstallation

To roll back a patch:
1) Log on to the LSF master host as root
2) Run ./patchinstall -r <patch>

7. List of files

bstage

8. Copyright and trademark information

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