<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><title></title>
<META http-equiv=Content-Type content="text/html; charset=iso-8859-15">
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
body {
margin: 5px 5px 5px 5px;
background-color: #ffffff;
}
/* ---------- Text Styles ---------- */
hr { color: #000000}
body, table /* Normal text */
{
font-size: 9pt;
font-family: 'Courier New';
font-style: normal;
font-weight: normal;
color: #000000;
text-decoration: none;
}
span.rvts1 /* Heading */
{
font-size: 10pt;
font-family: 'Arial';
font-weight: bold;
color: #0000ff;
}
span.rvts2 /* Subheading */
{
font-size: 10pt;
font-family: 'Arial';
font-weight: bold;
color: #000080;
}
span.rvts3 /* Keywords */
{
font-size: 10pt;
font-family: 'Arial';
font-style: italic;
color: #800000;
}
a.rvts4, span.rvts4 /* Jump 1 */
{
font-size: 10pt;
font-family: 'Arial';
color: #008000;
text-decoration: underline;
}
a.rvts5, span.rvts5 /* Jump 2 */
{
font-size: 10pt;
font-family: 'Arial';
color: #008000;
text-decoration: underline;
}
span.rvts6
{
font-size: 11pt;
font-family: 'tahoma';
font-weight: bold;
color: #ffffff;
background-color: #0000ff;
}
span.rvts7
{
font-family: 'arial';
}
span.rvts8
{
font-size: 11pt;
font-family: 'tahoma';
}
a.rvts9, span.rvts9
{
font-family: 'arial';
color: #0000ff;
text-decoration: underline;
}
span.rvts10
{
font-size: 8pt;
font-family: 'arial';
font-style: italic;
color: #c0c0c0;
}
a.rvts11, span.rvts11
{
font-size: 8pt;
font-family: 'arial';
color: #0000ff;
text-decoration: underline;
}
span.rvts12
{
font-size: 13pt;
}
a.rvts13, span.rvts13
{
font-size: 13pt;
color: #0000ff;
text-decoration: underline;
}
a.rvts14, span.rvts14
{
color: #0000ff;
text-decoration: underline;
}
span.rvts15
{
font-size: 18pt;
font-family: 'times new roman';
font-weight: bold;
}
span.rvts16
{
font-size: 13pt;
font-family: 'times new roman';
}
/* ---------- Para Styles ---------- */
p,ul,ol /* Paragraph Style */
{
text-align: left;
text-indent: 0px;
padding: 0px 0px 0px 0px;
margin: 0px 0px 0px 0px;
}
.rvps1 /* Centered */
{
text-align: center;
}
--></style>
</head>
<body>
<p>I'm currently working on a FC5/FC6 install document. (Auth Server only. I'm doing the Gateway on a Linksys WRT-54GL and OpenWRT or Coova)</p>
<p><br></p>
<p>I've gotten it working just fine.</p>
<p>Here's what I've found so far.</p>
<p><br></p>
<p>(I've used FC5 and I'm currently half way through a FC6 install.)</p>
<p><br></p>
<p>Install FC5, along with Postgresql and the dev tools, Webserver - also I usually install Gnome and Firefox etc - other than that I keep the install as small as I can. (I don't recall exactly what my install opts were - but the dev environment is usually pretty important.)</p>
<p><br></p>
<p>As an initial try, don't turn on any firewalling etc.</p>
<p><br></p>
<p>Then I make sure I either have or update the following. (From a console prompt and a live internet connection.)</p>
<p><br></p>
<p>yum install php</p>
<p>yum install postgresql*</p>
<p>yum install php-Smarty*</p>
<p>yum install php-devel</p>
<p>yum install php-mhash </p>
<p>yum install mcrypt </p>
<p>yum install php-mcrypt</p>
<p>yum install php-pgsql</p>
<p>yum install php-xmlrpc</p>
<p><br></p>
<p>yum install php-mbstring</p>
<p>yum install php-pear</p>
<p>yum install php-xml</p>
<p><br></p>
<p>pecl install radius</p>
<p>pear install Auth_RADIUS</p>
<p>pear install Crypt_CHAP</p>
<p><br></p>
<p>---</p>
<p>If you didn't install Apache server, then</p>
<p>yum install httpd</p>
<p>---</p>
<p><br></p>
<p>Edit the pg_hba.conf file</p>
<p>stop/restart postgres (See the "common errors" document on the WifiDog site for the edit to make to the Postgresql security - it's at the bottom, last I looked.</p>
<p><br></p>
<p>---</p>
<p>SVN down the WifiDoc Auth build.</p>
<p>(Assumes FC5 or 6 for proper directories!)</p>
<p><br></p>
<p>cd /var/www/html</p>
<p>mkdir -p /var/www/html/wifidog</p>
<p>svn checkout https://dev.wifidog.org/svn/trunk/wifidog-auth wifidog</p>
<p>(This will svn the project into a directory called /var/www/html/wifidog)</p>
<p><br></p>
<p>---</p>
<p>su to postgresql (In FC5 it's the user that has the ability to create Postgresql users and DB's)</p>
<p><br></p>
<p>createuser wifidog --pwprompt</p>
<p>pass: babykins55</p>
<p><br></p>
<p>createdb wifidog --encoding=UTF-8 --owner=wifidog</p>
<p><br></p>
<p>---</p>
<p>Get the "password" for install...as shown in the on-screen install.php docs</p>
<p>cat/tmp/dog_cookie.txt</p>
<p><br></p>
<p>---</p>
<p>Now run the install, by doing something like this... (From either another client, or from Firefox on the Auth Server itself.)</p>
<p>http://ip_or_hostname_of_auth_server/wifidog/install.php</p>
<p><br></p>
<p>---</p>
<p>You should be able to walk through the install properly. </p>
<p><br></p>
<p>You'll have to chown and chmod a few directories, but it will give you the exact commands needed to run in a console window. Again, follow the on-screen directions.</p>
<p><br></p>
<p>There is an error, I think with Smarty when it tries to copy the files over, as they're already there. I think it's safe to ignore the problem. (Perhaps someone more exp. can comment...)</p>
<p><br></p>
<p>===</p>
<p>Notes about postgresql security, if you didn't find them above...</p>
<p>(From the common errors web-page...</p>
<p><br></p>
<p><br></p>
<p>Errors running the install.php script. (This follows the "Database access configuration" page)</p>
<p>With error logging turned off, you'll get a blank page... and the install script simply "hangs." (The next steps help confirm that this is the "right" solution.) </p>
<p>If you turn on error logging by: </p>
<p>here's how to turn on php error message display so you can debug the problem.</p>
<p>In php.ini (in FC5 most likely located at /etc/php.ini) enable the </p>
<p>error_reporting = E_ALL </p>
<p>display_errors = On</p>
<p><br></p>
<p>This will display any error encounter in your browser </p>
<p><br></p>
<p>Anyway, the error return you get (when you re-run the "install.php" and get to the "hang" screen) will be something like this </p>
<p>Postgresql database connection :Warning: pg_connect() [function.pg-connect]: Unable to connect to PostgreSQL server: FATAL: Ident authentication failed for user "wifidog" in /var/www/html/wifidog/install.php on line 10</p>
<p><br></p>
<p>The problem is related to PostgreSQL security. </p>
<p>One ideally ought to study up on the security system employed by PGSQL, but this will also fix the problem. Be aware that it might create security issues on different systems depending on your database configuration and such. (Again, learning about the security model will help make sure your box stays secure!) </p>
<p><br></p>
<p>Edit the pg_hba.conf file (On different distro's there may be several versions of this file in different locations. Make sure you edit the correct one!) </p>
<p>#TYPE DATABASE USER IP-ADDRESS SUBNET MASK METHOD</p>
<p>host wifidog wifidog 192.168.0.11 255.255.255.0 md</p>
<p>Where the IP address matches the IP address of the machine connecting to the PGSQL server. (127.0.0.1 works if the PGSQL server is on the same box as the web-server that's running WiFiDOG Auth module.) </p>
<p><br></p>
<p>Restart the PostgreSQL server to load the new settings. (I use /etc/init.d/postgresql restart - though that's probably not the best way - it does work however.) </p>
<p>---</p>
<p>(That might come out a big ugly. If so, refer to the web-page, here:</p>
<p>http://dev.wifidog.org/wiki/doc/auth-server/commonErrors</p>
<p><br></p>
<p>===</p>
<p>That should get you through the install.</p>
<p><br></p>
<p>(I had an problem where I had to edit the /var/www/html/wifidog/config.php and point at "real" path for WifiDog. (Bug?))</p>
<p>If you get a page without graphics, this is likely the problem.</p>
<p><br></p>
<p>---</p>
<p>You should then be able to connect to the auth-server by:</p>
<p>http://ip_or_hostname_of_auth_server/wifidog/login</p>
<p>(I think that's right. From memory...)</p>
<p>---</p>
<p><br></p>
<p>Then you'll have the gateway side to configure, but IMO that's quite a bit easier.</p>
<p><br></p>
<p>Hope that's a start.</p>
<p><br></p>
<p>(I'm glad to answer more questions, but I only have a rough draft document currently and am out of time.)
<br>Good luck!</p>
<p><br></p>
<p>-Greg</p>
</body></html>