Kiwire 3.0 Administrator - Device & Controller Setup Guide
Kiwire 3.0 Administrator - Device & Controller Setup Guide
Cambium Networks Configuration for Kiwire Hotspot
Cambium Networks Configuration for Kiwire Hotspot
Prerequisites
​
Before integrating the controller with Kiwire, it is necessary that the controller and access point:
-
are connected to the Internet
-
are reachable on the network
-
have an IP address assigned to the a through DHCP or static
Note:
-
Kiwire-hostname or Kiwire-ip can be obtain by contacting our technical support for our cloud customer. For enterprise client the ip will be on premises Kiwire ip address.
-
Social network hostname list can be obtained from Social network whitelist guide
Part 1: Cambium cnMaestro configuration
-
Login to your Cambium cnMaestro controller
-
Go to WLANs > Configuration > AAA Servers
-
Authentication Server
-
Host: Kiwire-hostname or Kiwire-Ip
-
Secret: create a secret pass phrase
-
Port: 1812
-
Timeout: 3 seconds
-
Attempts: 1
-
-
Accounting Server
-
Host: Kiwire-hostname or Kiwire-ip
-
Secret: secret same as authentication server
-
Port: 1813
-
Timeout: 3 seconds
-
Attempts: 1
-
Accounting Mode: Start-Interim-Stop
-
Accounting Packet: ticked
-
Interim Update Interval: 1800 seconds
-
-
Advanced Settings
-
NAS-Identifier: AP MAC address with capital letters and colon
-
Dynamic Authorization: ticked
-
Dynamic VLAN: ticked
-
Called Station ID: AP-MAC:SSID
-
-
Omaya 3.0 Administrator > Quick Setup > Dashboard
Documentation
Kiwire 3.0 Administrator > Setting up the Wi-Fi Hardware & Configuration > Pointing Ruijie AP
Kiwire 3.0 Administrator - Device & Controller Setup Guide
Pointing Ruijie Wifi access point to Kiwire Hotspot
Step 1 : Active the Access Point
1. Enable AP (reset if u can)
Ruijie > enable || en
Ruijie# apm factory-reset
//command for enable
//command for reset
2. Change mode to FAT
​
Ruijie#configuration terminal || conf t
Ruijie(config)# ap-mode FAT
//entering configuration mode
//change AP mode to Fat mode
3.Int BVI 1 change IP Address​
​
Ruijie#conf t
Ruijie(config)# interface BVI 1 || int BVI 1
Ruijie(config -if-BVI 1)# ip add 192.168.0.11 255.255.255.255
​
Ruijie(config -if-BVI 1)# ip add dhcp
Ruijie(config -if-BVI 1)# exit || ex
Ruijie(config)# ip route 0.0.0.0 0.0.0.0 192.168.0.1
//enter interface BVI
//static AP IP Address
//DHCP AP IP Address
//exit interface
//route to default gateway
4. Show configuration and test internet
​
Ruijie(config)# show run || sh ru
Ruijie(config)# do ping 8.8.8.8
//DHCP AP IP Address
//checking for internet
”do” command only can used in config mode (shortest way to bypass EXEC mode). If in EXEC mode (enable mode), just “ping 8.8.8.8”.
Ruijie(config)# Hostname –APName-
Ruijie(config)# no web-auth …
Ruijie(config)# end
Ruijie(config)# show int st
Ruijie# write memory || wr mem
Ruijie# help || ?
//Changing AP Name
//Removing any command
//exit and direct to enable mode
//show int config in a table form
//save configuration
//view any available command
“MAKE SURE THE AP HAVE INTERNET ACCESS BEFORE PROCEEDING TO STEP 2. CHECK YOUR CONNECTION OR REPEAT STEP 1.”
Step 2 : Enable Access Point SSID
GUI METHOD
​
1. Open browser and search AP IP (default password usually admin:admin)
AP IP Address
Insert username and password
*by default, username and password is admin. Please refer Step 1 if unable to login.
2. On the left navigation bar, direct to network and then WIFI/WLAN tab.
Step 1
Step 2
3. Click ‘+’. Change the SSID and Encryption Type make it No Encryption. Click on the Advanced Settings and make sure tick 2.4G and 5G WiFi type. Last not lease Save.
Step 1
Step 2
Step 3
Step 4
Step 5
Step 6
4. Try to open Wifi setting and check whether the SSID is created. If there no SSID repeat Step 2 GUI METHOD.
CLI METHOD
1. Enable the SSID
​
Ruijie(config)# dot11 wlan 1
Ruijie(dot11-wlan-config)# ssid YOUR SSID NAME
Ruijie(dot11-wlan-config)# ex
// wlan id usually start with 1 - 16
// SSID name
2. Enable Wifi Radio (make sure int Dot11radio is available)
​
Ruijie(config)# int Dot11radio 1/0.1
Ruijie(config -subif-Dot11radio 1/0.1)# encapsulation dot1Q 1
Ruijie(config -subif-Dot11radio 1/0.1)# wlan-id 1
Ruijie(config -subif-Dot11radio 1/0.1)# ex
//enable 2.4G WiFi
//encapsulate Vlan
//wlan id
Ruijie(config)# int Dot11radio 2/0.1
Ruijie(config -subif-Dot11radio 2/0.1)# encapsulation dot1Q 1
Ruijie(config -subif-Dot11radio 2/0.1)# wlan-id 1
Ruijie(config -subif-Dot11radio 2/0.1)# ex
//enable 5G WiFi
3. Try to open Wifi setting and check whether the SSID is created. If there no SSID observe the configuration whether interface Dot11radio is created or not.
STEP 3: Pointing to KIWIREv3
1. Create DNS
​
Ruijie(config)# ip name-server 8.8.8.8
Ruijie(config)# ip name-server 8.8.4.4
//Enable HTTP
//Enable HTTPs
2. Enable redirection to http & https port 80,443
​
Ruijie(config)# http redirect port 80
Ruijie(config)# http redirect port 443
3. Create the template web authentication
​
Ruijie(config)# web-auth template KIWIREv3 wifidog
Ruijie(config.tmplt.KIWIREv3)# ip 192.168.0.1
Ruijie(config.tmplt.KIWIREv3)# nas-ip 192.168.0.11
Ruijie(config.tmplt.KIWIREv3)# url
Ruijie(config.tmplt.KIWIREv3)# gateway-id G1KD54G001122
Ruijie(config.tmplt.KIWIREv3)# ex
//The template created just now
4. Enable the web portal on the WLAN interface
​
Ruijie(config)# wlansec 1
Ruijie(config-wlansec)# web-auth portal KIWIREv3
Ruijie(config-wlansec)# ex
5. White list
​
Ruijie(config)# web-auth acl white-url
Ruijie(config)# web-auth acl white-url
Ruijie(config)# web-auth acl white-url
http://192.168.0.1 //KIWIRE IP
6. Free URL
​
Ruijie(config)# free-url
Ruijie(config)# free-url
Ruijie(config)# free-url
Ruijie(config)# free-url
7. Done AP configuration. Now will proceed to Step 4.
STEP 4: Setup on KIWIREv3
1. Login the KIWIREv3 Portal
2. Device -> Device (Select Tenant)
Step 1
Step 2
3. Add Device
Step 3
Field That Required *
​
-
Device Type: Controller
-
Identity: AP Serial Number
-
Vendor: WifiDog
-
IP Address: Access Point IP Address
Optional Option
-
Description
-
Monitoring Method
-
Seamless Roaming Interval
-
Community
-
SNMP version
-
MIB
4. Device -> Zone Mapping
5. Add Zone (If Zone already created skip this step)
-
Click Enable
-
Zone Name
-
Limit Connected User: 0
-
Priority: 0
-
Force Profile: None
-
Force Zone: None
-
Journey: Select journey
Click "Create"
6. Add Zone Rules
-
Add New Row (By Click the button on the bottom page). Insert IP Address and Save.
Click "Add new row"
7. Setting in KIWIRE is done. AP should be able to POP UP landing page.
EXTRA 1: MULTI SSID POINTING KIWIRE
1. Create an another SSID as in Step 2 // Make sure different wlan-id
2. Create a new template as in Step 3 // Skip this method if using same template
3. Declare SSID to the template.
Ruijie(config)# wlansec 2 // refer your wlan-id
Ruijie(config-wlansec)# web-auth portal Template Name // the template created just now
Ruijie(config-wlansec)# webauth
Ruijie(config-wlansec)# ex
4. Test Connectivity. If got issues, make sure using correct wlan-id and template.
TROUBLESHOOTING
1. Access Point is pointing to the KIWIRE but no landing page pops up.
Answer:
Check the IP address and Serial Number of the AP is correct filled in the KIWIRE. Check interface web-auth in Step 3, make sure correct filled.
2. A pop up only white screen instead of landing page.
Answer:
Try AP to ping internet and check for any internet connectivity. Check interface web-auth in make sure correct filled.
3. An error page pop up.
Answer:
Check Zone Mapping and Journey on KIWIRE.