Table of Contents

Article

Installing the Pega Platform Personal Edition

The Personal Edition version of Pega Platform ™ provides a fully functional version of Pega Platform ™ that you can install on your workstation to learn how to build and test applications. The rules and applications that you develop with the Personal Edition can be saved and later moved to a full version of Pega Platform ™. To request the Personal Edition, see Digital Software Delivery.

The performance of this version is limited by the speed and memory of your workstation.

Installation package

The Personal Edition installation package includes these components:

  • Java Runtime Environment (JRE)
  • PostgreSQL
  • Apache Tomcat
  • Pega Platform Personal Edition

Prerequisites

Before installing the Personal Edition, confirm that your workstation meets the following prerequisites:

  • Intel-based personal computer or laptop with at least 2 GB of free RAM running a supported 64-bit version of Microsoft Windows. For information about supported versions, see the Platform Support Guide.
  • 20 GB of free disk space for the following components:
    • 5 GB for the downloaded files, which you can delete after installation
    • 5 GB to extract the .zip files, which you can delete after installation
    • 8 GB for the installed files, which may increase over time as you use the system
  • ​A supported browser version:
    • Microsoft Internet Explorer 9 or later
    • Mozilla Firefox 5 or later
    • Google Chrome 9 or later

Installing the Personal Edition

  1. Download the PRPC_PE_win64.zip file from your installation package.
  2. Extract the contents to a directory on your computer.

    This directory name cannot contain spaces.
  3. In that directory, double-click the install.bat file. The system opens a command window, and then starts the installation wizard. If the install.bat file fails to run, confirm that there are no spaces in the directory path.
  4. On the Personal Edition Installation page, click Next.
  5. Review the information on the Overview and Prerequisites page to ensure that the Personal Edition installation was successful.
  6. Click Next.
  7. On the License Agreement page, review the software license for the Personal Edition and its third-party products.
  8. Click Next. On the Components to be installed page, the required components are preselected. If you do not want to automatically start the Pega Platform after installation, clear the Launch PRPC check box.
  9. Click Next.
  10. On the Directories Selection page, browse to the directory where you want to install the Personal Edition. Otherwise, the installation creates the PRPCPersonalEdition directory on your C: drive.

    The directory that you select must have at least 5 GB of free disk space and must allow a nonadministrative user to create instances in that directory.
  11. Click Next. The Port Configuration page displays the default port assignment that the Personal Edition uses for the database and Tomcat server.
  12. Click Port Availability to verify that the default ports are available. If there are conflicts, enter a different port number and repeat this step.

    If you are installing on Windows 10, ensure that the Windows firewall includes exceptions for the ports you select.
  13. Click Next.
  14. Click Start to start the installation. The Output and Error tabs display the progress of the installation.

    If the system prompts you to allow traffic for PostgreSQL and Tomcat, click OK.

  15. When the confirmation message is displayed, click OK.
  16. Click Exit to close the installation window.
  17. Log in to the Pega Platform instance:

    • If you accepted the default Launch PRPC selection, you can log in by using the browser window that is open after you close the installation window.
    • If you did not select the default, see the Using shortcuts to start, log in to, and shut down the Personal Edition section of this article for instructions.
    • If you see a 404 error, use the desktop shortcuts to stop and restart the Personal Edition:
      1. On the desktop, click Shutdown.
      2. Click Startup.

Using shortcuts to start, log in to, and shut down the Personal Edition

You can shut down and start the Personal Edition as you work through your testing and configuration. Shutting down frees up disk space when you are not actively using the Personal Edition.

For these actions, use the following shortcuts that were added to your desktop during the installation.

  • Startup starts the Personal Edition.
  • Login opens the Personal Edition login screen.
  • Shutdown shuts down the Personal Edition.

Starting and logging in to the Personal Edition

Follow these steps to start the Personal Edition and log in.

  1. Click Startup to start the Personal Edition. The startup process is logged in a command prompt window.
  2. When the server has started and displays the following message, click the Login shortcut to display the sign-on screen.

    INFO: Server Startup in <nnnnnn> ms

    You can minimize the Tomcat server window, but it must remain open while you work in the Personal Edition.
  3. Enter an operator ID and password.
  4. Click Log In.
If you have not yet created any operators, log in to the Pega Platform instance with the operator ID Administrator@pega.com and the password install.

Shutting down the Personal Edition

Click the Shutdown shortcut to shut down the Personal Edition after you log out of the Personal Edition. This action also closes the Tomcat server window.

Uninstalling the Personal Edition

When you have finished using the Personal Edition, you can remove it from your workstation. Before you uninstall the Personal Edition, you can package and save your work in a separate file to import your work into another application.

  1. Use the Application Packaging wizard to save your work, including work objects and data. Click Designer Studio > Application > Distribution > Package to start the wizard and save the export.zip file to a safe location. For details about how to use the wizard, see Migrating Applications with the Application Packaging Wizard.
  2. Optional: Back up your database.
  3. Close the Tomcat server and logging windows.
  4. Remove the Personal Edition:
    • Delete the PRPCPersonalEdition program directory that was created during the installation.
    • Delete the three Personal Edition shortcuts on your desktop.

Published December 17, 2015 — Updated October 3, 2018


94% found this useful

Have a question? Get answers now.

Visit the Pega Support Community to ask questions, engage in discussions, and help others.