Issue

When importing a Virtual Box driver scan into Build Console the drivers need to be added manually.


This TID details how to incorporate the Virtual Box Guest Additions installation into the File Library and create a driver add-on image to install them during the build process.


Requirements

  • Imaging Toolkit 9.x or later
  • Virtual Box Guest Additions

The Virtual Box Guest additions ISO image can be found in the Virtual Box program directory, the file is named VBoxGuestAdditions.iso. In order to access the VMware Tools files either mount or extract the ISO before continuing.

Solution

Import zip files of the contents of the Virtual Box Guest Additions ISO.

Procedure

Done Task
 
1. Import the Virtual Box hardware inventory file into Build Console
 
2. Create zip files of the Virtual Box Guest Additions files
 
3. Add the Guest Additions zip files for the Virtual Box machine
 
4. Create the drivers image
 
5. Test driver image



  1. Import the zdrivers-virtual-box.xml file into Build Console

    • Run Zdrivers on a Virtual Box virtual machine to create a hardware inventory XML file, review the documentation for more details.

    • Open Build Console then use the Add Drivers task to import the Virtual Box hardware inventory XML file. Once the machine has been imported it will appear in the File Library view.

  2. Create zip files of the Virtual Box Guest Additions files

    • To access the Virtual Box Guest Additions files either mount or extract the VBoxGuestAdditions.iso

    • Run VBoxWindowsAdditions-x86.exe /extract to extract the x86 files to a temporary folder

    • Create individual zip files for each of the following folders:

      • VBoxGuest
      • VBoxMouse
      • VBoxVideo
      • VBoxVideoW8

    • Repeat the process for VBoxWindowsAdditions-amd64.exe to extract the x64 files

  3. Add the Virtual Box drivers for the Virtual Box machine

    • Right-click the Virtual Box machine in the File Library and select Manually add driver file

    • Select the Windows operating system being deployed, set the Driver class to System, enter a description such as Virtual Box Guest and set the version to the version of the Virtual Box Guest Additions e,g, 4.3.20

    • Specify the path to the first zip package and click Next to import the package into the File Library

    • Repeat for the remaining zips relevant to that platform

  4. Create the drivers image

    • The Deployment Wizard is used to create driver images for each applicable hardware platform based on the Windows operating system being deployed.

    • Open the relevant deployment project in Build Console, then run the Deployment Wizard. Select Build process creation then select only Driver add-on images

    • From the list of available machines select the Virtual Box machine then click Next twice to create the driver image.

    • Review the images.ini file in the tftp\zimfiles folder of the integration directory

  5. Test updated files

    • Copy the drivers-virtualbox.zmg from the project images directory to the project directory on the imaging server.

    • Then edit the images.ini file on the server and add the lines from the images.ini in the drivers folder of the images directory

    • Run a test build in a Virtual Box workstation and check the results.