Project

General

Profile

Requesting Help and Reporting Bugs » History » Version 11

Tobias Brunner, 17.03.2017 12:25
Some editorial changes

1 11 Tobias Brunner
{{title(Requesting Help and Reporting Bugs)}}
2 1 Noel Kuntze
3 11 Tobias Brunner
h1. Requesting Help and Reporting Bugs
4 1 Noel Kuntze
5 11 Tobias Brunner
Before you request help or report bugs, please give the following items some consideration to avoid wasting your and our time and for optimizing the time it takes to find a solution.
6 1 Noel Kuntze
7 11 Tobias Brunner
If you are **new to strongSwan** please read [[IntroductionTostrongSwan|the introduction]].
8 11 Tobias Brunner
9 11 Tobias Brunner
If you look for **help regarding configuration**, base your configuration on [[UsableExamples|the usable examples]] first to avoid generic problems.
10 11 Tobias Brunner
11 11 Tobias Brunner
If you are **reporting a security issue**, refer to [[FlawReporting|the dedicated security flaw reporting instructions]].
12 11 Tobias Brunner
13 11 Tobias Brunner
If you require help with **configuring special features of strongSwan**, look at [[UserDocumentation#HOWTOs|the how-tos for those features first]].
14 11 Tobias Brunner
15 11 Tobias Brunner
For other problems please follow these steps:
16 11 Tobias Brunner
17 11 Tobias Brunner
# Read the [[FAQ|Frequently Asked Questions (FAQ)]]
18 11 Tobias Brunner
# Read the manuals (i.e. the man pages that come with *your* version of strongSwan)
19 11 Tobias Brunner
  And make sure your version of the man page corresponds to strongSwan and not FreeS/WAN, Openswan or Libreswan.
20 1 Noel Kuntze
  The software that a man page belongs to is usually printed in the center top of the man page when it's initially opened.
21 1 Noel Kuntze
# Make sure you put the files into the right directories. On distributions that stem from RHEL, strongSwan configuration files are under @/etc/strongswan@.
22 11 Tobias Brunner
# If charon crashes, [[FAQ#strongSwan-crashes|try these things first]].
23 1 Noel Kuntze
# Make sure your version is up to date. A lot of actual bugs (not user error) are fixed in newer versions of strongSwan.
24 11 Tobias Brunner
# Search the bug tracker using the "search function":https://wiki.strongswan.org/projects/strongswan/search for keywords from the logs or
25 11 Tobias Brunner
  keywords that describe your issue. Make sure to include issues.
26 11 Tobias Brunner
# Search the "mailing list archives":https://www.strongswan.org/support.html. You may also use your favorite search engine by restricting the results to lists.strongswan.org (usually the syntax is @site:lists.strongswan.org@).
27 11 Tobias Brunner
# Now, you may ask for help. Please write issues and emails to the mailing lists in English only. Do not write your messages in any other language.
28 11 Tobias Brunner
  Please attach your complete config files (ipsec.conf, strongswan.conf, swanctl.conf etc.) and a complete log file showing the problem.
29 11 Tobias Brunner
  We generally require the following from you:
30 11 Tobias Brunner
31 11 Tobias Brunner
  * The complete log from daemon start to the point where the problem occurs
32 11 Tobias Brunner
  * The complete configuration
33 11 Tobias Brunner
  * The complete firewall rules (output of @iptables-save@ on Linux, analogously on other operating systems using the corresponding command(s))
34 11 Tobias Brunner
  * The complete routing table (output of @ip route show table all@ on Linux, analogously on other operating systems)
35 11 Tobias Brunner
  * The complete overview over all IP addresses (output of @ip address@ on Linux, analogously on other operating systems)
36 11 Tobias Brunner
37 11 Tobias Brunner
  When you create the log file, use the following [[LoggerConfiguration|log settings]], unless we tell you otherwise.
38 11 Tobias Brunner
  <pre>
39 11 Tobias Brunner
    filelog {
40 11 Tobias Brunner
            /var/log/charon_debug.log {
41 11 Tobias Brunner
                    time_format = %a, %Y-%m-%d %R
42 11 Tobias Brunner
                    default = 2
43 11 Tobias Brunner
                    mgr = 0
44 11 Tobias Brunner
                    net = 1
45 11 Tobias Brunner
                    enc = 1
46 11 Tobias Brunner
                    asn = 1
47 11 Tobias Brunner
                    job = 1
48 11 Tobias Brunner
                    knl = 1
49 11 Tobias Brunner
                    ike_name = yes
50 11 Tobias Brunner
                    append = no
51 11 Tobias Brunner
                    flush_line = yes
52 11 Tobias Brunner
            }
53 11 Tobias Brunner
    }
54 1 Noel Kuntze
</pre>