Platform Support Guide

For Pegasystems Partners, Customers, and Prospects

PRPC Version 7.1

January 10, 2014

 Copyright 2014 Pegasystems Inc., Cambridge, MA

All rights reserved. This document describes products and services of Pegasystems Inc. It may contain trade secrets and proprietary information. The document and product are protected by copyright and distributed under licenses restricting their use, copying distribution, or transmittal in any form without prior written authorization of Pegasystems Inc. This document is current as of the date of publication only. Changes in the document may be made from time to time at the discretion of Pegasystems. This document remains the property of Pegasystems and must be returned to it upon request. This document does not imply any commitment to offer or deliver the products or services described. This document may include references to Pegasystems product features that have not been licensed by your company. If you have questions about whether a particular capability is included in your installation, please consult your Pegasystems service consultant. For Pegasystems trademarks and registered trademarks, all rights reserved. Other brand or product names are trademarks of their respective holders. Although Pegasystems Inc. strives for accuracy in its publications, any publication may contain inaccuracies or typographical errors. This document or Help System could contain technical inaccuracies or typographical errors. Changes are periodically added to the information herein. Pegasystems Inc. may make improvements and/or changes in the information described herein at any time.

This document is the property of: Pegasystems Inc. One Rogers Street Cambridge, MA 02142 Phone: (617) 374-9600 Fax: (617) 374-9620 www.pega.com Document: Platform Support Guide Software Version: 7.1 Updated: January 10, 2014

Contents
Policy Statement ............................................................................................. 2 Supported Server Platform List for PRPC v7.1 ..................................................... 4 PRPC v7.1 Client Requirements ....................................................................... 11 End-User Client Software ............................................................................ 11 A Note about 64-Bit Client Support ........................................................... 11 Developer Client Software ........................................................................... 12 Additional Client Software ........................................................................... 13

Policy Statement
PegaRULES Process Commander is designed as an open system which complies with industry standards. It is implemented in Java, using standard facilities to ensure compatibility and operability with similarly compliant 3rd party components such as Server Operating Systems, Databases, Applications Servers, Client Operating Systems, Browsers and integration service components. Our expectation is that PegaRULES can be deployed successfully in tandem with any combination of environmental and infrastructure components including hybrid heterogeneous combinations of dissimilar servers. It is also our expectation, gained from experience, that with such deployments the devil is in the details, and that the first such deployment should only be undertaken by experienced engineers who have the necessary skills to ensure smooth and complete installation and reliable and performant operation. In addition: 1. Customers should contact their Pegasystems representative to discuss their platform selection and their installation plan before beginning the installation. 2. PegaRULES Process Commander and applications built on it are designed to run on any combination within each category of the published platform components in the Platform Options section, including a mixed deployment of different application server or browser technology. Consult your Pegasystems representative to determine whether the desired platform combination has been deployed in production before, and to discuss risk mitigation strategies. 3. To obtain new features and capabilities, customers may be required to upgrade to newer versions of PegaRULES products, which may have different or additional prerequisites. Note also that updated versions of third-party components (including bug fix releases of such components) may themselves impose different or additional prerequisites. 4. For all of the third-party components, Pegasystems will support the current product version and the version immediately prior to the current release. 5. Pegasystems will make commercially reasonable efforts to offer support in its products for a new version of the third-party components listed in this document, within 12 months of that version becoming Generally Available (as differentiated from an alpha or beta version of the product). This support will normally be made available in a new release. 6. It is Pegasystems policy not to backwards-test new versions of third-party products with older releases of PRPC. Support for new third-party products is provided through newer versions of PRPC software.
PRPC Platform Support Guide January 10, 2014 Confidential

If you choose to upgrade third-party components to the latest releases, but want to stay on older releases of PRPC, you may enter support requests for any problems encountered. However, if the root cause of these problems stems from the fact that the older versions of PRPC were not designed to handle functionality in the newer components, Pegasystems may request that you upgrade your PRPC version to a release that directly supports that newer component, as listed in this Guide.

