|
|
(19 intermediate revisions by the same user not shown) |
Line 3: |
Line 3: |
| image =Warning.png| | | image =Warning.png| |
| heading =WARNING| | | heading =WARNING| |
− | message = This is only for for '''DEVELOPMENT''' notes. | + | message = Amahi for Ubuntu 12.04.x<br />Maintenance ONLY!}} |
− | Please see [http://docs.amahi.org/ubuntu-12.html 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: [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 =
| |
− | * 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/show/927 927]).
| |
− | * Greyhole does not automatically restart when adding new shares or drives to storage pool ([http://bugs.amahi.org/issues/show/940 940]).
| |
− | * Greyhole mount_shares_locally has warns about problems mounting printer shares ([http://bugs.amahi.org/issues/show/924 924]).
| |
− | * Amahi netboot package needs converted to Debian ([http://bugs.amahi.org/issues/show/929 929]).
| |
− | * DHCP and DNS server cannot be stopped permanently ([http://bugs.amahi.org/issues/show/932 932]).
| |
− | * Most themes do not display correctly ([http://bugs.amahi.org/issues/show/936 936]).
| |
− | * Amahi scripts need to be tested ([http://bugs.amahi.org/issues/show/923 923]), i.e. FirstAdminUser, hda-change-gw, etc.
| |
− | * 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 (no web installer).
| |
− | * hddtemp does not start automatically ([http://bugs.amahi.org/issues/show/954 954]).
| |
− | * user creation does not work correctly. The user is created, but no Home directory and cannot log into OS. ([http://bugs.amahi.org/issues/show/957 957]).
| |
− | | |
− | = Corrected Issues =
| |
− | *<s> DHCP leases do not display in Dashboard ([http://bugs.amahi.org/issues/show/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]
| |