Project

General

Profile

Edit History

ZRouterorg Project ยป

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