IBM Platform Application Center 9.1.1 Fix 240086 Readme

Abstract

This Fix resolves the following two issues with Web Services:

- The automatically created job directory is not displayed when job data is viewed with pacclient.py jobdata or the API Get Job File list (/platform/webservice/pacclient/jobfiles/). This occurs only when the submission script changes the directory to another directory before submitting the job with the bsub command.

- Files that are larger than 2 GB cannot be uploaded or downloaded with Web Services.

Description

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

This fix addresses the following issues:

a) The automatically created job directory is not displayed when job data is viewed with pacclient.py jobdata or the API Get Job File list (/platform/webservice/pacclient/jobfiles/). This occurs only when the submission script changes the directory to another directory before submitting the job with the bsub command.

When the application submission script is invoked, Platform Application Center automatically creates the job directory. If within the submission script there is a command to change to a different directory and then the bsub command is used to submit the job, the directory from which the bsub command is run is also a directory used by the job.

With this Fix, Platform Application Center displays all job directories used by the job when pacclient.py jobdata or the API Get Job File list(/platform/webservice/pacclient/jobfiles/) is used. The HOSTNAME column categorizes the type of directory:

- The automatically created job directory when the submission script is run is displayed as "PAC Server Spooler"
- The directory in which the bsub command was run is displayed as "PAC Server" directory

In addition, downloading data files for a job with pacclient.py download or the APIs /platform/webservice/pacclient/filePost/<ID> or /platform/webservice/pacclient/file/<ID> has been enhanced. Platform Application Center now downloads all data for a job, including the automatically created job directory(PAC Server Spooler) and the directory in which the bsub command was run(PAC Server).

b) It was not possible to download or upload files that are larger than 2 GB with Web Services. This limitation is now removed and files can be uploaded or downloaded with Web Services regardless of file size.

Readme file for: IBM® Platform Application Center
Product/Component Release: 9.1.1.0
Update Name: Fix 240086
Fix ID: pac9.1.1_standard_linux-x64.tar.Z
Publication date: 23 July 2014
Last modified date: 23 July 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#: P100447, P100509

• Download Location

 Download Fix 240086 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.1.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.1 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.1_standard_linux-x64.tar.Z.

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

             6.    As root, log on to your IBM Platform Application Center 9.1.1 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.1-240086.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.1-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.1-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

/opt/pac/gui/3.0/tomcat/webapps/platform/gui/pac/pacwebservice/clientwebservice/util/ClientWebServiceUtil.class
/opt/pac/gui/3.0/tomcat/webapps/platform/gui/pac/pacwebservice/clientwebservice/service/ClientWebService.class
/opt/pac/gui/3.0/tomcat/webapps/platform/gui/pac/pacwebservice/clientwebservice/service/ClientWebService$1.class
/opt/pac/gui/3.0/tomcat/webapps/platform/gui/pac/batchservice/Job.class
/opt/pac/gui/3.0/tomcat/webapps/platform/gui/pac/pacwebservice/clientwebservice/api/AppSubmit.class
/opt/pac/gui/3.0/bin/pac_api.py
/opt/pac/gui/3.0/bin/pacclient.py


• 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