handbook,.

EasyHotspot is a hotspot billing system, based on OpenSource Technology. EasyHotspot use
Linux as it's operating system, FreeRadius as RADIUS server and PHP MySQL APACHE
 trio for LAMP architecture.
EasyHotspot providing pre-configured billing system with web based administration that
readily get action with very minimum effort.
2. Hardware Recruitments
To build a hotspot system using EasyHotspot, you need :
1. PC with minimal spec :
■ Pentium 3 or equal
■ 256 MB RAM
■ 5 GB Free Space HDD
■ 2 network interface (LAN CARD)
■ 1 Wireless Access Point(you don't need wireless router feature but a Wireless AP)
■ Switch/Hub (optional, only for wired user)
3. Installing EasyHotspot
Installing Easyhotspot is easy, just boot up your PC using EasyHotspot CD, and then follow the
instructions. Since EasyHotspot using Xubuntu distro, you can see the installation details at
Xubuntu Documentation.
4. Configuring EasyHotspot
1. Editing Company Info
Easyhotspot Comes with Company Info editable feature. To edit the company info, please
edit the /var/www/system/application/config/easyhotspot.php . Edit the entries according to
your real condition.
2. Setting Language
For now EasyHotspot only support two language (English and Bahasa), you could add your
language by helping us translate it to another language (please send your email to me).
edit the /var/www/system/application/config/config.php
$config['language'] = "english";
3. Setting Homepage
By default, EasyHotspot is only accessible from the server itself (localhost), if you want to
remote your billing system you could tell EasyHotspot to change the homepage from
locahost to your accessible IP Address.
Edit /var/www/system/application/config/config.php, find $config['base_url'] line.
example :
$config['base_url'] = "http://192.168.182.1/";
192.168.182.1 is your EasyHotspot IP address4. Patching (version 0.1 only)
Some people noticed that EasyHotspot is not disconnected expired users when they reached
their limit (packet/octet based). It's happenned because FreeRadius didn't know what to do if
they reached their limit.
Actually there is some instructions written in FreeRadius configuration file, but somehow I
forgot to enable it. To fix it just enable the instructions and save it. This is how to do it:
edit /etc/freeradius/radiusd.conf file and remove # mark on line
5. Setting Your Network
Make sure that you have two interface named eth0 and eth1, if you have eth2, eth3 and so
on please consult the troubleshoot section.
1. internet
Set your eth0 as your internet connection source. It can be dynamic or static. If you have
a dynamic connection, just simply plug in the ethernet cable to eth0 interface, or if you
have a static connection you can configure it by clicking the network icon on system
tray and hit manual configuration.
2. distribution area
eth1 will act as distribution interface. You don't have to configure this interface at all.
Just connect to AP or Switch hub and then let your client connect . Make sure that you
have disabled DHCP, Encryption, and Router feature in your hotspot (if exist).
5. Using EasyHotspot
EasyHotspot comes with preconfigured hotspot system and a web interface to manage all stuffs
that related to bililng activity, such as account generation, invoice, billing plan, etc.
Actor in EasyHotspot web interface consist into :
■ admin : this user handle billing plan, price and system configuration.
■ cashier : this user handle business area, user generation, invoice, view stats
Admin Activity :
All of admin activity needs admin level permission.
1. Creating BillingPlan
BillingPlan is like a  template for your voucher. What kind of voucher you want to
generate ? The billing you have created then will be used by the cashier to generate the
vouchers.
2. Setting PostPaid Price
3. Managing cashier account
You can assign/add/edit/delete other people to be a cashier
Cashier Activity :
4. Generate Voucher
Voucher is a prepaid billing system. Voucher could be generated from BillingPlan that
admin have created before. Usually this method used by Cafe, Mall or any other place that
people usually mobile.
5. Postpaid account
Postpaid account is a postpaid billing system. The first step to use this feature, the cashiers
have to create postpaid user, print the voucher and then give it to clients. If the clients
decide to stop, the cashier will close and print invoice by clicking the detail of clients usage.
If the account closed this account would never be used again
6. Important things for your customers :
1. How to Connect the AP / Wired network
Connect your clients by choosing your AP or Switch, in this step EasyHotspot will give
your clients an IP Address.
2. How to log in using printed voucher
To login you need to open the browser and surf to the internet, before you see the page,
you will be prompted to a login page (accept all certificate before).
Enter user name and password that printed on your voucher. Enjoy your surfing =)
3. How to logout
Simply click logout and you will logged out. If you accidentally close the browser,
navigate to : http://192.168.182.1:9220/prelogin
6. Tips
1. Changing interface name
I highly recommend you to make sure that you have 2 interface named eth0 and eth1. eth0
will be act as an internet line and eth1 as a distribution interface. If your interfaces name are
not eth0 and eth1 you should change it.
This is how to do it :
edit the /etc/udev/rules.d/70-persistent-net.rules file
example :
from
SUBSYSTEM=="net", DRIVERS=="?*",
ATTRS{address}=="00:16:d3:5e:8f:f3", NAME="eth3" # PCI device
0x14e4:0x4311 (bcm43xx) SUBSYSTEM=="net", DRIVERS=="?*",
ATTRS{address}=="00:19:7e:a5:45:84", NAME="eth4"
to
SUBSYSTEM=="net", DRIVERS=="?*", ATTRS{address}=="00:16:d3:5e:
8f:f3", NAME="eth0"
# PCI device 0x14e4:0x4311 (bcm43xx)
SUBSYSTEM=="net", DRIVERS=="?*",
ATTRS{address}=="00:19:7e:a5:45:84", NAME="eth1"
2. Changing MySQL default password
It would be better to change the default root and easyhotspot user password. You can search
the details of how doing that at mysql documentation. After that don't forget to edit the /var/www/system/application/config/database.php