IBM Spectrum LSF Explorer V10.2.0 Fix Pack 12 Readme

Readme file for IBM® Spectrum LSF Explorer V10.2.0 Fix Pack 13 (601182)

Abstract

This release includes features and enhancements since the release of IBM Spectrum LSF Explorer 10.2.0.12 on 30 July 2021.

Description

Readme documentation for IBM Spectrum LSF Explorer 10.2.0.13 Release including installation-related instructions, prerequisites, and co-requisites.

Readme file for: IBM® Spectrum LSF Explorer
Productor component release: 10.2.0.13
Update name: Fix 601182
Fix ID: explorer-10.2.0.13-build601182
Publication date: 24 June 2022
Last modified date: 24 June 2022

Contents

1. What's new

2. System requirements

3. Known issues

4. Product notifications

5. Download location

6. Installation and configuration

7. Upgrade from 10.2.0.10 to 10.2.0.13

8. Uninstallation

9. Copyright and trademark information

1. What's new

Enhancements

- Support RHEL 8.5 for x86_64 and Power
- Increase auto-logout time value
- Support RLM loader
- Third-party upgrade

Third-party name	New version	Old version
IBM WebSphere Liberty	22.0.0.3	19.0.0.1
Apache Spring Framework	5.3.19	4.2.1
Apache Log4j	2.17.1	2.1.14
Jackson Databind	2.13.3	2.10.0
Bootstrap	3.4.0	2.3.2
jQuery UI	1.12.0	1.11.0

List of fixes

Fix ID	Description
Internal-364	Loader unable to handle long command line.
P104316	Unable to change username and password for role-based access control users.
P104344, P104535	Error 500 when role-based access control (RBAC) is enabled.
P104549	Blank page when unassigning all roles for a selected user.

2. System requirements

Refer to IBM Documentation: https://www.ibm.com/docs/en/sle/10.2.0?topic=requirements-system-102-fix-pack-13

3. Known issues

Refer to IBM Documentation: https://www.ibm.com/docs/en/sle/10.2.0?topic=notes-known-issues-limitations-troubleshooting

4. Product notifications

To receive information about product solution and fix 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 that you want to get notifications about, for example, security bulletins, fixes, troubleshooting, and product enhancements or documentation changes.

5. Download location

Download from the following location: https://www.ibm.com/support/fixcentral

6. Installation and configuration

Notes:
- COLLECTOR_TOP is the full path to the top-level installation directory of IBM Spectrum LSF Explorer Data Collector.
- SERVER_TOP is the full path to the top-level installation directory of IBM Spectrum LSF Explorer server.

Before you install:

· If you are using Elasticsearch 7.x or 6.x, skip and continue with the next step. If you have Elasticsearch 5.x installed, complete the following steps:

For IBM Spectrum LSF Explorer to work with an installed version of Elasticsearch 5.x, you must configure specific parameters in the elasticsearch.yml configuration file by completing the following steps:

1. Log in to the Elasticsearch server.

2. Add the following configuration parameters in the elasticsearch.yml file. Depending on your installation, the file might be found at ES_TOP/config/ or in the /etc/ directory. ES_TOP is the full path to the top-level installation directory of Elasticsearch:
script.inline: true
script.stored: true
script.search: true
Note: When you add lines to the elasticsearch.yml file, ensure that the new lines have no blank spaces before them. Otherwise, Elasticsearch reports errors and fails to start.

3. Restart the Elasticsearch service.

· You must install Elasticsearch, Logstash, and Kibana (ELK). Starting in version 10.2.0.10, IBM Spectrum LSF Explorer removed the bundled ELK. The supported ELK version is 7.2 or later. If you are installing an ELK version 8 or earlier, consider installing version 7.2.1. You can download ELK from the following links:
https://www.elastic.co/cn/downloads/past-releases/elasticsearch-7-2-1
https://www.elastic.co/cn/downloads/past-releases/logstash-7-2-1
https://www.elastic.co/cn/downloads/past-releases/kibana-7-2-1
You must set a proper heap size for Elasticsearch and Logstash before you install IBM Spectrum LSF Explorer. For more information, see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/heap-size.html.
Note: You can still use the version of Elasticsearch that is bundled with IBM Spectrum LSF Explorer Fix Pack 9. However, that version does not support https and authentication features because it is the OSS version. For information about enabling TLS for Elasticsearch HTTP connections, refer to https://www.ibm.com/docs/en/sle/10.2.0?topic=elasticsearch-enabling-https.

Installation steps for IBM Spectrum LSF Explorer Server 10.2.0.13

1. Log in to the host on which you intend to install IBM Spectrum LSF Explorer Server as root.

2. Extract the package:
tar -zxvf explorer10.2.0.13_server_linux-x64.tar.gz