Pegasystems Inc. Statement of Support for VMWare Pegasystems Inc. will support customers who run Pegasystems Inc. products on supported Operating Systems, irrespective of whether they are running in VMware environments or not. VMware supports a set of certified Operating Systems and Hardware, and the customer and VMware will be responsible for any interactions or issues that arise at the Hardware or Operating System layer as a result of their use of VMware. Pegasystems Inc. will not require clients to recreate and troubleshoot every issue in a non-VMware environment; however, Pegasystems Inc. does reserve the right to request our customers to diagnose certain issues in a native certified Operating System environment, operating without the virtual environment. Pegasystems Inc. will only make this request when there is reason to believe that the virtual environment is a contributing factor to the issue. Any time spent on investigation of problems that may, in the sole opinion of Pegasystems Inc. be related to VMware, will be handled in the following fashion: 1. Pegasystems Inc. will provide standard support to all Pegasystems Inc. products. 2. If a problem is encountered while a Pegasystems Inc. product is running in a VMware environment, the client may be asked to recreate the problem on a non-VMware server unit to assist with diagnostics and remediation. 3. Regardless of the problem type or source, time spent on investigation and resolution will be covered as part of regular maintenance, and support will be provided as usual.

PRPC Platform Support Guide

January 10, 2014

Confidential

Supported Server Platform List for PRPC v7.1

The following Platform Options have all been tested by Pegasystems in at least one combination; however, not every combination of all of these options has been tested. Any compatible combination should work; but there may be specific setup or configuration requirements for a particular combination. In addition, not all features may be available on all platforms. Decision Strategy Manager (DSM) supports all the platforms supported by PRPC except SQL Server and JBoss 6.1, as noted. Please contact your Pegasystems representative if you have questions about any option. Server Hardware IBM System p (pSeries) IBM System x (xSeries) for Linux) Oracle Sun Server (SPARC and Intel processors) Wintel (with Intel or compatible chip) HP 9000 series HP Integrity servers (Itanium) Cisco Unified Computing System (UCS)

