Anda di halaman 1dari 34

HotSpot Network Manager

Setting Up Your Gateway

Manual Version 5.0.2

November 2016

Software Version 5.0.x

PROMETEO S.R.L.
Via Roma, 61
31010 Fonte Treviso
Italy
Tel. +39 0423 9292
Fax. +39 0423 929392
www.hsnetworkmanager.com
THE SPECIFICATIONS AND INFORMATION CONTAINED IN THIS MANUAL ARE SUBJECT TO CHANGE
WITHOUT ANY NOTICE. ALL STATEMENTS, INFORMATION AND RECOMMENDATIONS IN THIS MANUAL
ARE INTENDED TO BE ACCURATE, BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED. USERS ASSUME FULL RESPONSIBILITY FOR THE USE.

IN NO EVENT SHALL PROMETEO S.R.L. OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL,
CONSEQUENTIAL OR INCIDENTAL DAMAGES, INCLUDING WITHOUT LIMITATION LOSS OF PROFITS OR
LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THE MANUAL THOUGH
PROMETEO S.R.L. OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Prometeo, HSNM, HsNetworkManager and logos Prometeo, HSNM and HsNetworkManager are
trademarks of PROMETEO S.R.L. The third party trademarks are the property of their respective
owners.

Copyright 2015 PROMETEO S.R.L.


All rights reserved.
INTRODUCTION ......................................................................................................................................................................... 1
CONFIGURING THE HSNM.......................................................................................................................................................... 1
CONFIGURING MIKROTIK GATEWAY .......................................................................................................................................... 3
CONNECTING THE HOTSPOT GATEWAY ..................................................................................................................................... 9
CONFIGURING RUCKUS ZONE DIRECTOR GATEWAY ..................................................................................................................10
CONFIGURING RUCKUS ACCESS POINT......................................................................................................................................14
CONFIGURING CISKO MERAKI GATEWAY ..................................................................................................................................17
CONFIGURING LIGOWAVE INFINITY ..........................................................................................................................................24
Access to the Management Interface of the Device ................................................................................................................... 24
Via DHCP ................................................................................................................................................................................................ 24
Via fallback IP address ........................................................................................................................................................................... 24
Base Configuration Wizard ......................................................................................................................................................... 24
NOTEBOOK CONNECTION .........................................................................................................................................................30
LOGGING IN THE HOTSPOT .......................................................................................................................................................31
DOCUMENTATION....................................................................................................................................................................31
Introduction

Introduction
The manual is intended to provide you with some steps that are required to configure a PPPoE or a
HotSpot Gateway as it can be interfaced to the HSNM. The gateway must have at least 2 interfaces (1
Ethernet + 1 wireless, or 2 Ethernet), where one ethernet interface will be connected to the existing
network, while on the other interface you have to configure the HotSpot or the PPPoE Server. This
script is compatible with version 5 or higher of RouterOS, so if you have available an hardware with an
older version you should upgrade it.

Configuring the HSNM


First of all, you have to configure your HSNM on your network using the " System Setting" menu,
then you have to configure general options through the " General Options" menu.
For further and detailed information, we suggest to read the Administrator Manual.

After that, create a " Reseller", then a " Manager". In case of a small network, the roles can
coincide and be the same. Then create a " Domain" and, at the end, you can create a " Gateway".
To create a new gateway, you have to click the domain contextual menu and select " Add Gateway"

Clicking "Add Gateway" menu, you will be displayed the "Add or edit a hotspot gateway for the
manager" page, where you have to choose the "Hardware Type" of the gateway.

Setting Up Your Gateway 1


Configuring the HSNM

Based on the hardware type you set (Mikrotik, Ruckus, Cisco Meraki, LigoWave, etc), follow the
proper configuring section described further in the next paragraph.
Warning! Only in case you have a Mikrotik Router, this screen will be displayed and you have to
follow these steps.

