mini HOWTO set up Hotcakes

Dirk van der Walt

2007-05-14

Revision History
Revision 0.12007-05-14Revised by: DK
first draft
Revision 0.22007-05-23Revised by: DK
first release
Revision 0.32007-05-25Revised by: DK
Fix typo, add Feisty appendix
Revision 0.42007-05-30Revised by: DK
Add warning about sql_conter position (TX Troy :)!)
Revision 0.52007-06-04Revised by: DK
Add links to sample freeRADIUS files add Appendix for PHP Login script
Revision 0.62007-08-20Revised by: DK
Add documentation on the rlm Perl script and graphs. Updated info on versions and locations of software.
Revision 0.72007-11-05Revised by: DK
Major rework to feature Feisty Fawn, new appendix and quick FreeRADIUS setup.

Quick setup of a Hotcakes 802.11 hotspot.


Table of Contents
1. Introduction
1.1. Feedback
1.2. What you will need.
2. Watch Out!
2.1. Ubuntu Gutsy Gibbon (7.10)
2.2. Free Radius version 1.1.7
2.3. Perl Linker problems
3. Configure Hotcakes as a LAMP Application
3.1. Installing the required packages
3.2. Installing CakePHP
3.3. Installing Hotcakes
3.4. Configure the database
3.5. Log Into Hotcakes
4. Configure Free Radius to use Hotcakes
4.1. Compiling Free Radius
4.2. Configure Free Radius the quick way
4.3. Specifying the paths used by Hotcakes
4.4. Testing the waters
4.5. Making things permanent
5. Configure ChilliSpot to use Free Radius
5.1. Description of ChilliSpot
5.2. Compiling ChilliSpot
5.2.1. The state of ChilliSpot
5.3. Setup SSL on Apache
5.4. Configure the Login Page
5.5. Routing and the Firewall
5.6. Setup chilli's configuration
5.7. Startup script for ChilliSpot
6. See Everything in action.
A. PHP login script Appendix
A.1. GoLogin (modified)
B. Easy URL's using a local DNS
B.1. Why a local DNS
B.1.1. How it works
C. Translating Hotcakes to your native tongue
C.1. Multi Language support

1. Introduction

This document should be used when you want to get a Hotcakes/ChilliSpot 802.11 hotspot up and running as soon as possible.

It is kept terse and to the point. Please refer to the other documents on Hotcakes in order to gain better knowledge of the setup once you have it up and running.

The document will be divided into parts. Once you completed a part, and are sure it works as intended, you can continue to the next one.

1.1. Feedback

Feedback is most certainly welcome for this document. Send your additions, comments and criticisms to the following email address : .

1.2. What you will need.

Table 1. Items required to setup the 802.11 hotspot

ItemComment
A modern GNU Linux MachineThis document will use Ubuntu Feisty Fawn (7.04)
Two Ethernet network cardsOne network card connects to the Internet. The other to an Access Point
A WiFi Access PointThis can be any type. NOT running a DHCP server.

Please refer to the following diagram to see how everything should fit together.

Figure 1. Hardware Setup.

Once you collected the above ingredients, you can jump right in.