Mercurial > hg > freeDiameter
annotate INSTALL.Ubuntu @ 311:a45bcbbeac8b
Added ready-to-copy instructions
author | Sebastien Decugis <sdecugis@nict.go.jp> |
---|---|
date | Mon, 17 May 2010 18:50:06 +0900 |
parents | ad3c46016584 |
children | 6fd1e6f56af5 |
rev | line source |
---|---|
234 | 1 See INSTALL file for general instructions on building freeDiameter. |
2 | |
3 On Ubuntu / Debian, the following packages are required (aptitude install ...): | |
4 cmake make gcc flex bison libsctp1 libsctp-dev libgnutls-dev libgcrypt-dev | |
5 | |
6 Additionnaly, these ones may be useful: | |
7 mercurial gdb | |
290
7842bed901ca
Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
234
diff
changeset
|
8 |
7842bed901ca
Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
234
diff
changeset
|
9 In order to build app_acct extension, you will also need the package libpq-dev. |
234 | 10 |
290
7842bed901ca
Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
234
diff
changeset
|
11 Tested not working: Ubuntu Hardy (too old). |
7842bed901ca
Updated documentation
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
234
diff
changeset
|
12 Tested working: Ubuntu Intrepid, Jaunty, Karmic, Lucid. Debian Lenny. |
298
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
13 |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
14 |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
15 |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
16 ===========================================- |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
17 Step by step instructions (with no prerequisite): |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
18 |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
19 1) Install all packages dependencies |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
20 # apt-get install mercurial cmake make gcc bison flex libsctp-dev libgnutls-dev libgcrypt-dev |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
21 |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
22 2) (OPTION) If you will compile modules that require postgresql, also install: |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
23 # apt-get install libpq-dev |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
24 |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
25 3) (OPTION) If you want a more user-friendly interface, install this: |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
26 # apt-get install cmake-curses-gui |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
27 |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
28 4) Retrieve the source files |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
29 # hg clone http://aaa.koganei.wide.ad.jp/hg/freeDiameter |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
30 |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
31 5) Create a build directory, and enter it |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
32 # mkdir fDbuild |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
33 # cd fDbuild |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
34 |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
35 6) Configure and generate the Makefiles |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
36 a) If you did not install ccmake in step 3: |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
37 # cmake ../freeDiameter |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
38 |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
39 b) If you did install ccmake: |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
40 # ccmake ../freeDiameter |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
41 - press 'c' (configure) |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
42 - toggle the values as needed (ex: BUILD_APP_RADGW=ON, ...) |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
43 - press 'c' again. New items may appear, iterate the process |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
44 - press 'c' and 'g' to complete the process |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
45 |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
46 7) Compile all files: |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
47 # make |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
48 |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
49 8) See available targets: |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
50 # make help |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
51 |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
52 9) (OPTION) Check the software has a correct basic behavior on your environment. -- only if you did not disable the tests in step 6 |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
53 # make test |
57b671bc5e8d
Added detailed instructions for Ubuntu
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
290
diff
changeset
|
54 |
304
ad3c46016584
Added install directives for cmake; also allow default directory to seek for extensions and configuration files
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
298
diff
changeset
|
55 |
311
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
56 =========================================== |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
57 apt-get -y install mercurial cmake make gcc bison flex libsctp-dev libgnutls-dev libgcrypt-dev libpq-dev ssl-cert |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
58 cd /usr/src |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
59 hg clone http://aaa.koganei.wide.ad.jp/hg/freeDiameter |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
60 mkdir fDbuild && cd fDbuild |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
61 cmake -DCMAKE_BUILD_TYPE:STRING=RelWithDebInfo \ |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
62 -DDEFAULT_CONF_PATH:PATH=/etc/freeDiameter \ |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
63 -DCMAKE_INSTALL_PREFIX:PATH=/usr \ |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
64 -DINSTALL_DOCUMENTATION_PATH:PATH=/usr/share/doc/freeDiameter \ |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
65 -DBUILD_APP_ACCT:BOOL=ON \ |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
66 -DBUILD_APP_RADGW:BOOL=ON \ |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
67 -DBUILD_DBG_MONITOR:BOOL=ON \ |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
68 -DBUILD_DBG_RT:BOOL=ON \ |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
69 -DBUILD_TEST_APP:BOOL=ON \ |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
70 -DBUILD_APP_ACCT:BOOL=ON \ |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
71 ../freeDiameter |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
72 make |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
73 make install |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
74 ln -s /etc/ssl/certs/ssl-cert-snakeoil.pem /etc/ssl/certs/freeDiameter.pem |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
75 ln -s /etc/ssl/private/ssl-cert-snakeoil.key /etc/ssl/private/freeDiameter.key |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
76 mkdir /etc/freeDiameter |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
77 cp /usr/share/doc/freeDiameter/*.sample /etc/freeDiameter |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
78 mv /etc/freeDiameter/freediameter.conf.sample /etc/freeDiameter/freeDiameter.conf |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
79 echo "Identity=\"localhost.localdomain\";" >> /etc/freeDiameter/freeDiameter.conf |
a45bcbbeac8b
Added ready-to-copy instructions
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
304
diff
changeset
|
80 freeDiameterd |