Network troubleshooting
Important information
Rule #1: do not turn off DHCP in your router until your HDA has full network connectivity
Your HDA should be capable of browsing all the major sites and http://www.amahi.org before doing anything else.
If you do not have connectivity, you may want to check that the settings that you programmed in amahi.org for your network and router match that of your actual network and the router in it. Amahi assumes a regular, typical home network and the settings there should be done to match what you have. The most common error is that the gateway is not set up properly. We have a page on how to Find Your Gateway IP.
Please note that only the first NIC/ethernet card (eth0) is supported out of the box. If you have two, please make sure you use eth0 for the LAN where your Amahi HDA resides. There is an unsupported way to support amahi on the eth1 device.
Identify the problem
To help you identify a network problem you might have, try using the Interactive Amahi Network Troubleshooter. If it fails along the way, it will give you instructions on how to get additional help, and how to provide us with the information we need to help you understand and fix the problem.
It the Network Troubleshooter can't help, you can try the steps below, and tell us (on IRC, or in the forums) what step you get stuck at.
Additional troubleshooting
Step 1
From your hda itself (via ssh or at the desktop in a terminal), can you:
- ping hda (it should ping the IP of your HDA; this ensures the dns server is working)
- ping router (it should ping the IP of the router; this ensures your HDA can see the router)
- ping 68.180.206.184 (this ensures you can see the rest of the world)
- ping yahoo.com (this ensures your dns server can see the world)
- Access http://hda in a browser (or use curl in a terminal)
If the above does not work, try and fix it by double checking the settings.
After the above works, you should be able to access
http://hda
from the HDA machine's desktop!
If the above works, then and only then you may turn off the DHCP server in your router. IMPORTANT: after turning off the DHCP server, you must repair (or reboot) your client's ethernet connection(s) for them to get a new DHCP lease from your Amahi HDA.
Step 2
Then move to one or more of the clients (after their network has restarted:
- ping hda (this ensures the client can see the DNS server in your HDA)
- ping router (this ensures the client can see your network gateway)
- ping yahoo.com (this ensures the client can see the world)
If you want to stop by the IRC channel for help, it would speed things up to report where you are "stuck" in that list, like step 1.3, or 2.2. You should also say:
- What client operating system are your other machines in the network using
- At what point did you turn off your router DHCP (if you did)
- At what point, relative to the above, did you restart (or release and renew the DHCP lease on the) clients
When all else fails
In some cases, it could be the client OS causing issues.
One known issue is the Vista_Networking_Issue
There are some special instructions if you have an Airport express or an Airport extreme
