Starting with the 11.10.280 release, we've included a utility that will uninstall Open VM Tools and install VirtualBox Guest Additions. To use the utility, you will need to add a CD-Rom device, mount the ISO, and then run the install utility.

Add CD-ROM Device and Mounting the ISO

We don't ship our OVA with a CD-ROM device attached by default, so you'll need to add one. To do that, you'll first need to shut down your VM and run the following commands:

VBoxManage storagectl YourGitHubEnterpriseVMName --name "IDE Controller" --add ide
VBoxManage storageattach YourGitHubEnterpriseVMName --storagectl "IDE Controller" --port 0 --device 0 --type dvddrive --medium /path/to/VBoxGuestAdditions.iso

After that finishes, you can start up your VM again.

The VBoxGuestAdditions.iso image can be found in these locations:

  • On a Windows host, you can find this file in the VirtualBox installation directory (usually under C:\Program files\Oracle\VirtualBox ).
  • On Mac OS X hosts, you can find this file in the application bundle of VirtualBox. (Right click on the VirtualBox icon in Finder and choose Show Package Contents. It is located in the Contents/MacOS folder.)
  • On a Linux host, you can find this file in the additions folder under the directory where you installed VirtualBox (normally /opt/VirtualBox/).
  • On Solaris hosts, you can find this file in the additions folder under the directory where you installed VirtualBox (normally /opt/VirtualBox).

Running the Install Utility

After you've made the above changes and booted your VM back up, the ISO should be attached to your VM. The rest of the installation is automated. All you need to do is SSH into the VM (you can find instructions on how to get SSH Access here) and then execute the following command:

ghe-install-virtualbox-tools

The utility will uninstall open-vm-tools, mount the device to /media/cdrom, and execute the installer. Once the utility completes, you'll need to reboot the VM.

Problems

If you encounter any trouble while performing the installation, please contact support and provide a detailed description of all your steps. You can also execute the utility in verbose mode with the -v flag to see what could be causing it to fail. If you do encounter problems, please create a secret gist containing the verbose output from the utility, and include the URL to that gist in your email.