Personal Virtual Serv

ver (PVS)
Quick Sta
art Gu
uide

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

PegaRULES, Process Commander, SmartBPM and the Pegasystems logo are trademarks or registered trademarks of
Pegasystems Inc. All other product names, logos and symbols may be registered trademarks of their respective owners.
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.
1 Rogers Street
Cambridge, MA 02142
Phone: (617) 374-9600
Fax: (617) 374-9620

www.pega.com

Document Name: PVS Quick Start Guide (32-bit)

Updated: September 29. 2014

Page|2

Contents
Introduction ....................................................................................................................... 1
PVS System Requirements............................................................................................... 1
Downloading the PVS ....................................................................................................... 2
Setting up the PVS............................................................................................................ 3
OnWindows.........................................................................................................3
OnOSX................................................................................................................4

Installing VMware Player .................................................................................................. 5

OnWindows.........................................................................................................5
OnOSX................................................................................................................5

Starting the PVS ............................................................................................................... 6

OnWindows.........................................................................................................6
OnOSX................................................................................................................7

Logging in to the PRPC Designer Studio .......................................................................... 8

Shutting Down the PVS .................................................................................................... 9
Getting Help ...................................................................................................................... 9

Intro
oductio
on
PegaRUL
LES Process Commander (PRPC) Pe
ersonal Virttual Server ((PVS) is a virrtual machin
ne
(VM) that lets you practice using PPRC - witthout havin
ng to install or configure
e the softwa
are.
The
T PVS is ju
ust like any other comp
puter. It hass its
own
o
operat ing system, and it runss software
applications
a
s such as PR
RPC, Postgre
eSQL (a
database
d
ap
pplication) a
and Apache Tomcat (a
simple
s
web server).
The
T PVS is r un using a vvirtual mach
hine applica
ation
and,
a
when yyou run the PVS, you arre actually
running
r
a co
omputer (th
he guest) within your
computer
c
(tthe host).

The PVS runs on you

ur compute
er - under yo
our control - making it a great environment fo
or
learning PRPC on your
y
own time and at your
y
conven
nience. Bestt of all, the P
PVS can be run
on Windows or OS X.
X

PVS System
S
m Requ
uireme
ents
The follo
owing are re
equired for completing
c
Pega Acade
emy exercisses using the PVS:

Minimum
M
4 GB
G RAM and
d 16 GB free
e disk space
e

32-bit capable CPU

Microsoft
M
Windows (XP SP2c,
S
Vista, 7, 8) or OS X

VMware
V
Play
yer 5.x (inclu
uded), VMware Worksta
ation 8.x, VM
Mware Fusion or Paralllels

Microsoft
M
Silv
verlight

Browsers:
B
Internet Explo
orer (8 11)), Chrome, S
Safari or Firefox

MS
M Office 20
003, 2007 orr 2010

Pagge|1

Dow
wnloadiing the
e PVS
1. Click
C
the Dow
wnload Exe
ercise Syste
em link in th
he Downloa
ading the Ex
xercise Syste
em
le
esson.
2. For Internet Explorer ussers, click the Token ID
D link to dow
wnload the P
PVS.

For Firefox, Safari

S
or Chrome and OS
O X users, rright-click on the Token
n ID and select
Save Link As
s to downlo
oad the PVS..

Once
O
the dow
wnload beg
gins, you can
n safely closse the PVS E
Exercise Sy
ystem
Download
D
modal
m
dialog
g.
Before
B
you begin
b
setting
g up the PVS
S, make surre you have at least 16 GB of free d
disk
sp
pace on you
ur computer.

Pagge|2

Setting up the PV
VS
On Win
ndows
1. Create
C
a fold
der on your local machiine named p
prpc-pvs.
Power
P
User Tip!
T
If you want to keep multiple
e PVS instances on your lo
ocal compute
er, name the ffolder using a
an
abbreviation
a
to
t represent the course.
For
F example, if you are cre
eating a folder for the DCO
O Essentials ccourse PVS, yyou could nam
me
the
t main folde
er DCO PVS. For any of th
he System Arcchitect Essen
ntials coursess you could na
ame
the
t main folde
er SAE1 PVS
S or SAE2 PVS.

