IBM Platform Application Center 9.1.3 Fix 242006 Readme

Abstract

This fix resolves the issue a) X.509 authentication does not work with Web Services and High Availability, b) It is not possible to download files larger than 2 GB with Web Services, c) The current execution working directory is not displayed when pacclient.py job -l is used, d) Patch installations display a message that the jvm.options file exists and is missing the port number in the displayed URL.
This fix adds support for: monitoring the license usage of multiple Platform Application Center installations and multiple LSF clusters.

Description

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

This fix addresses the following issues:

    -  When Platform Application Center is installed with High Availability, X.509 authentication does not work with Web Services

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

    -  The current execution working directory is not displayed when pacclient.py job -l job_ID is used.

    -  When a Patch is applied to a released version of Platform Application Center, the installation displays an error message that the jvm.options file exists and is missing the
       port number in the displayed URL

This fix adds support for:

    -  Monitoring the license usage of multiple Platform Application Center installations and multiple LSF clusters. The Usage Statistics page has been enhanced as well as the
       Login Settings page.

           - In $GUI_CONFDIR/entitlement.conf, the new parameter MAX_LOCAL_PAC_USERS allows you to specify the maximum number of concurrent users that are licensed
             to log into Platform Application Center in this cluster.
           - To specify from which Platform Application Center installations to collect usage data, specify the URLs with the new parameter REMOTE_PAC_URL in
                                     $GUI_CONFDIR/pmc.conf.
           - To specify from which LSF clusters to collect usage data, specify cluster information with the new parameter REMOTE_LSF in $GUI_CONFDIR/pmc.conf.

           Note: if REMOTE_PAC_URL or REMOTE_LSF is specified in pmc.conf, values in $GUI_CONFDIR/entitlement.conf become global values shared across all clusters and
                   Platform Application Center installations.

Readme file for: IBM® Platform Application Center
Product/Component Release: 9.1.3.0
Update Name: Fix 242006
Fix ID: pac9.1.3_standard_linux-x64.tar.Z
Publication date: 16 September 2014
Last modified date:  24 September 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#: P100579

• Download Location

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

• Products or components affected

 Affected components include: Usage Statistics

• System requirements

None

• Installation and configuration

5.1 Before installation

           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.

             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.3 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.3_standard_linux-x64.tar.Z.

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

             6.    As root, log on to your IBM Platform Application Center 9.1.3 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} --nopreun pcc-appcenter-9.1.3-242006.x86_64.rpm
Note: Replace ${PAC_TOP} with your actual installation directory.

5.3 After installation

             1.    Start IBM Platform Application Center services

    perfadmin start all
                   pmcadmin start

             2.    Merge ${PAC_TOP}/gui/conf/pmc.conf.old into ${PAC_TOP}/gui/conf/pmc.conf according to your old configuration.

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

5.4 Configure license usage monitoring for multiple LSF clusters

5.4.1   Configure passwordless SSH.

                       To configure license usage monitoring for multiple Platform LSF clusters, you need to configure passwordless SSH on those clusters. The user to
                       generate the public and private rsa key pair must be root.

                       1.  As root, log in to a host that belongs to the remote cluster for which you want to monitor license usage.

                            For example:

[root@pac-2 ~]# ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.
The key fingerprint is:
45:9f:be:13:c3:25:b5:a7:37:01:75:b7:9b:06:e1:23 root@pac-2
The key's randomart image is:
+--[ RSA 2048]----+
| . oo.o|
| . ..oo.+|
| .E++oo.|
| . o.ooo+|
| S = .=.|
| +...|
| o |
| . |
| |


                          2.  Append new public key (id_rsa.pub) to ~/.ssh/authorized_keys of remote LSF host.

                                For example:


cat ~/.ssh/id_rsa.pub | ssh user2@remotehost "cat >> ~/.ssh/authorized_keys"

                                Notes: Change the permissions of ~/.ssh to 700, and change the permissions of .ssh/authorized_keys to 640.

                          3. Testing without password and log in remote LSF host for the following:

                       ssh -o BatchMode=yes lsfadmin@remote_lsf_host

5.4.2   Configure which remote LSF clusters to monitor

                          1. As root, log on to the Platform Application Center web server from which you want to monitor the multiple LSF clusters.

                          2. Edit $GUI_CONFDIR/pmc.conf and use the REMOTE_LSF parameter to specify which LSF clusters to monitor.
                              For example, to configure license usage monitoring for the cluster with administrator lsfadmin, host name on which passwordless SSH is enabled
                              host1.example.com, and the directory in which LSF has been installed /share/lsf:

#
# Specify the LSF clusters for which to monitor license usage.
# Syntax:
# REMOTE_LSF=lsf_administrator@host_name:LSF_TOP,lsf_administrator@host_name:LSF_TOP
# where:
# - lsf_administrator is the LSF administrator of the remote LSF cluster
# - host_name is the fully qualified host name or IP address of the host in the
# remote LSF cluster
# in which passwordless SSH has been enabled
# - LSF_TOP is the directory in which LSF has been installed in the remote
# LSF cluster
#
# Separate different cluster information with a comma (,).
REMOTE_LSF=lsfadmin@host1.example.com:/share/lsf

                         3. Restart Platform Application Center to make changes take effect.


5.5 Configure license usage monitoring for multiple Platform Application Center installations

            1.  As root, log on to the Platform Application Center web server from which you want to monitor other Platform Application Center installations.

            2.  Edit $GUI_CONFDIR/pmc.conf and configure the REMOTE_PAC_URL parameter to indicate which Platform Application Center installations to monitor.

                 For example:

