Amahi Wiki - User contributions [en]

File:HDA-troubleshooting-tools-screenshot.png

2013-08-02T22:27:39Z

Aljachimiak: Screenshot for HDA Troubleshooting Tools app.

Screenshot for HDA Troubleshooting Tools app.

HDA Troubleshooting Tools

2013-08-02T21:39:09Z

Aljachimiak:

{{WorkInProgress}}







[[File:HDA-troubleshooting-tools-logo.png]]
This is a small app created for the Amahi7 release on Fedora 19. It installs two packages:
net-tools and bind-utils.

This allows you ability to use commands like <code>ifconfig</code>, <code>nslookup</code>, <code>netstat</code>, and others from the command line of your HDA.



[[category:Apps]]
[[Category:Fedora]]

File:HDA-troubleshooting-tools-logo.png

2013-08-02T21:35:08Z

Aljachimiak:

HDA Troubleshooting Tools

2013-08-02T21:31:50Z

Aljachimiak: Created page with "  ..."

{{WorkInProgress}}







This is a small app created for the Amahi7 release on Fedora 19. It installs two packages:
net-tools and bind-utils.

This allows you ability to use commands like <code>ifconfig</code>, <code>nslookup</code>, <code>netstat</code>, and others from the command line of your HDA.



[[category:Apps]]
[[Category:Fedora]]

User:Aljachimiak

2013-08-02T20:49:21Z

Aljachimiak: Blanked the page

User:Aljachimiak

2013-08-02T20:49:00Z

Aljachimiak: An app made for the release of Amahi 7 that installs command-line tools for troubleshooting your HDA.

HDA - Troubleshooting Tools

Turning off DHCP in your router

2013-01-06T00:25:06Z

Aljachimiak:

==== Turning off the DHCP in your router is the last step you take after installing Amahi. ====

