HotSpot Manual - Cool Side Online Shop _Powered by CubeCart_ by jizhen1947

VIEWS: 24 PAGES: 32

									What is Cool Side HotSpot software ?

Cool Side HotSpot Software is Windows PC gateway software which enables control and
charging for Internet access using captive portal technology. This software is suitable for all
purposes where customers should get fast login to system without Client software installations.
Upon connecting to network (using wireless cards or UTP cable), customer will be prompted to
type username and password to get access to Internet. Customer will see their time and
bandwidth usage and will be able to refill their time when needed.

Before you begin, please make sure that you have configured Internet Connection Sharing on
your computer. This is basic sharing method which comes with Windows. However, you can
configure sharing in different way - using hardware or third party software.

If you need help with network setup, please check our network topology documents.

Main HotSpot control panel

Main panel shows the most important details of connected computers: IP and MAC address,
username, time left, quota (bandwidth left for use), bandwidth (data transfer per second) and
inactivity.
In case of unlimited time accounts, time left field will be represented as 'Unlimited'. If account
has unlimited bandwidth, quota and bandwidth fields will show '...'
Bottom status line shows number of connected computers and total bandwidth used (data transfer
per second).

If you prefer smaller computer icons, you can switch to compact view and display more
computers in screen. Option is located in HotSpot - Setup - Options page.

Inactivity field shows time left in seconds before automatic logoff occur. Inactivity is optional
for every account and default number of seconds can be specified in HotSpot - Network page. It's
suitable to turn off this option for account if unlimited accounts is going to be used.

From the main panel you can choose one of the options:
. 'Computers' - Displays computers and their current status (screenshot below)
. 'Accounts' - Configure and generate customer accounts
. 'Statistics' - Shows earnings and action log for certain time period
. 'Setup' - Administrator options used to configure HotSpot Software
. 'Logoff' - Lock HotSpot Software. HotSpot will control traffic even if employee or
administrator logoff.
Network setup

Please specify network interface which is used to connect local network to this computer. It is
assumed that this computer is configured as gateway and connected to internet.
. 'Network Interface' - Choose network interface which is used to connect computers to your
HotSpot
. 'Auto start HotSpot for selected interface' - Use it to automatically start HotSpot when
program started
. 'IP address' - Set IP address of your network interface
. 'Maximum users' - Set how many computers can connect your HotSpot
. 'Inactivity logout' - Automatically disconnect customer from HotSpot after specified time of
inactivity
. 'Start' - Start HotSpot control
. 'Stop' - Stop HotSpot control
. 'Save' - Save network settings
Accounts

Working with accounts is very easy. You can sell your services in advance and your customers
are obliged to come back. You can generate accounts for example, for 30 minutes, 1 hour, 5
hours and sell them to your customers. This time can be used when customer wants to. If there is
some time left on their account, it can be used some other time when customer comes in your
cafe.
When accounts are used, employee assistance is not needed. Customer will start session by
typing username and password in login fields, and end his session by typing 'LOGOUT' in
address bar in web browser. HotSpot Software is taking care of time calculations for you.
How to generate accounts ?

If you intend to generate multiple accounts at once, please define number of accounts to
generate. You will be able to select 'Print bulk accounts (3x7 on one sheet)' option which allows
you to prepare (generate and print) accounts in advance. When customer walks in, you can
simply sell paper ticket which contains username, password, time and bandwidth available.

In case that single account should be generated when needed, please put 1 as number of
accounts. Start number field will disappear and you will be able to make account like a customer
name.

These are the steps to generate accounts:
1. Type how many accounts you want to generate in the 'Number Of Accounts' field
2. Choose Pricing Plan
3. Change Bandwidth Quota in MB (download limit for this accounts). Bandwidth quota is
specified by pricing plan
4. Change Download and Upload Limit in KB/s (maximum download and upload speed).
Bandwidth Limit is specified by pricing plan
5. Set account expiration in days
6. Choose if you want to sell the accounts 'Sell Later' or 'Sell Now'
7. 'Enable Unlimited Access Time' - Check this option if you want to give unlimited time to
this customers
8. 'Enable Unlimited Bandwidth' - Use this option to enable unlimited download
9. Determine whether you want to print a receipt by checking 'Print bulk accounts (3x7 on one
sheet)' option
10. Press 'Generate code' button
11. Press 'Save' button and accounts will be stored in a database