2. Double
D
click on the PVS self-extrac
cting archiv
ve executa
able you dow
wnloaded. IIt
may
m take som
me time beffore the file is ready to be processsed.
3. Click
C
the Ellip
psis button to browse to
t the folderr you create
ed in step 1 or enter the full
path of the folder.

4. Click
C
Extractt. It may tak
ke a few min
nutes for the
e setup of the PVS to complete.
Power
P
User Tip!
T
You
Y may have
e multiple PV
VS instances on
o your comp
puter in differe
ent locations. However,
depending
d
on
n your computter configurattion, running m
multiple PVS instances sim
multaneously
may
m not be ad
dvisable, or even
e
possible.

Pagge|3

On OS X
We recommend using StuffIt Ex
xpander to setup the P
PVS on your Mac.
1. Create
C
a fold
der on your Mac named
d prpc-pvs.
Power
P
User Tip!
T
If you want to keep multiple
e PVS instances on your lo
ocal compute
er, name the ffolder using a
an
abbreviation
a
to
t represent the course.
For
F example, if you are cre
eating a folder for the DCO
O Essentials ccourse PVS, yyou could nam
me
the
t main folde
er DCO PVS. For any of th
he System Arcchitect Essen
ntials coursess you could na
ame
the
t main folde
er SAE1 PVS
S or SAE2 PVS.

2. Right-click
R
on
n the .exe fiile you dow
wnloaded, an
nd then sele
ect Open W
With > Other.
3. Select StuffIt Expanderr from your Application
ns folder, an
nd then click
k Open.
4. Select the folder you cre
eated in step 1 as the d
destination ffor the new
w expansion..

5. Click
C
Open. It may take a few minuttes for the e
expansion o
of the PVS to
o complete..
Power
P
User Tip!
T
You
Y may have
e multiple PV
VS instances on
o your comp
puter in differe
ent locations. However,
depending
d
on
n your computter configurattion, running m
multiple PVS instances sim
multaneously
may
m not be ad
dvisable, or even
e
possible.

Pagge|4

Installing VMware Player

On Windows
VMware Player is an application that lets you run virtual machines. It is included in the PVS
download.
1. Navigate to the applications subdirectory of your PVS setup directory.
2. Double click the VMware setup file, VMware-player-5.0.1-894247.exe.
3. Complete the installation accepting the defaults.
Power User Tip!
When installing VMWare Player, you may be prompted to upgrade to a newer version of
VMWare Player or VMWare Workstation. There is no need to upgrade, but you may do so at
your own discretion.

On OS X
Before you can use the PVS on OS X you must have a VM application installed.
The most common VM applications for OS X are VMware Fusion, Parallels and VirtualBox.
VMware Fusion is the Mac-equivalent of VMware Player so it will be the easiest to use to
run the PVS.
Both VMware Fusion and Parallels allow you to use OS X features such as Launchpad,
Mission Control, and any other way you are used to launching applications on your Mac.
However, these applications require a paid license. VirtualBox is an open source (free to
use) application but requires a bit more technical knowledge to setup and use.

Page|5

Starting the PVS

Most of the PVS instances available on Pega Academy will use a minimum of 2 GB of your
computers memory, so you should shut down all non-essential applications before starting
the PVS especially if your computer has the minimum 4 GB RAM.

On Windows
1. Open VMware Player from the Windows Start Menu. Click Start > Programs >
VMware > VMware Player.
2. Click Open a Virtual Machine.
3. Navigate to the server folder of your PVS directory, select prpc.vmx, and then click
Open.
4. Start the PVS by clicking Play Virtual Machine. If this is the first time you are
starting the PVS, you will be asked whether you moved or copied the VM to its
current location. Select I copied it.
Wait for the PVS to start. In less than 30 seconds, you will see the Ubuntu Server
login screen. At this point, DO NOT log into the screen below. From the time you see
this screen, it may take about 3-4 minutes before PRPC is available.
Note: If you are prompted to install or update VMWare Tools you may skip doing so.

