IBM Spectrum LSF Application Center V10.2.0.7 Fix 528660 Readme

Abstract

This fix enables the single sign-on (SSO) feature.

Description

Readme documentation for IBM Spectrum LSF Application Center V10.2.0 Fix including installation-related instructions, prerequisites and co-requisites, and list of fixes.

This fix addresses the following enhancement.
1. This fix enables single sign-on (SSO) in LSF Application Center.

Readme file for: IBM® Spectrum LSF Application Center
Product/Component Release: 10.2.0.7
Update Name: Fix 528660
Fix ID: pac-10.2-build528660
Publication date: Sept. 12 2019
Last modified date: Sept. 12 2019

Contents

List of fixes
Download location
Product notifications
Products or components affected
System requirements
Installation and configuration
Uninstallation
List of files
Copyright and trademark information

List of fixes
P103116
Download location
Download from the following location: http://www.ibm.com/eserver/support/fixes/
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.
Products or components affected
N/A
System requirements
- Linux-x86_64
Installation and configuration
- 6.1 Before installation
  - Download package pac-10.2-build528643
  - Log on to the IBM Spectrum LSF Application Center server host as root.
  - Set your IBM Spectrum LSF Application Center environment.
    For csh or tcsh:
    % source /opt/ibm/lsfsuite/ext/cshrc.platform
    For sh, ksh, or bash:
    $ . /opt/ibm/lsfsuite/ext/profile.platform
  - Determine the location of your existing IBM Spectrum LSF Application Center installation.
    #rpm -q --queryformat "%{INSTPREFIXES}\n" lsf-appcenter
  - Check and record the version and build number of your existing installation of IBM Spectrum LSF Application Center in case you need to roll back the fix.
    pmcadmin -V
  - Stop all IBM Spectrum LSF Application Center services.
    perfadmin stop all
    pmcadmin stop
  - Back up your existing installation.
    For example:
    #cp -rfp /opt/ibm /opt/ibm.bak
- 6.2 Installation steps for IBM Spectrum LSF Application Center V10.2.0.
  The following steps assume that IBM Spectrum LSF Application Center is installed in /opt/ibm.
  Replace with your actual installation directory.
  Note: This patch is only for LSF Application Center V10.2.0. If you are using other versions, you must first migrate to V10.2.0 before applying this Fix Pack.
  - Extract pac10.2.0.7_standard_linux-x64.tar.Z.
    tar -xzvf pac10.2.0.7_standard_linux-x64.tar.Z
  - As root, log on to your IBM Spectrum LSF Application Center 10.2 host.
  - Set your IBM Spectrum LSF Application Center environment.
    For csh or tcsh:
    % source /opt/ibm/lsfsuite/ext/cshrc.platform
    For sh, ksh, or bash:
    $ . /opt/ibm/lsfsuite/ext/profile.platform
  - Configure the pacinstall.sh file
    Replace ${INSTALLATION_TOP} with your actual installation directory, set ${USE_REMOTE_DB} as 'Y' in case of PAC HA.
  - Install the patch
    ./pacinstall.sh
    Note: Make sure the script and all RPM files for the upgrade package are in the same directory.
  - Configure the $PMC_TOP/gui/conf/pmc.conf to add following parameters
    
    ENABLE_UAC_SSO=true
    UAC_CLASS_NAME=com.zte.uac.ssoclient.UacSSoClient
    UAC_LOGIN_URL=https://uac.zte.com.cn/portal/login.html
    UAC_VERIFY_URL=https://uac.zte.com.cn/auctoken/auth/token/verify.serv
    UAC_BACK_URL=http://pac.zte.com.cn/platform
    UAC_LOGOUT_URL=https://isc.zte.com.cn
    UAC_SYS_CODE=100000450439
    UAC_SESSION_NAME=SsoUser
    UAC_COOKIE_NAME=PORTALSSOUser
    UAC_TOKEN_NAME=PORTALSSOCookie
    UDS_COOKIE_NAME=ZTEDPGSSOUser
    UDS_TYPE_NAME=ZTEDPGSSOVersionType
    UDS_TOKEN_NAME=ZTEDPGSSOCookie
    UDS_CLIENT_IP_NAME=udsClientIp
    UDS_VERSION_NAME=udsVersion
    UDS_CLIENT_SN_NAME=clientSerialNo
  - Copy following files to directory $PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/lib and enable execution permission
    
    uacsso-1.4-jdk1.8.jar
    ezmorph-1.0.6.jar
    json-lib-2.4-jdk15.jar
  - Run following commands
    mv $PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/web.xml.uac $PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/web.xml
    mv $PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/spring-security.xml.uac $PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/spring-security.xml
  - Clean up directory $PMC_TOP/gui/work.
  - Start IBM Spectrum LSF Application Center services.
    perfadmin start all
    pmcadmin start
