annotate contrib/nightly_tests/README @ 1562:6219359a36a9 default tip

Merge latest changes from proposed branch
author Sebastien Decugis <sdecugis@freediameter.net>
date Mon, 21 Jun 2021 19:08:18 +0800
parents 506e272ddbba
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
344
0e1318e654bc Testing CTest script
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
1 This folder contains information and scripts to run a new test configuration for nightly builds
408
9a9a9e1ed4cb Added cron job information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 353
diff changeset
2 and reporting the results to freeDiameter dashboard at:
9a9a9e1ed4cb Added cron job information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 353
diff changeset
3 http://www.freediameter.net/CDash/index.php?project=freeDiameter
344
0e1318e654bc Testing CTest script
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
4
408
9a9a9e1ed4cb Added cron job information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 353
diff changeset
5 The information gathered here mostly comes from the following pages:
9a9a9e1ed4cb Added cron job information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 353
diff changeset
6 http://www.itk.org/Wiki/CMake_Testing_With_CTest
9a9a9e1ed4cb Added cron job information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 353
diff changeset
7 http://www.itk.org/Wiki/CMake_Scripting_Of_CTest
9a9a9e1ed4cb Added cron job information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 353
diff changeset
8 http://www.itk.org/Wiki/CTest:Buildserver
344
0e1318e654bc Testing CTest script
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
9
408
9a9a9e1ed4cb Added cron job information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 353
diff changeset
10 =============
344
0e1318e654bc Testing CTest script
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
11
408
9a9a9e1ed4cb Added cron job information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 353
diff changeset
12 INSTRUCTIONS to setup a new build slave for the freeDiameter buildserver:
466
7a2c3e233449 Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 464
diff changeset
13 -- note: the build slave should have cmake version 2.8 at least so that ctest will update the source tree properly.
344
0e1318e654bc Testing CTest script
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
14
464
e16866e190a4 Updated tests documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 417
diff changeset
15 1) Install all dependencies for freeDiameter as follow:
608
ee1dd2a6fd7e Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 587
diff changeset
16 a) Debian / Ubuntu: See the "prereqs.ubuntu" file
ee1dd2a6fd7e Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 587
diff changeset
17 $ sudo aptitude install `wget http://www.freediameter.net/hg/freeDiameter/raw-file/tip/contrib/nightly_tests/prereqs.ubuntu -O - | grep -v -e "^#"`
464
e16866e190a4 Updated tests documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 417
diff changeset
18
608
ee1dd2a6fd7e Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 587
diff changeset
19 b) FreeBSD: See the "prereqs.freebsd" file
464
e16866e190a4 Updated tests documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 417
diff changeset
20 - install base system and ports
e16866e190a4 Updated tests documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 417
diff changeset
21 - install freediameter dependencies as follow:
608
ee1dd2a6fd7e Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 587
diff changeset
22 # pkg_add -r -v wget
ee1dd2a6fd7e Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 587
diff changeset
23 # pkg_add -r -v `wget http://www.freediameter.net/hg/freeDiameter/raw-file/tip/contrib/nightly_tests/prereqs.freebsd -O - | grep -v -e "^#"`
612
95bb43106039 Updated documentation, included information for OpenSUSE and Fedora
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 608
diff changeset
24
95bb43106039 Updated documentation, included information for OpenSUSE and Fedora
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 608
diff changeset
25 c) OpenSUSE:
95bb43106039 Updated documentation, included information for OpenSUSE and Fedora
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 608
diff changeset
26 $ sudo zypper install `wget http://www.freediameter.net/hg/freeDiameter/raw-file/tip/contrib/nightly_tests/prereqs.opensuse -O - | grep -v -e "^#"`
95bb43106039 Updated documentation, included information for OpenSUSE and Fedora
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 608
diff changeset
27
95bb43106039 Updated documentation, included information for OpenSUSE and Fedora
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 608
diff changeset
28 d) Fedora:
613
69daef73812c Small update to documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 612
diff changeset
29 $ sudo yum install wget
612
95bb43106039 Updated documentation, included information for OpenSUSE and Fedora
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 608
diff changeset
30 $ sudo yum install `wget http://www.freediameter.net/hg/freeDiameter/raw-file/tip/contrib/nightly_tests/prereqs.fedora -O - | grep -v -e "^#"`
617
c16583e80ffe Update documentation for Fedora systems where SELinux prevents binding the SCTP socket
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 613
diff changeset
31
c16583e80ffe Update documentation for Fedora systems where SELinux prevents binding the SCTP socket
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 613
diff changeset
32 You may also have issues with SELinux later, an easy workaround is to disable it (until better solution)
c16583e80ffe Update documentation for Fedora systems where SELinux prevents binding the SCTP socket
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 613
diff changeset
33 # setenforce Permissive
612
95bb43106039 Updated documentation, included information for OpenSUSE and Fedora
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 608
diff changeset
34
344
0e1318e654bc Testing CTest script
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
35
352
2521e4d91dac Added the allext test
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 347
diff changeset
36 2) Create the "test" database for app_acct test (we assume the tests are run as user "test" here)
464
e16866e190a4 Updated tests documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 417
diff changeset
37 - check INSTALL.FreeBSD file for specific PostgreSQL pre-install instructions.
612
95bb43106039 Updated documentation, included information for OpenSUSE and Fedora
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 608
diff changeset
38 - These are the instructions for Debian/Ubuntu/OpenSUSE, adjust as needed:
353
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
39 # su - postgres
1046
506e272ddbba Update documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 617
diff changeset
40 # createuser --interactive test
353
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
41 Shall the new role be a superuser? (y/n) n
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
42 Shall the new role be allowed to create databases? (y/n) y
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
43 Shall the new role be allowed to create more new roles? (y/n) n
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
44 # logout
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
45 $ whoami
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
46 test
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
47 $ createdb test
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
48 $ psql test
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
49 psql (8.4.4)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
50 Type "help" for help.
352
2521e4d91dac Added the allext test
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 347
diff changeset
51
353
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
52 test=>
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
53 CREATE TABLE incoming_test (
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
54 recorded_on timestamp with time zone NOT NULL,
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
55 "Accounting-Record-Type" integer,
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
56 "Session-Id" bytea,
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
57 "Accounting-Record-Number" integer,
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
58 "Route-Record1" bytea,
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
59 "Route-Record2" bytea,
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
60 "Route-Record3" bytea,
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
61 "Route-Record4" bytea );
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
62 \q
612
95bb43106039 Updated documentation, included information for OpenSUSE and Fedora
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 608
diff changeset
63
352
2521e4d91dac Added the allext test
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 347
diff changeset
64
2521e4d91dac Added the allext test
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 347
diff changeset
65 3) Create a directory ~/fDtests
353
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
66 $ cd
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
67 $ mkdir fDtests
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
68 $ cd fDtests
344
0e1318e654bc Testing CTest script
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
69
352
2521e4d91dac Added the allext test
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 347
diff changeset
70 4) Retrieve the runtests.sh script and save in this directory
353
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
71 $ wget http://www.freediameter.net/hg/freeDiameter/raw-file/tip/contrib/nightly_tests/runtests.sh
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
72 $ chmod +x runtests.sh
344
0e1318e654bc Testing CTest script
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
73
352
2521e4d91dac Added the allext test
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 347
diff changeset
74 5) Create a file local.cmake defining the name of the build slave in this directory also.
353
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 352
diff changeset
75 $ echo "SET(CTEST_SITE \""`hostname`"\")" > local.cmake
417
195096819152 Cleanups in documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 410
diff changeset
76
608
ee1dd2a6fd7e Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 587
diff changeset
77 For FreeBSD, in addition do:
417
195096819152 Cleanups in documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 410
diff changeset
78 $ echo "set(CTEST_BUILD_OPTIONS \"\${CTEST_BUILD_OPTIONS} -DFLEX_EXECUTABLE:FILEPATH=/usr/local/bin/flex\")" >> local.cmake
608
ee1dd2a6fd7e Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 587
diff changeset
79
612
95bb43106039 Updated documentation, included information for OpenSUSE and Fedora
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 608
diff changeset
80 6) Run the runtests.sh script once to check it works properly (freeBSD might require: ln -s /usr/local/bin/bash /bin/bash)
345
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 344
diff changeset
81
352
2521e4d91dac Added the allext test
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 347
diff changeset
82 7) Set up a crontab to run the script
410
3ed2c84d9e23 Couple of fixes and improvements
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 408
diff changeset
83 $ wget http://www.freediameter.net/hg/freeDiameter/raw-file/tip/contrib/nightly_tests/cronjob.sh
3ed2c84d9e23 Couple of fixes and improvements
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 408
diff changeset
84 $ chmod +x cronjob.sh
408
9a9a9e1ed4cb Added cron job information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 353
diff changeset
85 $ crontab -l
417
195096819152 Cleanups in documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 410
diff changeset
86 0 0 * * * /home/test/fDtests/cronjob.sh > /home/test/fDtests/cronjob.log 2>&1
"Welcome to our mercurial repository"