OpenChange

h1. OpenChange Appliance

h2. Introduction

The OpenChange appliance is a virtual environment configured to provide a development environment similar to the OpenChange's development one. It contains everything to run OpenChange server out of the box and to start developing or following latest evolution of the OpenChange project. 

Existing appliances have been created using "Virtualbox 3.2.6":http://www.virtualbox.org/wiki/Downloads but was exported using the OVF format (Open Virtualization Format) with 0.9 legacy enabled to maximize the number and versions of virtualization systems able to import this appliance. This guide primarily focuses on VirtualBox, but additional setup and configuration information for other virtualization systems is welcome.

h2. Available appliances

h3. Ubuntu 10.04 Lucid LTS appliance

* x86 architecture

* 5Gb of Hard Disk drive

* 256Mb of memory

* 2 network interfaces:

** eth0: NAT

** eth1: Bridged with a default IP set to 10.254.0.100

h2. Download OpenChange Virtual Appliance

h3. Download

The appliance can be retrieved through FTP at the following address: ftp://openchange:openchange@labs.openchange.org

<pre>

$ wget ftp://openchange:openchange@labs.openchange.org/ubuntu-appliance.tgz

$ wget ftp://openchange:openchange@labs.openchange.org/ubuntu-appliance.sha512sum

</pre>

h3. Check Integrity

The OpenChange appliance comes with different level of integrity:

* one SHA512 file to check tarball integrity

* one SHA512 within the archive to check appliance data integrity

<pre>

$ sha512sum -c ubuntu-appliance.sha512sum

ubuntu-appliance.tgz: OK

$ tar xzvf ubuntu-appliance.tgz

SHA512SUM

ubuntu-appliance.mf

ubuntu-appliance.ovf

ubuntu-appliance.vmdk

$ sha512sum -c SHA512SUM

ubuntu-appliance.mf: OK

ubuntu-appliance.ovf: OK

ubuntu-appliance.vmdk: OK

</pre>

h2. Importing appliance in VirtualBox

h3. Using command line tools

From your Linux console, replace /path/to with the path where you extracted the appliance:

<pre>

$ VBoxManage import /path/to/ubuntu-appliance.ovf --dry-run

</pre>

h3. Using VirtualBox GUI

# Click _File_ in the menu bar, then select _Import Appliance_

# Click the Choose button, navigate to the directory where you extracted the appliance and select the OVF file (ubuntu-appliance.ovf) 

After VirtualBox is finished import the appliance, you can boot it. If you encounter issues when launching the virtual machine for the first time, please refer to the troubleshooting section of this guide.

h2. Troubleshooting