Account Details

Account details page contains most important account properties and offers time top-up and
bandwidth settings.

. 'Username' - Account username
. 'Password' - Account Password. If you want to see account password uncheck Hide checkbox.
To change account password, type new password in password field and press Save button
. 'Quota' - Download limit for this account
. 'Download' - Limit download speed
. 'Upload' - Limit upload speed
. 'Daily quota' - Limit download quota per day.
. 'Daily time' - Limit internet access time per day. If user have left time on the account after
daily limit expire, user will be able to use the account next day.
. 'IP' - IP address of customers computer
. 'MAC' - MAC address of customers computer. This field is filled up upon customer login.
. 'Sell this account' - Use it to sell not sold accounts. Note that unsold accounts can't login to
your HotSpot
. 'Add Plan' - Use it to add more time and bandwidth quota to the account
. 'Print receipt' - Determine if you want to print receipt
. 'Stop' - Logout account from the HotSpot
. 'Save' - Save account details




Manage Account

. 'Expiration date' - Set new expiration date to the account
. 'Set new time' - Set new time to the account
. 'Active' - If account is not active, your customer can't login to your HotSpot
. 'Enable Unlimited Access Time' - This option gives you the ability to give unlimited access
time to customer
. 'Enable Unlimited Bandwidth' - This option enables unlimited download
. 'Only Allow Access' - If you set this option customer can login with his account only at
specified time (set From/To)
. 'Inactivity timeout' - Uncheck this option to disable inactivity timeout for this account
. 'Delete account' - Delete this account from database
. 'Show all' - Show the list of all accounts
. 'Save' - Any change on manage account page require to press Save button

If you intend to offer 1 day access limited to specified hours, you can set from and to time fields.
For example, 'From' 20:00 'To' 08:00 with expire date set to 1.
Accounts will be logged off automatically in 8:00 (8am).
Customer details

Fill the formular with the customer details: name, last name, e-mail address, address, city,
country, phone, date of birthday, ID card and credit card info
Account login

As soon as customer connects to your Access Point (or switch, router in case of wired
connectivity) and types any web URL address, login page will be displayed in browser. Login
page contains username and password fields, login button, 'Open Infobox' option, link for help
page, and sign up link if you have a license with credit card processing option.

To proceed, customer need to type username and password and to press Login button. To logout,
customer can type Logout in address bar and press Enter key. To get information about left time
and bandwidth quota on the account type Info in address bar.

Login page can be easily customized. You can use integrated page editor (if you're familiar with
html) located in HotSpot - Setup - Pages - Customize page. If you're satisfied with page layout
and just want to change logo (replace Cool Side HotSpot picture), please go to HotSpot - Setup -
Pages - Quick Change page and choose your own JPG picture.

If you want to completely change layout of the page, you can use any of the web page editors
(Dreamweaver, Front Page, etc). Please make sure that login fields, button and other elements
stays with the same name. Otherwise you might experience login problems.
Account pricing plans

Pricing plans page allows creation of packages you will offer to your customers. Each plan is
defined with price, time, bandwidth, description and days in which account expires.
If you have a license with credit card processing option, these plans will be available to customer
for automated order. In sign-up page customer will see only description of package and it's
recommended to put a highly descriptive plan information.

. 'Currency' - Set the currency used in Your country
. 'Price' - Set the price of the plan
. 'Time' - Set internet access time
. 'Quota (MB)' - Limit bandwidth quota
. 'Download' - Limit download speed in kb/s
. 'Upload' - Limit upload speed in kb/s
. 'Days xpire' - Use thi
. 'Description' - Describe the plan so you can find it easily when generate accounts
. 'Daily time' - Limit internet access time per day.
. 'Daily quota' - Limit bandwidth quota per day.
. 'Add' - Use this button to add pricing plan
. 'Remove' - Use this button to remove selected pricing plan
. 'Currency' - Type the symbol representing your currency
. 'Save' - Save pricing plan list




