Mercurial > hg > freeDiameter

annotate INSTALL.FreeBSD @ 643:f065e3cb846e 1.0.3

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Updated documentation
author Sebastien Decugis <sdecugis@nict.go.jp>
date Tue, 21 Dec 2010 10:51:14 +0900
parents 85ba85b4739c
children a8269458d5b1
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
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
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
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
98 # freeDiameter/tests/testappacct -d
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
"Welcome to our mercurial repository"