Amahi 7

From Amahi Wiki
Revision as of 00:21, 24 November 2012 by Cpg (talk | contribs)
Jump to: navigation, search

NOTE: it's best to start installing "on the fly" with the Fedora 17 install, by adding f17.amahi.org as a repo at the time that Fedora allows you to add new repos. We are past the phase of installing packages by hand and want to start testing as users would install!


Work on Amahi 7 has started. Expected release is December 2012.

Amahi 7 is a re-engineering of some of the platform software to support a leap in technologies to the latest and greatest. We expect that there will be a lot of changes.

How to Get Amahi 7 Running

This is based on a bare Fedora 17 minimal install.

1) First let's install the dependencies:

  yum -y install yum-plugin-fastestmirror
  yum -y install wget bind bind-utils caching-nameserver sudo dhcp samba httpd
  yum -y install monit perl-Authen-PAM fpaste mysql-server perl-DBI 
  yum -y install ruby-devel ruby-mysql ruby-libs eruby ruby-augeas
  yum -y install ruby-irb ruby-racc rubygem-rdoc eruby-libs
  yum -y install perl-Authen-PAM perl-libwww-perl
  yum -y install cadaver php php-mysql perl-URI filesystem rubygem-passenger
  yum -y install mysql-server perl-DBI ruby-devel
  yum -y install hddtemp mod_passenger patch rubygem-passenger-native wol
  yum -y install tar unzip bzip2 rsync

2) Here are two binaries, compiled on Fedora 17, for 64bits and only 64bits even though the second one is a noarch rpm. (This is a temporary work-around.)

  wget http://alpha.amahi.org/tmp/hdactl-4.2.2-1.x86_64.rpm
  wget http://alpha.amahi.org/tmp/hda-platform-6.2.2-1.x86_64.rpm
  # the next command should give you exactly TWO errors with missing dependencies:
  # hda-greyhole and a weird ruby line  (if not, let us know!!)
  rpm -Uvh hdactl-4.2.2-1.x86_64.rpm hda-platform-6.2.2-1.x86_64.rpm
  # this overrides the dependencies:
  rpm --nodeps -Uvh hdactl-4.2.2-1.x86_64.rpm hda-platform-6.2.2-1.x86_64.rpm

3) Start the installer

  systemctl start amahi-installer.service
  systemctl stop iptables.service

4) Access http://localhost:2000 (or the IP of the machine instead of localhost) and the installer should come up. You may need to reboot to see it, not sure.

5) Create a profile in Amahi.org and get an install code. Punch this in and click on install

Please report errors in the forums!

6) If it succeeded reboot and the dashboard should come up at http://hda (or http://IP-OF-THE-MACHINE). If you used the Fedora 17 desktop install, use the first user you created to login.

If you used the Fedora 17 minimal install you need to create a first regular user by hand, for example, like this

  useradd -G users -c 'John Doe' jdoe

New Technology

  • Using Ruby 1.9.x
  • Using the latest Ruby on Rails (probably 3.2.8+)
  • We will try to use the Slim template engine for the platform
  • Based on Fedora 17 (or 18), because ruby 1.9 and RoR 3.x are in by default in it.
    • We're not "abandoning" Ubuntu or "going back" to Fedora. We will attempt to support both. However, Fedora is the first one to bring Ruby 1.9 and RoR 3.x out of the box, so far.

Hopeful Features

  • New disk wizard
  • Widgets
  • Gadgets
  • More modular
  • Faster and more efficient

How to Help

There are several ways to help:

  • If you are a contributor, make sure you get a machine running with Amahi 7 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