Examples how to create plans:

- 10$ pricing plan with 5 hours access time, bandwidth quota limited to 1GB and valid for 1
week




- 8$ pricing plan with unlimited access time, bandwidth quota limited to 2GB and valid for 2
days




- 12$ pricing plan with 10 hours access time, unlimited bandwidth quota and valid for 3 days
- 50$ pricing plan with unlimited access time, unlimited bandwidth quota and valid for 1 month




Taxes setup

This setup page offers highly configurable tax system. It's applied to time blocks and bandwidth
quota. You can setup 3 different taxes with desired name (VAT, GST...) and percent with 3
decimals.
For more complex tax systems you can choose tax on tax options.




Receipt setup

Receipt setup allows customization how the receipt will look like when it is printed out. Receipt
contains time used, price, subtotal, taxes. You can define Receipt Title, Receipt Header and
Receipt Footer.

. 'Choose Receipt Printer' - Choose printer you want to use for receipt printing
. 'POS printer compatibility mode' - Use this option if you have POS receipt printer
. 'Show Logo On Receipt' - Determine if you want printed logo on receipt printer
. 'Choose Logo' - Set your logo. Logo must be in *.BMP format
. 'Show Date And Time' - Set this option if you want printed date and time on receipt
. 'Save' - Save your receipt setup




Credit cards

Credit card processing option is very important if you want to automate your HotSpot. With this
option you can install unattended HotSpot gateway and our software will do all the job. Visitors
willing to use your services can sign up for username and password, choose a pricing plan and
pay with their credit card. Processing occurs within seconds and customers are able to continue
using your services.

Cool Side HotSpot offers different credit card processing gateways. Complete list is located here.

Authorize.Net : If you have an account with API, please use API Login ID as Merchant Login
and Transaction Key as merchant password.

PayPal: There are 2 PayPal processing options:
1. Website Payments Pro - available to US customers only
2. Express Checkout - available in other countries as described hre

Website Payments Pro payment is completed from our software and there is no need to transfer
customer to PayPal site. Processing is completed faster but this option requires PayPal account
with Payments Pro option enabled which is usually charged monthly by PayPal.

Express Checkout payment is initiated on HotSpot pages and completed on PayPal site.
Customer can use existing PayPal account for payment which significantly simplifies order, and
credit card payment is available for new customers who doesn't have PayPal account.

In order to use this option, your HotSpot need public IP (or IP of the network card connected on
the Internet side) so you can receive PayPal payment confirmations. These confirmations
activate account and stores payment details in the database. PayPal Express Checkout receipt can
be customized and it's located in Pages\ReceiptCheckout.htm file. If you're upgrading from 1.2
to 1.3 version, please delete signup2.htm page from Pages folder. This page will be recreated to
support Express Checkout.

After setting up, please check Site Whitelist page and make sure that:
api.paypal.com
paypal.com
www.paypal.com
www.paypalobjects.com
paypalssl.doubleclick.net
and HotSpot public IP are listed there.




        PayPal - Website Payments Pro                        PayPal - Express Checkout



In both cases, Website Payments Pro or Express Checkout, you'll need to provide PayPal API
username, API password and certificate file. Please follow these steps to obtain certificate file:
1. Login to merchant account
2. Click on Profile
3. Under Account Information, click on API Access
4. Click on Request API Credentials
5. Select API SSL client-side certificate
6. Select option "I agree to the API Certificate Terms of Use", click on Submit
7. You will get API Username and API Password. Type it in Cool Side HotSpot software
8. On the same page, please click on Download Certificate button
9. Save it in the same folder where software is installed. Make sure that correct path and name is
written in certificate path.

To make sure that you have correct certificate file, please open it and verify that it begins with:
-----BEGIN RSA PRIVATE KEY-----


Example of such file follows:

