IBM Platform Application Center 9.1.2 Fix 232739 Readme

Abstract

This fix resolves issues with PAC user authentication issue when user's passcode changes every 60 seconds, downloading .link file issue from job detail and PAC installation issue.

Description

Readme documentation for IBM Platform Application Center 9.1.2 Fix 232739 including installation-related instructions, prerequisites and co-requisites, and list of fixes.

This fix addresses the following issue:

1. The customer has enabled PAC with Process Manager. And customer is using a special security authentication system that changes the user passcode every  60 seconds, which is causing problems for PAC when Process Manager is enable. When a user logins into PAC, after about 1 minute the user will see an error message that the username or password is invalid when user tried to refresh job list page.
2. When a user is downloading ".lnk" files in jobs page, the Content-Type is set to "text/plain" and the file is saved as ".lnk.txt". User can't use the ".lnk" file directly.
3. "tr -d" in installing script changed the name of hosts in master list when install PAC.

Readme file for: IBM® Platform Application Center
Product/Component Release: 9.1.2.0
Update Name: Fix 232739
Fix ID: pac9.1.2_standard_linux-x64.tar.Z
Publication date: 14 April 2014
Last modified date: 4 May 2014

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#: P100388

• Download Location

 Download Fix 232739 from the following location: http://www.ibm.com/eserver/support/fixes/

• Products or components affected

 Affected components include: PAC and PPM integration, Installation, WS and Job.

• System requirements

 4.1 Software requirements

• IBM Platform Process Manager 9.1.2.0
• Installation and configuration

5.1 Before installation

           Stop all IBM Platform Application Center services:

           If EGO is not enabled:

perfadmin stop all
               pmcadmin stop

If EGO is enabled:

           a.  Log on to EGO.

egosh user logon -u Admin -x Admin

           b.  Stop IBM Platform Application Center services.

egosh service stop mysql WEBGUI jobdt plc purger

c.  Check that services have stopped.

                egosh service list

5.2 Installation steps

The following steps assume IBM Platform Application Center is installed in /opt/pac.
             Replace with your actual installation directory.

             1.    Determine the location of your existing IBM Application Center installation.
#rpm -q --queryformat "%{INSTPREFIXES}\n" pcc-appcenter

             2.    As root, log on to your IBM Platform Application Center 9.1.2 host. Backup the exiting installation directory, for example:
#cp -rfp /opt/pac /opt/pac.bak

             3.    Backup database if you use local MySQL.
                    Export local IBM Platform Application Center mysql database use command:
#mysqldump -u pacuser -p pac --add-drop-table > /root/pacdata.sql

             4.    Download the fix file: pac9.1.2_standard_linux-x64.tar.Z.

             5.    Extract  pac9.1.2_standard_linux-x64.tar.Z.

             6.    As root, log on to your IBM Platform Application Center 9.1.2 host.

             7.    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


             8.    Install the fix.
rpm -Uvh --prefix ${PAC_TOP} pcc-appcenter-9.1.2-232739.x86_64.rpm
Note: Replace ${PAC_TOP} with your actual installation directory.

5.3 After installation

             1.    Start IBM Platform Application Center services

                    If EGO is not enabled:

    perfadmin start all
                   pmcadmin start

        If EGO is enabled:

                   a.  Log on to EGO.

        egosh user logon -u Admin -x Admin

                   b.  Start IBM Platform Application Center services.

        egosh service start mysql WEBGUI jobdt plc purger

c.  Check that services have stopped.

                        egosh service list

             2.    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.

• Uninstallation

6.1 Before uninstallation

           Stop all IBM Platform Application Center services:

           If EGO is not enabled:

perfadmin stop all
               pmcadmin stop

If EGO is enabled:

           a.  Log on to EGO.

egosh user logon -u Admin -x Admin

           b.  Stop IBM Platform Application Center services.

egosh service stop mysql WEBGUI jobdt plc purger

c.  Check that services have stopped.

                egosh service list

 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.

             1.    Determine the location of your existing IBM Application Center installation.
#rpm -q queryformat %{INSTPREFIXES}\n pcc-appcenter

             2.    Download the RPM package for a version previous to the Fix, for example, pcc-appcenter-9.1.2-123456.x86_64.rpm.

             3.    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


             4.    Install the IBM Platform Application Center RPM package, for Example:
#rpm -Uvh --prefix ${PAC_TOP} --oldpackage --noscripts pcc-appcenter-9.1.2-123456.x86_64.rpm
Note: Replace ${PAC_TOP} with your actual installation directory.

             5.    If administrator has done some customization on code, copy back the changed code from backup directory.

             6.    Start IBM Platform Application Center services

                    If EGO is not enabled:

    perfadmin start all
                   pmcadmin start

        If EGO is enabled:

                   a.  Log on to EGO.

        egosh user logon -u Admin -x Admin

                   b.  Start IBM Platform Application Center services.

        egosh service start mysql WEBGUI jobdt plc purger

c.  Check that services have stopped.

                        egosh service list

             7.    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

${PAC_TOP}/gui/3.0/tomcat/webapps/platform/WEB-INF/classes/com/platform/gui/ppm/common/service/real/RealAbstractFlowService.class 
${PAC_TOP}/gui/3.0/tomcat/webapps/platform/WEB-INF/classes/com/platform/gui/ppm/common/util/FlowUtil.class 
${PAC_TOP}/gui/3.0/bin/pmcadmin
${PAC_TOP}/gui/3.0/tomcat/webapps/platform/WEB-INF/classes/com/platform/gui/pac/job/action/DataDownloadAction.class
${PAC_TOP}/gui/3.0/tomcat/webapps/platform/WEB-INF/web.xml
${PAC_TOP}/gui/3.0/tomcat/webapps/platform/WEB-INF/classes/com/platform/gui/pac/pacwebservice/clientwebservice/service/ClientWebService.class

• Copyright and trademark information

© Copyright IBM Corporation 2014

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