Mercurial > hg > freeDiameter

annotate INSTALL.FreeBSD @ 484:23e1fae23c75

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added note about known bug
author Sebastien Decugis <sdecugis@nict.go.jp>
date Tue, 10 Aug 2010 14:24:05 +0900
parents 4dc1edb5ddab
children 85ba85b4739c
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
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
7 On FreeBSD-8.0 the following packages were required (should be same on FreeBSD-7.x):
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
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
22 2) Install cmake
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
461
4dc1edb5ddab Added information about app_diameap in the main documentation files
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 415
diff changeset
28 b) or from package (don't forget to set your PACKAGEROOT appropriately: 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
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
32 3) Install mercurial (optional)
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
33 (replace "cmake" by "mercurial" in the previous command)
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
34
238
62eaf631eb61 Fix compilation issue when gnutls is not in standard directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 234
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
415
1f4aa49b26e4 Updated building instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 351
diff changeset
37 5) Install gnutls, same way also.
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
484
23e1fae23c75 Added note about known bug
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 461
diff changeset
53 Note: on FreeBSD <= 8.1 on amd64, SCTP does not work properly, causing testsctp & testcnx to fail.
323
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
54
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
55 9) Install
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
56 # make install
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
57
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
58 10) Run (the install path can be changed in cmake step):
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
59 # /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
60
239
aba4342b5916 Update status on freeBSD -- still, not running well
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 238
diff changeset
61
290
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
62 ------------------------------
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
63 app_acct test ADDITIONAL STEPS
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
64 ------------------------------
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
65 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
66
290
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
67 1) Install the required packages
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
68 # pkg_add -v -r postgresql84-client
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
69 # pkg_add -v -r postgresql84-server
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
70
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
71 2) Prepare access to the database:
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
72 # echo postgresql_enable=YES >> /etc/rc.conf
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
73 # /usr/local/etc/rc.d/postgresql initdb
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
74 # su - pgsql
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
75 > /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
76 > /usr/local/bin/createuser root
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
77 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
78 > logout
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
79 # /usr/local/bin/createdb root
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
80 # /usr/local/bin/psql root
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
81 root=# CREATE TABLE incoming_test (
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
82 root(# recorded_on timestamp with time zone NOT NULL,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
83 root(# "Accounting-Record-Type" integer,
351
0aa95dd79d0f Fix erroneous quote sign
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 335
diff changeset
84 root(# "Session-Id" bytea,
290
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
85 root(# "Accounting-Record-Number" integer,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
86 root(# "Route-Record1" bytea,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
87 root(# "Route-Record2" bytea,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
88 root(# "Route-Record3" bytea,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
89 root(# "Route-Record4" bytea );
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
90 root=# \q
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
91
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
92 3) configure the sources
323
f34646a91dbc Updated FreeBSD notes
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 290
diff changeset
93 # make edit_cache
290
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
94 BUILD_APP_ACCT:BOOL=ON
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
95 TEST_APP_ACCT:BOOL=ON
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
96 TEST_APP_ACCT_CONNINFO:STRING="user=root dbname=root"
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
97
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
98 4) run the test
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
99 # freeDiameter/tests/testappacct -d
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
100 or
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
101 # make test
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
102
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
103
"Welcome to our mercurial repository"