Amahi 8

	WARNING
	This is recommended for advanced users only, please proceed with caution.

This page is about the Alpha release of Amahi on Fedora 21.

Prerequisites

• Ensure your system meets the minimum requirements for Amahi before proceeding (NOTE: Now requires minimum of 768MB RAM or greater)

• Download the Fedora 21 DVD (the full DVD) for 64 bits
  • Fedora 21 64-bit

• The Server netinstall may work, Workstation Live DVD may work, but only full Server DVD with minimal install is supported
• 32-bits is not supported any more in Amahi

Install Fedora

• Install Fedora 21 minimal ... NOT the Desktop:
  • 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 DVD after installing and before rebooting.
• Choose the hard drive partitioning scheme
• DON'T change the hostname (it may create issues)
• Click on Begin Installation and the installer will proceed
• Create a user with a password. Make sure it's an admin user. Recommend creating a root password.
• After a minimal install one needs to login as root first (in a text console)
• Login with the user and become root for the rest of the installation

 sudo su -

Install Amahi

• Install the Amahi repo by hand with:

  rpm -Uvh http://f21.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

• 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```, so the Amahi install (also as root; replace YOUR-INSTALL-CODE with the code you set up in Amahi.org):

  hda-install YOUR-INSTALL-CODE

• If that fails, check the Express CD troubleshooting page. For help, please fpaste the log (you may have to yum -y install fpaste). The log should be in

 /root/hda-install-*.log

• If all goes well, it should tell you to reboot

Post Install Notes

• It will boot with the static IP you preconfigured in the Amahi control panel
• You can verify if the dashboard is available by accessing from any client using the IP address.
• It's strongly recommended that you turn off the previous DHCP server and let Amahi handle DHCP so that DNS falls into place
• Reboot all the clients to get them to use your Amahi server
• Your Amahi dashboard should be available at http://hda
• The first time it will initialize and will ask you to login to create a dashboard password for the admin user you created

Upgrading from Amahi 7/F19

We'll need testing on this procedure. The steps to update Amahi from F19 to F21 are:

• Install Amahi 7 with the express CD
• Do not install any apps
• Update everything in the system: yum -y update
• Reboot to pick up new kernels, etc.
• Update everything in the system again: yum -y update
• If there are any updates, do it again. If there are new kernels, reboot
• Follow with the upgrade below

Actual upgrade

Install the upgrade tool:

 sudo yum -y install fedup

Do the live update over the network:

   sudo fedup --network 21 --product=server

If you plan to test this more than once, you may want to download the ISO and do this locally, to avoid large downloads over the network each time the update is done.

Ref: FedUp Wiki

Install Media Testing

1. Server Full DVD Headless (2.1GB download)
   • Installed Amahi 8 without issues
2. Workstation Live DVD Desktop (1.5GB)
   • Not configurable for minimal install
   • Install and start OpenSSH server
     • yum -y install openssh-server
     • systemctl enable sshd.service
     • systemctl start sshd.service
   • SSH into OS to complete install steps
   • Installed Amahi 8 without issues
3. Server Netinstall CD Headless (440MB)
   • Takes longer to install since packages are downloaded from Fedora repositories
   • Installed Amahi 8 without issues

NOTE: USB install using the above methods has not been tested.

Hopeful features

• New disk wizard
• Per app database backup/restore
• Extra parameters for Samba [Global] area (Bug 1341)
• Pre defined extra parameters for Shares

How to Help

There are several ways to help:

• If you are a contributor, make sure you get a machine running with Amahi 8 and get your apps to run on it
• If you want to test the install, get a VM and an ISO file of the base OS and let's test! This is probably the best way to help without deep technical knowledge.
• If you want to help with the platform, get in the Amahi Mailing list and get some patches going. Ruby and RoR can help here.
• Testing and porting themes will also help
• Want to develop a new theme? Check the How to Create a new Theme page
• Stop by and hang out on our IRC Channel #Amahi on irc.freenode.net

Feedback

Please provide feedback on Amahi 8 ALPHA for Fedora 21 testing in Amahi Bug # 1661