-----BEGIN RSA PRIVATE KEY-----
MIICXQIBAAKBgQDUzQ2GZNhURQrwfM2ccGyXeX7qVondfQE93yN/V3PHs8gxROzK
yUS95WcatQew9of+pPj1QSS9CRJ7xAxn5p/QI9z2kWG8dqraXtZvMwkxlfNb5NYJ
w0jDoQbPLXf1ecowgZqgYPa3rAd7mGgpcywjL5l5Ocnvz6o2cJsvyVuPRQIDAQAB
AoGBAMYTX8V61MoLwhT7dj9pfgq4smPZzVX251L6AoajlkeKlosVxvsywOOpRoFb
hB86OnfSg1F2I4Y5jZTadVm5F4LpFllPJ03vz64vA1HUq1LskE6ucSHwedu1S3vo
5OD93rw9a4LiCOuZ1MtdWxTtGTFIHqhJaIUppn9Tt93Va0pBAkEA85ks76vKIK3z
s4vPqEs1GilGbfvtz1nszHls0MEqKvIjV22gwA871JoQooQG62YtrluCGjbWAC6o
uiKFDhYS+QJBAN+ifpUCYO2PzFysvoNGmFynajLTfmgHMgRntexGnrZB3zyXZ+YU
4CL/cg1W/F2qDNUU53yRSRamVFYP+xc45a0CQFIwfFjhPXGJP5B0u7uspF4PTxQM
zFAJpzvWPECy6+dRi1sUQgiLG0TANpyerzb9YqxRc7QkjE/Dbmpe+0WlbQECQCML
dcaoDsRrilzjfR9ZSrsKSSwZ1G884WurTOjv0CNDg1Yda9y0XMNfQGIyxW1wHn6t
vfDZW5i/C+xIqNJkyikCQQCyRPWwhrL75c1Chkr5GUMy3HURC+VDG9SlM9kavX8p
VyAgIO2MBvZpSEjyxmo0cyKZ66J0wS4T2ukhmn+GbXwU
-----END RSA PRIVATE KEY-----
-----BEGIN CERTIFICATE-----
MIICiTCCAfKgAwIBAgICT04wDQYJKoZIhvcNAQEFBQAwgZ8xCzAJBgNVBAYTAlVT
MRMwEQYDVQQIEwpDYWxpZm9ybmlhMREwDwYDVQQHEwhTYW4gSm9zZTEVMB
MGA1UE
ChMMUGF5UGFsLCBJbmMuMRYwFAYDVQQLFA1zYW5kYm94X2NlcnRzMRswGQYD
VQQD
FBJzYW5kYm94X2NhbWVyY2hhcGkxHDAaBgkqhkiG9w0BCQEWDXJlQHBheXBhbC5j
b20wHhcNMDYwNjA0MDkwMzM2WhcNMTYwNjAxMDkwMzM2WjBlMSIwIAYDVQQD
FBl2
bGFkYW5fYXBpMS5hbnRhbWVkaWEuY29tMRIwEAYDVQQKEwlBbnRhbWVkaWExETA
P
BgNVBAcTCEJlbGdyYWRlMQswCQYDVQQIEwJBSzELMAkGA1UEBhMCVVMwgZ8wD
QYJ
KoZIhvcNAQEBBQADgY0AMIGJAoGBANTNDYZk2FRFCvB8zZxwbJd5fupWid19AT3f
I39Xc8ezyDFE7MrJRL3lZxq1B7D2h/6k+PVBJL0JEnvEDGfmn9Aj3PaRYbx2qtpe
1m8zCTGV81vk1gnDSMOhBs8td/V5yjCBmqBg9resB3uYaClzLCMvmXk5ye/PqjZw
my/JW49FAgMBAAGjDTALMAkGA1UdEwQCMAAwDQYJKoZIhvcNAQEFBQADgYEA
W16b
Sanio2VDdNLlRfu3oXGLU8mZ7kYA8AAPsNmvYdXWEkBmDKCCnnVCLxZzQFyONHR1
WVF78KvBmqYwRu5sYVOyer+0/ytHMLGCJTLBIxKH0hdgCcTkThjwy1UvGGIJ7ZFE
DJ0ApKu9IfkKQvkZXOLY130cFRW4i1eEvLzmMq8=
-----END CERTIFICATE--- --

SSL Certificate

