Project

General

Profile

Requesting Help and Reporting Bugs » History » Version 9

Noel Kuntze, 16.03.2017 18:39
Fix

1 1 Noel Kuntze
h1. Requesting help and reporting bugs
2 1 Noel Kuntze
3 1 Noel Kuntze
Before you request help or report bugs, the following items have to be given consideration to avoid
4 1 Noel Kuntze
wasting your and our time and for optimizing the time it takes to find a solution.
5 6 Noel Kuntze
[[SaneExamples|If you look for help regarding configuration, base your configuration on the usable examples first to avoid generic problems.]]
6 1 Noel Kuntze
[[FlawReporting|If you are reporting a security issue, look at this document.]]
7 2 Noel Kuntze
[[UserDocumentation#HOWTOs|If you require help with configuring special features of strongSwan, look at the how-tos for those first.]]
8 1 Noel Kuntze
9 1 Noel Kuntze
Please follow the given steps:
10 1 Noel Kuntze
11 1 Noel Kuntze
# Read the [[FAQ]]
12 1 Noel Kuntze
# Read the manuals (the man pages that come with *your* version of strongSwan)
13 1 Noel Kuntze
  and make sure your version of the man page corresponds to strongSwan and not freeswan, openswan or libreswan.
14 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.
15 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@.
16 4 Noel Kuntze
# If charon crashes, [[FAQ#strongSwan-crashes|try those things first.]]
17 5 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.
18 1 Noel Kuntze
# Search the bug tracker using the "search function":https://wiki.strongswan.org/projects/strongswan/search for keywords from the logs
19 1 Noel Kuntze
  or keywords that describe your issue. Make sure to include issues.
20 1 Noel Kuntze
# Search the "mailing list":https://www.strongswan.org/support.html using google and google search syntax (use the @site:@
21 1 Noel Kuntze
  keyword in the search request for google to specify the site that google should
22 1 Noel Kuntze
  print results for. E.g. site:strongswan.org NO_PROP_CHOSEN)
23 5 Noel Kuntze
# Now, you can ask for help. Please only write issues and emails in english. Do not write your messages in any other language.
24 7 Noel Kuntze
  When you write the issue, please append your complete ipsec.conf, strongswan.conf and a complete log file showing the problem.
25 8 Noel Kuntze
  We generally require the following from you
26 9 Noel Kuntze
* The complete log from daemon start to the point where the problem appears
27 9 Noel Kuntze
* The complete configuration
28 9 Noel Kuntze
* The complete output of `iptables-save` (on Linux. Analoges to it on other operating systems)
29 9 Noel Kuntze
* The complete output of `ip route show table all`
30 9 Noel Kuntze
* The complete output of `ip address`
31 7 Noel Kuntze
  When you create the log file, use the following log settings, unless we tell you otherwise.
32 7 Noel Kuntze
<pre>
33 7 Noel Kuntze
        filelog {
34 7 Noel Kuntze
                /var/log/charon_debug.log {
35 7 Noel Kuntze
                        time_format = %a, %Y-%m-%d %R
36 7 Noel Kuntze
                        default = 2
37 7 Noel Kuntze
                        mgr = 0
38 7 Noel Kuntze
                        net = 1
39 7 Noel Kuntze
                        enc = 1
40 7 Noel Kuntze
                        asn = 1
41 7 Noel Kuntze
                        job = 1
42 7 Noel Kuntze
                        knl = 1
43 7 Noel Kuntze
                        ike_name = yes
44 7 Noel Kuntze
                        append = no
45 7 Noel Kuntze
                        flush_line = yes
46 7 Noel Kuntze
                }
47 7 Noel Kuntze
        }
48 7 Noel Kuntze
</pre>