View source for Install Amahi 7 on an Orange Pi

<!-- 
This page is created automatically by a script.
This part is commented and shall not show
-->
<!--At the top of the page can be visible one of the following tags..-->
<!-- {{WorkInProgress}} -->
<!--{{NeedsUpdate}}-->
<!--{{NeedsMerge | [[Main Page]]}}-->
<!--{{NeedsExpantion}}-->
<!--{{NeedsDelete |[[Main Page]]}}-->
<!--Please remove or place comment accordingly-->

<!-- 
'''This page is being edited actively and a lot of sections are missing currently; feel free to help improving it.'''
-->

=Current state=

Amahi can be installed and running under development on an Orange Pi.
I have managed to get the core platform running and tested applications PhpSysInfo and WikkaWiki.

This page describes how to get things working.
Note that due to the immature state of the code installing it is mainly interested for people who want to get a feeling of it, help in testing and resolving issues.

=Known Issues=

Feel free to add issues here. If you add an issue an email to the amahi developers list with a more detailed description and/or a bug report in our bugzilla is also greatly appreciated.

* scrypt gem has been remove because of this issues:- <nowiki>https://github.com/pbhogan/scrypt/issues/23</nowiki>
** update there is now a amahi/scrypt that will be used, -msse & -msse2 command line parameters have been removed.

=Requirements=
* A copy of Fedora 21 can be download from the Fedora download website. <nowiki>http://mirror.karneval.cz/pub/linux/fedora/linux/releases/21/Images/armhfp/Fedora-Minimal-armhfp-21-5-sda.raw.xz</nowiki>
* An Orange PI (Orange Pi Mini, Banana Pi and Banana Pi Pro might also work, please report here if you manage to get things working.
* A 8GB SD card or bigger.
* A PC to copy the Fedora image onto the SD card and to run the console.
* A serial console for the Orange Pi (see http://www.orangepi.org/Docs/LogintotheOrangePi.html#Using_TTL_serial_port)

=Installation=
<!-- This part is untested
===Installing Fedora image on to a SD card.===

The easiest way to install the Pidora is to use the win32 disk imager program. download form here <nowiki>http://sourceforge.net/projects/win32diskimager</nowiki>

Needed:
* A computer with at least 5 GB of free disk space, running Windows 7.
* A micro SD or SDHC card, with a capacity of 4GB or more. (Good-quality class 4 cards usually work well). You may use a  MicroSD card with an adapter.
* An SD/SDHC card writer, either built in to the computer or connected to a USB port.


Run the win32 disk imager.
# Click the folder icon, locate the Pidora-2014-R2-1.img file that you download early.
# Check the 'Device' to see if the correct letter that corresponds to your SD card letter.
# Click on 'Write'.


::[[File:Win32DiskImager.jpg|caption]]

When Win32 Disk imager has finished place the SD card in the Raspberry Pi.
-->
===SD Card Installation Using the dd Command===

The image can also be installed using the Unix/Linux dd command.

Needed:
* A computer with at least 5 GB of free disk space, running some form of Unix or Linux.
* An SD or SDHC card, with a capacity of 4GB or more. (Good-quality class 4 cards usually work well faster is advised).
* An SD/SDHC card writer, either built in to the computer or connected to a USB port.
* An Internet connection.


{{MessageBox
| image     = Important.png|40px
| style     = width: 300px; 
| textstyle = color: red; font-weight: bold; font-style: italic;
| heading   = Danger of Data Loss / System Damage!<br />The selected device will be overwritten. 
| message   = '''If you select the wrong device, you may lose data. Exercise extreme caution when using dd.'''
| backgroundcolor = Orange
}}
See this section on how to download and create your SDHC card: http://fedoraproject.org/wiki/Architectures/ARM/F21/Installation#Manual

Also perform the step writing u-boot to the media. Follow the Banana Pi instructions

===Extend the root filesystem===
This assumes your card is /dev/sdd
# fdisk /dev/sdd
# delete partition 3, create a new primary partition 3 starting at the same place with maximum size; write results to disk
# e2fsck -f /dev/sdd3
# resize2fs /dev/sdd3

===Boot into the fedora image===

# Put the sd card in your orange pi.
# connect your serial cable. See http://www.orangepi.org/Docs/LogintotheOrangePi.html#Using_TTL_serial_port for details
# start a console to connect to your board. I use minicom. 115200 n-8-1. For me it is /dev/ttyUSB0
# power the board and configure your fedora install


===Install Amahi 7 core platform===
# login as root.
##enter the root password (not the one from the first user)
# yum update (this will take a while)
# yum -y install tar koji net-tools
# yum -y install make git mysql-devel sqlite-devel mysql-server gcc-c++ tar rpm-build
# yum -y install ruby ruby-devel libxml2-devel libxslt-devel which patch rubygem-bundler
# exit the root user and use a regular user.
# we suggest you create a new folder to put the amahi development code.

===Building hda-ctl===
# git clone https://github.com/amahi/hda-ctl.git
# cd hda-ctl
# git checkout fedora-21
# make rpm
# cd ..

===Building hda-platform===
# git clone https://github.com/amahi/hda-platform.git
# cd hda-platform
# git checkout fedora-21
# git clone https://github.com/amahi/platform.git
# rmdir platform;mv platform html
# cd html
# git checkout fedora-21
# edit Gemfile; comment out the line gem 'scrypt'
# edit Gemfile.lock
## remove the line containing scrypt and the two lines below (ffi-compiler and rake)
## change the line
##      libv8 (~> 3.16.14.0)
## into 
##      libv8 (~> 3.16.14.7)
## (so change 0 to 7)
## There is a second place where you need to make the same change but this time from 3.16.14.3 to 3.16.14.7
# cd ..
# make rpm
# if this fails you may need to re-edit Gemfile.lock and try 'make rpm' again
# have patience. On a fast (x633) SDHC card this took 1 hr 20 minutes. With a slower card it will take longer. If you decided to go for an install on a SATA disk or a fast USB hard disk it may be faster.

===Installing the image===
# Prepare another micro SD card (or if you don't mind a polluted system use your build card) and boot and configure it.
# copy the two rpm's over that you created before (for hda-ctl and hda-platform (see the release directories).
# install these with yum install
# intall your hda using
## hda-install your-install-code
## where your-install-code is the code you obtain from www.amahi;org 

<!--Your text above this line-->
<!--This page must bellong to one of the following categories please remove comment-->

[[Category:Fedora]]
[[Category:Platform]]
[[Category:ARM Hardware]]