Changes between Version 3 and Version 4 of doc/install/openwrt

Show
Ignore:
Timestamp:
02/22/06 10:46:59 (13 years ago)
Author:
max-horvath
Comment:

Added information about correct firewalling

Legend:

Unmodified
Added
Removed
Modified
  • doc/install/openwrt

    v3 v4  
    3030Remember when you followed the OpenWRT building instructions ? Without knowing it, you already cross-compiled stuff!  You used your desktop to cross-compile an entire operating system for the MIPS architecture which resulted in one compressed firmware image you installed on your router. 
    3131 
    32 === Compiling a MIPS-friendly WiFiDog === 
     32=== Compiling a MIPS-friendly !WiFiDog === 
    3333 
    3434 1. Download the latest [http://sourceforge.net/projects/wifidog WiFiDog tarball from sourceforge]. 
     
    4141You're done.  If all is well you should now have a new file named ''wifidog_1.1.0_mipsel.ipk'' (version number may be different depending on the tarball you downloaded). 
    4242 
    43 === Getting the new MIPS-friendly WiFiDog onto the router === 
     43=== Getting the new MIPS-friendly !WiFiDog onto the router === 
    4444 
    4545The .ipk is a data file for the simple "ipkg/i-Package" package manager already on your router.  All that's needed now is to copy that file onto your router.  If you have installed the ''dropbear'' SSH daemon package on your router you can use ''scp'' on your desktop to copy the .ipk file to the router.  Otherwise copy that file to any web server you have access to, then use ''wget'' on the router to download the file from the web server. 
     
    5858== Configuration, Running and Testing == 
    5959 
    60 Same as the earlier section in a non-WRT54G environment 
     60=== Firewall rules === 
    6161 
    62 == The intricate link between WiFiDog and OpenWRT == 
     62If you set up your OpenWrt-powered router with a bridged network interface (default), the current firewall rules of !OpenWrt do not permit to block all outgoing TCP/UDP ports except port 80 until a user has authenticated via WiFiDog's login page. 
     63 
     64You are going to have to disable forwarding from the bridge interface to the wan interface: 
     65{{{ 
     66# The following have been commented out for WiFiDog to work 
     67# iptables -A FORWARD -i br0 -o br0 -j ACCEPT 
     68# iptables -A FORWARD -i $LAN -o $WAN -j ACCEPT 
     69}}} 
     70 
     71=== What else? === 
     72 
     73Well, it's the same as the earlier section in a non-WRT54G environment. 
     74 
     75== The intricate link between !WiFiDog and OpenWRT == 
    6376 
    6477Repeat after me: 
    6578 
    66 '''A WiFiDog RUNNING ON AN OpenWRT INSTALLATION MUST HAVE BEEN COMPILED AGAINST THE SAME OpenWRT BUILDROOT USED TO CREATE THAT INSTALLATION''' 
     79'''A !WiFiDog RUNNING ON AN OpenWRT INSTALLATION MUST HAVE BEEN COMPILED AGAINST THE SAME OpenWRT BUILDROOT USED TO CREATE THAT INSTALLATION''' 
    6780 
    6881What does that mean ? 
    6982 
    70  1. If you downloaded and compiled OpenWRT yourself, download and compile WiFiDog yourself against the same buildroot - Do not use someone else's pre-compiled WiFiDog 
     83 1. If you downloaded and compiled OpenWRT yourself, download and compile !WiFiDog yourself against the same buildroot - Do not use someone else's pre-compiled !WiFiDog 
    7184 1. If you downloaded a pre-compiled OpenWRT firmware image: 
    72   1. Ask the person who built it to compile WiFiDog for you against the same buildroot 
    73   1. Or ask them for a copy of their OpenWRT buildroot so you may compile WiFiDog against it 
     85  1. Ask the person who built it to compile !WiFiDog for you against the same buildroot 
     86  1. Or ask them for a copy of their OpenWRT buildroot so you may compile !WiFiDog against it 
    7487 
    75 == I am not comfortable with linux and don't know how to do all this compiling stuff.  Is there an easier way for me to get the WiFiDog client running on a Linksys WRT54G ? == 
     88== I am not comfortable with linux and don't know how to do all this compiling stuff.  Is there an easier way for me to get the !WiFiDog client running on a Linksys WRT54G ? == 
    7689 
    77 You can use an OpenWRT and WiFiDog compiled by someone else.  They must be compiled by the same person against the same OpenWRT buildroot. 
     90You can use an OpenWRT and !WiFiDog compiled by someone else.  They must be compiled by the same person against the same OpenWRT buildroot. 
    7891 
    79 IleSansFil makes it's own pair of OpenWRT images and WiFiDog .ipk compiled files available to the public: 
    80  * You can download a pre-compiled OpenWRT firmware image [http://www.ilesansfil.org/dist/openwrt/ here] UPDATE PLEASE 
    81  * And you can download a compatible WiFiDog .ipk file [http://www.ilesansfil.org/dist/wifidog/ here] 
     92!IleSansFil makes it's own pair of OpenWRT images and !WiFiDog .ipk compiled files available to the public: 
     93 * You can download a pre-compiled OpenWRT firmware image [http://www.ilesansfil.org/dist/openwrt/ here] '''UPDATE PLEASE''' 
     94 * And you can download a compatible !WiFiDog .ipk file [http://www.ilesansfil.org/dist/wifidog/ here] 
    8295 
    8396Look in the [http://www.openwrt.org/ OpenWRT] site for instructions on how to re-flash your router with the firmware image (skip any download/building instructions). 
    8497 
    85 Then follow the above installation instructions for installing the WiFiDog .ipk file into the OpenWRT-flashed router. 
     98Then follow the above installation instructions for installing the !WiFiDog .ipk file into the OpenWRT-flashed router. 
    8699 
    87100Please note that the above saves you from the knowledge and time needed to compile and produced these binary files.  It is however no magical cure for linux illiteracy.  You need to be proficient enough in a unix environment to be able to telnet/ssh into the router and perform the outlined installation and configuration tasks.  If you do not feel comfortable doing this we advise you consult with someone who is proficient in linux and networking.