3. Configure your installation:
-Edit the install.config file to set the installation variables.

-Verify that your ELK service is running and available.

-Configure ES_HOST and ES_PORT of your Elasticsearch.

-If Elasticsearch security feature is enabled, configure the ES_AUTHENTICATION_ENABLED and ES_SSL_CERT_PATH.

4. Run the ExplorerServerInstaller.sh script:
./ExplorerServerInstaller.sh -f install.config
Note: For a silent installation, add the -silent option.

5. Set the IBM Spectrum LSF Explorer Server environment:
-For csh or tcsh:
source SERVER_TOP/lsfsuite/ext/cshrc.platform
-For sh, ksh, or bash:
. SERVER_TOP/lsfsuite/ext/profile.platform

6. Start the IBM Spectrum LSF Explorer Server:
pmcadmin start

7. Check that the IBM Spectrum LSF Explorer Server services are started:
pmcadmin list

8. Log in to the IBM Spectrum LSF Explorer Server:
Open a web browser and access the IBM Spectrum LSF Explorer Server by entering the hostname or IP address, and port number of the server. The default port number is 8080.
For example, if your IBM Spectrum LSF Explorer Server IP address is 198.51.100.0, enter the following URL in your web browser:
http://198.51.100.0:8080
The login screen for the IBM Spectrum LSF Explorer console is displayed.

9. Use the LSF administrator name and password to log in. The default Cluster Overview dashboard is displayed.

10. Select Dashboards to view the default reports.

11. To create a new chart, select Charts and click New.

12. To create a new dashboard, select Dashboards and click New.

13. Check for errors in the log files. The log files are in the SERVER_TOP:
cd SERVER_TOP/lsfsuite/ext/explorer/server/logs

Installation steps for IBM Spectrum LSF Explorer Data Collector 10.2.0.13

Ensure that IBM Spectrum LSF Explorer Server is running. IBM Spectrum LSF Explorer Server must be started before IBM Spectrum LSF Explorer Data Collector services.
Note: If Explorer is installed with LSF 10.1.0.10, ensure that Explorer Data Collector is installed on a host that has been added to the LSF_ADDON_HOSTS parameter in lsf.conf.

1. Log in to the LSF host on which you intend to install IBM Spectrum LSF Explorer Data Collector as the primary LSF administrator.
Note: Log in as root if you want to update the rc.boot scripts.

2. Extract the package:
tar -zxvf explorer10.2.0.13_node_linux-x64.tar.gz

3. Configure your installation:
-Go to the extracted directory and edit the install.config file.
-Configure all required parameters by uncommenting the line for each related parameter.
-If the Elasticsearch security feature is enabled, configure ES_AUTHENTICATION_ENABLED and ES_SSL_CERT_PATH.
-If you choose to enable the scaled IO statistics feature, set the JAVA_HOME environment variable and configure the LOGSTASH_TOP, GPFS_HOME and GPFS_DEVICE parameters.
-If you choose to enable the energy accounting feature, set the JAVA_HOME environment variable and configure the LOGSTASH_TOP and IPMI_HOME parameters.

4. Run the ExplorerNodeInstaller.sh installation script:
./ExplorerNodeInstaller.sh -f install.config
Note: For a silent installation, add the -silent option.

5. Set the environment to start the data collectors, where COLLECTOR_TOP is the directory in which you installed IBM Spectrum LSF Explorer Data Collector:
-For csh or tcsh:
source COLLECTOR_TOP/lsfsuite/ext/perf/conf/cshrc.perf
-For sh, ksh, or bash:
. COLLECTOR_TOP/lsfsuite/ext/perf/conf/profile.perf