In case you set "Mikrotik" or "Miktrotik hEX"as "Hardware Type", in order to be able to create the
Gateway configuration script, remain in the "Add or edit a hotspot gateway for the manager" page,
then at the bottom of the page you have to enter all the information regarding the HotSpot (SSID, IP
address, the DHCP pool, etc..) or the PPPoE Server.

Then click on the "Save" button to save the settings, after that click the Download configuration files
for HotSpot to download the Gateway configuration script and, in case, also the HTML pages
(available only for configuration of Hotspot and not for PPPoE server) that have to be copied inside the
Gateway. See Administration Manual for details.

Setting Up Your Gateway 2


Configuring Mikrotik Gateway

Configuring Mikrotik Gateway


To configure the Mikrotik gateway, please follow these steps:
1) Unzip the file, that you have downloaded before, on your computer.
2) Download winbox from http://download2.mikrotik.com/winbox.exe

3) Power on Mikrotik routerboard.

4) Connect an Ethernet cable to ether1 of Mikrotik routerboard.

Setting Up Your Gateway 3


Configuring Mikrotik Gateway

5) Connect the other end of the cable to your computer.

6) Open Winbox and press on "..." button, then select your routerboard by clicking on its MAC
Address and click on "connect" button (login=admin without password).

7) Go to "New Terminal" menu on the left and you should see "Terminal" window. Then, on it, write
this command:
system reset-configuration no-defaults=yes
After that click on Y to reset and reboot the device

and press the " Enter button"


after that press on y to reset and reboot the device.

Setting Up Your Gateway 4


Configuring Mikrotik Gateway

8) Now it will be possible to configure Mikrotik Gateway. So login again with Winbox and click on
"File" menu on the left and you should see "File list" of your mikrotik routerboard.

9) Open the folder on your PC where you have unzipped the file at step 1) and copy the .rsc file (in
case of HotSpot configuration the file name will be ConfigScriptHotSpotRouterOS.rsc, while in case
of PPPoE Server configuration the name will be ConfigScriptPPPoERouterOS.rsc).

Setting Up Your Gateway 5


Configuring Mikrotik Gateway

10) Come back to winbox and paste the .rsc file into "File List".
NOTE: if you are configuring a Mikrotik hEX system, copy the file inside the flash folder otherwise
you will lose it if you reboot the Mikrotik

11) Open again the folder on your PC where you have unzipped the file at step 1) and copy the
hotspot folder in case you are configuring a HotSpot or the roundrobindomains.txt in case you
are configuring a PPPoE Server.

Setting Up Your Gateway 6


Configuring Mikrotik Gateway

12) Come back to winbox, delete the hotspot folder, if there is already one, and click on paste icon to
copy hotspot folder or roundrobindomains file into "File List".
WARNING! if you are configuring a Mikrotik hEX system, copy the hotspot folder or the
roundrobindomains file inside the flash folder, otherwise you will lose them if you reboot the
Mikrotik

13) Click on "New Terminal" men on the left and you should see "Terminal" window. Then on it write
this command:

For HotSpot gateway


import ConfigScriptHotSpotRouterOS.rsc

For PPPoE gateway


import ConfigScriptPPPoERouterOS.rsc

Setting Up Your Gateway 7


Configuring Mikrotik Gateway

14) Go to "System->Password" menu and insert a password for admin user on both "New password"
and "Confirmed Password" fields, then click the "Change" button.

Now your mikrotik routerboard is configured.

Setting Up Your Gateway 8


Connecting the Hotspot Gateway

Connecting the Hotspot Gateway


Connect the Mikrotik hotspot gateway that you have just configured to your network.

Setting Up Your Gateway 9


Configuring Ruckus Zone Director Gateway

Configuring Ruckus Zone Director Gateway


1) Login to your Ruckus Zone Director with your credentials or the credentials provided by Ruckus.

2) Set an IP address to your Ruckus Zone Director according with your local network. To to this go to
the "Configure" section.

3) Go to "Configure" section, then to "AAA Servers" menu. Click on "CreateNew" link and assign a
name. As "Type" choose "Radius", then on "Auth Method" select "PAP". Now on "IP Address", set
the IP used to reach HSNM, on "Port" set "1812" and on the "Secret" field set the radius secret that
you have set on HSNM System Settings. After that, click OK.

