Project

General

Profile

QuickStart » History » Version 34

Alexey Z., 03/06/2013 05:56 AM

1 29 Alexey Z.
h1. Quickstart guide
2 1 Nicolai Petri
3 29 Alexey Z.
h2. Creating a ZRouter build environment.
4 1 Nicolai Petri
5 1 Nicolai Petri
This should probably be done within a Jail.
6 1 Nicolai Petri
7 22 Alexey Z.
  At First, this Requires you have [[hg]]/mercurial installed:
8 23 Alexey Z.
9 22 Alexey Z.
* From FreeBSD ports:
10 22 Alexey Z.
<pre>
11 22 Alexey Z.
# cd /usr/ports/devel/mercurial
12 22 Alexey Z.
# make install clean
13 22 Alexey Z.
</pre>
14 22 Alexey Z.
* *OR* From FreeBSD packages:
15 22 Alexey Z.
<pre>
16 27 Alexey Z.
# pkg_add -r mercurial (or # pkg install mercurial)
17 22 Alexey Z.
</pre>
18 22 Alexey Z.
19 16 Michael Vale
# Create a path set aside for ZRouter build.
20 1 Nicolai Petri
<pre># mkdir -p ZRouter/</pre>
21 1 Nicolai Petri
# Enter directory: 
22 1 Nicolai Petri
<pre># cd ZRouter</pre>
23 1 Nicolai Petri
# Checkout/clone ZRouter Project
24 1 Nicolai Petri
<pre># hg clone http://zrouter.org/hg/zrouter/</pre>
25 1 Nicolai Petri
# Checkout/clone Current compatible FreeBSD source:
26 1 Nicolai Petri
<pre># hg clone http://zrouter.org/hg/FreeBSD/head FreeBSD</pre>
27 1 Nicolai Petri
# Begin ZRouter Build Menu
28 1 Nicolai Petri
<pre># ./menu.sh</pre>
29 22 Alexey Z.
30 22 Alexey Z.
h2. Entering ./menu.sh
31 1 Nicolai Petri
32 33 Alexey Z.
!mainmenu.jpg!
33 22 Alexey Z.
34 1 Nicolai Petri
# Select your target device (example D-Link DIR-632):
35 33 Alexey Z.
!Target.jpg!
36 22 Alexey Z.
# Select Base Profile. That's two choise: 
37 1 Nicolai Petri
 - Small - size firmware > 4 MB (if your ROM more than 4 MB)
38 1 Nicolai Petri
 - Extra small - size firmware <= 4MB (if your ROM less than 4 MB)
39 33 Alexey Z.
40 33 Alexey Z.
!kernel.jpg!
41 33 Alexey Z.
42 22 Alexey Z.
# At "Profiles" select package that included firmware:
43 30 Alexey Z.
 - DEBUG_ - 
44 30 Alexey Z.
 - ath - 
45 30 Alexey Z.
 - dhclient - 
46 30 Alexey Z.
 - dhcp - 
47 30 Alexey Z.
 - dig_spcdns - 
48 30 Alexey Z.
 - hostap - 
49 30 Alexey Z.
 - ipfw - stateful "firewall written for FreeBSD":http://www.freebsd.org/doc/handbook/firewalls-ipfw.html. 
50 30 Alexey Z.
 - lagg - 
51 30 Alexey Z.
 - lua_web_ui - 
52 30 Alexey Z.
 - mono - 
53 30 Alexey Z.
 - mpd -
54 30 Alexey Z.
 - mroute - 
55 30 Alexey Z.
 - net_help - 
56 30 Alexey Z.
 - nfs_client - 
57 30 Alexey Z.
 - ng_igmp_fwd - 
58 30 Alexey Z.
 - ntpdate - for clock synchronization over "Network Time Protocol (NTP)":http://en.wikipedia.org/wiki/Network_Time_Protocol.
59 30 Alexey Z.
 - openvpn - create a "Virtual Private Network (VPN)":http://en.wikipedia.org/wiki/VPN. Include "OpenVPN":http://openvpn.net, crypto libraries.
60 30 Alexey Z.
 - ppp -
61 30 Alexey Z.
 - racoon -
62 30 Alexey Z.
 - racoon2 - 
63 30 Alexey Z.
 - shttpd - 
64 30 Alexey Z.
 - ssh - enable "SSH service":http://en.wikipedia.org/wiki/Secure_Shell. Include ssh, sshd, SSH PAM service file and /etc/ssh configs.
65 30 Alexey Z.
 - watchdog - if software freeze, then "watchdog":http://en.wikipedia.org/wiki/Watchdog_timer H/W reset system. Include watchdogd and rc.d script.
66 30 Alexey Z.
 - zhttpd - 
67 22 Alexey Z.
!package.jpg!
68 1 Nicolai Petri
# Last that must to do - select paths of source and build object:
69 1 Nicolai Petri
!path.jpg!
70 23 Alexey Z.
 - Path of FreeBSD/head
71 23 Alexey Z.
!Path_head.jpg!
72 24 Alexey Z.
 - Path of objects (temporary direcroty where will be compilate your firmware)
73 23 Alexey Z.
!path_obj.jpg!
74 23 Alexey Z.
Then go back to main menu:
75 1 Nicolai Petri
!path_back.jpg!
76 26 Alexey Z.
# You can save your selection to "Build Profile" for future use (file will be created at "./Zrouter/zrouter/build_profiles/" ):
77 24 Alexey Z.
!save_menu.jpg!
78 24 Alexey Z.
!save.jpg!
79 1 Nicolai Petri
# You can load your Build Profile if you save it early:
80 25 Alexey Z.
!load_menu.jpg!
81 1 Nicolai Petri
!load.jpg!
82 26 Alexey Z.
# Now select to "Build" and you see all your choices:
83 26 Alexey Z.
!Compilate.jpg!
84 26 Alexey Z.
Answer "yes" and firmware will begining.
85 26 Alexey Z.
86 26 Alexey Z.
h2. "Flash your firmware":http://zrouter.org/projects/zrouter/wiki/Howto_flash