PegaRULES Process Commander Personal Edition Installation Guide

Version 6.x

 Copyright 2011 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. 101 Main Street Cambridge, MA 02142-1590 Phone: (617) 374-9600 Fax: (617) 374-9620 www.pega.com Document: Personal Edition Installation Guide 6.x Software Version: 6.x Updated: May 05, 2011

Contents
Contents ...................................................................................... 3 Introduction.................................................................................. 4 What Gets Installed?...................................................................... 4 Prerequisites ................................................................................. 5 System Requirements .................................................................... 5 Configuration Requirements............................................................ 5 Installation ................................................................................... 6 Disable Windows User Access Control .............................................. 6 Install Personal Edition ................................................................... 7 Starting and Stopping Personal Edition ............................................ 12 Login to Process Commander ......................................................... 12
Personal Edition Developer FastStart Guide....................................................... 13

Uninstalling Personal Edition .......................................................... 14

Introduction
The Personal Edition V6.x of PegaRULES Processor Commander provides a learning environment for a single developer. This version of Process Commander is fully functional, but performance is limited by the speed and memory of your workstation. Rules and applications you develop with the Personal Edition can be moved to a full Process Commander system, version 6.x or later.

What Gets Installed?

To simplify installation, the Personal Edition automatically installs: Oracle JRE 1.6 and JDK 1.6.0.23 IBM DB2Express-C 9.7.2 Personal Edition installs DB2 as a Windows service that starts automatically when your system is started. To improve performance while using Personal Edition, stop other database services and other Windows services that are not needed. To stop the DB2 service when you are not using Personal Edition, click the DB2 icon in the taskbar system tray on your Windows desktop.

Apache Tomcat 6.0.29 To avoid conflicts with other instances of Tomcat you may have installed, Person Edition installs Tomcat using the following port numbers: HTTP: 9090 (Tomcat default: 8080) SSL: 9443 SHUTDOWN: 9005 AJP: 9009 (Tomcat default: 8443) (Tomcat default 8005) (Tomcat default: 8009)

Pegasystems PegaRULES Process Commander 6.x Personal Edition

Process Commander Personal Edition Installation Guide

Prerequisites
Confirm that your workstation meets the following prerequisites.

System Requirements
Your workstation has: an Intel-based dual-core processor with at least 4GB of free RAM running a 64-bit version of Microsoft Windows 7 or Vista 20 GB of free disk space (After installation completes, the Personal Edition requires 15 GB of disk space.) Microsoft Internet Explorer 7 or higher is installed Microsoft Visio 2003 or higher is installed.

Configuration Requirements
You must log-in to Windows with administrator privileges to run the Personal Edition installer. You must disable Microsoft Windows User Access Control. See Disable Windows User Access Control on page 6. You cannot have an existing DB2 installation on the workstation. If you already have IBM DB2 installed on your system, you cannot install Personal Edition. You must either remove your existing DB2 installation before installing Personal Edition, or install a full version of PRPC using your existing DB2 installation. (See the Process Commander Installation Guide for 6.x for details.) If you remove your existing DB2 installation to install Personal Edition, be sure to backup your existing data and delete the Windows DB Admin user created during the DB2 installation, db2admin. After installing Personal Edition, you can restore your data to the DB2 instance installed with Personal Edition.

Process Commander Personal Edition Installation Guide

Installation
Disable Windows User Access Control
Before running the Personal Edition installer, you must disable Windows User Access Control on your workstation. To disable User Access Control on Windows 7: 1. In the Control Panel, search for User Account Control

2. In the search results, click on Change User Account Control settings

Process Commander Personal Edition Installation Guide

Set the slider to Never Notify, and click OK to close the settings window. To disable User Account Control in Vista, open the user account for the user that will run the Personal Edition installer and uncheck Administrative Access.

Note: Be sure to re-enable the User Account Control Settings after you complete the Personal Edition
installation.

Install Personal Edition