SSL Certificate is used to encrypt communication between Cool Side HotSpot and customer
browser when user pay for the account with the credit card. In the HotSpot software - Setup -
Credit Cards - SSL Setup page set the location of Certificate File, Private Key File and CAcert
Root Certificate. Please note that default certificate file can be used.




Database operations

. 'Next Bill Number' - Set next bill number in statistic
. 'Delete Bill Database' - This option will erase complete bill database
. 'Delete LOG Database' - Log Database is used to store various actions. By time, it gets very
large. It's recommended that you backup databases and delete Log Database periodically
. 'Export Registry Settings' - Use this option to export Cool Side HotSpot software settings in
registry file
. 'Archive databases' - in ZIP format. Choose location on your hard drive where it should be
stored




Account database

. 'Print accounts' with time left on the account and current status
. 'Export accounts' in CSV file (Comma separated values file, Microsoft Excel compatible)
. 'Import accounts' from CSV file
. 'Delete all accounts' - This option will erase complete account database
. 'Delete duplicate accounts' - Delete all duplicated accounts from the database
. 'Delete accounts' with following conditions: Exp Before (specified date), Last Used Before
(specified date), Time Left Less Than (specified left time on the account), Inactive and Unsold
accounts
Update accounts

- To define the same Internet connection speed to all accounts check options download and
upload and set the speed in kb/s. Use Update all clients button.

-To define the same expiration date to all accounts set Expire in ... days and use Update all
accounts button.
Statistics

Statistics provide access to accounting and reporting. You can see a list of bills with date and
time of charge, account username, subtotal tax and total amount charged.

You can easily filter bills and get report for specified time period. Options available on this page
are:
. 'Calculate' - Show and calculate bills for specified time period
. 'Export' - Export your report in *.csv, *.txt, *.html or *.pdf format
. 'Print' - Print report
 Action Log database

All actions of the employees are logged and this can be used for detail analysis. Every Start and
Stop of the session, employee login and Logoff, every sell is stored in central database log file.
Of course, there is filter engine for faster search. You are able to filter database by date, action,
computer IP or MAC address and username.

. 'Show' - Show action LOG database
. 'Export' - Export action LOG database in *.csv, *.txt, *.html or *.pdf format
. 'Print' - Print Action LOG database
Passwords

There are two kind of passwords used to access Cool Side HotSpot software. Administrator has a
unique password which allows access to all software options and to setup page. Employee
accounts comes with limited privileges: access to HotSpot Setup pages is disabled.

How to create employee account:
1. Type name and password of your employee
2. Press Add button to store new employee in database
3. Repeat steps (1) and (2) if you need to create more accounts
4. Press Save button
Use Remove button to delete selected employee account

To set Administrator password:
1. Type password
2. Press 'Save' button
Packet filter

Packet filter option can be used to block specified IP addresses and Ports for outgoing traffic.
You can block specified port for range of addresses or range of ports for specified address.

. 'Add' - Use it to add specified IP addresses and Ports in the block list
. 'Remove' - Remove selected IP address or Port from block list
. 'Save' - Save block list
URL filtering and URL tracking

Cool Side HotSpot software have ability to track and block unwanted web sites. Web sites will
be automatically blocked if specified keywords appear in url address. This way you can prevent
access to porn, warez and other web sites that do not comply with your usage terms.

If you enable URL Tracking option, every visited web site address will be stored in text (*.txt)
file, along with details wether the site was allowed or blocked. Log contains customer username,
time and date, so this option can be used to analyze which web sites your customers visit and for
latest antiterorism reports.

Example: by default of HotSpot software specified keywords are: sex, erotic, nude and porn.
Each web site which include any of this keywords is automatically blocked: www.eroticsite.com,
www.sexsite.com etc...
DHCP server

DHCP server option assigns IP addresses to the client computers instead of your access point.
Please configure Subnet Mask and DNS addresses.
DHCP can be used to provide fixed IP addresses to specific MAC addresses. For example when
specific computer requires always the same IP .
Excluded IPs can be used to disable assigning of specific IPs. For example if you want to reserve
IPs in range 192.168.0.2 - 192.168.0.10 for computer in your cafe which are used by Internet
Caffe software
Remote Login

