IBM Spectrum LSF RTM 10.1.0 Fix Pack 6 (497430) Readme File
Abstract
This Fix Pack includes 19 fixes and 8 enhancements since the release of IBM Spectrum LSF RTM 10.1 Fix Pack 5 on 8 February, 2018.
Description
Readme documentation for IBM Spectrum LSF RTM 10.1.0 Fix Pack 6 (497430) including installation-related instructions, prerequisites and co-requisites, what's new and list of fixes.
For details on the enhancements, refer to Section 1: What's new.
For details on the fixes, refer to Section 2: List of fixes.
Readme file for: IBM® Spectrum LSF RTM
Product/Component Release: 10.1.0
Update Name: Fix Pack 497430
Fix ID: rtm10.1.0-build497430
Publication date: July 27, 2018
Last modified date: November 16, 2018
Contents:
1. What's new
2. List of fixes
3. Download location
4. Products or components affected
5. System requirements
6. Installation and configuration
7. List of files
8. Product notifications
9. Copyright and trademark information
1. What's new
Package aggregate plugin v1.10
Disk usage enhancement:
* Collect local file system usage by default and add an extra option to
control the shared file system usage data collection per poller.
* Create a standalone graph device for each poller node and associate
two graphs with the new device: 'DISKU - Disk Space Percent', 'DISKU -
Disk Space Usage'
Grid->User viewer enhancement:
* Show cluster name
* Make all columns available or unavailable by configuring "Grid > Settings > Users"
* Support the "full name" pop-up window for each user with the meta plug-in
Additional support with Fix Pack 6:
* Support CentOS 7.2-7.5 for x86_64
Other enhancements:
* Three new graph templates for effective monitoring of IBM Spectrum LSF:
Cluster level graph:
GRID - Cluster/host effective utilization
GRID - Cluster effective utilization
Host group graph:
GRID - Host group - Effective utilization
* Add a new alert template:
Disk used over <num> percent on the <hostname> host
* CLI tool "grid_backup_restore_rtm.php" supports backup data only
* Show number of licenses and the percentile on license usage charts
* Show detailed host names in the chart panel of the cluster dashboard
.
2. List of fixes
|
ID |
Description |
P102573/189661 |
Guest user can access the Console page by using the URL directly |
P102603/193225 |
The layout of the Nectar report is not aligned. |
P102646/196208 |
The host based jobs viewer does not show zombie jobs. |
177969 |
RTM cannot create the feature graph before capturing the feature usage |
182077 |
lsfpollerd service does not auto-start after a server reboot. |
182365 |
Pending reason historical chart is blank in the historical time range area. |
182540 |
Job detail page shows an incorrect job exception status "TERM_MEMLIMIT" after the job killed was by root or an administrator. |
184044 |
Pending benchmark job is killed because the maximum runtime limit value is reached. |
186063 |
Pending reason historical chart only shows one resource pending reason "Load threshold reached(mem)" when there are multiple resource reasons: "Load threshold reached(mem)" and "Load threshold reached(ut)" |
193427/190538 |
License poller output shows a SQL Error if the user name includes a single quote ('). |
196661 |
Pending reason dashboard combines all identical resource reasons into one "Load threshold reached(mem)" entry when there are multiple resource reasons "Load threshold reached(mem)" and "Load threshold reached(ut)". |
179007 |
Statistical data for the previous day does not display if the database maintenance time is not 12:00am (midnight). |
189411 |
The vertical axis value for the host grid available memory graph is always 100. |
189978 |
License poller does not support user names with a space. |
195534 |
Feature hyperlink does not work on the License > Service dashboard. |
195546 |
The hyperlink for "RTM Summary" does not work on the JobIQ > Daily Throughput panel. |
196086 |
The hyperlink list from the cluster dashboard to daily statistics page does not work with the "All" project filter. |
196180 |
License usage filter does not work from the Heuristics job viewer. |
196181 |
Heuristics job list does not work with the 'All' cluster filter. |
3. Download Location
Download Fix Pack 497430 from the following location: http://www.ibm.com/eserver/support/fixes/
4. Products or components affected
Components affected by the new issues
addressed in IBM Spectrum LSF RTM Version 10.1.0 Fix Pack 6 include:
Aggregate Plugin
Disku Plugin
Grid Plugin
Gridalarms Plugin
Gridcstat Plugin
Gridpend Plugin
Heuristics
Plugin (JobIQ)
License Plugin
Lichist Plugin
Meta Plugin
Nectar Plugin
Superlinks Plugin
5. System requirements
OS of RTM master:
RHEL6.2+ x86_64, RHEL7.1+ x86_64,
CentOS 7.2+ x86_64, RHEL7.2 on Power 8 Little Endian, RHEL7.5 on Power 9 Little Endian,
SLES 11.3+ x86_64
and SLES12.1~12.3 x86_64.
Ubuntu 14.04 on x86_64 and Ubuntu 16.04 on Power 8 Little Endian.
6. Installation and configuration
6.1 Before installation
Ensure that you installed RTM, version 10.1, or newer.
Download the patch file. Install the patch file as follows:
1) Log in to the RTM master host as root.
2) #tar xzf rtm10.1-build497430-<_os>-<_arch>.tar.gz
Back up the changed RTM files. In following command example, RTM_TOP is the RTM installation directory, which is /opt/IBM by default:
1) #cd $RTM_TOP
2) #tar -czf rtm_backup10.1.0.6.tar.gz -T <path_to_FixPack_6>/patch.filelst
Note:
The backup and downgrade procedure is only applicable to RTM 10.1.0 Fix Pack 5 to 10.1.0 Fix Pack 6 upgrades.
Backup command will show multi-lines error for new files.
For remote poller backup procedures like the previous one, the ‘tar' command will show more errors for php files.
Back up database:
1) #cd $RTM_TOP/cacti/plugins/grid
2) #php -q grid_backup_restore_rtm.php --backup
3) #ls cacti_db_backup*.tgz
If you installed IBM Spectrum LSF RTM 10.1.0 and performed some customizations with updated files, back up your customization files before you install Fix Pack 6 . Otherwise, your customization files will be lost.
Note:
a. Before performing a fresh installation of RTM 10.1 on SLES 11.4, replace the following file:
Extract rtm_install.sh from rtm10.1.0-build497430-sles11-x64.tar.gz, then use it to replace the rtm_install.sh file under the RTM 10.1 install package location.
b. Before performing a fresh installation of RTM 10.1 GA on CentOS 7.2+, perform the following steps:
1. Prepare the environment according to the RTM 10.1.0 for RHEL 7 installation guide.
2. Download and extract the RTM 10.1.0 GA for RHEL 7 x64 package
3. Extract rtm_install.sh and rtm.rc.d/* from rtm10.1.0-build497430-centos7-x64.tar.gz, then use these files to replace rtm_install.sh and rtm.rc.d/* under the RTM 10.1 GA install package location.
4. Switch back to the RTM 10.1.0 Fix Pack 6 for CentOS 7 location to deploy RTM 10.1.0 Fix Pack 6 if required.
c. If you configured the extra repo RHN "optional" channel on RHEL7 and installed RTM 10.1 GA on a custom file path (that is, not /opt/IBM/), replace the following file:
Extract rtm_install.sh from rtm10.1.0-build497430-rhel7-x64.tar.gz, then use it to replace rtm_install.sh under the RTM 10.1 GA install package location.
6.2 Installation steps
1) Run the rtm_patch.sh file as follows:
#./rtm_patch.sh
Note:
a. If you need to deploy the patch on a remote poller, copy the RPM poller package from your Fix Pack 6 package location to the remote poller node, and install the packages. For example:
#cd x86_64
#rpm -Uvh --replacefiles --nodeps --prefix $RTM_TOP rtm-poller-10.1.0-6.497430.x86_64.rpm
b. If the eauth patch is applied to the LSF cluster that RTM monitors, replace the old version of eauth in RTM_TOP/rtm/lsf<8/9/10>/etc/eauth with the new eauth.cve on the RTM server. For example:
#mv /opt/IBM/rtm/lsf101/etc/eauth /opt/IBM/rtm/lsf101/etc/eauth_bak
#mv /opt/IBM/rtm/lsf101/etc/eauth.cve /opt/IBM/rtm/lsf101/etc/eauth
6.3 After installation
* Log out, then login to RTM again with the new version number from the Web UI.
6.4 Uninstallation
1. Remove the new aggregate plugin if the aggregate is not installed before RTM 10.1.0 Fix Pack 6:
#rm -rf $RTM_TOP/cacti/plugins/aggregate
Restore 10.1.0 Fix Pack 5 files from the previous backup tarball:
#cd $RTM_TOP
#tar -xzf rtm_backup10.1.0.6.tar.gz
Note:
Remote poller restore procedure is the same as previously mentioned.
Restore database:
#mysql cacti -e "UPDATE settings SET value='10.1.0.5' WHERE name='grid_version'"
#cd $RTM_TOP/cacti/plugins/grid
#php -q grid_backup_restore_rtm.php --restore --file=<above cacti_db_backup tgz file path>
Note:
* RTM RPMS version is still 10.1 Fix Pack 6 with the previous uninstall procedure, even if the binary and database is downgraded to 10.1.0 Fix Pack 5
* After performing the uninstall procedure, re-installing RTM 10.1.0 Fix Pack 6 is required before contacting IBM support.
* After performing the uninstall procedure, the RTM 10.1.0 Fix Pack 6 database backup file (under $RTM_TOP/cacti/backup) is not valid for the RTM 10.1.0 Fix Pack 5 database restore.
* After performing the uninstall procedure, all new records are lost, including newly-added clusters and external links.
7. List of files in package
cacti/graphs.php
8. 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.
9. Copyright and trademark information
© Copyright IBM Corporation 2018
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.