Amahi 7 installation

	Released
	This page is updated as Amahi 7 on Fedora 19 is updated; changes expected

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.
• Note that this installation is for x64 (64-bit) systems only.
• also see Amahi 7 release notes

Installation Guide Video!

Please see the video tutorial for installation

Installation Guide

Please reference the Amahi Documentation

x86 / 32-bit installations

Note that the Express disc is a x64 (64-bit) installation only.

For x86/32-bit installation intructions, see the Amahi 7 full DVD page.

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: Some apps are not working yet. There are a limited number of apps publicly available in Amahi 7/Fedora 19. We want to keep our attention on the base system before we turn our attention to Apps, which can be very distracting.

Greyhole

Currently there is no Dashboard add-on to setup and configure Greyhole for Amahi 7. This must be done manually using the following guidance as root user:

• Install the package (to get the latest version, follow upgrade guidance):

  yum -y install hda-greyhole

• Set up a mysql database and user to access it:

 hda-create-db-and-user greyhole

• Load the database schema:

 mysql -u greyhole -pgreyhole  greyhole < /usr/share/greyhole/schema-mysql.sql

• Initialize the basic settings for Greyhole, configure /etc/greyhole.conf and add a line for each drive (go here for adding new hard drives) in the storage pool at the end of the file. The example below is for two drives:

  storage_pool_directory = /var/hda/files/drives/drive2/gh, min_free: 10gb
  storage_pool_directory = /var/hda/files/drives/drive3/gh, min_free: 10gb

NOTE: Ensure db_user and db_password are set to greyhole near the top of the file.

• Now configure the number of copies per share. The example below sets the shares as follows:
  • Books for max copies (which is 1 for 2 drives)
  • Pictures for 1 copy (which is the same as max)
  • Movies for no copies

  num_copies[Books] = 999
  num_copies[Pictures] = 2
  num_copies[Movies] = 1

NOTE: For a system with 2 Greyhole drives, 1 copy is the max. The first Greyhole drive holds the master copy and the second a copy. The share will contain a symbolic link to the master.

• In the Dashboard, Shares tab add the following to Extra Parameters for each share you will be configuring to use Greyhole:

  dfree command = /usr/bin/greyhole-dfree
  vfs objects = greyhole

• Finally, enable greyhole permanently and start the service:

 systemctl enable greyhole.service
 systemctl start greyhole.service

• You can monitor activity by watching /var/log/greyhole.log file:

  tail -f /var/log/greyhole.log