Mercurial > hg > freeDiameter

annotate contrib/OpenWRT/HOWTO @ 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 672876bf2699
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
700
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
1 #####################
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
2 # !! IMPORTANT !! #
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
3 #####################
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
4
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
5 The uClibc library that is shipped with OpenWRT lacks support for several POSIX thread
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
6 features, such as pthread_cleanup_{push,pop}, that are required by the freeDiameter
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
7 framework.
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
8
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
9 Until these features are included in the base OpenWRT system, the framework will not
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
10 behave correctly on this platform.
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
11
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
12 Therefore, the OpenWRT port is NOT usable properly at this moment with uClibc.
700
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
13
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
14 A test software is included in test_required for checking if new uClibc distributions
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
15 support the required features. You'll have to adapt the Makefile according to your environment.
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
16
702
672876bf2699 Changed reference from glibc to eglibc in OpenWRT HOWTO
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 701
diff changeset
17 An alternative choice if your hardware allows it is to use (e)glibc in your openwrt image.
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
18
700
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
19 #####################
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
20
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
21
0ae67f14ac17 Added testcase and explanation about problematic OpenWRT support (#26)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 670
diff changeset
22
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
23 This HOWTO describes how to generate a set of ipkg modules for
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
24 providing support of freeDiameter in an OpenWRT system.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
25
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
26 This HOWTO is written for OpenWRT 10.03 (BackFire) and no guarantee is provided
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
27 that it will work for you. Be prepared to eventually brick your routeur...
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
28
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
29 Table of contents:
498
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
30 0) Quick HOWTO: optimistic step-by-step instructions.
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
31 1) Prerequisites: get the OpenWRT development environment ready.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
32 2) Supplied packages: use the existing packages when possible (gnutls, ...)
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
33 3) Other dependencies: provide for additional missing dependencies (sctp ...)
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
34 4) freediameter package: now create the freeDiameter package
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
35 5) Configuration: how to set the configuration on the router.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
36
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
37 This HOWTO will NOT cover how to install OpenWRT on your access device, nor
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
38 its basic configuration. Please refer to OpenWRT website for this type of HOWTOs.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
39
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
40
498
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
41 ==============================================
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
42 0) Quick HOWTO
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
43 ==============================================
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
44 The following instructions should allow you to put freeDiameter on your OpenWRT-compatible router.
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
45 In case something goes wrong, you should follow the detailed instructions in the remaining of
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
46 this file.
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
47
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
48 Be warned: playing with the software in your router may brick it, i.e. make it unusable forever.
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
49 Do it at your own risk.
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
50
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
51 1) Get the OpenWRT environment:
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
52 $ git clone git://nbd.name/openwrt.git
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
53 $ cd openwrt
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
54
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
55 2) Get the feeds
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
56 $ cp feeds.conf.default feeds.conf
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
57 $ echo "src-hg freediameter http://www.freediameter.net/hg/fD-OWRT-packages" >> feeds.conf
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
58 $ scripts/feeds update
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
59 $ scripts/feeds install freeDiameter
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
60
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
61 3) Configure your image
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
62 $ make menuconfig
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
63 (set Target System and Target Profile as needed for your equipment)
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
64
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
65 - Network --->
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
66 freeDiameter (M)
670
05dbfcd6f1cf Updated OpenWRT package files
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 566
diff changeset
67 freeDiameter-test (M)
562
e837ef4bdf35 Remove local machine name from the file
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 531
diff changeset
68 wpad (*)
e837ef4bdf35 Remove local machine name from the file
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 531
diff changeset
69 wpad-mini ( )
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
70
498
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
71
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
72 4) Set the C library to glibc instead of uClibc (broken support, see #26)
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
73
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
74 - Advanced configuration options (for developers) --->
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
75 - Toolchain Options ---->
702
672876bf2699 Changed reference from glibc to eglibc in OpenWRT HOWTO
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 701
diff changeset
76 C Library implementation (Use eglibc)
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
77
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
78
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
79 5) Build the image and packages, this takes a while
498
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
80 $ make world
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
81
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
82 6) Export the bin/* directory through a webserver.
498
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
83 We assume it is available at http://192.168.1.25/owrt
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
84
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
85 7) Flash the router with your new image -- THIS DESTROYS ALL CONFIG ON THE ROUTER!
498
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
86 $ ssh root@192.168.1.1
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
87 # cd /tmp
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
88 # wget http://192.168.1.25/owrt/openwrt-brcm47xx-squashfs.trx
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
89 ;; change the file name with yours
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
90 # mtd -r write openwrt-brcm47xx-squashfs.trx linux
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
91 ;; wait for reboot
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
92 $ telnet 192.168.1.1
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
93 # passwd
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
94 # sync
566
62ad61238af2 Cosmetics
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 562
diff changeset
95 # exit
498
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
96
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
97 8) Update the opkg router's config to get your new packages
498
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
98 ssh root@192.168.1.1
562
e837ef4bdf35 Remove local machine name from the file
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 531
diff changeset
99 # echo "src/gz localrepo http://192.168.1.25/owrt/packages" >> /etc/opkg.conf
498
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
100 # opkg update
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
101
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
102 9) Install freeDiameter, you're done. Optionnaly, install also certtool on the router before, to
562
e837ef4bdf35 Remove local machine name from the file
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 531
diff changeset
103 generate the TLS certificate automatically.
498
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
104 # opkg install freeDiameter
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
105
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
106 ==============================================
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
107 1) Prerequisites:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
108 ==============================================
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
109
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
110 We will first need a working OpenWRT toolchain environment. You can retrieve
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
111 pre-compiled binaries of such toolchains ("Image builder") on the OpenWRT website. Anyway,
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
112 in case the architecture you are interested in is not listed, you can build
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
113 the full toolchain from source. This is the path we are following in this HOWTO.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
114
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
115 a) Retrieve the latest OpenWRT source, using subversion or git.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
116 Since I have to go through a proxy, I use the later here, svn being quite annoying with proxies.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
117 Note, the following commands must not be run as root.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
118 $ git clone git://nbd.name/openwrt.git
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
119 (Note: you might instead use "backfire.git" if you want to stick with an OpenWRT release.)
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
120 $ cd openwrt
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
121 $ cp feeds.conf.default feeds.conf
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
122
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
123 b) If you are using git, you have to edit the feeds.conf file to use git as well for packages.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
124 Do the following modifications in this case:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
125 $ vi feeds.conf
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
126 Comment out this line:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
127 src-svn packages https://svn.openwrt.org/openwrt/packages
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
128 Add this line instead:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
129 src-git packages git://nbd.name/packages.git
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
130
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
131 You can leave uncommented the luci (for GNUTLS) and Xwrt (webif) repositories. Since these repositories
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
132 use svn over http, you can use subversion even if you are behind a proxy.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
133
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
134 c) Then issue the following command to update the package list:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
135 $ scripts/feeds update
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
136
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
137 d) Now, let's already create the toolchain and basic image.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
138 $ make menuconfig
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
139
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
140 This will open a menu for you. You must select the target you are building for.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
141 See http://wiki.openwrt.org/toh/start for the table of hardware and associated information.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
142 In my case, I am using a Buffalo WZR-HP-G300NH router. I therefore select these options:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
143 - Target System --->
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
144 Atheros AR71xx/AR7240/AR913x
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
145 - Target Profile --->
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
146 Buffalo WZR-HP-G300NH
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
147
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
148 For many routeurs, the recommended kernel is a 2.4x version. I have NOT tried with such kernel,
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
149 and the SCTP support is likely to be different in this generation of kernels. I strongly recommend
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
150 to go with a 2.6x kernel, whenever possible.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
151
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
152 e) As per freeDiameter ticket #26, you also need to change the library to glibc instead of uClibc.
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
153 Change the option as follow:
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
154
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
155 - Advanced configuration options (for developers) --->
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
156 - Toolchain Options ---->
702
672876bf2699 Changed reference from glibc to eglibc in OpenWRT HOWTO
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 701
diff changeset
157 C Library implementation (Use eglibc)
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
158
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
159 f) Once configured, create the toolchain and default image (this takes a while):
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
160 $ make world
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
161
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
162 After this command completes successfully, your build environment is ready.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
163 The resulting image and packages are stored in the "bin/" subdirectory.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
164 It is very convenient if you make this repository available in http to your routeur.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
165
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
166 You should probably try at this early stage to flash your device with the image you have generated.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
167 If the default basic image does not work, it is probably not worth adding new problems on top of it.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
168
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
169 For troubleshooting, please consult OpenWRT documentation directly.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
170 "make prereq" may help you building the initial image also.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
171 See http://downloads.openwrt.org/docs/buildroot-documentation.html for additional information
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
172 concerning this step.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
173
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
174 You should now be able to login on your routeur with telnet (first time) or ssh (after setting a password).
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
175
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
176 ==============================================
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
177 2) Supplied packages:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
178 ==============================================
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
179
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
180 There are some dependencies of freeDiameter already available in the OpenWRT packages repository.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
181 You can check for the available packages with the script:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
182 $ ./scripts/feeds search <package>
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
183
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
184 We will now describe how to install these dependencies. At the time this HOWTO is written,
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
185 the OpenWRT repositories contains packages for sctp, ipv6, gnutls, pthreads and hostapd.
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
186 Follow these instructions to build them.
491
6edd14e5f132 Fix SCTP support for OpenWRT, now it really works
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 490
diff changeset
187
6edd14e5f132 Fix SCTP support for OpenWRT, now it really works
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 490
diff changeset
188 Alternatively, you can find these packages pre-compiled in the OpenWRT packages repository.
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
189
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
190 a) Add the packages
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
191 $ scripts/feeds install libgnutls
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
192 $ scripts/feeds install sctp
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
193
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
194 b) Select the following components in the menu:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
195 $ make menuconfig
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
196 - Base system --->
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
197 libpthread (M)
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
198
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
199 - Network --->
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
200 sctp (M)
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
201 hostapd (M)
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
202 wpad-mini ( )
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
203
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
204 - Libraries --->
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
205 SSL --->
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
206 libgnutls (M)
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
207
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
208 - Kernel modules --->
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
209 Network Support --->
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
210 kmod-ipv6 (M)
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
211
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
212 Quit and save the new config, then:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
213 $ make world
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
214
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
215 This will add a bunch of modules in your bin directory that will be required for freeDiameter.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
216 Since we are removing the wpad-mini daemon from the base image, this image (trx or bin file) is also recompiled.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
217
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
218 Note that if you are setting your device as WPA supplicant also (wireless client), you must select wpad instead of hostapd.
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
219 (in any case, the -mini version is not suitable since we will use the RADIUS authentication).
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
220
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
221
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
222 You should now reflash your routeur with the new firmware image. The simplest way to achieve if your routeur has enough
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
223 flash memory is to:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
224 - copy the new trx image to your routeur's /tmp (using wget or scp)
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
225 - run this command (on the device) -- replace <newfile.trx> with your actual filename:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
226 root@OpenWrt:~# mtd -r write <newfile.trx> linux
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
227
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
228 WARNING: this will erase your existing configuration on the routeur.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
229 In case you need to save it, you may try the sysupgrade command instead.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
230
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
231 This will reboot the device after writing the new image file.
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
232 Afterwards, if you have set up the http server on your development machine properly
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
233 (let's assume it has IP address 192.168.1.25)
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
234 you can run the following command on your router:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
235 root@OpenWrt:~# echo "src/gz mydev http://192.168.1.25/packages" >> /etc/opkg.conf
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
236 root@OpenWrt:~# opkg update
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
237
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
238 Install the newly compiled packages with:
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
239 root@OpenWrt:~# opkg install kmod-ipv6 hostapd libpthread sctp
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
240
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
241 ==============================================
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
242 3) Missing packages:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
243 ==============================================
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
244
531
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
245 UPDATE: Starting from revision r22917, sctp and kmod-sctp are included in the OpenWRT distribution, and have been removed
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
246 from freeDiameter package. One may consider using a freeDiameter package prior to 2010/09/05 in order to get the sctp
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
247 package, or a more recent OpenWRT environment.
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
248
531
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
249 PREVIOUS SITUATION: If you are using components prior to 2010/09/05, the following applies:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
250 P:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
251 P: There are other dependencies for freeDiameter that are not provided by OpenWRT packages.
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
252 P: For convenience, we include these meta-packages in the freeDiameter distribution -- but they
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
253 P: might not be up-to-date.
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
254 P:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
255 P: a) Adding the contributed directory to the feeds
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
256 P: Add the following line in your feeds.conf file:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
257 P: src-link freediameter /path/to/freediameter/contrib/OpenWRT/packages/
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
258 P:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
259 P: Then run:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
260 P: $ scripts/feeds update
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
261 P:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
262 P: This should allow you to install the missing dependencies as follow:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
263 P:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
264 P:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
265 P: b) SCTP library (note: you might alternatively compile freeDiameter without SCTP support).
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
266 P: $ scripts/feeds install sctp
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
267 P:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
268 P:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
269 P: c) Select these components in the menu:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
270 P: $ make menuconfig
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
271 P: - Libraries --->
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
272 P: sctp (M)
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
273 P:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
274 P: Quit and save the new config, then:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
275 P: $ make world
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
276 P:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
277 P:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
278 P: d) Install this on the router as well:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
279 P: root@OpenWrt:~# opkg update
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
280 P: root@OpenWrt:~# opkg install sctp
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
281
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
282
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
283 ==============================================
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
284 4) freediameter package:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
285 ==============================================
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
286
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
287 Now, your environment should be ready to compile the freeDiameter ipkg package.
498
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
288 $ scripts/feeds install freeDiameter
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
289
498
753c9ed8f19a Initial working freeDiameter package
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 491
diff changeset
290 Note that in order to build this package, you need to have cmake & flex on your compilation machine.
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
291
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
292 $ make menuconfig
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
293 - Network --->
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
294 freeDiameter (M)
701
8af6b79cf7d7 Updated OpenWRT howto, added workaround for #26
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 700
diff changeset
295 freeDiameter-test (M)
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
296
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
297 Quit and save the new config, then:
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
298 $ make world
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
299
531
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
300 On your router, run:
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
301 # opkg update
d1cb0dadc22d SCTP support added upstream in OpenWRT: r22917 in openwrt, r22912 in packages
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 498
diff changeset
302 # opkg install freeDiameter
490
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
303
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
304
2577514b2546 Updated documentation (still incomplete)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
305
"Welcome to our mercurial repository"