welcome: please sign in

Diff for "MemberManual/ShellAccess/TroubleshootingKerberos"

Differences between revisions 10 and 11
Revision 10 as of 2008-01-01 17:15:11
Size: 3404
Editor: netblock-68-183-71-43
Comment:
Revision 11 as of 2008-04-30 15:09:13
Size: 3407
Editor: AdamChlipala
Comment: deleuze -> kerberos
Deletions are marked like this. Additions are marked like this.
Line 17: Line 17:
traceroute deleuze.hcoop.net traceroute kerberos.hcoop.net
Line 20: Line 20:
The last line should say "deleuze.hcoop.net" and have NO ASTERISKS. If this is not the case, fix your firewall or your network. The last line should say "kerberos.hcoop.net" and have NO ASTERISKS. If this is not the case, fix your firewall or your network.
Line 57: Line 57:
If you are using a firewall you might want to open it for UDP packets to and from deleuze.hcoop.net:88. Lines If you are using a firewall you might want to open it for UDP packets to and from kerberos.hcoop.net:88. Lines

This page explains how to troubleshoot Kerberos problems.

TableOfContents

Unix

Step 1: turn off your firewall

Make sure any and all firewalls are disabled.

Make sure you can send UDP packets to HCOOP by typing

traceroute kerberos.hcoop.net

The last line should say "kerberos.hcoop.net" and have NO ASTERISKS. If this is not the case, fix your firewall or your network.

Step 2: check your krb5.conf

Examine your /etc/krb5.conf (or, on MacOS, your /Library/Preferences/edu.mit.Kerberos file).

Make sure that dns_lookup_kdc or dns_lookup_realm options are NOT DISABLED. They should be on-by-default, but just in case your linux distribution packager decided to be retarded and changed that, try adding

[libdefaults]
  dns_lookup_kdc   = true
  dns_lookup_realm = true

Step 3: make sure your DNS is working

Install the dig program and type

dig -t SRV _kerberos._udp.hcoop.net

You should see kerberos1.hcoop.net in the output.

If you don't see this record, one or more of the DNS servers that you're querying is probably blocking SRV requests. Figure out which name servers you're using by reading the file /etc/resolv.conf (cat /etc/resolv.conf) on your linux host. Query these particular name servers for the record in order to see where modifications might be necessary. You can do this by adding @nameserver.example.com to the end of the command, e.g. dig -t SRV _kerberos._udp.hcoop.net @nameserver.example.com.

You will likely find that one or more name servers you are using does not return a SRV record. If the offending name server is one that you administer, there may be an easy fix. For example, DNSMASQ (no relationship to djbdns) has an option filterwin2k that causes it to drop these records for added security. Some network device vendors (used by OpenWrt and lots of other distros) unfortunately ship their product with this option enabled, so you will need to comment it out (see page https://dev.openwrt.org/ticket/557 for more info). Restart the device or name resolution process on the offending device for the changes to take effect. If the offending name servers that refuse to pass SRV records through aren't your own, you may have to contact the ISP that runs them, or switch to other names servers that are properly configured.

Step 4: post to hcoop-discuss

Make sure to include:

  1. Your entire krb5.conf
  2. The output of all the commands in steps 1 and 3.

Client side firewall Setting

If you are using a firewall you might want to open it for UDP packets to and from kerberos.hcoop.net:88. Lines for [http://www.netfilter.org/ iptables] saved rules might look like the following:

 [0:0] -A INPUT -s 69.90.123.67 -p udp -m udp --sport 88 --dport 1024:65535 -j ACCEPT

 [0:0] -A OUTPUT -d 69.90.123.67 -p udp -m udp --dport 88 --sport 1024:65535 -j ACCEPT

Put them before any rules that conflicts them (and before 'COMMIT' line in the saved rules file).

Windows

Use tracert instead of traceroute. Consult the [:MemberManual/TransferringFiles/OpenAFS/Windows:OpenAFS and Windows instructions] page of our Member Manual for further details that may prove helpful.

MemberManual/ShellAccess/TroubleshootingKerberos (last edited 2013-01-13 18:17:02 by ClintonEbadi)