#
# Specify the URLs of Platform Application Center installations for which you want to monitor
# license usage. To specify multiple installations, separate with a comma (,).
#
# Examples:
# Platform Application Center installations without multiple Platform Application Center instances
# and no High Availability:
# REMOTE_PAC_URL=http://192.168.1.100:8080/platform,https://192.168.1.101:8080/platform
#
# If you have installed multiple Platform Application Center instances with High Availability,
# specify the IBM HTTP Server IP address instead of the Platform Application Center
# web server IP address. For example:
# REMOTE_PAC_URL=http://192.168.1.100/platform,https://192.168.1.101/platform
#
# NOTE: If you have customized the URL by specifying -Ddefault.context.name in $GUI_CONFDIR/jvm.options,
# do not specify /platform but your custom value.
REMOTE_PAC_URL=https://192.168.1.101:8080/platform,https://192.169.1.101:8080/platform


            3.  Edit $GUI_CONFDIR/entitlement.conf and configure the number of concurrent users across all clusters.

                 a) Configure MAX_PAC_USERS to specify the maximum number of concurrent users across all monitored Platform Application Center installations.

                     For example:

#
# Maximum number of concurrent users that are licensed to
# log into Platform Application Center.
#
# If REMOTE_PAC_URL is configured in $GUI_CONFDIR/pmc.conf, this parameter becomes the
# maximum number of concurrent users across al monitored Platform Application Center
# installations. You will need to configure MAX_PAC_LOCAL_USERS in entitlement.conf
# to specify the maximum number of concurrent users for this Platform
# Application Center installation.
#
MAX_PAC_USERS=200


                 b) Configure MAX_PAC_LOCAL_USERS to specify the maximum number of concurrent users for this Platform Application Center installation.

                     For example:

#
# Maximum number of concurrent users that are licensed to
# log into this Platform Application Center installation. If the maximum number of concurrent
# users is reached, an alert message is displayed in Platform Application Center.
#
MAX_PAC_LOCAL_USERS=50


            4.  Restart Platform Application Center to make changes take effect.

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

             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.3-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 --nopreun --noscripts pcc-appcenter-9.1.3-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

    perfadmin start all
                   pmcadmin start

             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/bin/pmcadmin
${PAC_TOP}/gui/3.0/bin/pac_api.py
${PAC_TOP}/gui/conf/entitlement.conf
${PAC_TOP}/gui/conf/pmc.conf
${PAC_TOP}/gui/conf/fusionChart/coresStatisticAreaChart.xml
${PAC_TOP}/gui/conf/fusionChart/serversStatisticAreaChart.xml
${PAC_TOP}/gui/conf/fusionChart/slotsStatisticAreaChart.xml
${PAC_TOP}/gui/conf/fusionChart/userLogonStatisticAreaChart.xml
${PAC_TOP}/gui/conf/fusionChart/vmJobContainersStatisticAreaChart.xml
${PAC_TOP}/gui/conf/navigation/pmc_layout.xml
${PAC_TOP}/gui/conf/navigation/pmc_tree.xml
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/security/sync/MixedSynchronizeServiceImpl.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/cluster/util/ClusterHelper.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/cluster/util/ClusterHelper$1.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/cluster/webservice/ClusterWebService.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/cluster/webservice/impl/ClusterWebServiceImpl.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/dashboard/action/DashboardAction.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/dashboard/model/chart/ChartPoint.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/package.properties
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/package_zh_CN.properties
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/package_ja.properties
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/package_de_DE.properties
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/struts.xml
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/action/LicenseStatisticAction.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/action/UserSessionsAction.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/dao/LicenseComplianceDao.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/dao/UserSessionsDao.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/dao/impl/LicenseComplianceDaoImpl.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/dao/impl/UserSessionsDaoImpl.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/model/DCUsage.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/model/LsfUsage.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/model/LSUsage.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/model/MetricSetUsage.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/model/MetricUsage.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/model/PacChartService.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/model/PacUsage.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/model/PacUsageService.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/service/ConcurrentUserService.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/service/ConcurrentUserTask.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/service/LicenseComplianceLoader.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/service/LicenseComplianceService.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/service/impl/LicenseComplianceServiceImpl.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/util/GenerateChartUtil.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/util/GenerateChartUtil$ChartConf.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/util/GenerateXMLStream.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/util/LicenseComplianceUtil.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/license/util/UserSessionsManage.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/pacwebservice/clientwebservice/service/ClientWebService.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/pacwebservice/clientwebservice/service/ClientWebService$1.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/pacwebservice/clientwebservice/util/ClientWebServiceUtil.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/pacwebservice/clientwebservice/util/ClientWebServiceUtil$1.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/batchservice/Job.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/WEB-INF/classes/com/platform/gui/pac/plugin/PACLoginServiceImp.class
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/dynamicClusterUsage.jsp
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/dynamicClusterUsageTable.jsp
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/licenseSchedulerUsage.jsp
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/licenseSchedulerUsageTable.jsp
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/licensestatistic.jsp
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/lsfUsage.jsp
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/lsfUsageTable.jsp
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/pacUsageTable.jsp
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/usageStatistics.jsp
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/usersSetting.jsp
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/css/licensestatistic_lowResolution.css
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/css/licensestatistic.css
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/js/dynamicClusterUsage.js
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/js/dynamicClusterUsageTable.js
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/js/licenseSchedulerUsage.js
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/js/licenseSchedulerUsageTable.js
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/js/licensestatistic.js
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/js/lsfUsage.js
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/js/lsfUsageTable.js
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/js/pacUsageTable.js
${PAC_TOP}/gui/3.0/wlp/usr/servers/platform/apps/platform.war/pac/license/js/usersSetting.js


• 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