Download the Personal Edition ZIP file, PRPC_6_1_SP2_PE.zip, and extract the contents to a directory on your workstation. 1. Double-click install.bat. The Personal Edition welcome screen displays:

Process Commander Personal Edition Installation Guide

2.

Click Next to display Overview and Prerequisites:

Review this information carefully to ensure that your Personal Edition installs successfully. Scroll down to view all the contents. Click Next to display the License Agreement:

Process Commander Personal Edition Installation Guide

Review and accept the software license for Personal Edition and its embedded thirdparty products before starting the installation. Click Accept to display Components to be Installed:

This page lists the components that may be installed. Deselect Create Desktop Shortcuts if you do not want Personal Edition to add 3 shortcuts, to start and stop the Personal Edition server and to open the Process Commander login, to your Windows desktop. Deselect Start PRPC if you do not want Personal Edition to automatically start Process Commander when the installation is completed. When your selections are complete, click Next to display Directories Selection:

Process Commander Personal Edition Installation Guide

Specify the location of the directory created by Personal Edition for the installation. Important: You must have at least 13GB of free disk space for this directory. When you have completed the page, click START to begin the installation process:

The install will run for approximately 25 minutes. To monitor the progress of the installation, click Show Logs to display the installation logging messages during the process. When the installation is complete, a confirmation window is displayed:

Process Commander Personal Edition Installation Guide

10

Note: On most systems the DB2 installation runs without interaction in the background. On some
systems a progress popup with a Cancel button is displayed. If this popup appears, do not cancel it. Allow the installation to continue. The popup closes when the DB2 installation is complete.

Important: After completing the installation, re-enable User Access Control on your system. See
Disable Windows User Access Control on page 6.

Process Commander Personal Edition Installation Guide

11

Starting and Stopping Personal Edition

If you chose Start PRPC, the Process Commander login screen displays when the installation is complete. If you chose Create Shortcuts, three Process Commander shortcuts are added to your desktop:

Click PRPC 61 SP2 Startup

to start the Process Commander application.

Click PRPC 61 SP2 Shutdown screen.

to open the Process Commander login

Click PRPC 61 SP2 login application.

to shutdown the Process Commander

Login to Process Commander

On the Process Commander login screen, enter a username and password to begin using Personal Edition:

To login to the Process Commander Designer Studio, login in as Administrator@pega.com with a password of install.

Process Commander Personal Edition Installation Guide

12

To login in to the ESupply application used in the Developer Fast Start tutorial, login as WorkUser@ECorp.com with a password of rules.

Personal Edition Developer FastStart Guide

The Process Commander Personal Edition Developer FastStart guide provides a brief tutorial demonstrating a few basic Process Commander features and functions. See the PDF file FastStartGuide.pdf located in your installation media. The Personal Edition (PE) guide provides hands-on instructions for modifying the PE sample application. The application allows employees of ECorp to submit purchase order requests using their Web browser and it automates the process of entering, routing, and approving purchase orders.

Process Commander Personal Edition Installation Guide

13

Uninstalling Personal Edition

Due to security reasons, PRPC Personal Edition does not provide an automated uninstall. To remove Personal Edition: 1. If you wish to save the work you have done in Personal Edition, use the Application Packaging Wizard (Application > Tools > Packaging Wizard) to export your developed PRPC application, including work objects and data. Save the export ZIP file to a safe location. 2. Back-up the database to a safe location. 3. Delete the PRPCPersonalEdition directory you specified during the PRPC PE installation. 4. Uninstall DB2: a. From the Windows Control Panel click Add or Remove Programs and select the DB2 program (for example, DB2 Enterprise Server Edition or DB2 Express-C) from the list of installed programs:

Click Remove. From the Windows Control Panel click User Accounts:

Process Commander Personal Edition Installation Guide

14

From the list of users, select db2admin and click Remove.

Process Commander Personal Edition Installation Guide

15