Wi5Stars
Setting Up Your Gateway
Manual Version 9.6
November 2022
Software Version 9.3.x
PROMETEO S.R.L.
Via Roma, 61
31010 Fonte
Treviso
Italia
Tel. +39 0423 9292
Fax. +39 0423 929392
info@[Link]
[Link]
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, Wi5Stars, WiFiveStars e loghi Prometeo are trademarks of PROMETEO S.R.L. The third-party
trademarks are the property of their respective owners.
Copyright © 2022 PROMETEO S.R.L
All rights reserved.
Contents
CONTENTS
INTRODUCTION ............................................................................................................................................................................. 8
ETHERNET NETWORKING SKILLS ................................................................................................................................................................ 8
TRAINING ............................................................................................................................................................................................. 8
CONFIGURING WI5STARS .............................................................................................................................................................. 9
ADDING A NEW GATEWAY ....................................................................................................................................................................... 9
RADIUS SECRET.................................................................................................................................................................................... 11
MIKROTIK GATEWAY ................................................................................................................................................................... 12
FIELDS FOR CONFIGURING THE GATEWAY.................................................................................................................................................. 15
MANUAL CONFIGURATION OF YOUR MIKROTIK GATEWAY ........................................................................................................................... 17
Downloading the Configurations Files for Your MikroTik ........................................................................................................... 17
Uploading the Configurations Files to Your MikroTik ................................................................................................................. 18
MikroTik with Flash Folder.......................................................................................................................................................................... 20
MikroTik without Flash Folder .................................................................................................................................................................... 21
AUTOMATIC CONFIGURATION OF YOUR MIKROTIK GATEWAY....................................................................................................................... 23
CONNECTING THE HOTSPOT GATEWAY ..................................................................................................................................................... 25
NOTEBOOK CONNECTION ............................................................................................................................................................ 26
LOGGING IN THE HOTSPOT .......................................................................................................................................................... 27
DOCUMENTATION ....................................................................................................................................................................... 27
Setting Up Your Gateway III
Introduction Ethernet Networking Skills
Introduction
The manual is intended to provide you with some steps that are required to configure a PPPoE or a
Hotspot Gateway in order it can be interfaced to the Wi5Stars. 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.
Ethernet Networking Skills
The installer needs to have the ability to configure IP addressing on a PC and to set up and control
products using a web browser interface.
Training
The installer needs to have basic knowledge about network installation. The specific requirements,
applicable to the Wi5Stars, must be gained by reading this user guide and by performing sample setups
and test at own lab before live deployments.
Setting Up Your Gateway 8
Configuring Wi5Stars Adding a New Gateway
Configuring Wi5Stars
Adding a New Gateway
Wi5Stars is supplied with an existing branch structure (a Reseller, a Manager, a Domain and a Gateway).
You can create an additional branch structure by using the following steps.
In the Domain dropdown, click Add Gateway, enter the details required and click the Save button
on the top right of the page.
Note In the domain, you need to add a product in the Products for the Domain session.
Once you click the Add Gateway menu, the "Add or edit a gateway (hotspot)" page will appear.
Setting Up Your Gateway 9
Configuring Wi5Stars Adding a New Gateway
In the General Data, select the Hardware Type of your gateway.
Note Follow the dedicated configuring section described in the following paragraphs based on the
hardware type you select (MikroTik, Ruckus, Cisco Meraki, LigoWave, etc.).
Note Only if you selected a MikroTik router, the complete
"Fields to Configure the Gateway" dropdown will
appear, and you must follow the steps described in
Configuring Your MikroTik Gateway.
Setting Up Your Gateway 10
Configuring Wi5Stars Radius Secret
Radius Secret
You can find the secret by accessing your Wi5Stars.
In the Gateway level, click on Edit, scroll down and click on Fields for Configuring the Gateway.
Now expand the Radius section. In the Secret for Radius field, you can view the secret.
Setting Up Your Gateway 11
MIKROTIK Gateway Radius Secret
MIKROTIK Gateway
This chapter describes how to configure your MikroTik gateway.
If you are using a MikroTik that is already running in a production network, we suggest that you make a backup
of your current configuration. Go to Files > Backup, then click to back up your current configs to the file.
Optionally drag and drop the new backup file to your desktop to save it locally.
Wi5Stars is already supplied with a pre-configured gateway, ready to work. If you prefer to add another
gateway, please proceed as described in the Adding a New Gateway chapter at page 9.
Warning Your MikroTik router must have version 6.46.7 or greater. In case you have a hardware with an
older version, you need to upgrade it.
Check if your MikroTik has the Flash folder. Log in with Winbox, select Files.
The File List appears, and please check whether it contains a folder named Flash.
MikroTik with the flash folder
MikroTik without the flash folder
Setting Up Your Gateway 12
MIKROTIK Gateway Radius Secret
Now inside Wi5Stars, select your Gateway, click the dropdown menu, choose Edit.
Expand the General Data session and in the Hardware Type field, choose MikroTik or MikroTik with
flash (hEX, hAP AC Lite, etc…).
In the Gateway RouterOS Version field, you need to enter the version of your MikroTik router.
If you have a version equal to or greater than 7 and you don’t declare the version, you may face issues
when downloading your configuration file.
Setting Up Your Gateway 13
MIKROTIK Gateway Radius Secret
Scroll down till Fields for Configuring the Gateway. This session appears only if you have selected the
MikroTik-type gateway in the Hardware Type field.
Setting Up Your Gateway 14
MIKROTIK Gateway Fields for Configuring the Gateway
Fields for Configuring the Gateway
To help you configure your gateway, Wi5Stars is supplied with a gateway already completed with default
values.
In the Wireless session, the "Use Wireless" field is enabled and the SSID already defined as shown Figure
Use Wireless
Figure Use Wireless
Caution: enable Use Wireless only if you have a wireless card in your MikroTik gateway.
The fields in the Hotspot session are already preconfigured with an IP address, network mask, DNS IP
address, first and last IP address for the DHCP address pool and DHCP lease time as shown Figure Guest
Interfaces and Guest Network
Figure Guest Interfaces
Setting Up Your Gateway 15
MIKROTIK Gateway Fields for Configuring the Gateway
Figure Guest Network
If you don’t want to use the default values, you need to complete all the fields related to the hotspot
(SSID, IP address, the DHCP pool, etc..).
Click the Save button on the top right of the page.
Wi5Stars offers you two options for configuring your MikroTik: automatic and manual configuration.
Note Select the Automatic Configuration only if you can enter into your MikroTik an IP address that Wi5Stars
can reach.
Setting Up Your Gateway 16
MIKROTIK Gateway Manual Configuration of Your MikroTik Gateway
Manual Configuration of Your MikroTik Gateway
Downloading the Configurations Files for Your MikroTik
Follow these steps only to run the manual configuration.
Select your gateway, and click the contextual dropdown menu.
Scroll down till Download Gateway Conf Files and click it.
Double click the ZIP file to open WinZip.
Unzip the files by selecting all the files and by clicking Extract.
Select the destination folder for the extracted files and save them.
Setting Up Your Gateway 17
MIKROTIK Gateway Manual Configuration of Your MikroTik Gateway
Uploading the Configurations Files to Your MikroTik
Now you need to upload your configuration files to your MikroTik.
Power on your MikroTik routerboard.
Open WinBox or download Winbox from [Link]
Select your routerboard by clicking its MAC Address
(login=admin without password).
Enter the details as follows:
Login – Enter admin
Password – Leave it empty (no password)
Click the Connect button on the right.
Setting Up Your Gateway 18
MIKROTIK Gateway Manual Configuration of Your MikroTik Gateway
Scroll down till New Terminal and click it.
The Terminal window will appear. Then, in it, write the following command:
system reset-configuration no-defaults=yes
Press "Y" to reset and wait till the device reboots.
Click Reconnect
Setting Up Your Gateway 19
MIKROTIK Gateway Manual Configuration of Your MikroTik Gateway
Once it reconnects, scroll down till Files and click it.
The File List will appear.
MikroTik with Flash Folder
Now drag and drop the Hotspot folder and the RCS file that you previously unzipped.
Warning Drag and drop both the Hotspot folder and the RCS file into the Flash folder.
Both elements must be under the flash folder otherwise you will lose it in case you reboot
the MikroTik
If you have completed the drag-and-drop operation, move to Step 3.
Setting Up Your Gateway 20
MIKROTIK Gateway Manual Configuration of Your MikroTik Gateway
MikroTik without Flash Folder
Now drag and drop the Hotspot folder and the RCS file that you previously unzipped.
If you have completed the drag-and-drop operation, move to Step 3.
Select the New Terminal menu on the left, and the "Terminal" window will appear.
Write the following command:
import [Link]
Setting Up Your Gateway 21
MIKROTIK Gateway Manual Configuration of Your MikroTik Gateway
Scroll down to System.
Select Password.
Edit the admin users’ password on both "New password" and "Confirmed Password" fields.
Then click the Change button to save the entry.
Reboot your MikroTik to apply the configuration.
Now you have configured your MikroTik routerboard.
Setting Up Your Gateway 22
MIKROTIK Gateway Automatic Configuration of Your MikroTik Gateway
Automatic Configuration of Your MikroTik Gateway
This section describes how you can automatically configure a MikroTik gateway without following the
various manual steps described in the "Downloading the Configurations Files for MikroTik" paragraph
and subsequent.
You can automatically configure a MikroTik gateway if it is reachable from your Wi5Stars.
If you are configuring a new gateway, you need to enter an IP address in your MikroTik that is reachable
from the Wi5Stars. To do this, please follow these steps:
Open WinBox and move to the Neighbors tab, select your routerboard by clicking its MAC
Address and then click the Connect button on the right.
In case of a new router, enter “Admin” in the Login field and leave the Password field empty
Scroll down to the IP menu on the left and click Addresses. Then click the + add button on the top left
corner. The New Address form will appear.
In the IP Address field, enter an IP Address” that can be reached from your Wi5Stars in the form CIDR
(IP/Subnet example: [Link]/24) and choose the interface with which you are reaching the
gateway.
Click the OK button on the right to confirm.
Setting Up Your Gateway 23
MIKROTIK Gateway Automatic Configuration of Your MikroTik Gateway
Now login to your Wi5Stars, from the Data tab select your gateway, expand the dropdown menu and click
Edit.
Click the Upload Configuration button on the top right corner of the page.
Now you will be displayed a page where you need to enter the data for the upload.
Enter the relevant details in the fields. The following deplays an example:
• IP Address Assigned to the Gateway –[Link]
• Username to Log In –Enter admin (MikroTik default value)
• Password to Log In –Enter the password assigned to the gateway. In case of a new router,
the password field is empty, so you don’t need to enter it.
Click the Run button and confirm to proceed with the automatic configuration.
Once you have completed the above steps, the configuration will be loaded and the gateway will be
automatically rebooted.
Setting Up Your Gateway 24
MIKROTIK Gateway 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 25
Notebook Connection Connecting the Hotspot Gateway
Notebook Connection
Search for the Wi-Fi networks with a notebook and you will find a network called “CoffeeHouse”.
NOTE: please don’t use the same notebook/PC where you are running Wi5Stars, 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 26
Logging in the Hotspot Connecting the Hotspot Gateway
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 27
