How to Install Pega 7 Exercise System on Mac with Oracle VM VirtualBox

Pega Academy provides Pega 7 Exercise Systems that are used to complete the course exercises and to provide a fully functional Pega 7 environment for training purposes. The exercise systems are packaged as virtual machine archives and require a virtual machine player to run. The Oracle VM VirtualBox can be used to run the Pega 7 Exercise System on macOS.

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 macOS
  3. Run the Pega 7 Exercise System on VirtualBox
  4. Validate the Pega 7 Exercise System Installation

Related Posts

  • 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).

  • Download the Oracle VM VirtualBox for macOS. 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 macOS installer file VirtualBox-5.1.18-114002-OSX.dmg is about 80MB in size.

Oracle VM VirtualBox MacOS 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 MacOS Installer Package

  • Click on Continue on the Introduction step.

Oracle VM VirtualBox MacOS Installer - Introduction Screen

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

Oracle VM VirtualBox MacOS Installer - Installation Type Screen

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

Oracle VM VirtualBox MacOS Installer - Installation Successful Screen

  • Launch VirtualBox from the Applications folder on macOS.

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 macOS 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 macOS host system, open a Terminal window and ping the virtual machine:

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

  • 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