RouterStationChallenge NETSHe

From Ubiquiti Wiki

1 NETSHe

NETSHe

Overview

NETSHe is a feature rich and general purpose web interface for configuring RouterStation devices. The main features of NETSHe are:

Network interface management (including point-to-point and wireless);
VLAN's and aliases;
Advanced routing (static, multipath, rule-based, RIP, OSPF, BGP);
Zone based firewall;
Bridges with brouter and filtering capability;
Interface bonding;
Quality of Service, bandwidth management, traffic shaping, rate control and traffic prioritization;
L7 based (application patterns based) IP-traffic filtering and marking;
Extended management of wireless interfaces; Access Point, Ad-Hoc, Client and Repeater mode with (or without) variable WEP encryption modes, WPA-PSK, WPA2-PSK, WPA-EAP, WPA2-EAP, 802.11X authorization and key management;
Access concentrator for variable VPN's (PPTP, L2TP and OpenVPN);
IPSEC support for L2TP VPN solution;
PPPoE access concentrator;
Hot-spot controller with external UAM-authorization; walled garden and bandwidth management;
Authorization and accounting through external radius-server;
Built-in IP-address assignment or assignment through external radius-server;
DHCP server with flexible rules; dynamic IP-address assignment; static IP-address assignment; configurable black-list mode for DHCP requests from specified MAC's;
DHCP relay;
Network time synchronization server and client. Server integration with DHCP server.
Built-in HTTP proxy with ability to use upstream proxy;
Full software management; support of external software repositories; software installation and deletion;
User management; two levels of user access: full and read-only;
External storage management; SWAP control;
System monitoring; chart graphing in a near real-time mode;
System monitoring through SNMP v2 protocol;
Configurable system backup; backup images can be moved to external devices and/or network shares;
Files and folders restoration;
Backup and restoration of configurations;
Firmware flashing;
Traffic capture and analysis;
System halt and reboot;
Some helpful utilities.

RouterStation Image(s)

http://stasoft.net (for the latest)
http://ubnt.com/downloads/RouterStationChallenge/NETSHe/NETSHe.bin (snapshot 2009-11)

User Instructions

English version of documentation (pdf form):
http://stasoft.net/files/netshe/NETSHe_eng.pdf
http://ubnt.com/downloads/RouterStationChallenge/NETSHe/NETSHe_eng.pdf (snapshot - 2009/11)

Russian version of documentation (pdf form):
http://stasoft.net/files/netshe/NETSHe.pdf
http://ubnt.com/downloads/RouterStationChallenge/NETSHe/NETSHe.pdf (snapshot - 2009/11)

English version of documentation (html form):
http://stasoft.net/files/netshe/netshe.eng.zip
http://ubnt.com/downloads/RouterStationChallenge/NETSHe/NETSHe.html
http://ubnt.com/downloads/RouterStationChallenge/NETSHe/netshe.eng.zip (snapshot - 2009/11)

Building

Note: This document describes only the firmware assembly steps, which differ from standard firmware assembly procedure for OpenWRT Kamikaze.

For standard firmware image assembly procedures please refer to Ubiquity web sites (http://wiki.ubnt.com/wiki/index.php/RouterStation_OpenWRT_Setup_Guide http://www.ubnt.com/forum/showthread.php?p=54837) and OpenWRT web site (http://wiki.openwrt.org/doc/howto/buildroot https://dev.openwrt.org/wiki/GetSource).
We proceed from the assumption, that you are aware of the manner and procedure of firmware assembly based on OpenWRT tools.
Further all references to filesystem will be made with regards to Kamikaze root directory.

1. Create directory for OpenWRT Kamikaze and change current directory (e. g. cd ~; mkdir kamikaze; cd kamikaze)
2. Download OpenWRT source code (svn co svn://svn.openwrt.org/openwrt/trunk)
3. Download source code of OpenWRT packages (svn co svn://svn.openwrt.org/packages)
4. Update source tree (svn up)
5. Download archives from http://stasoft.net/files/netshe-openwrt-build.tar.bz2 and http://stasoft.net/files/php5-openwrt-build.tar.bz2
6. Besides, you can also download a configuration file for image assembly http://stasoft.net/files/ubnt-rs-openwrt-config. This file was created for a development version of OpenWRT and represents a slice at a given date. You may have troubles with current or future slices of development version. Use this file only as a sample.
7. Ignore this step if you have not completed step 6. Otherwise, copy downloaded file to kamikaze root under the name .config (e. g. cp ~/ubnt-rs-openwrt-config ~/kamikaze/trunk/.config)
8. Remove php5 directory in packages/lang directory (e. g. rm -rf ~/kamikaze/packages/php5)
9. Unpack archive php5-openwrt-build.tar.bz2 to directory packages/lang (e. g. cd ~/kamikaze/packages/lang; tar -xjf ~/php5-openwrt-build.tar.bz2).
10. Make sure that directory packages/lang/php5 exists.
11. Unpack archive netshe-openwrt-build.tar.bz2 to directory packages/admin (e. g. cd ~/kamikaze/packages/admin; tar -xjf ~/netshe-openwrt-build.tar.bz2).
12. Make sure that directory packages/admin/netshe exists.
13. Change directory to kamikaze (e. g. cd ~/kamikaze)
14. Create a symbolic link from trunk/package to directory packages (e. g. ln -sf packages ~/kamikaze/trunk/package/packages)
15. Change directory to trunk (e. g. cd ~/kamikaze/trunk)
16. Type in make menuconfig
17. Choose Atheros AR71XX/AR7240/AR913x from Target System menu (if you don’t use our config file).
18. Choose Ubiquity RouterStation from Target System menu (if you don’t use our config file).
19. In Adminisration menu put asterisk at item netshe (if you don’t use our config file).
20. Choose additional software packages and build options.
21. Type in and execute make to assembly image.
22. Flash assembled software to device as described below.

Navigation

RouterStationChallenge NETSHe

From Ubiquiti Wiki

Contents

NETSHe

Overview

RouterStation Image(s)

User Instructions

Building

Source Code

Developer Instructions

Links and Author Contact Information