Setting Up Your Gateway 10


Configuring Ruckus Zone Director Gateway

4) Do the same things of point 3) but choose "RADIUS Accounting" as "Type", set "1813" as port and
obviously set a different name. After that click on "OK".

5) Now configure the Hotspot service. Go to "Configure" section and then on "Hotspot Services"
men. Click on "Create new" link and assign a name to the Hotspot service. On "Login page" field
set the HSNM Welcome Portal URL where the end user will be redirected (the URL will be like
http://HSNM_IP_OR_DOMAIN/mtlogin.php?domain=domain-name-created-inside-
hsnm&hotspotname=name-of-the-hotspot-created-inside-hsnm).Enable the "terminate user
session" field ans set, for example, 60. After that on "authentication server" field choose the radius
name created on point 3) and on "accounting server" field choose the radius name created on point
Click on "+" icon near "walled garden" , then click on "create new" and add the IP used to reached
HSNM, then click on "OK" to save.

Setting Up Your Gateway 11


Configuring Ruckus Zone Director Gateway

Setting Up Your Gateway 12


Configuring Ruckus Zone Director Gateway

6) Go on "Configure" section then click on "Wlans" men. Click on "Create new" link, inside "Wlans",
then assign a SSID for your wireless network and choose "hotspot services WispR" on "type" field.
As "Hotspot services" it is necessary to specify the Hotspot service previously created at point 5).
After that, click "OK" to save.

Now, if you connect to a Ruckus AP configured with ZoneDirector, you should be able to view the
HSNM Welcom Portal.

Setting Up Your Gateway 13


Configuring Ruckus Access Point

Configuring Ruckus Access Point


1) Set an IP address to your ruckus device according with your local network. To do this go to the
men Configuration/Internet.

2) Set a local subnet to use for the Hotspot WiFi network and enable a DHCP on it. To do this go to the
men Configuration/LocalSubnet.

3) Go to the men Configuration/Hotspot, enabled it and on Redirect "unauth user to" field set the
HSNM URL where to redirect the user. The URL must be like
http://HSNM_IP_OR_DOMAIN/mtlogin.php?domain=domain-name-created-inside-
hsnm&hotspotname=name-of-the-hotspot-created-inside-hsnm.

Setting Up Your Gateway 14


Configuring Ruckus Access Point

4) Set also on "Primary Radius Server" the IP address used to reach the HSNM and secret for the
radius.

5) Always on the Configuration/Hotspot men, click on the "walled garden" and add as walled-garden
the ip used to reach the HSNM.

6) Set the WiFi network parameters.To do this go to the men Configuration/Radio2.4/Wireless 1 and
set the WiFi parameters (SSID, Hotspot service, local subnet etc.)

Setting Up Your Gateway 15


Configuring Ruckus Access Point

WARNING!: it is important to choose an "Hotspot Service" and choose as "Local Subnet" the subnet
created before at point 2. As "Packet Forward option, choose "Local Subnet NAT and Route to
WAN".

Setting Up Your Gateway 16


Configuring Cisko Meraki Gateway

Configuring Cisko Meraki Gateway


This guide applies to the Meraki MR series. Don't connect the Access Point before you have configured
the Meraki Cloud dashboard.

1) Go to your order status page to set up your network. Your order status page is
dashboard.meraki.com/claim/YourOrderNumber. You'll find your order number on the packing list
included in this shipment and in your order confirmation e-mail.

2) Set up your account, following the on-screen instructions, and configure your network before to
plug in any hardware.

3) Go to Wireless menu and then, under configure section, click on SSIDs. So you can change, if you
desire, the network name clicking on rename:

4) Go to Wireless menu and then, under configure section, click on Access control and set these
parameters under Network access section:

Setting Up Your Gateway 17


Configuring Cisko Meraki Gateway

5) Set to "Open" the Association requirement field:

6) Set to "Sign-on with my Radius server" the Splash page field:

