test
[hcoop/zz_old/ikiwiki] / TroubleshootingKerberos.mdwn
CommitLineData
ee25310d 1[[TableOfContents(2)]]\r
2== Unix ==\r
3=== Step 1: turn off your firewall ===\r
4\r
5Make sure any and all firewalls are disabled.\r
6\r
7Make sure you can send UDP packets to HCOOP by typing\r
8\r
9{{{\r
10traceroute deleuze.hcoop.net\r
11}}}\r
12\r
13The last line should say "deleuze.hcoop.net" and have NO ASTERISKS. If this is not the case, fix your firewall or your network.\r
14\r
15=== Step 2: check your krb5.conf ===\r
16\r
17Examine your `/etc/krb5.conf` (or, on MacOS, your `/Library/Preferences/edu.mit.Kerberos` file).\r
18\r
19Make 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\r
20\r
21{{{\r
22[libdefaults]\r
23 dns_lookup_kdc = true\r
24 dns_lookup_realm = true\r
25}}}\r
26\r
27=== Step 3: make sure your DNS is working ===\r
28\r
29Install the `dig` program and type\r
30\r
31{{{\r
32dig -t SRV _kerberos._udp.hcoop.net\r
33}}}\r
34\r
35You should see `kerberos1.hcoop.net` in the output.\r
36\r
37If 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}}}.\r
38\r
39You 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. Djbdns (used by OpenWrt and lots of other distros) need to have the line {{{filterwin2k}}} commented out or removed in order for them to pass SRV records through (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.\r
40\r
41=== Step 4: post to hcoop-discuss ===\r
42\r
43Make sure to include:\r
44\r
45 1. Your entire krb5.conf\r
46 2. The output of all the commands in steps 1 and 3.\r
47\r
48\r
49=== Client side firewall Setting ===\r
50\r
51If you are using a firewall you might want to open it for UDP packets to and from deleuze.hcoop.net:88. Lines\r
52for [http://www.netfilter.org/ iptables] saved rules ''might'' look like the following: \r
53\r
54{{{\r
55 [0:0] -A INPUT -s 69.90.123.67 -p udp -m udp --sport 88 --dport 1024:65535 -j ACCEPT\r
56}}}\r
57\r
58{{{\r
59 [0:0] -A OUTPUT -d 69.90.123.67 -p udp -m udp --dport 88 --sport 1024:65535 -j ACCEPT\r
60}}}\r
61\r
62Put them before any rules that conflicts them (and before 'COMMIT' line in the saved rules file).\r
63\r
64== Windows ==\r
65\r
66Wave a dead chicken over your keyboard and pray.\r