Once you see the prpc login: prompt in the VM application window, you may
minimize the PVS and the VM application to your Taskbar or Dock.

Page|6

On OS X
1. Launch VMware Fusion.
2. Select File > Open from the Menu bar.
3. Navigate to the server folder of your PVS directory, select the prpc.vmx file, and
then click Open.
4. Click the Power On icon in the VM window. If this is the first time you are starting
the PVS, you will be asked whether you moved or copied the VM to its current
location. Select I copied it.
Parallels and VirtualBox Users
If you are using either Parallels or VirtualBox, you will need to convert the PVS virtual machine.
Consult the user guides for these applications if you need help converting the PVS. Then
follow the appropriate instructions for starting the PVS virtual machine in either of those
applications.

Wait for the PVS to start. In less than 30 seconds, you will see the Ubuntu Server
login screen. At this point, DO NOT log into the screen below. From the time you see
this screen, it may take about 3-4 minutes before PRPC is available.
Note: If you are prompted to install or update VMWare Tools you may skip doing so.

Once you see the prpc login: prompt in the VM application window, you may
minimize the PVS and the VM application to your Taskbar or Dock.
Page|7

Logg
ging in to the
e PRPC
C Desig
gner Sttudio
1. When
W
the 3-4
4 minutes has
h elapsed,, open a bro
owser of your choice on
n your
co
omputer an
nd enter http://prpc:808
80/prweb/P
PRServlet

If the URL does not

n work add a dot afte
er prpc as sh
hown in thiss link
http:///prpc.:8080
0/prweb/PRS
Servlet

If you stiill cannot acccess the De

esigner Stud
dio using the URLs above, click in tthe VM wind
dow,
and follo
ow these ste
eps:
1. At
A the prpc lo
ogin: promp
pt enter arc
chitect and then press Enter.
2. At
A the Passw
word: promp
pt, enter pas
ssword and
d then presss Enter.
3. Enter ifconfiig and presss Enter. Loo
ok for the etth0 section, then the line for inet
addr:xxx.xxx.xxx.xxx

U the IP ad
ddress listed
d for inet ad
ddr: instead
d of prpc in tthe url, for e
example
4. Use
http://192.16
68.41.128:80
080/prweb//PRServlet
Power
P
User Tip!
T
To
T leave the VM
V Ubuntu se
erver and retu
urn your mou se and keybo
oard to your ccomputer, pre
ess
Ctrl
C + Alt (Win
ndows) or Con
ntrol + Cmd (OS X) on you
ur keyboard.

You can now log into PRPC with

h the userna
ame and pa
assword app
propriate fo
or your courrse
to complete course exercises.
To explo
ore PRPC as a server ad
dministratorr, use User N
Name/Passw
word
administtrator@pega
a.com/insta
all.

Pagge|8

Shutting Down the PVS

To make the PVS start up faster the next time you want to complete Pega Academy
exercises, we recommend you suspend the PVS rather than shut it down completely. This
can be done by selecting Suspend from the Virtual Machine menu in VMware Player or
Fusion.
Though you can also shut down the PVS from the VMware menu, it is a best practice to log
into the Ubuntu Server and enter a shutdown command on the command line. Remember,
you must click in the VM terminal window to type in the VM.
Skip steps 1 and 2 if you are already logged into the VM Ubuntu server.
1. At the prpc login: prompt enter architect and then press Enter.
2. At the Password: prompt enter password and then press Enter.
3. Enter the command: sudo shutdown h now
4. When prompted for a password, enter: password.
5. If desired, close the VM application when the VM is powered off.
Power User Tip!
To leave the VM Ubuntu server and return you mouse and keyboard to your computer, press
Ctrl + Alt (Windows) or Control + Cmd (OS X) on your keyboard.

Getting Help
Technical support for PVS is available to all students who are enrolled in Pega Academy
courses that use PVS as a development environment. If you experience technical difficulties
with PVS, visit http://pdn.pega.com/forums. If you do not find an answer to your problem
after searching the Exercise System forum, post a message and we will assist you as soon
as possible.

Page|9