Remote database login allow multiple HotSpots to connect to one database server and share all
accounts. Database server should be located outside local network (which is controlled). Please
create these folder c:\Cool Side\HotSpot and unpack database inside. You will find there
DBAdmin tool and DBSrvr which is of course database server.. Enable remote database login
option
. Configure IP address of Your database server
. Configure compression of database. Database compression depend of Internet connection. In
the case of slower internet connection configure higher compression.
. Set database server username and passwords. Preconfigured account is: user: hotspot, pass:
admin
. Save remote database login setup configuration

Database server allows 5 HotSpots to connect.




SMTP roaming

Some of ISPs (Internet service providers) do not allow sending e-mails through other ISPs.
SMTP roaming option can be used to fix this problem. HotSpot software tracks port 25 which is
used for e-mail sending. All traffic from this port will be routed through SMTP server which you
define. This way, customer will not need to change any SMTP settings in e-mail client (Outlook,
The Bat ...).
To activate SMTP roaming, please check 'Enable' and type address of your SMTP mail server.
This server have to be outside of local network which is controlled by Cool Side HotSpot. If you
don't know IP, please resolve it by typing SMTP URL, choose IP and press Save button.




Misc options

. 'Display small laptop icons' - Change the size of laptop icons in the list of connected users
(main page)
. 'Enable multiple logins with one account' - With this option enabled the same account can be
used on few computers at the same time
. 'Verify MAC address and enable login only if it's done from the same computer' - Limit
login always from the same computers. Computers are recognized by MAC address
. 'Force clearing account IP addresses on HotSpot restart' - Clear all account IP addresses on
HotSpot software restart
. 'Increase daily limits (quota and time) to default values when saving account
modifications' - Reset daily limits to the defaults when make any modifications to the account
Free access

With Free access option allow access to the Internet without chanrge using specified login
keyword. Free access option is based on MAC addresses so you can limit access:

. 'Time' - Limit internet access time
. 'Quota' - Limit Bandwidth quota
. 'Download' - Limit download speed
. 'Upload' - Limit upload speed
. 'Allow free access' - Allow free access only at specified daytime
. 'Maximum logins per day' - Limit number of logins per day from the same computer
. 'Maximum allowed logins' - Limit allowed free access logins from the same computer
. 'Login keyword' - Set the keyword used for free access login
Customize pages

Cool Side HotSpot software gives you ability to customize: Login, Logout, Welcome, Max
users, Restricted, Infobox, Infobox Logout, Info and Help pages. All of this pages are in HTML
code format.
If you prefer to edit pages using Web page editing software (Dreamweaver, Front Page, etc) you
can open these pages from c:\Cool Side\HotSpot\Pages folder.
Custom login

Custom login option enables different login pages for different computer. Example: If your
customer login to your HotSpot from 192.168.0.11 IP address, in customers web browser will be
loaded customlogin.htm page. If customer login to your HotSpot from 192.168.0.12 IP address,
in web browser will be loaded customlogin2.htm page

. 'Add' - Add IP or MAC address and login page tob the list
. 'Remove' - Remove selected IP address from the list
. 'Choose' - Choose login page from hard disk
Change logo

Change logo displayed on default HotSpot pages. Existing logo stored in default location
c:\Program Files\HotSpot\www\HotSpot.jpg will be replaced with your new logo.
MAC whitelist

Cool Side HotSpot software gives you ability to specify MAC addresses of computers which
should pass through the hotspot without authentification. MAC address is a unique identifier
attached to most forms of networking equipment.

• 'Add' - Add MAC to the whitelist
. 'Remove' - Remove selected MAC address from the whitelist
. 'Save' - Save you MAC whitelist




Web site whitelist

This option gives you ability to specify web sites which can be accessed by customers without
authentification. Option can be used for advertising purposes.
You can type host names only and IP addresses will be filled automatically after pressing on Add
button.

. 'Add' - Add web address to the web site whitelist
. 'Remove' - Remove selected web site from the whitelist
. 'Save' - Save your web site whitelist

								
To top