==== Generally this involves the following steps:====
# login to your router's admin interface in a browser
# locate the DCHP Server setting
# uncheck the box to disable the DHCP server
# save of apply your settings
 
 
==== Having trouble? Here are some links to vendor specific instructions to help you find the DHCP setting in your router. ====
* [http://www.123seminarsonly.com/Tips/003/How-to-turn-off-DHCP-on-the-Linksys-Wireless-G-WRT54G-router.html Linksys-WRTG54G]
*[http://www.voipmechanic.com/turning-off-dhcp-wireless-netgear.htm Netgear]
*[http://homecommunity.cisco.com/t5/Wireless-Hotspots/Can-Valet-be-set-as-an-access-point-only/td-p/330771 Cisco]
*[http://www.tp-link.com/us/article/?id=169 TP-Link]
*[http://www.peppercrew.nl/index.php/2013/01/how-to-disable-the-dhcp-server-on-an-apple-airport/ Apple-Airport]

Turning off DHCP in your router

2013-01-06T00:23:43Z

Aljachimiak:

== Turning off the DHCP in your router is the last step you take after installing Amahi.

== Generally this involves the following steps:
# login to your router's admin interface in a browser
# locate the DCHP Server setting
# uncheck the box to disable the DHCP server
# save of apply your settings
 
 
== Having trouble? Here are some links to vendor specific instructions to help you find the DHCP setting in your router.
* [http://www.123seminarsonly.com/Tips/003/How-to-turn-off-DHCP-on-the-Linksys-Wireless-G-WRT54G-router.html Linksys-WRTG54G]
*[http://www.voipmechanic.com/turning-off-dhcp-wireless-netgear.htm Netgear]
*[http://homecommunity.cisco.com/t5/Wireless-Hotspots/Can-Valet-be-set-as-an-access-point-only/td-p/330771 Cisco]
*[http://www.tp-link.com/us/article/?id=169 TP-Link]
*[http://www.peppercrew.nl/index.php/2013/01/how-to-disable-the-dhcp-server-on-an-apple-airport/ Apple-Airport]

Turning off DHCP in your router

2013-01-06T00:21:40Z

Aljachimiak: Created page with "Turning off the DHCP in your router is the last step you take after install Amahi. Generally this involves the following steps: # login to your router's admin interface in a ..."

Turning off the DHCP in your router is the last step you take after install Amahi.

Generally this involves the following steps:
# login to your router's admin interface in a browser
# locate the DCHP Server setting
# uncheck the box to disable the DHCP server
# save of apply your settings
 
 
Having trouble? Here are some links to vendor specific instructions to help you find the DHCP setting in your router.
* [http://www.123seminarsonly.com/Tips/003/How-to-turn-off-DHCP-on-the-Linksys-Wireless-G-WRT54G-router.html Linksys-WRTG54G]
*[http://www.voipmechanic.com/turning-off-dhcp-wireless-netgear.htm Netgear]
*[http://homecommunity.cisco.com/t5/Wireless-Hotspots/Can-Valet-be-set-as-an-access-point-only/td-p/330771 Cisco]
*[http://www.tp-link.com/us/article/?id=169 TP-Link]
*[http://www.peppercrew.nl/index.php/2013/01/how-to-disable-the-dhcp-server-on-an-apple-airport/ Apple-Airport]

Turning off DHCP

2013-01-06T00:05:28Z

Aljachimiak:

<div style="color:darkred; background: #f8e6e6; border: 1px solid #aa0000; padding: 1em; margin: 1em 3em">'''Note that a few of the benefits of your HDA, such as short names, etc. will not work if you disable DHCP on your server.'''

Here are the [http://www.amahi.org/faq#is-dhcp-server-required DHCP tradeoffs] if you would like to only use some of the functionality.</div>

'''NOTE:''' For Ubuntu, there is a [http://bugs.amahi.org/issues/932 dhcp bug]. To work around it, it must be done manually via the isc-dhcp-server.conf and isc-dhcp-server6.conf files in the /etc/init directory.

Otherwise, the DHCP server in the HDA can be stopped by doing this:

* First turn on Advanced Settings, under Setup --> Settings
* Then go to the Settings --> Servers
* Once there, find the DHCP Server and unselect both "Watchdog. DHCP Server is being monitored 24x7" and "Start at Boot time"
* Then stop it. It will be stopped forever

'''NOTE:''' If this does not permanently stop it in Fedora, you can also rename the init script (dhcpd) as a work around. On boot it cannot find it to execute, but you will see an error in the boot log.

In short, a few of the nicer features of your HDA will not be available. You can still point your machines to the DNS server in the HDA and get some of the benefits, like nice URLs for your HDA-provided services. This is not a supported configuration for things like [[Netboot]].

Want to let your HDA handle your DHCP? Here is how to [[Turning_off_DHCP_in_your_router|turn off DHCP in your router]].

IPsec VPN

2013-01-04T18:18:30Z

Aljachimiak: /* Route All IPSEC VPN traffic through IPSEC VPN */

We now have a new [http://www.amahi.org/apps/ipsec-vpn IPsec VPN] app for your HDA!

This VPN stack has many advantages, although it still requires two ports to be forwarded from your router to your HDA. These are

'''500 UDP''' and '''4500 UDP'''

UDP, not TCP.

Here is how to set up clients for various client operating systems:

* [[IPSec VPN iOS Client | iOS]] (iPad, iPhone, iPod) built-in client
* [[IPSec VPN Windows Client | Windows 7]]
* [[IPSec VPN Mac OS X Client | Mac OS X]] built-in client
* [[IPSec VPN Android Client | Android]] built-in client, (ICS, i.e. 4.x or later)

The Android (2.x/3.x) OS is known to be broken with respect to [http://www.amahi.org/apps/ipsec-vpn IPSec VPN]. See [[IPSEC/L2TP_VPN_Server|here]] for a manual implementation that should work.

= Changing the Secret and/or the Group Name =

Optionally, you can change the secret and/or group name.

For that, you have to be able to edit a system file as root.

Become root via ssh or a terminal and then edit this file:

/etc/racoon/psk.txt

This file has two field separated by at least one space. The first one is the Group name and the second is the Secret. Change them , keeping in mind that.

The changes will be picked up automatically a few seconds later. If you want to make sure, perform a:

service racoon restart

= Route All IPSEC VPN traffic through IPSEC VPN =

After you install IPSEC VPN and configure your router and iPhone correctly, you may find that twitter and facebook are still blocked by some networks.Also google-ing "what is my ip" will report back that you are still on the local network.

It turns out that the Amahi VPN is set to use a split VPN tunnel by default. If you want to use blocked services while behind somebody's internet filters, you can use these steps to encrypt your traffic and use blocked services like twitter and facebook.

Below are the steps to direct all traffic through the VPN. Please note: this will divert all of your traffic through your hda, but you will not be able to access some of your network resources.

1 - Open a terminal on your hda or ssh in.

2 - go to /etc/racoon (that is spelled correctly BTW)

{{Code| cd /etc/racoon}}
3 - open racoon.conf with your favorite editor, mine happens to be nano (this needs to be done as root)
{{Code| sudo nano racoon.conf}}
4 - down arrow to the mode_cfg
{{Code| mode_cfg {
auth_source system;
save_passwd on;
network4 10.8.1.1;
netmask4 255.255.255.0;
pool_size 10;
dns4 192.168.1.10;
wins4 192.168.1.10;
default_domain "Jamahi3.com";
auth_throttle 60;
split_network include 198.162.1.0/24 10.100.100.0/24;
split_dns "home.com";
banner "/etc/racoon/welcome.txt";
}
}}
note: I'm going to concentrate on the two lines that I changed: "split_network" and "split_dns".

5 - change split_network from "include" to "local_lan" and delete the 198.162.... range.

{{Code| mode_cfg {
~~
split_network local_lan 10.100.100.0/24;
}}
6 - I also changed split_dns to the name that I changed my home domain to...
{{Code| mode_cfg {
~~
split_dns "Jamahi3.com";
}}
7 - save your work

8 - restart the racoon server
{{Code| sudo /etc/init.d/racoon restart
}}

Or - open up your hda, click on settings>servers and restart the IPSEC server.

Googling "What is My IP" should now report your home VPN. You should then be able to use twitter and facebook through your VPN.

IPsec VPN

2012-06-09T21:16:48Z

Aljachimiak:

We now have a new [http://www.amahi.org/apps/ipsec-vpn IPsec VPN] app for your HDA!

This VPN stack has many advantages, although it still requires two ports to be forwarded from your router to your HDA. These are

'''500 UDP''' and '''4500 UDP'''

UDP, not TCP.

Here is how to set up clients for various client operating systems:

* [[IPSec VPN iOS Client | iOS]] (iPad, iPhone, iPod) built-in client
* [[IPSec VPN Windows Client | Windows 7]]
* [[IPSec VPN Mac OS X Client | Mac OS X]] built-in client
* [[IPSec VPN Android Client | Android]] built-in client, (ICS, i.e. 4.x or later)

The Android (2.x/3.x) OS is known to be broken with respect to [http://www.amahi.org/apps/ipsec-vpn IPSec VPN]. See [[IPSEC/L2TP_VPN_Server|here]] for a manual implementation that should work.

= Changing the Secret and/or the Group Name =

Optionally, you can change the secret and/or group name.

For that, you have to be able to edit a system file as root.

Become root via ssh or a terminal and then edit this file:

/etc/racoon/psk.txt

This file has two field separated by at least one space. The first one is the Group name and the second is the Secret. Change them , keeping in mind that.

The changes will be picked up automatically a few seconds later. If you want to make sure, perform a:

service racoon restart

= Route All IPSEC VPN traffic through IPSEC VPN =

After you install IPSEC VPN and configure your router and iPhone correctly, you may find that twitter and facebook are still blocked by some networks.Also google-ing "what is my ip" will report back that you are still on the local network.

It turns out that the Amahi VPN is set to use a split VPN tunnel by default. Here are the steps to direct all traffic through the VPN:

1 - Open a terminal on your hda or ssh in.

2 - go to /etc/racoon (that is spelled correctly BTW)

{{Code| cd /etc/racoon}}
3 - open racoon.conf with your favorite editor, mine happens to be nano (this needs to be done as route)
{{Code| sudo nano racoon.conf}}
4 - down arrow to the mode_cfg
{{Code| mode_cfg {
auth_source system;
save_passwd on;
network4 10.8.1.1;
netmask4 255.255.255.0;
pool_size 10;
dns4 192.168.1.10;
wins4 192.168.1.10;
default_domain "Jamahi3.com";
auth_throttle 60;
split_network include 198.162.1.0/24 10.100.100.0/24;
split_dns "home.com";
banner "/etc/racoon/welcome.txt";
}
}}
note: I'm going to concentrate on the two lines that I changed: "split_network" and "split_dns".

5 - change split_network from "include" to "local_lan" and delete the 198.162.... range.

{{Code| mode_cfg {
~~
split_network local_lan 10.100.100.0/24;
}}
6 - I also changed split_dns to the name that I changed my home domain to...
{{Code| mode_cfg {
~~
split_dns "Jamahi3.com";
}}
7 - save your work

8 - open up your hda, click on settings>servers and restart the IPSEC server.

Googling "What is My IP" should now report your home VPN. You should then be able to use twitter and facebook through your VPN.

Ubuntu

2012-05-24T01:22:48Z

Aljachimiak:

{{MessageBox|
backgroundcolor = #ffaaaa|
image =Warning.png|
heading =WARNING|
message = 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 32bit''' is supported. The 64bit 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 i486 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/.... Feel free to report results.
* 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
* Only supported on Ubuntu 12.04 32-bits
* [[Greyhole]] is not yet supported

= How to install Amahi on Ubuntu i386 =

* 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 addres 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 =

* 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...

= 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. 

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]].

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

= 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]

Drupal

2012-03-21T00:03:36Z

Aljachimiak:

----
You now can install [http://http://www.amahi.org/apps/drupal Drupal 7.12] with one click in Amahi!

If you would like to use a lower version, or are feeling adventurous, you will need to manually install Drupal as a web-app. Here are some steps to help you along.

#Use the instructions [http://wiki.amahi.org/index.php/Webapps here] to help you create the web-app from the control panel and create an associated database.
#Download your [http://drupal.org/project/drupal Drupal tarball] and install. The second page of [http://wiki.amahi.org/index.php/File:Packaging-Applications-for-OneClick-Installation.ppt this presentation] is very helpful.
#Now open your Drupal app and complete Drupal's initial setup. You may have to check the readme for specific instructions.
#You will now need to change the app's conf file to allow Drupal to have full functionality.
*Use [http://wiki.amahi.org/index.php/Hosting_a_website these instructions] to find Drupal's conf file.
*Once you have opened the file, find the portion that looks like this:

{{Code|lang=text|
Code= <Directory "/var/hda/web-apps/drupal/html">
Options Indexes FollowSymLinks +ExecCGI
AddHandler fcgid-script .fcg
AllowOverride AuthConfig
Order allow,deny
}}

You need to change the AllowOverride value to all. Here, you'll see that the default is commented out (#) and the new value is added below:
{{Code|lang=text|
Code= <Directory "/var/hda/web-apps/drupal/html">
Options Indexes FollowSymLinks +ExecCGI
AddHandler fcgid-script .fcg
#AllowOverride AuthConfig
AllowOverride all
Order allow,deny
}}

After restarting apache services, your Drupal installation should be ready for action.

[[User:Aljachimiak|Aljachimiak]] 17:03, 20 March 2012 (PDT)

Drupal

2012-03-21T00:01:44Z

Aljachimiak:

Drupal

2012-03-20T23:33:07Z

Aljachimiak: Created page with "==Drupal== ---- You now can install Drupal 7.12 with one click in Amahi!"

==Drupal==
----
You now can install Drupal 7.12 with one click in Amahi!