Uninstallation
- 7.1 Before uninstallation
  
  Stop all IBM Spectrum LSF Application Center services:
  perfadmin stop all
  pmcadmin stop
- 7.2 Roll back the fix
  The following steps assume that IBM Spectrum LSF Application Center is installed in the /opt/ibm directory.
  Replace this with your actual installation directory.
  - Determine the location of your existing IBM Application Center installation.
    #rpm -q --queryformat "%{INSTPREFIXES}\n" lsf-appcenter
  - Download package pac-10.2-build509656
  - Set your IBM Spectrum LSF Application Center environment:
    For csh or tcsh:
    % source /opt/ibm/lsfsuite/ext/cshrc.platform
    For sh, ksh, or bash:
    $ . /opt/ibm/lsfsuite/ext/profile.platform
  - Extract pac10.2.0.7_standard_linux-x64.tar.Z.
    tar -xzvf pac10.2.0.7_standard_linux-x64.tar.Z
  - Configure the pacinstall.sh file
    Replace ${INSTALLATION_TOP} with your acture installation directory
  - Install the package of previous version
    ./pacinstall.sh -d
    Note: Make sure the script and all RPMs for the downgrade package are in the same directory.
  - If you have made any customizations, reapply your customizations from the backup directory.
  - Start IBM Spectrum LSF Application Center services
    perfadmin start all
    pmcadmin start
  - Clear your browser cache before logging into IBM Spectrum LSF Application Center.
    This is required on every browser that will access IBM Spectrum LSF Application Center. Otherwise, IBM Spectrum LSF Application Center will not work properly.
List of files

$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/pac._RANDOMSTRING_.js
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/pac._RANDOMSTRING_.js.map
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/0-chunk._RANDOMSTRING_.js
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/0-chunk._RANDOMSTRING_.js.map
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/1-chunk._RANDOMSTRING_.js
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/1-chunk._RANDOMSTRING_.js.ma
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/framework/framework._RANDOMSTRING_.j
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/framework/framework._RANDOMSTRING_.js.map
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/login/login._RANDOMSTRING_.js
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/login/login._RANDOMSTRING_.js.map
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/framework/security/authentication/filter/TokenAuthenticationFilter.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/framework/security/authentication/filter/UacPreAuthenticationFilter.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/framework/security/authentication/filter/UacRedirectFilter.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/framework/security/util/AuthUtil.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/webservice/impl/LogOnWebServiceImpl.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/webservice/impl/LogOutWebServiceImpl.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/webservice/util/PermissionUtil.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/util/RepositoryHelper.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/pws/webservice/impl/RBACWebServieImpl.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/pacwebservice/clientwebservice/service/ClientWebService.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/pacwebservice/clientwebservice/service/internal/InternalWebService.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/webservice/util/AuthUtil.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/webservice/util/PermissionUtil.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/spring-security.xml.uac
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/web.xml.uac
Copyright and trademark information
©Copyright IBM Corporation 2019

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 http://www.ibm.com/legal/copytrade.shtml