Changes between Version 3 and Version 4 of FAQ

Show
Ignore:
Timestamp:
01/22/06 16:18:46 (14 years ago)
Author:
mina
Comment:

Expanded on the WRT54G section from the old wiki

Legend:

Unmodified
Added
Removed
Modified
  • FAQ

    v3 v4  
    133133  In summary: '''Make sure EVERYTHING works first'''. 
    134134 
     135== Installation == 
     136 
     137=== Introduction === 
     138 
     139Installation of the client on the WRT54G is a bit tricky.  The space limitations on the device mean there is no compiler in the OpenWRT operating system.  That means that you must compile the client on an external machine then transfer the compiled form onto the router. 
     140 
     141To complicate things more, if you compile your client regularly on a standard x86 desktop the produced binary will not run on the router due to the different type of processor (MIPS) on that router. 
     142 
     143What is needed is called cross-compilation, In that scenario you use an architecture (such as your x86 desktop) to produce binaries explicitly designed to run on a different architecture (your MIPS router). 
     144 
     145The above was the bad news since it makes things sound complicated.  The good news is that it's not too complicated and we've built scripts to make this a snap for you.  As a matter of fact, you've already done this before! 
     146 
     147Remember 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. 
     148 
     149=== Compiling a MIPS-friendly WiFiDog === 
     150 
     151 1. Download the latest [http://sourceforge.net/projects/wifidog WiFiDog tarball from sourceforge]. 
     152 1. Uncompress the tarball, enter the directory 
     153 1. Run the following, replacing ''/usr/local/openwrt/'' with wherever you unpacked the OpenWRT tarball earlier: 
     154{{{ 
     155ipkg/rules BUILDROOT=/usr/local/openwrt/ 
     156}}} 
     157 
     158You'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). 
     159 
     160=== Getting the new MIPS-friendly WiFiDog onto the router === 
     161 
     162The .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. 
     163 
     164Either way, place the file in the ''/tmp/'' directory on the router. 
     165 
     166=== Actual installation === 
     167 
     168Once you have the .ipk file on the router, use this command to install it: 
     169{{{ 
     170ipkg install /tmp/wifidog_1.1.0_mipsel.ipk 
     171}}} 
     172 
     173Once that is successful delete the .ipk file from ''/tmp/'' to free the occupied memory. 
     174 
     175== Configuration, Running and Testing == 
     176 
     177Same as the earlier section in a non-WRT54G environment 
     178 
     179== The intricate link between WiFiDog and OpenWRT == 
     180 
     181Repeat after me: 
     182 
     183'''A WiFiDog RUNNING ON AN OpenWRT INSTALLATION MUST HAVE BEEN COMPILED AGAINST THE SAME OpenWRT BUILDROOT USED TO CREATE THAT INSTALLATION''' 
     184 
     185What does that mean ? 
     186 
     187 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 
     188 1. If you downloaded a pre-compiled OpenWRT firmware image: 
     189  1. Ask the person who built it to compile WiFiDog for you against the same buildroot 
     190  1. Or ask them for a copy of their OpenWRT buildroot so you may compile WiFiDog against it 
     191 
     192== 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 ? == 
     193 
     194You can use an OpenWRT and WiFiDog compiled by someone else.  They must be compiled by the same person against the same OpenWRT buildroot. 
     195 
     196IleSansFil makes it's own pair of OpenWRT images and WiFiDog .ipk compiled files available to the public: 
     197 * You can download a pre-compiled OpenWRT firmware image [http://www.ilesansfil.org/dist/openwrt/ here] 
     198 * And you can download a compatible WiFiDog .ipk file [http://www.ilesansfil.org/dist/wifidog/ here] 
     199 
     200Look 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). 
     201 
     202Then follow the above installation instructions for installing the WiFiDog .ipk file into the OpenWRT-flashed router. 
     203 
     204Please 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. 
     205 
    135206= Auth-Server FAQ = 
    136207