mirror of
https://github.com/OpenVPN/openvpn.git
synced 2024-09-20 12:02:28 +02:00
186f9a76fd
Run from "make check" if "t_client.rc" is found in workdir or srcdir
(copy t_client.rc-sample, fill in specifics for your test server)
How does it work?
- you run "sudo make check" (needs root access to configure tun if!)
- t_client.sh reads t_client.rc from current dir or ${srcdir}
- t_client.rc defines a number of "test suffixes" to run (could be
"1" "2" "3" or "p2m", "p2p", "special" or whatever you like), and
for each suffix, there's config variables to specify
- how to call OpenVPN
- which hosts to ping for IPv4 and IPv6 when OpenVPN is up
(and actually before starting OpenVPN - to make the test more
meaningful, I have decided that the test hosts must not ping
before the tests starts)
- which addresses must show up in the output of "ifconfig" after
OpenVPN has started
- all variables except OPENVPN_CONF_<x> are optional
(this should all be fairly obvious from looking at t_client.rc-sample)
- the script wants to connect to a well-defined OpenVPN server that
will assign well-known IPv4 (and IPv6) addresses, have well-defined
pingable addresse, etc. - so you need to setup the test server before
the script is useful for you. (Whether you use certificates or
username/password is up to you, you could even mix and match - run
one test with certs, and one with user/pass against different target
ports... :-) )
[we *could* run a "reference server" somewhere and ship a sample
t_client.rc + cert so that users could use this right away, but I
do not currently have the resources to run such a public server]
- whatever the script does is logged to a newly created directory
below the current directory (openvpn output, ifconfig+route before
starting OpenVPN, while running it, after ending it)
- important: at least on NetBSD and OpenBSD, the script will print
one failure, because the tun0 interface created is not destroyed
after openvpn ends. For OpenBSD, I have changed close_tun() to
do so ("ifconfig tun0 destroy"), for NetBSD I have not yet changed
anything - but I strongly believe that the output of "ifconfig+route"
should be reverted to exactly how it looked like before OpenVPN
was started, so I consider this a bug in the NetBSD-specific bits
of OpenVPN (and will look into this).
- the test framework has been tested on Linux, NetBSD and OpenBSD.
It *should* work fine on FreeBSD and Solaris.
It works on MacOS X (but the output looks funny, because /bin/sh
does not implement "echo -e" - need to add configure trickery)
It will *not* work on Windows yet - I haven't looked into what's
needed to make it work (background processes and signals in mingw
bash?), maybe it's as easy as adding the necessary "ipconfig" and
"netsh" commands to print interface + routing config...
- I have only tested "connect via IPv4 transport, use IPv4+IPv6 payload",
but the framework is generic enough that "connect via IPv6 transport"
should work just fine (just setup OPENVPN_CONF_x accordingly in the
t_client.rc).
- this is neither finished nor pretty, but it helps me a *lot* in
quickly testing whether I broke anything when fiddling system-dependent
code (tun.c, route.c) across multiple build hosts - so I hope this
is going to be fairly useful to Samuli and the buildbot :-)
Signed-off-by: Gert Doering <gert@greenie.muc.de>
Acked-by: David Sommerseth <dazo@users.sourceforge.net>
Signed-off-by: David Sommerseth <dazo@users.sourceforge.net>
84 lines
2.1 KiB
Plaintext
84 lines
2.1 KiB
Plaintext
#
|
|
# this is sourced from t_client.sh and defines which openvpn client tests
|
|
# to run
|
|
#
|
|
# (sample config, copy to t_client.rc and adapt to your environment)
|
|
#
|
|
#
|
|
# define these - if empty, no tests will run
|
|
#
|
|
CA_CERT="/home/openvpn-test-ca/keys/ca.crt"
|
|
CLIENT_KEY="/home/openvpn-test-ca/keys/client-test.key"
|
|
CLIENT_CERT="/home/openvpn-test-ca/keys/client-test.crt"
|
|
#
|
|
# remote host (used as macro below)
|
|
#
|
|
REMOTE=mytestserver
|
|
#
|
|
# tests to run (list suffixes for config stanzas below)
|
|
#
|
|
TEST_RUN_LIST="1 2"
|
|
|
|
#
|
|
# base confic that is the same for all the p2mp test runs
|
|
#
|
|
OPENVPN_BASE_P2MP="--client --ca $CA_CERT \
|
|
--cert $CLIENT_CERT --key $CLIENT_KEY \
|
|
--ns-cert-type server --nobind --comp-lzo --verb 3"
|
|
|
|
# base config for p2p tests
|
|
#
|
|
OPENVPN_BASE_P2P="..."
|
|
|
|
#
|
|
#
|
|
# now define the individual tests - all variables suffixed with _1, _2 etc
|
|
# will be used in test run "1", "2", etc.
|
|
#
|
|
# if something is not defined here, the corresponding test is not run
|
|
#
|
|
# possible test options:
|
|
#
|
|
# OPENVPN_CONF_x = "how to call ./openvpn" [mandatory]
|
|
# EXPECT_IFCONFIG4_x = "this IPv4 address needs to show up in ifconfig"
|
|
# EXPECT_IFCONFIG6_x = "this IPv6 address needs to show up in ifconfig"
|
|
# PING4_HOSTS_x = "these hosts musts ping when openvpn is up (IPv4 fping)"
|
|
# PING6_HOSTS_x = "these hosts musts ping when openvpn is up (IPv6 fping6)"
|
|
#
|
|
# Test 1: UDP / p2mp tun
|
|
# specify IPv4+IPv6 addresses expected from server and ping targets
|
|
#
|
|
OPENVPN_CONF_1="$OPENVPN_BASE_P2MP --dev tun --proto udp --remote $REMOTE --port 51194"
|
|
EXPECT_IFCONFIG4_1="10.100.50.6"
|
|
EXPECT_IFCONFIG6_1="2001:dba:a050::1:0"
|
|
PING4_HOSTS_1="10.100.50.1 10.100.0.1"
|
|
PING6_HOSTS_1="2001:dba::1 2001:dba:a050::1"
|
|
|
|
# Test 2: TCP / p2mp tun
|
|
#
|
|
OPENVPN_CONF_2="$OPENVPN_BASE_P2MP --dev tun --proto tcp --remote $REMOTE --port 51194"
|
|
EXPECT_IFCONFIG4_2="10.100.51.6"
|
|
EXPECT_IFCONFIG6_2="2001:dba:a051::1:0"
|
|
PING4_HOSTS_2="10.100.51.1 10.100.0.1"
|
|
PING6_HOSTS_1="2001:dba::1 2001:dba:a051::1"
|
|
|
|
# Test 3: UDP / p2p tun
|
|
# ...
|
|
|
|
# Test 4: TCP / p2p tun
|
|
# ...
|
|
|
|
# Test 5: UDP / p2mp tap
|
|
# ...
|
|
|
|
# Test 6: TCP / p2mp tun
|
|
# ...
|
|
|
|
# Test 7: UDP / p2p tap
|
|
# ...
|
|
|
|
# Test 8: TCP / p2p tap
|
|
# ...
|
|
|
|
# Test 9: whatever you want to test... :-)
|