Ubuntu

	WARNING
	This is only for for DEVELOPMENT notes. Please see Ubuntu 12.04 LTS for Install Instructions

Ubuntu Release

Welcome to the first release of Amahi Ubuntu Edition!

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

Caveats

• This is a first wide release. Expect things to mostly work, but there could still be some turbulence.
• 32-bits, 64-bits and (some) ARM editions are supported
• No graphical installer yet. Installation involves two CLI (command-line) commands.
• Note that this is intended to be installed under Ubuntu 12.04 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.
  • Xubuntu has been tested and appears to work fine.
• There are 70+ apps live at the moment with more to follow
• Greyhole should be working
• To enable Secure Shell (ssh), please use one of these apps: OpenSSH or Dropbear
• VPN is now an app that you install if needed
• Do not mount Greyhole drives during the initial Ubuntu install. Mount them just before you install Amahi to prevent data loss.
• We DO NOT recommend you install Amahi on an existing Ubuntu install. It works best if you have a fresh install with no updates or modifications to the OS. Amahi will modify certain parts of the Ubuntu environment, i.e. Apache, Samba, etc.

How to install Amahi on Ubuntu

• 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 address 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.

Disable Automatic Updates