Note

You are not reading the most recent version of this documentation. See the latest version available.

Oracle VirtualBox

Quality Approver supports an automated package testing on virtual machines, hosted on a local Oracle VirtualBox hypervisor.


PREREQUISITES:

  • Oracle VirtualBox version is 6.0 or newer.

  • Virtual machine is running Windows 10 version 1803 or newer.

  • The user account on the virtual machine has the administrative privileges.


CONFIGURATION INSTRUCTIONS:

To configure the virtual machine for testing with Quality Approver perform the following:

  1. Run Quality Approver either from the Start Menu shortcut or from Launcher on your work station (PC).

    img_start-menu-shortcuts img_desktop-shortcuts

  2. Click Configure new VM.

    quality-approver-home

  3. In the opened wizard select Local Oracle VirtualBox and follow the listed instructions.

    quality-approver-configure-virtbox-1


PREREQUISITES AND CONFIGURATION INSTRUCTIONS FOR VIRTUAL MACHINE:

  • (1 of 6) Check Windows OS version.

    The supported operating system of the virtual machine is Windows 10 version 1803 or newer. To check a version of your Windows, run winver command (Win + R).

    image21

    Note

    It is recommended to use a clean Windows OS with a minimum set of preinstalled software in order to minimize the negative impact on testing results.

  • (2 of 6) Check/install VirtualBox Guest Additions.

    The VirtualBox Guest Additions consist of device drivers and system applications that optimize the operating system for better performance and usability. If VirtualBox Guest Additions are installed, you could find the respective icon in the taskbar notification area.

    image26

    If additions are not installed, see Installing the VirtualBox Guest Additions online article.

  • (3 of 6) Install the testing kit.

    On the virtual machine download the Windows SDK installer (web installer ~1.3 MB) and install two required components:

    • Application Verifier For Windows (size ~5.4 MB)

    • Windows App Certification Kit (size ~47.4 MB)

    image23

  • (4 of 6) Run the automatic system configurator

    Copy the PACE Tuner for Quality Approver installer to the virtual machine and run it there to configure the system for the automatic package testing and to install the required files.

    Get PACE Tuner for Quality Approver clicking on the ‘PACE tuner’ link.

    quality-approver-configure-virtbox-1-pacetuner By default, it is located at C:\Program Files (x86)\PACE Suite\Quality Approver\Tuner installations\VirtualBox\Oracle VirtualBox – PACE Tuner for Quality Approver.msi

    Warning

    PACE Tuner changes the security features of the operating system and must not be run on your work station (PC). The uninstall mechanism of PACE Tuner does not restore the changed security settings. Run PACE Tuner only on the virtual machine, which can be restored to the previous state.

    Find the list what PACE Tuner changes below in this article.

  • (5 of 6) Shut down the virtual machine

    Shut down the operating system of the virtual machine (Start > Power > Shut down).

    image24

  • (6 of 6) Take a snapshot of the configured virtual machine

    Take a snapshot of the current state of virtual machine. Further, the virtual machine will be automatically restored to this snapshot before and after testing process. For more details, see Taking, Restoring, and Deleting Snapshots.

  1. Switch back to the Quality Approver wizard on your work station (PC) and tick the I have configured as requested checkbox. Then click Next.

    quality-approver-configure-virtbox-1-configuredasrequested

  2. Using Browse… first select the configured virtual machine from the list, then select the previously taken snapshot of the configured state. Afterward, specify a user name and password to login into the operating system of the virtual machine and click Next.

    quality-approver-configure-hyperv-3

  3. Wait a little, while Quality Approver is checking the configuration of the virtual machine. Once the check is completed, click OK and Finish to close the wizard.

    quality-approver-configure-hyperv-4

    Now the virtual machine on Oracle Virtualbox hypervisor is configured for testing with Quality Approver.



LIST OF CHANGES MADE ON VIRTUAL MACHINE BY PACE TUNER:

  • Enables Developer mode.

    Windows App Certification Kit requires enabling this system feature.

  • Enables automatic login in Windows.

    Windows App Certification Kit requires a UI session for the testing. Automatic login secures this UI session.

  • Disables User Account Control.

    Windows App Certification Kit requires the administrative privileges for running. Disabling the User Account Control (UAC) allows to run Windows App Certification Kit with the administrative privileges remotely in an unattended mode.

  • Disables non-essential services.

    Update, Search, Offline files, Security center, and Diagnostic policy services produce lots of system noise that could influence the testing results.

  • Installs PACE broker service

    PACE broker service serves communication between Quality Approver and the virtual machine.



Note

PACE Suite covers the whole range of application packaging tasks - learn more.

Try PACE Suite for free - 30 days no obligations unlimited trial with all functions unlocked.