Fix Readme

IBM Platform Application Center 9.1.4 and 9.1.4.1 Fix 373600 Readme

Abstract

This fix resolves the following issues: 1. User names that contain a backslash(\) cannot be assigned the Platform Application Center administrator role. 2. User names that contain a backslash (\) immediately followed by t or n (\t, \n) are not correctly displayed in System & Settings>Settings>Users>Users & Groups. 3. Integration with CA SiteMinder. When user mapping is enabled with USER_MAP_SCRIPT in $GUI_CONFDIR/pmc.conf and a pre-defined security token is also enabled with WS_LOGON_USERS in $GUI_CONFDIR/pmc.conf, Platform Web Services cannot retrieve jobs submitted by user names passed in the variable REMOTE_USER.

Description

Readme documentation for IBM Platform Application Center 9.1.4 and 9.1.4.1 Fix 373600 including installation-related instructions, prerequisites and co-requisites, and list of fixes.
This fix resolves the following issues:
- User names that contain a backslash(\) cannot be assigned the Platform Application Center administrator role.
- User names that contain a backslash (\) immediately followed by t or n (\t, \n) are not correctly displayed in System & Settings>Settings>Users>Users & Groups.
- When user mapping is enabled with USER_MAP_SCRIPT in $GUI_CONFDIR/pmc.conf and a pre-defined security token is also enabled with WS_LOGON_USERS in in $GUI_CONFDIR/pmc.conf, Platform Web Services cannot retrieve jobs submitted by user names passed in the variable REMOTE_USER.

Contents

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

List of fixes
APAR#: P101435 P101434 P101466
Download location
Download Fix 373600 from the following location: http://www.ibm.com/eserver/support/fixes/
Affected components:
- Command line interface: pacclient.py
- Settings > Users & Groups.
System requirements
Linux_x86_64
Installation and configuration
- 5.1 Before installation
  
  Check and record the version and build number of IBM Platform Application Center. this is in case of rolling back the fix.
  pmcadmin -V
  
  Stop all IBM Platform Application Center services:
  perfadmin stop all
  pmcadmin stop
- 5.2 Installation steps
  The following steps assume IBM Platform Application Center is installed in /opt/pac.
  Replace with your actual installation directory.
  - Installation steps for IBM Platform Application Center 9.1.4
    - Determine the location of your existing IBM Application Center installation.
      #rpm -q --queryformat "%{INSTPREFIXES}\n" pcc-appcenter
    - Back up the existing:
      #cp -rfp /opt/pac /opt/pac.bak
    - Complete this step to backup database only if you are using a local MySQL database.
      Export your local IBM Platform Application Center MySQL database by using the following command:
      #mysqldump -u pacuser -p pac --add-drop-table > /root/pacdata.sql
    - Download the fix file: pac9.1.4.1_standard_linux-x64.tar.Z.
    - Extract pac9.1.4.1_standard_linux-x64.tar.Z.
    - As root, log on to your IBM Platform Application Center 9.1.4.1 host.
    - Set your IBM Platform Application Center environment:
      For csh or tcsh:
      % source /opt/pac/cshrc.platform
      For sh, ksh, or bash:
      $ . /opt/pac/profile.platform
    - Install the fix.
      rpm -Uvh --prefix ${PAC_TOP} --nopreun pcc-appcenter-9.1.4.1-373600.x86_64.rpm
      Note: Replace ${PAC_TOP} with your actual installation directory.
    - Upgrade steps
      
      If you have a local database your database is automatically updated for you. If you have a remote database, update your existing database schema from 9.1.4 to 9.1.4.1.
      
      As root, extract the schema package.
      tar -xvf pcc-appcenter-9.1.4.1-dbschema.tar
      
      Connect to your database with your existing user name and password, then run the appropriate scripts according to the previous version of Platform Application Center that you have installed.
      To update your database schema from 9.1.4 to 9.1.4.1:
      mysql -u root -p $rootpassword
      mysql>use pac
      mysql>source DBschema/MySQL/Patch/pac914_to_9141.sql;
  - Installation steps for IBM Platform Application Center 9.1.4.1.
    - Determine the location of your existing IBM Application Center installation.
      #rpm -q --queryformat "%{INSTPREFIXES}\n" pcc-appcenter
    - Back up the existing:
      #cp -rfp /opt/pac /opt/pac.bak
    - Download the fix file: pac9.1.4.1_standard_linux-x64.tar.Z.
    - Extract pac9.1.4.1_standard_linux-x64.tar.Z.
    - As root, log on to your IBM Platform Application Center 9.1.4.1 host.
    - Set your IBM Platform Application Center environment:
      For csh or tcsh:
      % source /opt/pac/cshrc.platform
      For sh, ksh, or bash:
      $ . /opt/pac/profile.platform
    - Install the fix.
      rpm -Uvh --prefix ${PAC_TOP} --nopreun pcc-appcenter-9.1.4.1-373600.x86_64.rpm
      Note: Replace ${PAC_TOP} with your actual installation directory.
- 5.3 Start IBM Platform Application Center services.
  
  perfadmin start all
  pmcadmin start
Uninstallation
- 6.1 Before uninstallation
  
  Stop all IBM Platform Application Center services:
  perfadmin stop all
  pmcadmin stop
- 6.2 Roll back the fix
  The following steps assume IBM Platform Application Center is installed in /opt/pac.
  Replace with your actual installation directory.
  - Determine the location of your existing IBM Application Center installation.
    #rpm -q queryformat %{INSTPREFIXES}\n pcc-appcenter
  - Download the RPM package for a version previous to the Fix, for example, pcc-appcenter-9.1.4.1-123456.x86_64.rpm.
  - Set your IBM Platform Application Center environment:
    For csh or tcsh:
    % source /opt/pac/cshrc.platform
    For sh, ksh, or bash:
    $ . /opt/pac/profile.platform
  - Install the IBM Platform Application Center RPM package. For example:
    #rpm -Uvh --prefix ${PAC_TOP} --oldpackage --nopreun --noscripts pcc-appcenter-9.1.4.1-123456.x86_64.rpm,
  - If you have made any customizations, reapply your customizations from the backup directory.
  - Start IBM Platform Application Center services
    perfadmin start all
    pmcadmin start
  - Clear your browser cache before logging into IBM Platform Application Center.
    This is required on every browser that will access IBM Platform Application Center. Otherwise, IBM Platform Application Center will not work properly.
List of files

$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/framework/security/action/UsersGroupsAction.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/framework/security/action/UsersGroupsAction$1.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/framework/security/action/UsersGroupsAction$2.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/security/util/PACAdminsUtil.class
$PMC_TOP/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/framework/security/spring.xml
Copyright and trademark information
©Copyright IBM Corporation 2015

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