Installation Guide

Main steps of the install:
- Initial Setup
- Install CoovaChilli
- Run our script
- Check if hotspot interface set well

1. Make initial settings
   Once you have the router with enough resources and compatible OpenWRT freshly installed please do your initial setup
   1. Connect to the router's management WEB interface called LuCi and login
      
   2. Set router password under menu System / Administration. At the end click button Save & Apply
   3. Your hotspot router will uplink to your ofice or home LAN. To a safe environment.
      And LAN interfaces on your hotspot router might be configured as hotspot interfaces so you can't manage the router through these.
      Therefore we suggest to allow management from WAN. However it is not obligatory but highly suggested to be able to manage the router later.
      You can do it in LuCi under menu Network / Firewall / Traffic Rules by adding a new rule to open ports 22, 80 and 443.
      List the ports separated by only spaces. At the end click button Add and then button Save & Apply
      
   4. We highly recommend to move your LAN network on the hotspot router from the commonly used 192.168.1.0/24 to 192.168.20.0/24
      You can do it under menu Network / Interfaces / LAN / Edit by simply modifying IPv4 address to 192.168.20.1 and clicking button Save & Apply.
      This is neither obligatory if your office LAN will not overlap with the default settings.
      But strongly suggested.
      
   5. If want to allow hotspot on all your interfaces joined to bridge LAN disable DHCP server under menu Network / Interfaces / Lan / Edit / DHCP Server / General Setup by enabling check box Ignore Interface.
      If want to allow only some specific interfaces remove them from all available bridges.
      You can even create a new bridge and join multiple physical interfaces to this, then set this as hotspot interface.
      
2. Install CoovaChilli
   Under menu System / Software click button Update Lists
   Make sure you are on tabsheet Available packages
   Filter for package CoovaChilli
   Click button Install next to package coova-chilli
   
3. Run our script
   Login to our Control Center at https://hotspotsystem.com/login
   Go to menu Manage > Locations > Location
   Scroll down to section Router Setup Command For This Location
   Set Firmware Version to OpenWRT
   Highlight and copy the command
   Connect to the router through SSH
   Paste and run the command
   The router will reboot at the end of the install
   
4. Check if hotspot interface set well
   After reboot if hotspot not working first you should check the HS_LANIF in the config file.
   Open /etc/chilli/defaults in your favorite text editor installed on the router. We use VI because it is installed on most Unix like distros by default.
   
   root@openwrt# vi /etc/chilli/defaults
   
   Second section should look similar to this:
   
   #############################################################
   
   HS_WANIF=eth1 # WAN Interface toward the Internet
   HS_LANIF= # Subscriber Interface for client devices
   HS_UAMPORT=3990 # HotSpot UAM Port (on subscriber network)
   HS_UAMUIPORT=4990 # HotSpot UAM "UI" Port (on subscriber network, for embedded portal)
   HS_MAXCLIENTS=4096
   
   
   If HS_LANIF is empty or not what you'd like set your desired interface, save the file and reboot the router.
   Remember what we said about hotspot interfaces in section A5.
   

Should you have any more questions or problems, please read our Knowledgebase or contact Help Desk.