Note: You might notice an error when you set the environment on the Red Hat Enterprise Linux 6.x x_64 platform, such as:
-bash: /lib/libc.so.6: No such file or directory
-bash: [: : integer expression expected
Cannot get binary type

To avoid this error, after you set the environment, install the related files by running the following command:
yum install ld-linux.so.2

6. Optional: Enable data collectors in your cluster to collect data for the FLEXlm-Managed Licenses Dashboard.
Note: The data collector for the FLEXlm Managed Licenses Dashboard is not supported on Linux for Power System Servers 8 Little Endian.

a. Get the FLEXlm utility files lmutil and lmgrd from your license server.

b. Copy the lmgrd and lmutil files from the license server location to the directory NODE_TOP/license/7.0/os_type/etc, where os_type is the operating system type.

c. Assign execute permissions to the lmgrd and lmutil files.

d. Edit the FLEXlm license usage data loader configuration file:
COLLECTOR_TOP/conf/dataloader/flexlicusage.properties and change the ServerList (or FileName) parameter to point to the FLEXlm license servers.
For more information, see the description in the flexlicusage.properties file.

e. Enable the FLEXlm license usage data loader in your cluster by editing the COLLECTOR_TOP/conf/plc/plc_license_explorer.xml file. Set the Enable attribute to true in the <DataLoader Name="flexlicusageloader" .../> element:
<DataLoader Name="flexlicusageloader" Interval="300" Enable="true" LoadXML="dataloader/flexlicusage.xml/>

7. Start the data collector plc service:
perfadmin start all

8. Check that the data loaders are running:
plcclient.sh -s

9. Check for errors in the data loader log files in the following directory:
$PERF_LOGDIR/dataloader

10. Optional: For installations of version 10.2.0.6 and later, if the scaled IO statistics feature or the energy accounting feature is enabled, restart Logstash as root user to make the configuration change effective.
If Logstash is installed by rpm package, you must change /etc/systemd/system/logstash.service to set the user as root and then start Logstash service by systemctl.

7. Upgrade from 10.2.0.10 to 10.2.0.13

Note: You must upgrade to IBM Spectrum LSF Explorer 10.2.0.10 before upgrading to IBM Spectrum LSF Explorer 10.2.0.13.

If you want to migrate data from the fix pack packaged OSS Elasticsearch 7.2.1 to your newly installed Elasticsearch. Back up your data before proceeding. For more details, see https://www.elastic.co/guide/en/elasticsearch/reference/7.2/restart-upgrade.html and https://www.elastic.co/guide/en/elasticsearch/reference/7.2/modules-snapshots.html.

Upgrade from 10.2.0.10 to 10.2.0.13 for IBM Spectrum LSF Explorer Server

1. Set the IBM Spectrum LSF Explorer Server environment:
    -For csh or tcsh:
     source SERVER_TOP/lsfsuite/ext/cshrc.platform
    -For sh, ksh, or bash:
     . SERVER_TOP/lsfsuite/ext/profile.platform

2. Stop the IBM Spectrum LSF Explorer Server:
        pmcadmin stop

3. Install LSF Explorer Server 10.2.0.13 by following the steps under the Installation steps for IBM Spectrum LSF Explorer Server 10.2.0.13 section.

4. Set the IBM Spectrum LSF Explorer Server environment:
    -For csh or tcsh:
     source SERVER_TOP/lsfsuite/ext/cshrc.platform
    -For sh, ksh, or bash:
     . SERVER_TOP/lsfsuite/ext/profile.platform

5. Start the IBM Spectrum LSF Explorer Server:
     pmcadmin start

6. Optional: If Explorer is not installed to the default location (/opt/ibm) and you want to enable https, open a new session, and run the following command:
    pmcadmin https enable --password xxx

Upgrade from 10.2.0.10 to 10.2.0.13 for IBM Spectrum LSF Explorer Data Collector

1. Source the environment:
    -For csh or tcsh:
   source COLLECTOR_TOP/lsfsuite/ext/perf/conf/cshrc.perf
    -For sh, ksh, or bash:
   . COLLECTOR_TOP/lsfsuite/ext/perf/conf/profile.perf

2. Stop the data loaders:
        perfadmin stop all

3. Install LSF Explorer Data Collector 10.2.0.13 by following the steps under the Installation steps for IBM Spectrum LSF Explorer Data Collector 10.2.0.13 section.

4. Source the environment:
   -For csh or tcsh:
   source COLLECTOR_TOP/lsfsuite/ext/perf/conf/cshrc.perf
   -For sh, ksh, or bash:
    . COLLECTOR_TOP/lsfsuite/ext/perf/conf/profile.perf

5. Start the data loaders:
    perfadmin start all

6. Optional: Restart Logstash when either the scaled IO statistics feature or the energy accounting feature is enabled.
    Note: Logstash must be started as root user.
    If Logstash is installed by rpm package, you must change /etc/systemd/system/logstash.service to set the user as root and then start Logstash service by systemctl.

8. Uninstallation

Uninstall Explorer Server
Run the ExplorerServerUninstall.sh script:
. SERVER_TOP/lsfsuite/ext/explorer/server/bin/ExplorerServerUninstall.sh

Uninstall Explorer Data Collector
Run the ExplorerNodeUninstall.sh script:
. COLLECTOR_TOP/lsfsuite/ext/perf/1.2/bin/ExplorerNodeUninstall.sh

9. Copyright and trademark information

©Copyright IBM Corporation 2022

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

This product includes some components redistributed from third-party vendors which are provided here for convenience. Licensee may copy and use these components within the confines of the third-party license as identified in the Notices file. IBM provides these third-party components without obligation of support and "AS IS", WITH NO WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTY OF TITLE, NON-INFRINGEMENT OR NON-INTERFERENCE AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.