Readme File for IBM® Spectrum Conductor 2.4.1 Interim Fix 600717
Readme file for: IBM Spectrum Conductor
Product release: 2.4.1
Update name: Interim Fix 600717
Fix ID: sc-2.4.1-build600717
Publication date: September 24, 2021
Interim fix to enable configuration for the SameSite attribute for cookies created by the IBM Spectrum Conductor cluster management console WEBGUI service.
Contents
1. List of fixes
2. Download location
3. Product and components affected
4. Installation
5. Uninstallation
6. List of files
7. Product notifications
8. Copyright and trademark information
1. List of fixes
APAR: P104378
2. Download location
Download interim fix 600717 from the following location: https://www.ibm.com/eserver/support/fixes/
3. Product and components affected
Component name, Platform, Fix ID:
WEBGUI, Linux x86_64, Linux ppc64le, sc-2.4.1-build600717
4. Installation
Follow the instructions in this section to download and install this interim fix to your cluster.
System requirements
Linux x86_64 or Linux ppc64le
Prerequisites
Before applying this fix, ensure that you have upgraded WebSphere Liberty Profile to the appropriate version by applying IBM Spectrum Conductor 2.4.1 interim fix 600049.
Installation
a) Log on to the primary host as the cluster administrator and stop the ascd, REST, WEBGUI and plc services:
> egosh user logon -u Admin -x Admin
> egosh service stop ascd REST WEBGUI plc
b) Stop the Elastic Stack services using the procedure in the 2.5.0 IBM Documentation, which is also applicable to 2.4.1.
c) On each of your management hosts, download and
extract the following packages to, for example, an /scfixes directory:
ascd-2.4.1.0_noarch_build600717.tar.gz
egomgmt-3.8.0.1_noarch_build600717.tar.gz
egorest-3.8.0.1_noarch_build600717.tar.gz
d) On each of your hosts, download and extract
the following packages to, for example, an /scfixes directory:
egoelastic-1.4.3.0_[x86_64|ppc64le]_build600717.tar.gz
e) On each of your management hosts, run the egoinstallfixes command to install the downloaded packages.
> egoinstallfixes /scfixes/ascd-2.4.1.0_noarch_build600717.tar.gz
> egoinstallfixes /scfixes/egomgmt-3.8.0.1_noarch_build600717.tar.gz
> egoinstallfixes /scfixes/egorest-3.8.0.1_noarch_build600717.tar.gz
On each of your hosts, run the egoinstallfixes command to install the downloaded packages.
> egoinstallfixes /scfixes/egoelastic-1.4.3.0_[x86_64|ppc64le]_build600717.tar.gz
Note: Running the egoinstallfixes command automatically backs up the current binary files to a fix backup directory for recovery purposes. Do not delete this backup directory; you will need it if you want to recover the original files. For more information on using this command, see the egoinstallfixes command reference.
f) On each of your hosts, run the pversions command to verify the installation:
> pversions -b 600717
g) From the primary host, start the Elastic Stack services using the procedure in the 2.5.0 IBM Documentation, which is also applicable to 2.4.1.
h) To set the SameSite attribute for the cluster management console cookies:
i) Edit the $EGO_CONFDIR/../../gui/conf/pmc.conf file by adding the new COOKIE_ATTRIBUTE_SAMESITE parameter with a value of either None, Lax, or Strict. For example:
COOKIE_ATTRIBUTE_SAMESITE=None
ii) Edit the $EGO_CONFDIR/../../gui/conf/server_gui.xml file by adding the httpSession cookieSameSite element with a value of None, Lax, or Strict. Add this new element inside the existing <server> element. For example:
<httpSession cookieSameSite="None" />
i) Start the ascd, REST, WEBGUI, and plc services:
> egosh service start ascd REST WEBGUI plc
5. Uninstallation
If required, follow the instructions in this section to uninstall this interim fix from your cluster.
a) Log on to the primary host as the cluster administrator and stop the ascd, REST, WEBGUI, and plc services:
> egosh user logon -u Admin -x Admin
> egosh service stop ascd REST WEBGUI plc
b) Stop the Elastic Stack services using the procedure in the 2.5.0 IBM Documentation, which is also applicable to 2.4.1.
c) On each host, roll back this interim fix:
> egoinstallfixes -r 600717
d) Remove any configuration changes that were made during the installation step.
e) From the primary host, start the Elastic Stack services using the procedure in the 2.5.0 IBM Documentation, which is also applicable to 2.4.1.
f) Start the ascd, REST, WEBGUI, and plc services:
> egosh service start ascd REST WEBGUI plc
6. List of files
$EGO_TOP/ascd/2.4.1/lib/commons-ego.jar
$EGO_TOP/perf/ego/3.8/lib/commons-ego.jar
$EGO_TOP/gui/3.8/lib/commons-ego.jar
$EGO_TOP/wlp/usr/shared/resources/rest/3.8/commons-ego.jar
$EGO_TOP/integration/elk/1.4.3/elasticsearch-7.2.1/plugins/search-guard-7/commons-ego.jar
7. 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.
8. Copyright and trademark information
© Copyright IBM Corporation 2021
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.