Mikrotik Configuration Guide

The following instructions outline how to apply the Marketing 4 WiFi platform’s configuration script to your MikroTik to configure the unit to your hotspot. The script can be used as a framework to get any MikroTik device configured to the platform. Additional changes to the MikroTik may be required to support various models and use cases. This guide assumes your MikroTik can be reset into a default state with no configuration. You will need access to the Marketing 4 WiFi dashboard and a computer with Winbox installed to complete this guide. Please make sure any firewall rules, web content filters, and other security measures have been configured to interface with the platform.

Adding Gateways to your Hotspot

The MAC of every access point that broadcasts the Guest WiFi must be added to your hotspot.

1. Login to your GoZone Marketing 4 WiFi dashboard
2. Using the navigation panel to the left, select Network> Gateways
3. Click the Add Gateway option to the top right
   1. Select Hotspot: Select your desired hotspot
   2. Gateway Name: Enter a name for this Gateway(s)
   3. Gateway Type: MikroTik
   4. MAC Address: Enter the MAC Address of your MikroTik
   5. Wireless SSID: SmartWiFi (Or whatever you wish)
   6. Wireless LAN Ports to Splash: Turn this on if you want the LAN ports 2 through 5 to serve the splash page
   7. Client Isolation: ON
   8. WLAN2: Turn this on if you want to broadcast the Guest WiFi SSID on the 5GHz radio
4. Press Submit
5. Now on the Edit gateway page for your MikroTik, press “View Script for Router OS” for the version of Router OS your MikroTik uses
6. Copy the entire script that is displayed in a new tab, including the blank space at the bottom. Save the text for use later in this guide.
7. This completes the Gateway creation portion of this guide

MikroTik Configuration

1. Connect your MikroTik device Eth1 port to a port on your local network that provides DHCP and a connection to the internet
2. Connect your computer with WinBox to another Ethernet port on the MikroTik OR connect your computer to the same Subnet that the MikroTik Eth1 is on
3. Open WinBox on your computer
4. Select the Neighbors tab
5. In the table at the bottom of WinBox, click on the MAC of your MikroTik to add it to the connect To setting of your WinBox window
   You may have to click Refresh before you can see the MikroTik
6. Using the Username admin with no password, press Connect
7. Now connected to your MikroTik, use the menu to the left and select System > Reset Configuration
8. Check the boxes for No Default Configuration and Do Not Backup and then press Reset Configuration
9. The device will power cycle as part of the reset process, once it is complete Connect to the MikroTik again
10. Use the menu to the left and click New Terminal
11. Paste the entire script collected from the Marketing 4 WiFi dashboard’s Edit Gateway page for this MikroTik
    • The script from the dashboard contains several line returns at the bottom of it to ensure the whole script runs. It is still possible you may have to press the Enter key a couple times to run the final line of the script.
    • If the script runs successfully, the last thing you should see is two messages stating “Status: finished” twice.
      
    • If WinBox kicks you out the first time you past the script, simply log back in and paste the script again. This can occur because the interface that you’re using to connect to the MikroTik may be reset during the configuration process.
12. After the script has run successfully, use the menu panel to the left to select System > Reboot and then reboot the MikroTik.
13. Once the power cycle is complete your MikroTik configuration to your Marketing 4 WiFi  hotspot is complete.
14. As a final step, be sure to assign a password to admin user of the MikroTik by using the menu panel to the left to select System > Password

Hardware-Dependent Features

This integration supports the platform’s Session Profile values for Download/Upload speed. This means bandwidth throttling is set by the platform when a guest connects to a hotspot using any login method, including Guest Plans and Ad-Based.

 

This integration does not support Presence/Proximity data. This means Presence Campaigns can not be configured for a hotspot utilizing this hardware. Standard Smart Campaign rules are still supported.

This integration does not support the SecurePass™ module. This means a hotspot utilizing this hardware can not provide dynamically generated wifi passwords to guests who purchase a Guest Plan.

 

Troubleshooting Splash Pages

If you do not get to the Finished Finished step of running the script the common cause is the MikroTik is not able to connect to the internet. Make sure the MikroTik is patched into your router with DHCP enabled using the correct ports.

Disclaimer on Hardware Configuration Guides

This gateway integration was completed and documented with the Marketing4WiFi platform using the firmware versions below.

• Router OS6
• Router OS7

LIMITED HARDWARE SUPPORT: Hardware manufacturers frequently make changes to firmware, controllers and GUI’s. The information below may be out of date or images may be different and is to be used as a general reference guide. We do offer additional limited support to help with trouble-shooting and we highly recommend that you have a hardware support agreement and/or access to a hardware support engineering representative from the manufacturer.

For any additional questions or concerns, please reach out to our Support Team at [e-mail].