userapps/opensource/ipsec-tools/src/racoon/doc/FAQ

   1 This document is derived from the KAME racoon FAQ. Some answers do not
   2 apply to ipsec-tools (they are obsolete or not up to date). They are
   3 tagged [KAME]
   4
   5 Q: With what other IKE/IPsec implementation racoon is known to be interoperable?
   6
   7 A: [KAME]
   8         See "IMPLEMENTATION" document supplied with KAME kit, or:
   9         http://www.kame.net/dev/cvsweb.cgi/kame/IMPLEMENTATION
  10         As we have tested/got test reports in the past, and our end and
  11         the other end may have changed their implemenations, we are not sure
  12         if we can interoperate with them today (we hope them to interoperate,
  13         but we are not sure).
  14         Also note that, IKE interoperability highly depends on configuration
  15         on both ends.  You must configure both ends exactly the same.
  16
  17 Q: How can I make racoon interoperate with <IKE/IPsec implementation>?
  18
  19 A:
  20         Configure both ends exactly the same.  With just a tiny little
  21         differnce, you will be in trouble.
  22
  23 Q: How to build racoon on my platform?
  24
  25 A:
  26         As usual: configure && make && make install
  27         ipsec-tools is also available as a package in the NetBSD pkgsrc
  28
  29 Q: Describe me the options to "configure".
  30
  31 A:
  32         --enable-adminport:
  33                 Lets racoon to listen to racoon admin port, which is to
  34                 be contacted by racoonctl(8).
  35         --enable-natt:
  36                 Enable NAT-Traversal. This needs kernel support, which is
  37                 available on Linux. On NetBSD, NAT-Traversal kernel support
  38                 has not been integrated yet, you can get it from here:
  39                 http://ipsec-tools.sourceforge.net/netbsd_nat-t.diff
  40                 If you live in a country where software patents are legal,
  41                 using NAT-Traversal might infringe a patent.
  42         --enable-frag:
  43                 Enable IKE fragmentation, which is a workaround for
  44                 broken routers that drop fragmented packets
  45         --enable-hybrid:
  46                 Enable hybrid authentication, and ISAKMP mode config and
  47                 Xauth as well. Note that plain Xauth (without hybrid auth)
  48                 is not implemented.
  49         --with-libradius:
  50                 Enable the use of RADIUS with hybrid authentication on the
  51                 server side. RADIUS is used for authentication, configuration
  52                 and accounting.
  53         --enable-gssapi:
  54                 Enable GSS-API, for Kerberos V support.
  55         --enable-stats:
  56                 Enable statistics logging function.
  57         --enable-samode-unspec:
  58                 Enable to use unspecified a mode of SA.
  59         --enable-ipv6:
  60                 Enable IPv6 support.
  61         --with-kernel-headers:
  62                 Supply the location of Linux kernel headers.
  63         --with-readline:
  64                 Support readline input (yes by default).
  65         --with-openssl:
  66                 Specify OpenSSL directory.
  67         --sysconfdir:
  68                 Where racoon config file goes. Default is /etc, which means
  69                 that racoon will look for /etc/racoon.conf
  70         --localstatedir:
  71                 Where is the directory where racoon stores the control socket
  72                 (when using --enable-adminport). Default is /var, which
  73                 means racoon will use /var/racoon/racoon.sock
  74         --prefix:
  75                 Where racoon gets installed.
  76
  77 Q: How can I get help?
  78
  79 A:
  80         Always identify your operating system platforms, the versions you are
  81         using (like "ipsec-tools-0.5"), and information to repeat the
  82         problem.  The more revelant information you supply, the better your
  83         chances of getting help are. Useful informations include, depending
  84         of the problem:
  85         - version identification
  86         - trace from racoon, taken by "racoon -d 0xffffffff"
  87                 (maximum debug level)
  88         - configuration file you are using
  89         - probabaly, tcpdump trace
  90         http://orange.kame.net/dev/send-pr.html has the guideline.
  91
  92         If your question is not confidential, send your questions to:
  93         <ipsec-tools-devel@lists.sourceforge.net>
  94
  95         If your question is confidential, send your questions to:
  96         <ipsec-tools-core@lists.sourceforge.net>
  97
  98 Q: Other documents to look at?
  99
 100 A:
 101         http://www.netbsd.org/Documentation/network/ipsec/
 102         http://www.kame.net/
 103         http://www.kame.net/newsletter/