7) Set Radius configuration for Splash Page and for accounting. To be able to add an accounting Radius
server you have to contact Meraki support asking them to enable this feature. To contact Meraki
support, go to Help menu and then click Get help. Then you can open a new case, following the
on-screen instructions, or call your country Meraki service number (they speak in English) asking
them to enable the possibility to configure an accounting Radius server.

Setting Up Your Gateway 18


Configuring Cisko Meraki Gateway

8) Go back to Wireless, Access control men and set the Radius configuration: Click on add server,
under Radius for splash page, and set your Radius IP address, the 1812 port and the Radius secret.
Then enable Radius accounting, click on add server, under Radius accounting server, and set your
radius IP address again, the 1813 port and the Radius secret.

9) Set to "Block all access until sign-on is complete" the captive portal strength field:

10) Enable walled garden and set the IP addresses/DomainName to reach the Appliance and its
services. The IP addresses hidden with a black mark, in the sample image below, only means that
you have to set your own IP addresses. In the walled garden list you have also to set all (in the
below sample image there are just some walled garden) the host name required to benefit
features like social login (facebook etc...) and online payments (pay pal etc..) as well as free host
name you want users are able to reach without registering to the HotSpot system (for example
your own site for advertising purposes). To be able to set a host name instead an IP address you
have to contact, as in step 4.1, Meraki support asking them to enable this feature.

Setting Up Your Gateway 19


Configuring Cisko Meraki Gateway

11) Set to "Restricted" the Controller disconnection behavior field:

12) Set to "NAT mode" the Client IP assignment field:

13) Go to Wireless menu and then, under configure section, click on Firewall & traffic shaping and set
to "Allow", if the Meraki is on the same LAN of the Appliance (othrewise set to "Deny"), the
already created firewall rule. The IP address hidden with a black mark, in the sample image below,
only means that you have to set your own IP address:

Setting Up Your Gateway 20


Configuring Cisko Meraki Gateway

14) Go to Wireless menu and then, under configure section, click on Splash page. Configure your
"Custom Splash URL". It must be like
http://ApplianceIP_OR_DOMAIN/mtlogin.php?domain=domain-name-created-inside-
Appliance&hotspotname=name-of-the-hotspot-created-inside-Appliance. Note that
Appliance_IP_OR_DOMAIN must be inside the walled garden (point 4.4).

Setting Up Your Gateway 21


Configuring Cisko Meraki Gateway

15) You have to open in your firewall, if not already done, TCP/UDP ports listed in the Help, Firewall
info men (the IP address hidden with a black mark, in the sample image below, only means that
you have to set your own IP address):

16) Connect to your Appliance and edit your gateway to set the Hardware type field to Cisco Meraki
MR series (Beta):

Setting Up Your Gateway 22


Configuring Cisko Meraki Gateway

17) Last step is to connect your Meraki to your network which will receive its configuration
automatically from the Meraki Cloud dashboard. Now you are able to connect to the configured
wireless network and reach the Appliance Welcome Portal of your domain.

These are all the steps to configure Meraki Cloud dashboard in order to be able to interact with the
Appliance. Others fields in Meraki Cloud dashboard can be configured as you prefer.

Setting Up Your Gateway 23


Configuring LigoWave Infinity

Configuring LigoWave Infinity


This chapter describes how to configure LigoWave Infinity.
Before proceeding further with the configuration, it is necessary to have an HSNM configured with a
domain and a gateway. In the gateway, in the type of hardware field, you have to select LigoWave
Infinity.

To configure your device, proceed as follows:

Access to the Management Interface of the Device


Access can be performed in two ways:
Via IP address assigned by the DHCP;
Using the fallback IP address pre-assigned to the the device (192.168.2.66).

Via DHCP
1. Connect the access point to a network with an active DHCP and determine the assigned IP
address;
2. Open the browser and type the IP address assigned by the DHCP.

Via fallback IP address


Connect the device to the PC;
Assign to the PC the network address 192.168.2.10, subnet mask 255.255.255.0 and gateway
192.168.2.1
Open the browser and type the IP address 192.168.2.66.

