Difference between revisions of "Network troubleshooting"

From Amahi Wiki
Jump to: navigation, search
 
(40 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
<div style="border: 1px solid #B66; padding: .5em 1em; color: #000; background-color: #FEE; margin: 3px 3px 1em 3px;">
 
<div style="border: 1px solid #B66; padding: .5em 1em; color: #000; background-color: #FEE; margin: 3px 3px 1em 3px;">
'''Rule #1: Do NOT turn off the DHCP server in your router until your HDA has full network connectivity'''
+
'''RULE #1: <u>DO NOT</u> turn off the DHCP server in your router until your HDA has full network connectivity'''
 
</div>
 
</div>
  
Your HDA should be capable of browsing all the major sites and http://www.amahi.org before doing anything else.
+
Your HDA should be capable of browsing all the major sites and <nowiki>http://www.amahi.org</nowiki> 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]].
 
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|eth1]] device.
+
Please note that '''only the first NIC/ethernet card''' is supported out of the box. If you have two, please make sure you disable the one not used in your network.
  
If a wireless network connection is all you have available, you may want to experiment with running [[Amahi over wlan0|Amahi_over_wlan0]]. This is not a well tested or recommended approach, though, so expect problems of some kind.
+
There is a final critical step to [[Transition to Amahi]] for your network. Your clients need to be using Amahi for DNS for it all to be working as expected.
  
= Identify the problem =
+
== Amahi 7/8/9/10/11 (Fedora 19/21/23/25/27) Prerequisite ==
  
To help you identify a network problem you might have, try using the [http://net.pommepause.com/network_troubleshooter/ Interactive Amahi Network Troubleshooter].
+
You will need to install the network tools package (or [https://www.amahi.org/apps/hda-troubleshooting-tools HDA Troubleshooting Tools] web application):
 +
yum install net-tools bind-utils
 +
 
 +
::'''NOTE:'''  <code>yum</code> (deprecated) has been replaced with <code>dnf</code> as the package manager for Fedora 23 and greater.
 +
 
 +
== Identify the problem ==
 +
 
 +
To help you identify a network problem you might have, try using the [http://www.amahi.net 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.
 
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.
  
= Additional troubleshooting =
+
== Additional Diagnosis ==
 +
 
 +
If the [http://www.amahi.net Interactive Amahi 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.
 +
 
 +
=== Step 1 ===
 +
 
 +
From your hda itself (via ssh or at the desktop in a terminal), can you:
 +
 
 +
# ping hda <small>(it should ping the IP of your HDA; this ensures the dns server is working)</small>
 +
# ping router  <small> (it should ping the IP of the router; this ensures your HDA can see the router)</small>
 +
# ping 8.8.8.8  <small>(this ensures you can see the rest of the world)</small>
 +
# ping yahoo.com  <small> (this ensures your dns server can see the world)</small>
 +
# Access <nowiki>http://hda</nowiki> 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
  
<b>It the Network Troubleshooter above can't help</b>, you can try the steps in the [[More network troubleshooting]] page.
+
            <code><nowiki>http://hda</nowiki></code>
  
= Non Default Network Set-ups =
+
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 in your router, you must [[RenewIP|renew your client's IP addresses]].
 +
 
 +
=== Step 2 ===
 +
 
 +
If you want to use the full functionality of your HDA, you '''must make sure your client has a DHCP lease from your HDA''' from here on, so let's move to one or more of the clients (after their network has restarted:
 +
 
 +
# ping hda  <small>(this ensures the client can see the DNS server in your HDA)</small>
 +
# ping router <small>(this ensures the client can see your network gateway)</small>
 +
# ping yahoo.com  <small>(this ensures the client can see the world)</small>
 +
 
 +
 
 +
If you want to stop by the [http://talk.amahi.org 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
 +
 
 +
== Non Default Network Set-ups ==
  
 
If your router does not have an IP of 192.168.1.1, the following command will make the process easy to allow your HDA to work:
 
If your router does not have an IP of 192.168.1.1, the following command will make the process easy to allow your HDA to work:
  
su -
+
su -
 +
hda-change-gw [gateway IP]
  
[enter root password]
+
Example if your default gateway (router) has an IP of 192.168.0.1:
  
hda-change-gw [gateway IP]
+
hda-change-gw 192.168.0.1
  
Example if your default gateway (router) has an IP of 192.168.0.1:
 
  
hda-change-gw 192.168.0.1
+
<b>NOTE:</b> You will need to restart your server after applying the change.
 +
 
 +
== Can't Disable Router DHCP ==
 +
It's unusual, but not unheard of, to not be able to disable DHCP on the router. Most notable is the case of using an Airport Express for DHCP service.
  
Note: You will need to restart your server after applying the change.
+
Refer to the Apple [[Airport express|Airport Express]] guidance for a work around.
  
 +
This same technique may work with other router brands.
  
= When all else fails =
+
== When all else fails ==
  
 
In some cases, it could be the client OS causing issues.
 
In some cases, it could be the client OS causing issues.
  
One known issue is the [[Vista_Networking_Issue]]
+
One known issue is the [[Vista_Networking_Issue|Windows Networking Issue]]
 +
 
  
There are some special instructions if you have an [[Airport express]] or an [[Airport express|Airport extreme]]
+
Back to the [[Troubleshooting]].

Latest revision as of 01:21, 4 October 2018

RULE #1: DO NOT turn off the DHCP server 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 is supported out of the box. If you have two, please make sure you disable the one not used in your network.

There is a final critical step to Transition to Amahi for your network. Your clients need to be using Amahi for DNS for it all to be working as expected.

Amahi 7/8/9/10/11 (Fedora 19/21/23/25/27) Prerequisite

You will need to install the network tools package (or HDA Troubleshooting Tools web application):

yum install net-tools bind-utils
NOTE: yum (deprecated) has been replaced with dnf as the package manager for Fedora 23 and greater.

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.

Additional Diagnosis

If the Interactive Amahi 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.

Step 1

From your hda itself (via ssh or at the desktop in a terminal), can you:

  1. ping hda (it should ping the IP of your HDA; this ensures the dns server is working)
  2. ping router (it should ping the IP of the router; this ensures your HDA can see the router)
  3. ping 8.8.8.8 (this ensures you can see the rest of the world)
  4. ping yahoo.com (this ensures your dns server can see the world)
  5. 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 in your router, you must renew your client's IP addresses.

Step 2

If you want to use the full functionality of your HDA, you must make sure your client has a DHCP lease from your HDA from here on, so let's move to one or more of the clients (after their network has restarted:

  1. ping hda (this ensures the client can see the DNS server in your HDA)
  2. ping router (this ensures the client can see your network gateway)
  3. 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

Non Default Network Set-ups

If your router does not have an IP of 192.168.1.1, the following command will make the process easy to allow your HDA to work:

su -
hda-change-gw [gateway IP] 

Example if your default gateway (router) has an IP of 192.168.0.1:

hda-change-gw 192.168.0.1


NOTE: You will need to restart your server after applying the change.

Can't Disable Router DHCP

It's unusual, but not unheard of, to not be able to disable DHCP on the router. Most notable is the case of using an Airport Express for DHCP service.

Refer to the Apple Airport Express guidance for a work around.

This same technique may work with other router brands.

When all else fails

In some cases, it could be the client OS causing issues.

One known issue is the Windows Networking Issue


Back to the Troubleshooting.