= How to Install Aquilon =
[[TracNav]]

[[TOC(inline)]]


There is an early version of a virtual appliance for trying out Aquilon, available at http://sourceforge.net/projects/quattor/files/appliances/. This version of the appliance is for testing only. Although it can produce profiles, it is not yet integrated with QWG templates and there is a large amount of work remaining to productionize the appliance.

This appliance provides:
   * A complete quattor server distribution, managed by Aquilon. This includes the 8.4 version of the PAN compiler.
   * A couchdb datawarehouse to describe all the profiles produced by the appliance.
   * A webserver providing access to the generated profiles and providing an interface to manage the appliance.

This virtual appliance is available in ISO format, tested with: VMware Fusion on a Mac; and qemu/kvm under Fedora 15.

To install the appliance, create a Linux Ubuntu 64-bit VM (no special requirements - I've typically used 5GB disk, 1GB memory, 1 processor) with your favourite virtualization software. Add the ISO to the CD for the virtual machine and boot the machine. On boot this will display a Turnkey appliance logo and ask you to install the software on the virtual machine. Please see the detailed [/wiki/Download/Aquilon/ApplianceWalkthrough appliance walkthrough] if you need more information.

Once the appliance has started up normally the console will show an Aquilon URL that you can use from a web browser to activate the appliance. You should see a web page similar to the screenshot below.

[[Image(welcome.png)]]

There is an intent to automate much of the activation but that work is incomplete. Therefore the only option is to use [[wiki:ManualActivation manual activation guide]]. This means you should fill in the organisation code (the distinguished name in LDAP terms) and a text representation of the organisation, but leave the Quattor URL empty. Submit that form to activate your appliance. At this point your appliance will be ready for use. You should be able to look at the appliance status, browse logs, etc. Without any hosts defined within Aquilon, the datawarehouse will not yet be of any use.

See the [[wiki:ManualActivation manual activation guide]] to continue setting up your Aquilon appliance.