Amahi 7 installation

	In progess
	This page is updated as Amahi 7 on Fedora 19 reaches release; changes expected

Installing Amahi 7 (Express-Disc)

• The express-disc installation method is the primary installation method for Amahi 7 with Fedora 19 and as such, upgrades from prior versions of Fedora are not advised, since very much has changed since older versions of Fedora.
• This installation method works with both physical and virtual machine systems.
• Separate wiki articles are in the works for transitioning old storage/ shares to new installations.

Installation Guide Video!

Please see the video tutorial for installation

Installation Guide

• It’s very important to understand that in the Express Disc installation, the first available drive WILL BE COMPLETELY ERASED unless you change the default storage settings!

1. Download Amahi Express

• The process of installing Amahi via the Express disc should take you 5 minutes in fast hardware to 15 or 10 minutes in older hardware and it’s documented below in a fair amount of detail.
• Download the Amahi 7 Express Disc and burn it to a DVD. NOTE 1 – THIS LOCATION MAY CHANGE WHEN WE RELEASE
• Boot your system from that DVD [1]

2. Customize Your Settings and Install

• Set up the language, keyboard layout, the date and time settings
• Select your storage settings to match the destination where you want Amahi to be installed
  [2]
  [3]
• It’s very important to understand that in the Express Disc installation, the first available drive will be completely erased unless you change the default storage settings! [4] [5]
• When your settings are ready, click Begin Installation
• Create a user and make it administrator (a root password is optional) [6] [7]
• The installation may be quick or take some time, depending on the speed of your hardware
• Towards the end, enter your Amahi install code for this system. You should obtain your install code from [Amahi Control Panel]
  [8] [9]
• The networking settings you previously set for this system in the Amahi Control Panel should match what you have in your network, or the installation may not work in your network.
• You will be asked to reboot. The Operating System will then boot from the hard drive, to a text console.
• Amahi will fully configure in the background and reboot by itself one last time. This time it will boot with the static IP address you set up in the Amahi control panel.

3. Initialize Amahi and start using it

• It is recommended for best operation that you turn off all other DHCP servers in your network. Then reboot all the systems in your network so that they get their network settings from your new Amahi server.

• Open an Internet browser from a client machine and type http://hda/ in the URL box

• This will bring you to an initialization web page for your system
  [10] [11]
• If http://hda/ does not work , you could try the IP address of your system to get to the initialization page. This may be an indication troubleshooting may be needed. Make sure the settings in the control panel are what the network expects. Otherwise go through the Networking Troubleshooter (top right).
• This page will ask you to re-enter the username, password and password confirmation, to initialize the system. Make sure you use the same capitalization here that you used for your username and password earlier
• This page will take you to your server’s Dashboard! Start setting up your users, shares, install some apps from Amahi’s [app store] and enjoy! [12] [13] [14] [15]

Installing Amahi 7 for Testing

NOTE: for installing Amahi 7 for development, visit the Fedora 19 page

• Install Fedora 19 minimal, 32 or 64 bits (desktop should be OK, LiveCD may not work as it includes different stuff)
  • one way to do this is: http://download.fedoraproject.org/pub/fedora/linux/releases/19/Fedora/x86_64/iso/Fedora-19-x86_64-netinst.iso
  • boot, choose Install Fedora, choose language; then in software selection choose "minimal install";
  • this is not the default and is at the bottom of the list. Don't forget to remove the cd after installing and before rebooting.
• After a minimal install one needs to create a regular user

   useradd -c 'Amahi User' -g users -G wheel yourusername

• and the password

   passwd yourusername

• Install Amahi repo by hand with:

  rpm -Uvh http://f19.amahi.org/noarch/hda-release-6.9.0-1.noarch.rpm

• Get the mariadb base packages (this is to avoid dependency conflicts)

  yum -y install mariadb-libs mariadb-server

• If mariadb gives conflicts with mysql, uninstall all mysql stuff:

  yum -y erase 'mysql*'

• Try installing both hda-ctl and hda-platform. This should install a lot of dependencies with them

   yum -y install hda-ctl hda-platform

• If that works, and only if that works, try this as root:

  hda-install YOUR-INSTALL-CODE

• When that fails (and it will), please fpaste the log (you may have to yum -y install fpaste). The log should be in

 /root/hda-install-*.log

Installing the Desktop

After this is installed, there is no desktop. You can see what groups of packages you can install with

    yum group list

One of the popular ones is GNOME Desktop environment. To install that you do:

     yum group install 'GNOME Desktop'

Needless to say, there are a few other environments you can choose to install besides GNOME.

Apps

IMPORTANT: Apps are not working yet. No apps are publicly available in Amahi 7/Fedora 19 yet. We want to keep our attention on the base system before we turn our attention to Apps, which can be very distracting.

Greyhole

You can install the Greyhole stack with:

  yum -y install hda-greyhole

However, you have to configure it by hand:

• set up a mysql database and user to access it
• load the schema
• initialize the basic settings for Greyhole