Project

General

Profile

Requesting Help and Reporting Bugs » History » Version 7

Noel Kuntze, 10.03.2017 23:20
settings and logs for issues.

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 7 Noel Kuntze
  When you create the log file, use the following log settings, unless we tell you otherwise.
26 7 Noel Kuntze
<pre>
27 7 Noel Kuntze
        filelog {
28 7 Noel Kuntze
                /var/log/charon_debug.log {
29 7 Noel Kuntze
                        time_format = %a, %Y-%m-%d %R
30 7 Noel Kuntze
                        default = 2
31 7 Noel Kuntze
                        mgr = 0
32 7 Noel Kuntze
                        net = 1
33 7 Noel Kuntze
                        enc = 1
34 7 Noel Kuntze
                        asn = 1
35 7 Noel Kuntze
                        job = 1
36 7 Noel Kuntze
                        knl = 1
37 7 Noel Kuntze
                        ike_name = yes
38 7 Noel Kuntze
                        append = no
39 7 Noel Kuntze
                        flush_line = yes
40 7 Noel Kuntze
                }
41 7 Noel Kuntze
        }
42 7 Noel Kuntze
43 7 Noel Kuntze
</pre>