Difference between revisions of "Amahi 7"

From Amahi Wiki
Jump to: navigation, search
 
(48 intermediate revisions by 2 users not shown)
Line 1: Line 1:
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!
+
{{MessageBox|
 +
backgroundcolor = #faa|
 +
image =Warning.png|
 +
heading =WARNING|
 +
message = Amahi 7 for Fedora 19<br />Maintenance Support ONLY!}}
 +
<!--Amahi 7 is an almost complete 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. Any instability should be [https://bugs.amahi.org reported quickly].
  
<hr/>
+
= New Features =
 +
* One-click "clearing" permissions for a share.  This eliminates most needs to dive into Linux to deal with file permissions
 +
* Plugins for adding setup area tabs (here is [https://github.com/amahi/platform/blob/master/doc/plugins.md how to make a new plugin])
 +
* More stable distribution by bundling most of the platform dependency
 +
* Faster and more efficient, through using performance mode in passenger
 +
* When a user is made admin, that user also becomes sudo-capable at the system level
 +
* One-click dynamic toggle in disk temperature readout between C an F
 +
* New initialization flow for first login, cleaner and more manageable
 +
* Be more permissive about capitalization in usernames, a common mistake for non-unix-natives
  
Work on Amahi 7 has started. Expected release is November 2012.
+
= Features w/ [[Advanced_Settings|Advanced Settings]] Enabled =
 +
* One-click selection of the upstream DNS servers to OpenDNS, Google DNS or custom
 +
* Easy change of the DHCP lease time
 +
* Ability for users to manage their public keys! Like a pro!
 +
* Easy changing of the gateway
  
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.
+
= New Technology =
 
+
Lots of new technology is going into Amahi 7:
= How to Get Amahi 7 Running =
+
* Using [http://www.ruby-lang.org/ Ruby] 2.0, which is substantially faster than the previous version of Ruby we used in Amahi 6
 
+
* Using a very stable yet recent [http://rubyonrails.org/ Ruby on Rails] (3.2.14)
This is based on a bare Fedora 17 '''minimal''' install.
+
* We are using the [http://slim-lang.com/ Slim] template engine for the platform, which makes it easier to manage new code
 
+
* Based on [[Fedora 19]], because ruby 2.0, passenger and RoR 3.x are in by default in it
1) First let's install the dependencies:
+
* New plugin system where simple plugins can be easily generated and developed for the Amahi setup area. See the [https://github.com/amahi/platform/blob/master/doc/plugins.md docs about plugins] for details on how to develop one of your own
 
 
  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 <nowiki>http://alpha.amahi.org/tmp/hdactl-4.2.2-1.x86_64.rpm</nowiki>
 
  wget <nowiki>http://alpha.amahi.org/tmp/hda-platform-6.2.2-1.x86_64.rpm</nowiki>
 
  # 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 <code>http://localhost:2000</code> (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 <code>http://hda</code> (or <code>http://IP-OF-THE-MACHINE</code>). If you used the Fedora 17 desktop install, use the first user you created to login.
+
'''NOTE:''' We're not "abandoning" Ubuntu or "going back" to Fedora. We will attempt to support '''both''' in alternate releases. However, Fedora is the first one to bring Ruby 2.0 and RoR 3.x out of the box, so far.
 
 
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 [http://www.ruby-lang.org/ Ruby] 1.9.x
 
* Using the latest [http://rubyonrails.org/ Ruby on Rails] (probably 3.2.8+)
 
* We will try to use the [http://slim-lang.com/ 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 =
+
= Missing Features =
* New disk wizard
+
We will work on these for the next major release:
* Widgets
+
* New disk wizard as a plugin.
* Gadgets
+
* Manual creation of web apps as a plugin.
* More modular
+
* Wake on LAN.
* Faster and more efficient
 
  
= How to Help =
+
= Release Notes =
There are several ways to help:
+
View the [[Amahi_7_release_notes|Release Notes]] for Amahi 7 versions detailing of bug fixes and enhancememts.-->
* 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
 

Latest revision as of 02:35, 8 September 2015

Warning.png WARNING
Amahi 7 for Fedora 19
Maintenance Support ONLY!