Ubuntu

	WARNING
	This is only for advanced users. Do NOT use with data you would not mind losing!

Beta 1 Release

Welcome to the Beta 1, 32-bit release of Amahi Ubuntu Edition!

This is our first beta release ... still expect turbulence! Let's start with the caveats and then on to how to install!

Caveats

• This is a fist beta release. Expect things to mostly work, but your machine could still explode in a million pieces, losing all the data.
• Only 32-bit is supported. The 64-bit and ARM editions are not supported yet.
• No graphical installer yet. Installation involves two CLI (command-line) commands.
• Note that this is intended to be installed under Ubuntu 12.04 i686 desktop or server. Ubuntu server takes 2.1GB of disk vs 3.7GB for desktop.
• We do not recommend or support the likes of Kubuntu/Lubuntu/Gobuntu/Edubuntu or any other Ubuntu derivative. Feel free to report results if you do attempt any of these flavors.
• Not many applications are available for Ubuntu yet. This is on purpose, so that we keep the focus tightly on platform stability before chasing ghosts in apps
• Greyhole is not yet supported. It is installed, but needs some minor tweaks before it will work.
• hda-diskmount script works, but you need to install one dependency before using it (pmount).
• hda-first-admin script is broken. It involves some ruby issues, so do not recommend using it.
• SSH (OpenSSH and Dropbear) and VPN are not integrated into the platform. They are now apps that you install if needed.

How to install Amahi on Ubuntu i386

• Download the Ubuntu 12.04 CD/DVD from the Ubuntu downloads page
• Install Ubuntu
• Start a terminal. On the Dash home, search for terminal. Click on the icon with caption terminal
• Make sure you have the proper network settings set up in your control panel, with one profile and one install code
• Get the installer by executing the following command in the terminal window (hint: use copy and paste):

bash code
​ wget http://u12.amahi.org/install-amahi ​

• Then start the install with

bash code
​ sh install-amahi ​

• The install script partially runs as root so it will ask for your install code and password
• This should take a while (about 5~10 minutes). The time depends on the speed of your PC and your internet connection.
• Once the installation is completed the system will tell you to reboot.

Note that rebooting will change the IP address of your system to the addres you've given when creating your install code.

After rebooting, http://hda should be working if entered on the local system. From a remote system this will only work if you have your DNS pointing to the amahi system as otherwise your system cannot resolve the name "hda".

Known Issues

• The name of the first user has three extra commas after the name, e.g. "Amahi User,,,"
• The network restarts during installation in some systems and you may loose connection to the port-2000 installer
• Debian is not well supported in this release (there are a couple of known issues). We are focusing on Ubuntu only for now.
• DNS server reports as "Stopped" with a red light (settings tab, servers Sub-Menu). Is it really off? Well, typing HDA, drupal, or names of other web-apps into the URL bar gets you to the correct app...
• SSH is not installed. Need to make an SSH app so users can decide.

Troubleshooting

Double check your network settings with ifconfig and route -n. These should be the settings that you use in the installation. If these are not correct you can change the ip address by issuing the command

bash code
​sudo ifconfig eth0 192.168.1.14 netmask 255.255.255.0 up​

assuming 192.168.1.14 is your IP address. The route can be changed with

bash code
​sudo route add default gw 192.168.1.1​

assuming 192.168.1.1 is the address of your router.

This is especially important if you are doing a headless install

Other

Refer to the Debian page for the latest info, how to install via other methods and development updates.

The old Ubuntu information (mostly out of date now) is in the Ubuntu old page.

Problems, questions, etc.

If you encounter any problems, have questions or whatever, please stop by on our irc channel #amahi and #amahi-debian), or send them to the mailing list.

If you encountered a problem and found a solution feel free to add your solution to this page.

Related

Installing Amahi on Pandaboard

Tips

Install Gnome Classic

How To Install RPM Package In Ubuntu: Convert RPM to DEB and will help where the depends are not hard coded in the RPM.

Debian Package Cheat Sheet

Ubuntu Commands Wallpaper

Ubuntu Geek: website that provides tutorials for a variety of needs.