annotate INSTALL.FreeBSD @ 290:7842bed901ca

Updated documentation
author Sebastien Decugis <sdecugis@nict.go.jp>
date Fri, 07 May 2010 16:33:12 +0900
parents 6e6ada749a11
children f34646a91dbc
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
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
28 b) from package (don't forget to set your PACKAGEROOT appropriately: set PACKAGEROOT=ftp://ftp.jp.freebsd.org):
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
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
37 5) Retrieve freeDiameter source code:
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
38 # cd ~
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
39 # /usr/local/bin/hg clone http://aaa.koganei.wide.ad.jp/hg/freeDiameter/
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
40
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
41 6) Make a build directory
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
42 # mkdir fD-build
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
43 # cd fD-build
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
44
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
45 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
46 # /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
47
f91fe0b85928 Updated INSTALL files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
48 8) make, run, enjoy :)
238
62eaf631eb61 Fix compilation issue when gnutls is not in standard directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 234
diff changeset
49
239
aba4342b5916 Update status on freeBSD -- still, not running well
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 238
diff changeset
50
290
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
51 ------------------------------
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
52 app_acct test ADDITIONAL STEPS
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
53 ------------------------------
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
54 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
55
290
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
56 1) Install the required packages
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
57 # pkg_add -v -r postgresql84-client
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
58 # pkg_add -v -r postgresql84-server
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
59
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
60 2) Prepare access to the database:
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
61 # echo postgresql_enable=YES >> /etc/rc.conf
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
62 # /usr/local/etc/rc.d/postgresql initdb
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
63 # su - pgsql
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
64 > /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
65 > /usr/local/bin/createuser root
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
66 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
67 > logout
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
68 # /usr/local/bin/createdb root
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
69 # /usr/local/bin/psql root
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
70 root=# CREATE TABLE incoming_test (
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
71 root(# recorded_on timestamp with time zone NOT NULL,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
72 root(# "Accounting-Record-Type" integer,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
73 root(# "Session-Id" bytea, "
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
74 root(# "Accounting-Record-Number" integer,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
75 root(# "Route-Record1" bytea,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
76 root(# "Route-Record2" bytea,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
77 root(# "Route-Record3" bytea,
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
78 root(# "Route-Record4" bytea );
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
79 root=# \q
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
80
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
81 3) configure the sources
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
82 # ccmake .
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
83 BUILD_APP_ACCT:BOOL=ON
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
84 TEST_APP_ACCT:BOOL=ON
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
85 TEST_APP_ACCT_CONNINFO:STRING="user=root dbname=root"
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
86
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
87 4) run the test
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
88 # freeDiameter/tests/testappacct -d
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
89 or
7842bed901ca Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 249
diff changeset
90 # make test
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
"Welcome to our mercurial repository"