IBM Mainframe System z (zSeries) with zAAP processor or IFL (Integrated Facility

Load Balancers F5 BigIP versions 10.x.x, 11.x.x

b

Beginning in PRPC Version 7.1, production systems may take advantage of highavailability features. Customers using this high-availability functionality must use a load balancer that supports: session affinity pool management (enable, disable, remove servers) server monitoring for crash detection For details, please refer to the High Availability guide on the PDN.

Requires a minimum of one zSeries Application Assist Processor (zAAP). Consult the installation

guide and PDN for the latest set-up options. b Must include the Local Traffic Manager (LTM) module
January 10, 2014 Confidential

PRPC Platform Support Guide

A note on the charts: RED highlighting means desupported. GREEN means support added for this release. Operating systems

AIX v6.1 AIX v7 HP-UX 11i v3 Red Hat Enterprise Linux AS v5 Red Hat Enterprise Linux AS v6 SUSE Linux Enterprise Server 10 SUSE Linux Enterprise Server 11 Oracle Solaris 10 (SPARC and Intel edition) Oracle Solaris 11 (SPARC and Intel edition) Windows 2008 Windows 2012

Version 6.2 (Aug 9, 2011) supported supported supported supported supported supported supported

Version 6.2 SP2 (Jan 31, 2012) supported supported supported supported supported supported supported

Version 6.3 (Sept 10, 2012) supported supported supported supported supported supported supported

Version 7.1 supported supported supported supported supported supported supported

IMPORTANT NOTES

Pegasystems tests Linux on the Intel and zSeries (zLinux or Linux on System z) platforms.

Pegasystems tests Linux on the Intel and zSeries (zLinux or Linux on System z) platforms.

supported

supported

supported

supported

supported

supported

supported

supported supported supported

z/OS v1.10 z/OS v1.11 z/OS v1.12 z/OS v1.13

support added in 6.2 SP1 support added in 6.2 SP1

supported supported supported supported supported supported

For recommendations for best runtime performance and response with operating systems, please reference KB article #26356 on the PDN: Performance Guidance for Production Applications Operating Systems.
PRPC Platform Support Guide January 10, 2014 Confidential

Relational Databases

DB2 for LUW v9.1 DB2 for LUW v9.5

Version 6.2 supported supported

Version 6.2 SP2 supported supported

Version 6.3 supported

Version 7.1

IMPORTANT NOTES

DB2 for LUW v9.7 DB2 for LUW v10.1 DB2 for z/OS v9 DB2 for z/OS v10 Oracle 11g R1

supported

supported

supported

supported supported

Progressive streaming must be used to run PRPC with DB2 version 9.7. Please reference KB article #25690 on the PDN for details.

supported supported supported

supported supported supported

supported supported supported

supported supported

Requires a C compiler for external stored procedures; native stored procedures do not require the C compiler.

Oracle 11g R2 Oracle 12c

supported

supported

supported

supported supported

PRPC has been successfully deployed in Oracle RAC (Real Application Cluster) configurations, and Pegasystems supports this deployment mode. Future product plans may broaden RAC support to leverage the Oracle Clusterware High Availability API and to publish scalability benchmark data. PostgreSQL is only supported for the Tomcat webserver. PostgreSQL is NOT supported for zLinux.

PostgreSQL 9.1.x SQL Server 2008 SQL Server 2008 R2 SQL Server 2012 supported supported supported

supported supported supported

Decision Strategy Manager (DSM) will not run on SQL Server.

Please note: none of the Express or Personal versions of these databases have been tested with the Enterprise version of PRPC; no express/personal version of a database is supported with PRPC. For recommendations on how to improve the performance of your PRPC application on the database, please reference KB article #26357 on the PDN: Performance Guidance for Production Applications Database.
PRPC Platform Support Guide January 10, 2014 Confidential

Application Servers

WebSphere 6.1.x WebSphere 7.0.x WebSphere 8.0.x WebSphere 8.5 Oracle Weblogic Server 9.x Oracle Weblogic Server 11g (10.3.1 and higher) Oracle Weblogic Server 12c JBoss Redhat EAP 4.3.x JBoss Redhat EAP 5.0.x

Version 6.2 supported supported

Version 6.2 SP2 supported supported supported supported

Version 6.3 supported supported supported supported supported

Version 7.1 supported supported supported

IMPORTANT NOTES

SUPPORT ADDED 1/9/14 for version 6.2 SP2 and 6.3.

supported

supported

supported

supported

supported supported

supported supported
Weblogic 12.1.2.0 will not work with PRPC. Only 12.1.1.0 is supported.

supported

supported

supported
JBoss EAP 5.x runs on several versions of Java. For PRPC Version 7.1, JBoss on Java 6 and Java 7 only are supported. NOTE: JBoss EAP 5.1.0 is not supported. JBoss EAP 5.x runs on several versions of Java. For PRPC Version 7.1, JBoss on Java 6 and Java 7 only are supported. JBoss 6.1 runs only with PRPC deployed in a servlet container (WAR). Decision Strategy Manager (DSM) will not run on JBoss 6.1. This web server runs only with PRPC deployed in a servlet container (WAR). This web server runs only with PRPC deployed in a servlet container (WAR). This web server runs only with PRPC deployed in a servlet container (WAR).
Confidential

supported

supported

supported

supported

JBoss Redhat EAP 5.1.2

supported

supported

supported

supported supported for WAR installations only supported

JBoss Redhat EAP 6.1.x tc Server 2.8.2 Tomcat 6.x Tomcat 7.x supported supported supported supported supported supported

supported supported

PRPC Platform Support Guide

January 10, 2014

Please note: none of the Community Editions of these application servers (such as JBoss or WebSphere) have been tested with PRPC; therefore, these Community Editions are not supported with PRPC.

Important Notes:
For tuning recommendations to improve the performance of your PRPC application, please reference the following KB articles on the PDN: #26356 - Performance Guidance for Production Applications Operating Systems #26357 - Performance Guidance for Production Applications Database The websites of Platform Options vendors may contain additional information about how they work with other hardware or software options on this list. If vendors state a particular combination will not work or is not supported, that combination will not be supported by Pegasystems. Applications built on PegaRULES Process Commander may not function correctly if run on platforms which are not approved for Process Commander. Prior versions of PegaRULES Process Commander may not work with the most recent Platform Options. Pegasystems Solution Framework products may not yet be certified on 7.x versions of Process Commander. Please reference the System Requirements for Pegasystems Solution Frameworks and Product Components document for product details.

Java Versions

Java Versions - Sun/Oracle

J2SE 5.0 Java SE 6 Java SE 7

Version 6.2 supported supported supported

Version 6.2 SP2 supported supported supported

Version 6.3 supported supported supported

Version 7.1 supported supported

PRPC Platform Support Guide

January 10, 2014

Confidential

Java Versions - IBM

Java SDK 1.5 (WebSphere 6.1) Java SDK 1.6 (WebSphere 7.0) Java SDK 1.6.1 (WebSphere 8, 8.5) Java SDK 1.7 (WebSphere 8, 8.5)

Version 6.2 supported supported

Version 6.2 SP2 supported supported

Version 6.3 supported supported supported in 6.3 SP1 supported in 6.3 SP1

Version 7.1

supported supported supported

Notes on Java Virtual Machines (JVMs): PegaRULES Process Commander requires Java to be installed on the application server. Pega 7 requires the use of the Java 6 or Java 7 specification. Each of the Java vendors will routinely issue maintenance that addresses security, performance, and stability issues in the JDK. Pegasystems recommends that this maintenance be applied on a periodic basis; customers JDKs should never be more than a year behind current JDK maintenance levels. Process Commander recommends 64-bit JVMs on the platforms your application server supports. Please refer to the support matrix of your application server and the third-party products for details on which combinations support 64-bit JVMs. Pegasystems recommends that your verbose GC options be enabled, even in production (this adds negligible overhead). For WebSphere, use the latest approved JVM provided by IBM for that version and patch level of the application server (unless it is specifically stated that it does not run with PRPC). Be sure to check the JVM Known Issues section on the next page to avoid issues with certain JVM versions. For WebLogic, Pega has tested both Hotspot (Sun/Oracle) JVM and JRockit; either may be used. Neither Tomcat nor JBoss bundles a JVM in its application. For the supported versions of these products, Oracle or IBM Java 7 are recommended, at the Java vendors latest patch level (unless it is specifically stated that it does not run with PRPC). As of Version 6.1, Process Commander will no longer support Java 1.4.2. This specifically impacts users of WebSphere 6.0.2, which depends upon Java 1.4.2; WebSphere 6.0.2 is no longer supported.

PRPC Platform Support Guide

January 10, 2014

Confidential

As of Version 7.1, PRPC will no longer support Java 5. This specifically impacts users of WebSphere 6.1, which depends upon Java 5; WebSphere 6.1 is no longer supported. When DSM is used, the minimum JVM memory requirements (if using ADM and VBD) are: o Initial Java Heap Size: 1024 o Maximum Java Heap Size: 2048 DSM JVM memory requirements depend upon your applications use of ADM and VBD. Contact Pega Support for specialized sizing recommendations.

Known Issues with JVMs: Process Commander supports the 64-bit Sun Java 6 JVM at update 10 or later. Earlier versions of the Sun Java 6 JVM will not function correctly due to a Java 6 bug. Oracle reported a bug with Java 6 (Hotspot) Update 29: it does not work with Microsoft SQL database drivers: http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=7105007 This bug prevents PRPC from starting (the system just hangs). When using Java 6, be sure to use Update 28 or earlier, or Update 30 or later.

The following are issues with WebSphere and the IBM Java versions. To avoid these issues, new installs of PRPC should use the following WebSphere Fixpack versions available from IBM:

WebSphere Version
6.1 7.0 8.0

Fixpack Version or later

N/A (JAVA5) 7.0.0.23 8.0.0.2

SDK Version

SDK 1.6 SR10 FP1 SDK 1.6.1 SR1

IBM reported a bug with IBM Java 6 and 7: http://www-01.ibm.com/support/docview.wss?uid=swg1IV06580 This issue manifests as corrupted records in the PRPC database, caused by a bug in the JVM used by WebSphere; this bug was observed when the JVM is under a load heavy enough to invoke the just-in-time (JIT) compiler feature. Existing PRPC systems running earlier versions of WebSphere can avoid the risk by turning on a JIT switch for Idiom Recognition. The JVM argument is: -Xjit:disableIdiomRecognition

PRPC Platform Support Guide

January 10, 2014

Confidential

10

PRPC v7.1 Client Requirements

End-User Client Software
(includes CaseManager7 portal) Windows: 7, 8, XP Professional with SP2 (or higher), Vista Internet Explorer 8, 9, 10 Firefox 5+ Safari release 5+ (on Mac and Windows) Chrome 9+
c

Traditional non-auto-generated portals (e.g., WorkUser, WorkManager) are only supported for Internet Explorer (in quirks mode). PRPC is certified on the latest version of these supported browsers at the time a given version of PRPC is released. Reasonable efforts are made to test previous versions of the browsers, with particular attention paid to Internet Explorer 8, 9, and 10. If you have an issue with PRPC guardrail-compliant UI in a particular version of a supported browser type, please contact Pega Support, and we will make commercially-reasonable efforts to resolve the issue.

A Note about 64-Bit Client Support

Adobe Flash and ActiveX controls do not work in a 64-bit Internet Explorer browser (IE8 and IE9 64-bit). This meant that prior versions of PRPC could not use these 64-bit IE versions. Note that IE 10 works fine in 64-bit mode. Pega 7 has greatly reduced dependency on Flash and ActiveX controls, so it is possible to run using the IE 64-bit browsers; however, as some rules still depend upon ActiveX controls, an occasional issue may be seen. (Future versions of PRPC will eliminate dependency on ActiveX controls.) Customers who are concerned about this issue should avoid using the 64-bit versions of IE 8 or IE 9. For full details, please reference KB #26313 on the PDN.

Windows XP Service Pack 1 (SP1) is not supported.

January 10, 2014 Confidential

PRPC Platform Support Guide

11

Developer Client Software

Version 6.2 Windows XP Professional with SP2 (or higher) Windows 7 Windows 8 Vista Internet Explorer 7 Internet Explorer 8 Internet Explorer 9 Version 6.2 SP2 Version 6.3 Version 7.1

IMPORTANT NOTES
Windows XP Service Pack 1 (SP1) is not supported.

supported supported supported supported supported

supported supported supported supported supported supported

supported supported supported supported supported supported

supported supported supported supported supported supported

Internet Explorer 10 Microsoft Office 2003 Microsoft Office 2007 Microsoft Office 2010 Microsoft Visio 2003 Microsoft Visio 2007 Microsoft Visio 2010 Adobe Flash Player 10.x supported supported supported supported supported supported supported supported supported supported supported supported supported supported supported supported supported supported supported supported supported

supported supported supported supported no longer used no longer used no longer used supported

For IE9 and IE10, Pega 7 will no longer support the IE8 compatibility mode (EmulateIE8). Content rendered in these browsers using IE8 compatibility mode will not display correctly.

Beginning in Version 7.1, Visio will no longer be used for flow editing. For customers upgrading older versions of PRPC who have flows created in Visio, the first time those flows are edited, they will automatically be upgraded to use Process Modeler, and will save as Process Modeler flows.

In PRPC versions prior to 7.1, the Developer Desktop is limited to IE due to its dependence on ActiveX controls. In Version 7.1, IE with ActiveX is required for full development capabilities. However, ActiveX controls are not downloaded until they are needed. This means it is possible to log into other browsers (Chrome, Firefox, Safari) and perform most PRPC interactions without needing to use ActiveX, except for certain functionality.

PRPC Platform Support Guide

January 10, 2014

Confidential

12

Fully eliminating the need for ActiveX, to provide full cross-browser support in the Designer Studio, is a high priority for future versions of PRPC.

Additional Client Software

Certain features of PegaRULES require additional software or specific operating systems on the client side: Functionality Use of charts Use of Excel export or templates Use of Microsoft Word for Correspondence editing Pega Document Scanning Software Adobe Flash 10.x Microsoft Excel 2003, 2007, 2010 Microsoft Word 2003, 2007, 2010 Scanner that has TWAIN driver support (www.twain.org )

PRPC Platform Support Guide

January 10, 2014

Confidential

13