Install Pega 7 on Mac OS with Oracle VirtualBox

Pega Academy provides Pega 7 Exercise Systems for completing the course exercises. The exercise systems are packaged as virtual machine disk images and require a virtual machine player to run. The Oracle VM VirtualBox is used to install Pega 7 on Mac OS to run the exercise system.

For an alternative, where no virtual machine is needed, and Pega 7 is installed on a local Tomcat server, see:

Summary

  1. Download a Pega 7 Exercise System from Pega Academy
  2. Install Oracle VM VirtualBox on Mac OS
  3. Run the Pega 7 Exercise System on VirtualBox
  4. Validate the Pega 7 Exercise System Installation

Related Posts

1  Download a Pega 7 Exercise System from Pega Academy

  • Note: A Pega Academy account and course registration are required in order to download a Pega 7 Exercise System. See the Pega Academy Course List for information on available courses and on how to register.
  • Once registered for a course, for example the Certified System Architect (CSA), login to Pega Academy and access the course. The Orientation module should contain a step called Downloading the Exercise System. Click on the link.

Pega Academy System Architect Essentials Training Course - Download Exercise System

  • Right-click on the button labeled DOWNLOAD EXERCISE SYSTEM

Pega Academy Training Course - Download Exercise System Button

  • A new dialog opens that show a download token link. Click on that token link to start the download.

Pega Academy Training Course - Download Exercise System Token Link

  • The Pega 7 Exercise System is quite large, here the file is about 4GB in size, and may take a while to complete.

Progress of Downloading Pega 7 Exercise System in Chrome

  • Once the download is completed, the file should be available in the Downloads folder. Here, the file is named SAE1_716_VM_20160708.tar.
  • Double-click on the file to uncompress the archive to the current folder using the mcOS Archive Utility.

Pega 7 Exercise System TAR File Archive Utility

  • The Download folder should now contain a sub-folder with the virtual machine files containing the Pega 7 Exercise System.

Pega 7 Exercise System Virtual Machine Files

  • In this case, there is one VMDK file (virtual machine disk) and one OVF file (Open Virtualization Format).

2  Install Oracle VM VirtualBox on Mac OS

  • Download the Oracle VM VirtualBox for Mac OS. This application is freely available as open source software under the terms of the GNU General Public License.
  • On the download page, use the OS X hosts link for the VirtualBox platform packages binaries.

Oracle VM VirtualBox Download Page

  • The Mac OS installer file VirtualBox-5.1.18-114002-OSX.dmg is about 80MB in size.

Oracle VM VirtualBox Mac OS DMG Download in Chrome

  • Once downloaded, double-click on the downloaded file to start the installation.
  • In the VirtualBox disk image window, click on the VirtulBox.pkg icon to start the installer.

Oracle VM VirtualBox Mac OS Installer Package

  • Click on Continue on the Introduction step.

Oracle VM VirtualBox Mac OS Installer - Introduction Screen

  • Click on Continue on the Installation Type step to install VirtualBox in the default location.

Oracle VM VirtualBox Mac OS Installer - Installation Type Screen

  • Click on Close on the Summary step to close the installer.

Oracle VM VirtualBox Mac OS Installer - Installation Successful Screen

3  Run the Pega 7 Exercise System on VirtualBox

  • Launch VirtualBox from the Applications folder on Mac OS.

Oracle VM VirtualBox - Welcome Screen

  • In the VirtualBox application menu, click on File > Import Appliance.
  • Use the browse icon to select the OVF file of the Pega 7 Exercise System, here that file is SAE1_716_VM_20160708.ovf, and click on Continue.

Oracle VM VirtualBox - Import Appliance - Select OVF File

  • Review the appliance settings and click on Import.

Oracle VM VirtualBox - Import Appliance - Review Appliance Settings

  • The process of importing the Pega 7 Exercise System virtual machine may take a while.

Oracle VM VirtualBox - Import Appliance - Importing Virtual Disk Image Progress Bar

  • The imported virtual machine will now show up in VirtualBox. Here it is called SAE1 on Pega 7.1.6.

Oracle VM VirtualBox - SAE1 on Pega 7.1.6 Virtual Machine Configuration Summary

  • By default, the network adapter of the virtual machine is configured to use Bridged mode.
  • This setup is the equivalent of the virtual machine being connected with an Ethernet cable to the host machine. For more information on bridged networking, see the VirtualBox manual on this topic.
  • Click on the green Start icon in the VirtualBox menu to start the VM.
  • In this case, the Pega 7 Exercise System uses Ubuntu. Based on the exercise system version, login using:
Pega 7.1.6: username = architect and password = password
Pega 7.1.9: username = root and password = install

Oracle VM VirtualBox - Pega 7 Exercise System Ubuntu Login

  • The IP address of the virtual machine is shown in the command line window. Here it is:
192.168.0.12
  • Note: If the virtual machine does not start due to a network adapter error as shown below, it may be necessary to change the adapter.

Oracle VM VirtualBox - Pega 7 Exercise System Startup Error Network Adapter

  • Click on the Settings icon in the VirtualBox menu and select Network and select the correct adapter on the host system to use for bridged networking. Here, the WiFi adapter of the Mac OS host system is named en0.

Oracle VM VirtualBox - Pega 7 Exercise System - Configure Bridged Network Adapter

  • To confirm that the Pega 7 Exercise System is reachable from the Mac OS host system, open a Terminal window and ping the virtual machine:

Oracle VM VirtualBox - Pega 7 Exercise System - Mac OS Host Ping to Pega 7 Virtual Machine

4  Validate the Pega 7 Exercise System Installation

  • The Pega 7 Exercise System landing page can be accessed using the below URL.
http://192.168.0.12:9080
  • It shows the following login credentials for different components of the exercise system:
Training course: username = LeadArchitect, password = password
Linux OS: username = root, password = password
PostgreSQL DB: username = postgres, password = postgres
Tomcat Server: username = admin, password = admin

Oracle VM VirtualBox - Pega 7 Exercise System - Landing Page

  • The Pega 7 Designer Studio can be accessed directly using the URL:
http://192.168.0.12:9080/prweb/PRServlet
  • The default Designer Studio administrator credentials can be used to login:
username = [email protected] and password = install

Oracle VM VirtualBox - Pega 7 Exercise System - Designer Studio Login Page

  • A section in the Designer Studio displays the latest news from the Pega Developer Network (PDN).
  • If that section displays the news feed correctly, it means that the virtual machine is able to connect to the Internet since the PDN news feed is retrieved through a REST service call from the Pega 7 system.

Oracle VM VirtualBox - Pega 7 Exercise System - Designer Studio PDN News Feed

Leave a Reply