|
|
| Line 4: |
Line 4: |
| | heading =WARNING| | | heading =WARNING| |
| | message = Amahi for Ubuntu 12.04.x<br />Maintenance ONLY!}} | | message = Amahi for Ubuntu 12.04.x<br />Maintenance ONLY!}} |
| − | <!--
| |
| − | = 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: [http://www.amahi.org/apps/openssh OpenSSH] or [http://www.amahi.org/apps/dropbear Dropbear]
| |
| − | * [http://www.amahi.org/apps/openvpn 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 [http://www.ubuntu.com/download 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 [http://www.amahi.org/user 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):
| |
| − | {{Code| wget http://u12.amahi.org/install-amahi }}
| |
| − | * Then start the install with
| |
| − | {{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, '''<nowiki>http://hda</nowiki>''' 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 =
| |
| − | * Greyhole does not automatically restart when adding new shares or drives to storage pool ([http://bugs.amahi.org/issues/940 940]).
| |
| − | * Amahi netboot package needs converted to Debian ([http://bugs.amahi.org/issues/929 929]).
| |
| − | * DHCP and DNS server cannot be stopped permanently ([http://bugs.amahi.org/issues/932 932]).
| |
| − | * Most themes do not display correctly ([http://bugs.amahi.org/issues/936 936]).
| |
| − | * Amahi scripts need to be tested ([http://bugs.amahi.org/issues/923 923]), i.e. FirstAdminUser, hda-change-gw, etc.
| |
| − | * The network restarts during installation in some systems and you may loose connection to the port-2000 installer (no web installer).
| |
| − |
| |
| − | = Corrected Issues =
| |
| − | *<s> New share creation does not assign correct ownership. Also, platform updates cause share permissions to be reset to www-data:users ([http://bugs.amahi.org/issues/927 927]).</s>
| |
| − | *<s> User creation does not work correctly. The user is created, but no Home directory and cannot log into OS. ([http://bugs.amahi.org/issues/957 957]).</s>
| |
| − | *<s> hddtemp does not start automatically ([http://bugs.amahi.org/issues/954 954]).</s>
| |
| − | *<s> The name of the first user has three extra commas after the name, e.g. "Amahi User,,, ([http://bugs.amahi.org/issues/960 960])"</s>
| |
| − | *<s> Greyhole mount_shares_locally has warns about problems mounting printer shares ([http://bugs.amahi.org/issues/924 924])</s>.
| |
| − | *<s> DHCP leases do not display in Dashboard ([http://bugs.amahi.org/issues/931 931]).</s>
| |
| − | *<s> 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...</s>
| |
| − | *<s> SSH is not installed. Need to make an SSH app so users can decide.</s>
| |
| − | * <s>Use of app dependencies in install script cause some apps to not install (i.e. SABnzbdPlus, DLNA, etc)</s>
| |
| − |
| |
| − | = Troubleshooting =
| |
| − |
| |
| − | Double check your network settings with '''<code>ifconfig</code>''' and '''<code>route -n</code>'''. 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
| |
| − | {{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
| |
| − | {{Code|sudo route add default gw 192.168.1.1}}
| |
| − | assuming 192.168.1.1 is the address of your router.<br>
| |
| − |
| |
| − | 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 [http://talk.amahi.org #amahi] and #amahi-debian), or send them to the [[mailing list]].
| |
| − |
| |
| − | = Related =
| |
| − |
| |
| − | Installing [[UbuntuOnPandaboard | Amahi on Pandaboard]]
| |
| − |
| |
| − | = Tips =
| |
| − | [http://www.ubuntugeek.com/how-to-install-classic-gnome-desktop-in-ubuntu-12-04-precise.html Install Gnome Classic]
| |
| − |
| |
| − | [http://atutorialblog.com/how-to-install-rpm-package-in-ubuntu.htm How To Install RPM Package In Ubuntu]: Convert RPM to DEB and will help where the depends are not hard coded in the RPM.
| |
| − |
| |
| − | [http://www.cyberciti.biz/tips/linux-debian-package-management-cheat-sheet.html Debian Package Cheat Sheet]
| |
| − |
| |
| − | [http://ubuntuinthewild.blogspot.com/2012/01/ubuntu-command-line-wallpaper.html Ubuntu Commands Wallpaper]
| |
| − |
| |
| − | [http://www.ubuntugeek.com/ Ubuntu Geek]: website that provides tutorials for a variety of needs.
| |
| − |
| |
| − | [http://www.garron.me/linux/turn-off-stop-ubuntu-automatic-update.html Disable Automatic Updates]
| |
| − |
| |
| − | [http://howtoubuntu.org/ How to Ubuntu]: Another website of tutorials for customization.
| |
| − | -->
| |
