Changes between Initial Version and Version 1 of doc/install/debian

01/23/06 00:46:57 (15 years ago)



  • doc/install/debian

    v1 v1  
     1= Client installation on a Debian based PC = 
     3 * Install two network interface cards into your PC. One will be connected to your internal network or internet connection, and the other will be connected to a wireless router. 
     5 * Install Debian minimal install. 
     7 * Run '''apt-get update''' and '''apt-get upgrade''' to ensure that your installation is up to date. 
     9 * Ensure that the '''/etc/network/interfaces''' file is configured correctly and that both network interfaces are configured - for example: 
     12iface eth0 inet static 
     13             address 
     14             netmask 
     15             gateway 
     16             dns-nameservers 
     18iface eth1 inet dhcp 
     21You should visit for a comprehensive network configuration tutorial. 
     23 * You now need to bridge '''eth0''' and '''eth1''' so that your wireless clients can connect to the internet through your internet connection. 
     25To accomplish this you will need to ensure that you have a proxy script in place using iptables (much like internet connection sharing if you come from a Windows background). 
     27If you are using Debian then you're in luck. You will find a full tutorial for setting up IPTABLES for NAT Linux Proxy Server at Just follow the rules there, test to ensure that you can connect to the internet via your wireless interface with the rules in place, and then and only then try your wifidog client installation.  Don't forget to read the tutorial all the way through, and MAKE SURE THAT YOU CAN GET AN INTERNET CONNECTION THROUGH THE WIRELESS INTERFACE NOW! 
     29 * Navigate to '''/usr/src/''' and grab a copy of wifidog '''wget URL-HERE''' You then need to decompress it '''gunzip WIFIDOG-FILE''' then untar '''tar -xvf yourcopyofwifidog'''. 
     31 * Go to the place wifidog decompressed to and run: 
     36make install 
     39If you get any errors check to ensure that you are running the latest compiler. 
     41 * Move '''wifidog.conf''' to '''/etc/''' : '''mv wifidog.conf /etc/''' and edit the options there (the file is commented so you know what to change. 
     43 * Type '''wifidog -f -d 7''' to run wifidog in the foreground with full debugging.  If everything is working OK you should see lots of output and be able to get to your portal screen.  
     45= DHCP = 
     47If you want to have a little more power over your DHCP settings, you may want to consider running DHCP from your wifidog gateway box rather than your wireless access point.  You can do this on Debian by installing DHCPD. 
     49First of all to get DHCP server you need to run '''apt-get install dhcpd''' 
     51When you have the DHCP server you need to set it up. First of all run the following command: 
     54/etc/init.d/dhcp stop 
     57This will stop the DHCP server so that you can change the configuration scripts. You will need to set the interface card that you wish the DHCP server to operate the service on, and give it a range of IP addresses and networking information to give to client PC's. 
     59To change the interface you want the DHCP service to run on you need to edit '''/etc/init.d/dhcp''' and input your network interface here (the standard value may be OK): 
     62# Defaults 
     66To change the network information issued via your DHCP server you need to edit the '''/etc/dhcpd.conf''' file.  I've included the one I use as an example for you.  Read on for an explanation of the different components: 
     69default-lease-time 10800; 
     70max-lease-time 28800; 
     72subnet netmask { 
     74option routers; 
     75option domain-name-servers; 
     80 * default-lease-time = the default time that your client is issued an IP address for. 
     82 * max-lease-time = the maximum time that your client is issued an IP address for. 
     84 * subnet = the subnet of the IP range you are issuing the client, in this case is the subnet of (take the last number off your range and change to 0) 
     86 * netmask = the mask applied to your subnet range giving the available number of IP address. In this case allows only the last section of the IP address to be changed. 
     88 * range = the range of IP addresses you want clients to be able to get from dhcp. 
     90 * option routers = the network interface card in your gateway that is running dhcp. 
     92 * option domain-name-servers = your DNS server (perhaps supplied by your ISP?) 
     94When you have fiddled with the options, and have everything up and running then you will want to restart the DHCP: 
     97/etc/init.d/dhcp start 
     100That is DHCP set up now.  If you want to test it, either connect wirelessly via your bridged access point or connect a cross over cable to your gateway ethernet card and another PC to see what network details it gives you. 
     104= Auth Server = 
     106Installing the Auth Server on Debian Sarge - The rough and ready guide! 
     108 * Grab the minimal install of Debian Sarge and install to your server. Ensure that you have 'testing' sources added to your apt configuration file. 
     110 * Do an '''apt-get update''' and an '''apt-get upgrade''' to update your Debian installation and grab the latest sources to your apt cache. 
     112 * Install Apache2 '''apt-get install apache2''' 
     114 * Install PHP5 for Apache2 '''apt-get install libapache2-mod-php5''' 
     116 * Install PostgreSQL '''apt-get install postgresql-8.1''' 
     118 * Install PostgreSQL support for PHP5 '''apt-get install php5-pgsql''' 
     120 * If you wish to use PEAR, you can download the Debian package from the unstable branch by running '''apt-get install php-pear''' You will also need curl support for php which you can get by running '''apt-get install php5-curl''' 
     122 * Install [ Phlickr 0.2.5+ package] '''pear install Phlickr-0.2.5.tgz''' 
     124 * Download the latest copy of Wifidog Auth and untar it to your web directory.   
     126 * Run '''install.php''' and follow the guide there to get your Auth server going. If you get problems with missing modules like pgsql, then try restarting Apache '''apache2 -k restart''' a couple of times to ensure that the changes have applied properly. 
     128 * Edit '''config.php''' to suit your needs. 
     130More coming soon. 
     132= Configuring the postgresql database for wifidog installation = 
     134You will need to create a user and a database for your wifidog installation.  You need to make a note of the username and password of your user, and the name of your database.  You will need these during the install process.   
     136 * Creating a postgresql user  
     138Switch to the postgres database user account '''su postgres''' then type the following to set up your new user and create the database, make sure that you press enter after each line. Be careful when typing the code ensuring you don't miss the semicolons! 
     141$ psql 
     142-> CREATE USER wifidog 
     143-> WITH PASSWORD 'yourpassword'; 
     145-> CREATE DATABASE wifidog 
     146-> WITH OWNER wifidog; 
     149You should now be the proud owner of a wifidog database! To exit the pgsql command tool type '\q' To change back to the root user again type 'su root' and then your password when prompted.