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

Installing a Desktop GUI on Pega 7 Exercise System Virtual Machine with Ubuntu

The Pega 7.1.6 Exercise System from Pega Academy runs on a virtual machine that uses the Ubuntu operating system. The virtual machine can be accessed through a command line interface that is provided by a virtual machine player such as VMWare Workstation Player or Oracle VM VirtualBox.

Summary

  1. Updating the Ubuntu APT Package Information Cache on the Pega 7 Virtual Machine
  2. Installing the Ubuntu Desktop GUI on the Pega 7 Virtual Machine

Related Posts

  • Before installing the Ubuntu Desktop GUI, it is necessary to update the APT package information cache.
  • The APT update will not break the currently installed Pega 7.1.6 Exercise System.
  • Login to the virtual machine of the Pega 7.1.6 Exercise System using root and password.
  • The Pega 7.1.6 Exercise System, (build SAE1_716_VM_20160708), uses Ubuntu 12.04.1.

Pega 7.1.6 Exercise System SAE Course - Login to Ubuntu CLI

  • Use the Advanced Packet Tool (APT) and execute the below command to download the latest package information from all servers:
sudo apt-get update

_

  • This process may take a few minutes, depending on the Internet connection speed.

  • After updating the package information cache, execute the below command to open the Ubunto Software Package Installation Utility:
sudo tasksel
  • The utility lists currently installed software packages and all available software packages for download.
  • For example, in the screen shot, the PostgreSQL database package is currently installed as it is part of the Pega 7.1.6 Exercise System.

Pega 7.1.6 Exercise System SAE Course - Ubuntu Software Package Installation Utility

  • Use the arrow keys to move up and down the list of software packages.
  • Select the package Ubuntu Desktop by pressing the Space key.

Pega 7.1.6 Exercise System SAE Course - Ubuntu Software Package Installation Utility - Select Ubuntu Desktop

  • Use the Tab key to navigate to the OK button at the bottom of the utility and hit Enter.

Pega 7.1.6 Exercise System SAE Course - Ubuntu Software Package Installation Utility - Start Ubuntu Desktop Installation

  • The package installer will show a progress bar. The whole installation process may take a while, depending on the Internet connection speed.

_

  • Once the installation is completed, the installation utility will be closed and control is returned to the command line. Reboot the Ubuntu OS to apply the changes.
sudo reboot

_

  • The virtual machine be restarted and when Ubuntu is launched, the Desktop GUI is launched by default instead of the command line interface.

_

  • Ubuntu has the Firefox browser installed and it can be used to access the local Pega 7.1.6 Exercise System.

_