Base Configuration Wizard


Accessing via browser for the first time, you will be displayed the initial configuration wizard that will
allow you to define the essential parameters of the configuration.
Proceed as follows:
1. Select the language;
2. Click on the I have read and agree check to accept the terms of use;
3. Select the Operating country;
4. Press Next;

Setting Up Your Gateway 24


Configuring LigoWave Infinity

5. The second step of the wizard will be displayed:

6. Select the type of system (in general Master AP Integrated);


7. Press Next >;

Setting Up Your Gateway 25


Configuring LigoWave Infinity

8. The third step of the wizard will be displayed:

9. Complete the required data, leaving Open in the Security field;


10. Press Next >;

Setting Up Your Gateway 26


Configuring LigoWave Infinity

11. The forth step of the wizard will be displayed:

12. Enter the password to assign to the Admin user;


13. Press Next >;
14. You will be displayed the summary of the configurations;
15. Press Finish to confirm and complete the basic configuration;
16. Wait for the saving of the configuration data;
17. At the request, enter the username and the password previously selected;
18. Press Login;

19. Click on the Controller icon on the top ;


20. Click on Enable Infinity Controller to disable the option;

21. Click on the Settings icon on the top ;

22. Click on the Network configuration icon on the left ;


23. On Network Mode select Router IPv4;
24. Configure WAN and LAN parameters properly by assigning IP classes different for the WAN and
the LAN;

Setting Up Your Gateway 27


Configuring LigoWave Infinity

25. Click on the Wireless configuration icon on the left ;

26. On Wireless settings (AP) click to enter the data


27. On Security select Hotspot (UAM);
28. Click on UAM settings to open the options;
29. On RADIUS enter in the Primary server and Secondary server fields the IP address assigned
to the HSNM;
30. On Server secret enter the radius secret (the one defined in the System Settings of the
HSNM);
31. Click on Captive portal;
32. On Splash page type select External;
33. On login URL enter
http://HSNMURL/portal/index.php?domain=HSNMDomainName&hotspotname=HSNMHotSpotN
ame where, instead of HSNMURL, enter the URL or the IP address of HSNM, instead of the
HSNMDomainName, enter the domain name defined in the HSNM and instead of
HSNMHotSpotName enter the gateway name as defined in the HSNM;
34. Click on White/Black list;
35. Click on White/Black list auto update activating the option;
36. On List URL enter
http://HSNMURL/functions/walledgarden.php?domain=HSNMDomainName&hotspotname=HSN
MHotSpotName where, instead of HSNMURL, entered the URL or the IP address of HSNM,
instead of HSNMDomainName, enter the domain name defined in the HSNM and instead of
HSNMHotSpotName, enter the gateway name as defined in the HSNM;
37. Click on the field List update interval (hh:mm) and enter 00:05 to enable automatic updating
of the walled garden every 5 minutes;
38. Press the Done button on the bottom-right;
39. Press the Save changes button on the top-right and save all the changes.

Now you can the hotspot connecting to the wifi network with the name assigned during the
configuration.

Setting Up Your Gateway 28


Configuring LigoWave Infinity

When data has been saved, to access again to the device configuration it is necessary to login again,
typing in the browser the IP assigned by the DHCP or assigned during the configuration of the
network.

Setting Up Your Gateway 29


Notebook Connection

Notebook Connection
Search for the Wi-Fi networks with a notebook and you will find a network called CoffeeHouse.
NOTE: please dont use the same notebook/PC where your are running HSNM, otherwise you will be
not able to view the Welcome Portal (Hotspot Login Page).

Connect to this network by clicking the "Connect" button.

Setting Up Your Gateway 30


Logging in the Hotspot

Logging in the Hotspot


In the notebook, open a web browser and try to load a website, you will be redirected to the hotspot
Welcome Portal.

Documentation
For further reading, please click the "Admin" tab on the upper left side menu, then press the "
Documentation" button where you will find the Administration Manual.

Setting Up Your Gateway 31