Mercurial > hg > freeDiameter

annotate INSTALL.FreeBSD @ 882:ae96ae28f3dd 1.1.5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Limit python version to avoid using python3 (not compatible)
author Sebastien Decugis <sdecugis@freediameter.net>
date Sat, 03 Nov 2012 18:45:41 +0100
parents e387d5c6b6f5
children a0ab56aa089f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
234
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
1 See INSTALL file for general instructions on building freeDiameter.
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
2
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
3 ------------------
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
4 QUICK INSTRUCTIONS
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
5 ------------------
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
6
643
f065e3cb846e Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 559
diff changeset
7 On FreeBSD-8.0 at least the following ports packages were required (should be same on FreeBSD-7.x):
234
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
8 cmake flex bison gnutls
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
9
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
10 Then the cmake command had to look like:
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
11 cmake -DFLEX_EXECUTABLE:FILEPATH=/usr/local/bin/flex ...
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
12
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
13
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
14 ---------------------
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
15 COMPLETE INSTRUCTIONS
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
16 ---------------------
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
17
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
18 1) If you don't have freeBSD yet:
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
19 Install minimal system + ports using initial installer /usr/sbin/sysinstall
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
20
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
21
707
e387d5c6b6f5 Added support for Internationalized Domain Names (IDNA) using GNU libidn
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 696
diff changeset
22 2) Install 'cmake'
234
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
23
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
24 a) from sources:
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
25 # cd /usr/ports/devel/cmake
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
26 # make install
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
27
660
a8269458d5b1 Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 643
diff changeset
28 b) or from package (don't forget to set your PACKAGEROOT appropriately. Ex: set PACKAGEROOT=ftp://ftp.jp.freebsd.org):
234
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
29 # pkg_add -v -r cmake
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
30
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
31
707
e387d5c6b6f5 Added support for Internationalized Domain Names (IDNA) using GNU libidn
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 696
diff changeset
32 3) Install 'mercurial' (optional)
e387d5c6b6f5 Added support for Internationalized Domain Names (IDNA) using GNU libidn
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 696
diff changeset
33 (replace 'cmake' by 'mercurial' in the previous command)
234
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
34
707
e387d5c6b6f5 Added support for Internationalized Domain Names (IDNA) using GNU libidn
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 696
diff changeset
35 4) Install 'flex' and 'bison', same way.
234
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
36
707
e387d5c6b6f5 Added support for Internationalized Domain Names (IDNA) using GNU libidn
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 696
diff changeset
37 5) Install 'gnutls' and 'libidn', same way also.
415
1f4aa49b26e4 Updated building instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 351
diff changeset
38
1f4aa49b26e4 Updated building instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 351
diff changeset
39 6) Retrieve freeDiameter source code:
234
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
40 # cd ~
335
603791d2dcc4 Updated website information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 323
diff changeset
41 # /usr/local/bin/hg clone http://www.freediameter.net/hg/freeDiameter/
234
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
42
415
1f4aa49b26e4 Updated building instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 351
diff changeset
43 6b) Make a build directory
234
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
44 # mkdir fD-build
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
45 # cd fD-build
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
46
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
47 7) Run cmake for freeDiameter (add other flags as you see fit, see INSTALL for more details)
238
62eaf631eb61 Fix compilation issue when gnutls is not in standard directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 234
diff changeset
48 # /usr/local/bin/cmake -DFLEX_EXECUTABLE:FILEPATH=/usr/local/bin/flex ../freeDiameter
234
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
49
323
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
50 8) Compile, optionnaly test
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
51 # make
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
52 # make test
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
53
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
54 9) Install
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
55 # make install
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
56
643
f065e3cb846e Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 559
diff changeset
57 10) Run (the install path can be changed during cmake step):
323
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
58 # /usr/local/bin/freeDiameterd --help
238
62eaf631eb61 Fix compilation issue when gnutls is not in standard directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 234
diff changeset
59
239
aba4342b5916 Update status on freeBSD -- still, not running well
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 238
diff changeset
60
290
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
61 ------------------------------
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
62 app_acct test ADDITIONAL STEPS
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
63 ------------------------------
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
64 Here is additional steps in order to run the test for app_acct
239
aba4342b5916 Update status on freeBSD -- still, not running well
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 238
diff changeset
65
290
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
66 1) Install the required packages
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
67 # pkg_add -v -r postgresql84-client
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
68 # pkg_add -v -r postgresql84-server
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
69
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
70 2) Prepare access to the database:
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
71 # echo postgresql_enable=YES >> /etc/rc.conf
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
72 # /usr/local/etc/rc.d/postgresql initdb
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
73 # su - pgsql
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
74 > /usr/local/bin/pg_ctl -D /usr/local/pgsql/data -l logfile start
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
75 > /usr/local/bin/createuser root
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
76 Shall the new user be allowed to create databases? (y/n) y
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
77 > logout
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
78 # /usr/local/bin/createdb root
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
79 # /usr/local/bin/psql root
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
80 root=# CREATE TABLE incoming_test (
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
81 root(# recorded_on timestamp with time zone NOT NULL,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
82 root(# "Accounting-Record-Type" integer,
351
0aa95dd79d0f Fix erroneous quote sign
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 335
diff changeset
83 root(# "Session-Id" bytea,
290
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
84 root(# "Accounting-Record-Number" integer,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
85 root(# "Route-Record1" bytea,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
86 root(# "Route-Record2" bytea,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
87 root(# "Route-Record3" bytea,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
88 root(# "Route-Record4" bytea );
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
89 root=# \q
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
90
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
91 3) configure the sources
323
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
92 # make edit_cache
290
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
93 BUILD_APP_ACCT:BOOL=ON
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
94 TEST_APP_ACCT:BOOL=ON
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
95 TEST_APP_ACCT_CONNINFO:STRING="user=root dbname=root"
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
96
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
97 4) run the test
660
a8269458d5b1 Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 643
diff changeset
98 # tests/testappacct -d
290
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
99 or
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
100 # make test
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
101
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
102
696
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
103 ----------------------------------
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
104 Segmentation fault on program exit
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
105 ----------------------------------
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
106
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
107 In case you encounter a segmentation fault on program termination like this:
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
108 [...]
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
109 freeDiameterd framework is terminated.
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
110 Segmentation fault: 11 (core dumped)
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
111
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
112 with a backtrace like this:
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
113 #0 0x0000000801a414a0 in ?? ()
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
114 #1 0x0000000800f99274 in __cxa_finalize () from /lib/libc.so.7
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
115 #2 0x0000000800f460b7 in exit () from /lib/libc.so.7
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
116
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
117 You may try to add the following compilation directive in cmake:
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
118 -DSKIP_DLCLOSE:BOOL=ON
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
119
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
120 Note: this segmentation fault was experienced with:
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
121 - FreeBSD 8.1
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
122 - 64 bits architecture only.
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
123 - Profiling mode only.
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
124
ff23fecac0b2 Added documentation for rare segfault in FreeBSD 64bits (Profiling profile)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 660
diff changeset
125
"Welcome to our mercurial repository"