Changes

From Amahi Wiki
Jump to: navigation, search
790 bytes added ,  03:50, 16 October 2015
m
→‎Run the installation: Grammer, punctuation.
* A working installation of VirtualBox
* An [[Express CD]] image (this was tested with Amahi-5.4-Express-2.6-Beta-i386.iso). This can be done using the normal Fedora i386/x86_64 DVD as well.
* A desire to do this!
The process is fractionally more complex than a standard Amahi install, because we need to tweak the VM network configuration part-way through.
You will also need to know the IP address range that your version of VirtualBox uses for its "Host only" network type. Check the network configuration of the host system on . On a Mac OS host, there's an interface called "vboxnet0". At the time of writing, the default on Mac OS is 192.168.56.1.  On linuxa Linux host, you need to create "vboxnet0" on VirtualBox. It's on file -> Settings -> Network , and then add a host only network. It will also have 192.168.56.1 as default IP address range.
= Configure the hda =
First, configure your amahi Amahi install in the usual way at the [http://www.amahi.org/user control panel]. You must use the IP address of the VirtualBox "Host only" interface as your gateway (in my case, 192.168.56.1).  You can also set the dhcp VirtualBox DHCP server to a single start/end address (i.e. 192.168.56.10). This will ensure your VM has only one possible IP and that will be the one you add to the profile. If you do not do this, then you will need to find out the IP address in order to access the dashboard. If you want to use the VirtualBox DHCP server, here's how to do it. Be aware that this affects ''all'' virtual machines on the host system, not just the virtual machine you are creating for Amahi. * In the VirtualBox Manager go to File -> Preferences -> Network -> Host-only Networks -> double-click on "VirtualBox Host-Only Ethernet Adapter" -> select the DHCP Server tab.* Check "Enable Server".** Server Address: 192.168.56.1** Server Mask: 255.255.255.0** Lower Address Bound: 192.168.56.10** Upper Address Bound: 192.168.56.10 
If you have already have Amahi on your network, you might wish to consider changing the home domain to something other than home.com.
* Select "Linux" and "Fedora" as the OS and version
* Create a virtual disk for the installation: 8GB, dynamically sized should be sufficient
 
Once you've created the VM, go to the settings window and do the following:
= Run the installation =
Start your VM and it will boot from the CD image. Work through the [[Express CD]] installer in the usual way, entering the install code that the amahi Amahi control panel gave created you earlier. You will be asked to reboot a couple of times during the process. (During the first reboot you will have to disconnect the Express CD iso image, otherwise you'll get back to the installer menu.)
Eventually, the console should show a text login prompt. At which point you should shut down the VM (, either by sending the shutdown signal from VirtualBox or log in and issue the '''shutdown''' command).
= Altering the VM network config =
Amahi will work behind VirtualBox NAT quite happily, but at the time of writing, VirtualBox port-forwarding doesn't play nicely with Amahi's network config. (Or at least it didn't for me.) NAT also won't permit two virtual machines communicating (e.g. for testing PXE-booting).
== Bridged Mode ==If you want Amahi within the VM to serve other machines on your LAN, select bridged mode instead of NAT initially and don't alter the network config. (The basic install process will ''just work''.)  However, in your [https://www.amahi.org/user Amahi control panel] you should enter a configuraion that matches your existin network and does not clash with any other machine. This is important. If you are running on a Linux host, you can go into the "Advanced" settings and set the "Adapter Type" to "Paravirtualized Network (virtio-net)". For more information as to why you might want to do this, check read [http://wiki.libvirt.org/page/Virtio here].
= Guest Additions (Windows) =
16

edits