Device Configuration: Cambium cnPilot E400

Login to your cnPilot E400 admin panel. Go to Configure-WLAN tab to setup your hotspot networks. Go to Basic tab to setup and enable the SSID.

Go to Radius Server tab to configure the radius server which is Kiwire. Set configuration as below details and leave others as default.

Authentication Server 1 Host: Kiwire IP address

Authentication Server 1 Secret: insert a key and must be the same as Kiwire shared secret key

Authentication Server 1 Port: 1812

Accounting Server 1 Host: Kiwire IP address

Accounting Server 1 Secret: same as Authentication Server 1 Secret

Accounting Server 1 Port: 1813

Accounting Mode: start-interim-stop

NAS Identifier: AP MAC Address (must matched with Kiwire NAS ID)

Dynamic Authorization: Enable

Next, go to Guest Access tab to configure the captive portal settings. Set configuration as below and leave others as default.

Enable: ticked

Portal Mode: External Hotspot

Access Policy: Radius

Redirect Mode: HTTP

External Page URL: http://kiwire-ip/user

Success Action: Redirect user to Original URL

Whitelist:

  • kiwire ip
  • synchroweb.com (if using social login)
  • *facebook.com (if using Google+ social login)
  • *akamaihd.net (if using Google+ social login)
  • *facebook.net (if using Google+ social login)
  • *fbcdn.net (if using Google+ social login)
  • *google.com (if using Google+ social login)
  • *googleapis.com (if using Google+ social login)
  • *gstatic.com (if using Google+ social login)
  • *googleusercontent.com (if using Google+ social login)
  • *instagram.com (if using Instagram social login)
  • *twitter.com (if using Twitter social login)
  • *twimg.com (if using Twitter social login)
  • *vk.com (if using VK social login)
  • *vk.me (if using VK social login)

Kiwire Configuration

Open your web browser and type in http://kiwire-ip/admin to access your Kiwire admin panel.

Go to Device-NAS and click add NAS to add your Ruijie.

  • Device type is Cambium
  • NAS ID is your AP MAC Address (same as the NAS Identifier from Cambium AP)
  • IP address is your Cambium AP IP address
  • Shared Secret Key is the same as secret from the Cambium AP secret
  • COA Port is any port
  • NAS username and password is your Cambium AP username and password
  • Address is your Cambium AP location
  • Description is remark of your Cambium AP

Next, we go to Device-Zone to assign which zone we want to assign splash page. We can assign zone based on NAS ID, VLAN ID, IP address, or SSID. Create a new zone by clicking Create Zone. Put a name to it, Link To User and Limit Connected User can be empty. Then enable the Status.

Finally, you have completed the configuration of both Kiwire and Cambium. Next is you need to design a landing page, create user profile and create user and assign the landing page to the zone desired. You may refer to http://doc.synchroweb.com/kiwire-2-0-directory/ for setting up landing page, user profile, users, and other details of Kiwire.




Device Configuration : FortiWiFi with firmware ver5.2

  1. Setup the FortiWiFi Hostname

In the settings, under the tab System / Dashboard / Status you need to change the hostname with the following settings:

  1. Add the RADIUS server

Under the tab User&Device / RADIUS Servers you need to create a record for primary RADIUS server with the following settings:

Then, you need to configure a FortiGate unit to send accounting interim updates to the Kiwire server to update the status of an active session. In the CLI console, run the following command:

config user radius
edit [name] #name Kiwire
config accounting-server
edit 1
set status enable
set server [IP] # IP of Kiwire
set secret [secret] # shared secret key
end
set acct-interim-interval [duration] #duration between each interim update (600 to 86400 seconds)
end

Here is the sample output:

You can also test a FortiGate user authentication to Kiwire server. Below is the RADIUS diagnostic command:

Fortigate # diagnose test authserver radius radius-server pap user1 password1

Here is the sample output:

As the next step, you need to create a user in User&Device / User Definition settings:

In User&Device / User Groups you need to create an authentication group:

  1. Create a “WALLED GARDEN”

To allow the user to get the content thru the Kiwire Page to connect you need to allow specific IP addresses. To do so, go to Policy & Objects / Addresses. You can create required records based on the table below. You can merge them under one title to make it more clean to understand and allow better management. Specific records for Google, Facebook and Twitter should be created only when you use social networks for authentication.

Also, adding the synchroweb socialgate

Go to Policy & Objects > Objects > Addresses and create an address for the captive portal.

Go to Policy & Objects > Policy > IPv4. Create a security policy for unauthenticated users that allows access only to the captive portal.

In the CLI, enable bypass of the captive portal so that the user can make the initial contact with the external server.

  1. Create the Internet access security policy 

The first rule for allowing the access to selected sources for not-authenticated users

The second rule for access to the DNS service to the master subnet.

  1. Create the WiFi Network

Go to System > Network > Interface to create the WiFi SSID with the following settings:

Go to WiFi Controller > WiFi Network > FortiAP Profiles.  Edit the default profile for your FortiAP model. Enable your SSID for each radio.

 

KIWIRE

  1. Login to Kiwire Captive Portal; http://Kiwire_IP_Address/admin
  2. Go to Device > NAS and add NAS for FortiAP

  1. Go to Device > Zone and create a zone for the FortiWiFi. We can assign the zone based on NAS ID, VLAN, IP address, or SSID.
  2. After that, edit the zone and click AddFinally, you have completed the configuration of both Kiwire and FortiWiFi. Next is you need to design a landing page, create user profile and create user and assign the landing page to the zone desired. You may refer to http://doc.synchroweb.com/kiwire-2-0-directory/ for setting up landing page, user profile, users, and other details of Kiwire.

 

For configuration of Captive Portal on LAN interface, just amend the External Authentication Portal where we need to add “?nasid=[FortiWiFi MAC Address]




Device Configuration : Ruijie

3.1 Ruijie AP Configuration (FAT mode) – using web authentication

Telnet to Ruijie AP (default ip: 192.168.110.1 ; Password: admin)

  1. Configure the IP address

Ruijie#conf

Enter configuration commands, one per line.  End with CNTL/Z.

Ruijie(config)#interface BVI 1

Ruijie(config-if-BVI 1)#ip address 192.168.0.200 255.255.255.0

Ruijie(config-if-BVI 1)#ip route 0.0.0.0 0.0.0.0 192.168.0.1

  1. Create DNS for the AP

Ruijie(config)#ip name-server 8.8.8.8

Ruijie(config)#ip name-server 8.8.4.4

  1. Configure the SSID

Ruijie(config)#dot11 wlan 1

Ruijie(dot11-wlan-config)#ssid TEST

  1. Enable redirection for http port 80 and https port 443

Ruijie(config)#http redirect port 80

Ruijie(config)#http redirect port 443

  1. Create the template for the web authentication

Ruijie(config)#web-auth template KIWIRE wifidog                        #KIWIRE is the template name

Ruijie(config.tmplt.KIWIRE)#ip 192.168.0.209                               #ip address of the Kiwire server

Ruijie(config.tmplt.KIWIRE)#nas-ip 192.168.0.200                       #ip address of the Ruijie AP

Ruijie(config.tmplt.KIWIRE)#url http://192.168.0.209/user

Ruijie(config.tmplt.KIWIRE)#redirect js

Ruijie(config.tmplt.KIWIRE)#gateway-id G1KD54G003803        #serial number of the Ruijie AP

  1. Enable the web portal on the WLAN interface

Ruijie(config)#wlansec 1

Ruijie(config-wlansec)#web-auth portal KIWIRE

Ruijie(config-wlansec)#webauth

Ruijie(config-wlansec)#webauth prevent-jitter 1             #when user disassociated, will send logout immediately

  1. To enable the wall garden

Ruijie(config)#http redirect direct-site 31.13.24.0 255.255.248.0

Socialgate.synchroweb.com: 103.228.53.119

facebook 5.178.40.0/255.255.240.0
195.27.154.0/255.255.255.0
80.150.192.0/255.255.255.0
77.67.97.0/255.255.252.0
212.119.27.0/255.255.255.128
2.16.219.0/255.248.0.0
66.171.231.0/255.255.255.0
31.13.24.0/255.255.248.0
31.13.64.0/255.255.192.0
212.245.45.0/255.255.255.0
213.254.17.0/255.255.255.0
46.33.70.0/255.255.255.0
185.8.148.0/255.255.255.0
Google 216.239.32.0/255.255.224.0
64.233.160.0/255.255.224.0
66.249.64.0/255.255.224.0
72.14.192.0/255.255.192.0
209.85.128.0/255.255.128.0
66.102.0.0/255.255.240.0
74.125.0.0/255.255.0.0
64.18.0.0/255.255.240.0
207.126.144.0/255.255.240.0
173.194.0.0/255.255.0.0
Google+ 216.239.32.0/255.255.224.0
64.233.160.0/255.255.224.0
66.249.64.0/255.255.224.0
72.14.192.0/255.255.192.0
209.85.128.0/255.255.128.0
66.102.0.0/255.255.240.0
74.125.0.0/255.255.0.0
64.18.0.0/255.255.240.0
207.126.144.0/255.255.240.0
173.194.0.0/255.255.0.0
Twitter 199.16.156.0/255.255.252.0
199.59.148.0/255.255.252.0
199.96.56.0/255.255.248.0
192.133.76.0/255.255.252.0

 

  1. Then whitelist the domain

Ruijie(config)#web-auth acl white-url socialgate.synchroweb.com

Type Walled Garden List
Synchroweb social gate socialgate.synchroweb.com
Facebook Login facebook.com
www.facebook.com
akamaihd.net
fbcdn.net
Wechat Login qq.com
weixin.qq.com
Twitter Login twitter.com
twimg.com
Instagram instagram.com
Google www.google.com

google.com

Youtube youtube.com

www.youtube.com

s.youtube.com

 

  1. Then free url the domain
Type Walled Garden List
Synchroweb social gate socialgate.synchroweb.com
Facebook Login facebook.com
www.facebook.com
akamaihd.net
fbcdn.net
Wechat Login qq.com
weixin.qq.com
Twitter Login twitter.com
twimg.comabs.twitter.com

api.twitter.com

*.twimg.com

Instagram instagram.com

*.instagram.com

Google www.google.com

google.com

Youtube youtube.com

www.youtube.com

s.youtube.com

*.youtube.com

*.googlevideo.com

 

Open your web browser and type in http://kiwire-ip/admin to access your Kiwire admin panel.

Go to Device-NAS and click add NAS to add your Ruijie.

  • Device type is Ruijie WIFI
  • NAS ID is your AP serial number
  • IP address is your Ruijie AP
  • Shared Secret Key is any key
  • COA Port is any port
  • NAS username and password is your Ruijie AP username and password
  • Address is your Ruijie AP location
  • Description is remark of your Ruijie AP

Next, we go to Device-Zone to assign which zone we want to assign splash page. We can assign zone based on NAS ID, VLAN ID, IP address, or SSID. Create a new zone by clicking Create Zone. Put a name to it, Link To User and Limit Connected User can be empty. Then enable the Status.

After that, edit the zone by clicking Add.

Finally, you have completed the configuration of both Kiwire and Ruijie. Next is you need to design a landing page, create user profile and create user and assign the landing page to the zone desired. You may refer to http://doc.synchroweb.com/kiwire-2-0-directory/ for setting up landing page, user profile, users, and other details of Kiwire.




Device Configuration : Xirrus

Open your web browser and type in http://kiwire-ip/admin to access your Kiwire admin panel.

Go to Device-NAS and click add NAS to add your Mikrotik.

  • Device type is Xirrus
  • NAS ID is your Xirrus NAS Identifier
  • IP address is your Xirrus IP address
  • Shared Secret Key is your Xirrus Primary Server secret
  • COA Port is Xirrus DAS port 3799
  • NAS username and password is your Xirrus username and password
  • Address is your Xirrus location
  • Description is remark of your Xirrus

Next, we go to Device > Zone to assign which zone we want to assign kiwire page. We can assign zone based on NAS ID, VLAN, IP address, or SSID. Create a new zone by clicking Create Zone. Put a name to it, Link To User and Limit Connected User can be empty. Then enable the Status.

After that, edit the zone by clicking Add.

Finally, you have completed the configuration of both Kiwire and Xirrus. Next is you need to design a landing page, create user profile and create user and assign the landing page to the zone desired. You may refer to http://doc.synchroweb.com/kiwire-2-0-directory/ for setting up landing page, user profile, users, and other details of Kiwire.

 

 

 

Xirrus Setup

Connect to your Xirrus device portal and navigate to the security heading.

On the External RADIUS subheading fill out the fields using the following information.

RADIUS Dynamic Authentication Settings:

  • Timeout (Seconds): 600
  • DAS Port: 3799
  • DAS Event-Timestamp: REQUIRED
  • DAS Time Window: 300
  • NAS Identifier: [Radios MAC Address; without the colon] eg# 506028410B20

RADIUS Attribute Formatting:

  • Called-Station-Id Attribute Format: Ethernet-MAC
  • Station MAC Format: lc-hyphenated
  • Accounting: On

And then save your changes.

Navigate to the SSIDs heading and then to the SSID Management sub heading.

Create a new SSID or use an existing one and tick the WPR setting. This will open the Web Page Redirect Configuration settings.

Configure the fields using the following settings:

  • Server: External Login
  • Redirect URL: http://ip.address/user/index.php
  • Redirect Secret: (Gigabit 1 MAC Address; with hyphenated) eg# 50-60-28-04-3b-3a

Then add the Walled Garden URLs to the whitelist by entering them into the box shown at the bottom left of the screenshot, and clicking create.

WPR Whitelist Configuration

Type Walled Garden List
Synchroweb social gate socialgate.synchroweb.com
Kiwire Kiwire IP address
Facebook Login *.facebook.com
*.facebook.net
*.akamaihd.net
*.fbcdn.net
Wechat Login *qq.com*
*weixin.qq.com*
Twitter Login *.twitter.com
*.twimg.com
Instagram *.instagram.com
VK *.vk.com
*.vk.me

 

Finally, save your changes and reboot your Xirrus.

The reboot is required, as with firmware versions 7.6.2, 8.1.2, 8.1.3, any changes made to the External Radius or SSID options will set the Called Station ID to the wrong format prior to a reboot.

And that should be it. Confirm you can login and view the kiwire pages.

 




Device configuration : Mikrotik

Open Winbox application to access Mikrotik or you may use a web browser to connect to your Mikrotik. Connect to Mikrotik using it’s IP address or MAC address if you are using Winbox.

To start setting up the hotspot network, click on IP-Hotspot and click on Hotspot Setup under Servers tab. Go through the Hotspot Wizard by selecting the desired interface to run the hotspot network.

Create a gateway for your hotspot network and masquerade the network.

Create a DHCP pool range for your hotspot network.

Select none for SSL Certificate.

Leave the SMTP server address as default 0.0.0.0.

Add Google DNS Servers 8.8.8.8 and 8.8.4.4.

Leave the DNS name empty.

Skip the local hotspot user by clicking next.

Now you have successfully created a hotspot network on your Mikrotik. The next step is to point your hotspot network to RADIUS server which is Kiwire. To do that, first, click on the Server Profiles tab and select the hotspot server profile that you just created. Go to the Login tab and tick only HTTP PAP and HTTPS.

Next, go to RADIUS tab and tick on use RADIUS.

Next, go to User Profiles tab and click on the default profile. Edit the Shared Users box by putting 1000.

Go to Walled Garden, add new Walled Garden at the Dst. Host section, select your hotspot server and allow it on the Action. This setting is for allowing the social login and pre-login campaign videos or URLs.
Type Walled Garden List

Synchroweb social gate socialgate.synchroweb.com
Facebook Login *facebook*
*akamai*
*fbcdn*
Wechat Login *qq.com*
*weixin.qq.com*
Twitter Login *twitter*
*twimg*
Instagram *Instagram*
Google+ *google*
*googleapis*
*gstatic*

 

Next, go to Walled Garden IP List and add Kiwire IP address in the Src. Address and Dst. Address and select your hotspot server.

Click on the RADIUS menu and add new RADIUS. Put Kiwire IP address and create a secret. Tick on hotspot for Service.

On the Incoming tab in the RADIUS menu, tick on Accept and use port 3799.


Next, go to System-Identity and set an identity for your Mikrotik. This will be the NAS ID of your Mikrotik.

Next, go to Files, copy below login.html into the existing login.html and edit the url part as http://kiwire-ip/user/index.php. For example, http://controller.synchroweb.com/user/index.php


<html>

<head><title></title></head>

<body>

$(if chap-id)

<noscript>

<center><b>JavaScript required. Enable JavaScript to continue.</b></center>

</noscript>

$(endif)

<center>If you are not redirected in a few seconds, click 'continue' below<br>

<form name="redirect" action="http://controller.synchroweb.com/user/index.php" method="post">

<input type="hidden" name="mac" value="$(mac)">

<input type="hidden" name="ip" value="$(ip)">

<input type="hidden" name="username" value="$(username)">

<input type="hidden" name="link-login" value="$(link-login)">

<input type="hidden" name="link-orig" value="$(link-orig)">

<input type="hidden" name="error" value="$(error)">

<input type="hidden" name="chap-id" value="$(chap-id)">

<input type="hidden" name="chap-challenge" value="$(chap-challenge)">

<input type="hidden" name="link-login-only" value="$(link-login-only)">

<input type="hidden" name="link-orig-esc" value="$(link-orig-esc)">

<input type="hidden" name="mac-esc" value="$(mac-esc)">

<input type="hidden" name="nasid" value="$(identity)" />

<input type="hidden" name="vlan" value="$(interface-name)" />

<input type="submit" value="continue">

</form>

<script language="JavaScript">

<!--

document.redirect.submit();

//-->

</script></center>

</body>

</html>

 

1.1 KIWIRE CONFIGURATION

 

Open your web browser and type in http://kiwire-ip/admin to access your Kiwire admin panel.

Go to Device-NAS and click add NAS to add your Mikrotik.

  • Device type is Mikrotik
  • NAS ID is your Mikrotik identity
  • IP address is your Mikrotik IP address
  • Shared Secret Key is your Mikrotik RADIUS secret
  • COA Port is Mikrotik Incoming port 3799
  • NAS username and password is your Mikrotik username and password
  • Address is your Mikrotik location
  • Description is remark of your Mikrotik

Next, we go to Device-Zone to assign which zone we want to assign splash page. We can assign zone based on NAS ID, VLAN ID, IP address, or SSID. Create a new zone by clicking Create Zone. Put a name to it, Link To User and Limit Connected User can be empty. Then enable the Status.

After that, edit the zone by clicking Add.

Finally, you have completed the configuration of both Kiwire and Mikrotik. Next is you need to design a landing page, create user profile and create user and assign the landing page to the zone desired. You may refer to http://doc.synchroweb.com/kiwire-2-0-directory/ for setting up landing page, user profile, users, and other details of Kiwire.

 

Setup rate limit / bandwidth control for Mikrotik PPPOE

Kiwire can also support dialup pppoe services for Mikrotik as controller, with Mikrotik as PPPOE server is an popular option for fixed fiber or wifi always on internet services for telco or internet service provider .

One of the requirement is to provide bandwidth or rate limit to the subscriber , the default profile by Kiwire is for WISPr ( Wireless ISP ) which use Wispr attribute , however you can use policy-> radius attribute to add PPPOE rate limit attribute to the profile. the step are

    1. create a profile as usual for your subscriber
    2. Access Radius attribute editor by going to Policy-> Radius Attribute
    3. Add the attribute “Mikrotik-Rate-Limit” ,select “:=” as operator and value in K or MB as you desire in upload/download format as the screenshot.

 

Schedule script

The schedule script will enable automatic download of wallgarden list and firewall list into the mikrotik nas on an interval.

mik_schedule

  1. Login to winbox
  2. Go to System > Scheduler and add a new task by pressing the plus sign.
  3. Under the field Name type “firewall”
  4. set the Interval to 01:00:00 
  5. Paste the following text into it, replace the ip of “192.168.0.202” with your kiwire server ip.



Kiwire 2.0 social network login whitelist

Walled garden for the Social Login
(web sites/domains to open)

The walled garden is a list of web sites/domains that end-users are able to visit without being authenticated.
In order to correctly configure the Social Login feature, it is necessary to add web sites to the walled garden. Mainly because the authentication is directly performed on the social network website, and no password is stored or processed in our Solution.

Social Login can be configured to run with the following providers:

  • Facebook
  • Foursquare
  • Gmail
  • Google+
  • Instagram
  • LinkedIn
  • Pinterest
  • Twitter
  • Wechat
  • VKontakte

The default domain that to be white list / wall garden are socialgate.synchroweb.com and the domains to open are the following:

Facebook
facebook
facebook.com
facebook.net
akamaihd.net
fbcdn.com
fbcdn.net
Foursquarefoursquare
foursquare.com
4sqi.net
doubleclick.net
In the login box displayed during the login, it is possible to connect a Foursquare account to an existing Facebook account. In order to allow this operation, it is necessary to add also the walled garden entries for Facebook.
Googlegoogle
google.com
googleapis.com
gstatic.com
We recommend you to add also your local Google domain (e.g. “*google.us” for USA, “*google.it” for Italy, “*google.co.uk” for UK, etc.).
Google+google_plus
google.com
googleapis.com
gstatic.com
googleusercontent.com
We recommend you to add also your local Google domain (e.g. “*google.us” for USA, “*google.it” for Italy, “*google.co.uk” for UK, etc.).
Instagraminstagram
instagram.com
akamaihd.net
LinkedInlinkedin
linkedin.com
licdn.com
Pinterestpinterest
pinterest.com
pinimg.com
In the login box displayed during the login, it is possible to connect a Pinterest account to an existing Facebook, Google+ or Twitter account. In order to allow this operation, it is necessary to add also the walled garden entries for Facebook, Google+ or Twitter.
Twittertwitter
twitter.com
twimg.com
abs.twitter.com
Wechat

wifi.weixin.qq.com
VKontaktevk
vk.com
oauth.vk.com
vk.me

 

If you are not able to use domain name , please whitelist/wallgarden the ip address as bellow

Socialgate.synchroweb.com : 103.228.53.119

Facebookfacebook
5.178.40.0/255.255.240.0
195.27.154.0/255.255.255.0
80.150.192.0/255.255.255.0
77.67.97.0/255.255.252.0
212.119.27.0/255.255.255.128
2.16.219.0/255.248.0.0
66.171.231.0/255.255.255.0
31.13.24.0/255.255.248.0
31.13.64.0/255.255.192.0
212.245.45.0/255.255.255.0
213.254.17.0/255.255.255.0
46.33.70.0/255.255.255.0
185.8.148.0/255.255.255.0
Foursquarefoursquare
The information is not available at the moment. Sorry for the inconvenience.
Googlegoogle
216.239.32.0/255.255.224.0
64.233.160.0/255.255.224.0
66.249.64.0/255.255.224.0
72.14.192.0/255.255.192.0
209.85.128.0/255.255.128.0
66.102.0.0/255.255.240.0
74.125.0.0/255.255.0.0
64.18.0.0/255.255.240.0
207.126.144.0/255.255.240.0
173.194.0.0/255.255.0.0
We recommend you to add also IP address ranges of your local Google domain (e.g. google.us for USA, google.it for Italy, google.co.uk for UK, etc.).
Google+google_plus
216.239.32.0/255.255.224.0
64.233.160.0/255.255.224.0
66.249.64.0/255.255.224.0
72.14.192.0/255.255.192.0
209.85.128.0/255.255.128.0
66.102.0.0/255.255.240.0
74.125.0.0/255.255.0.0
64.18.0.0/255.255.240.0
207.126.144.0/255.255.240.0
173.194.0.0/255.255.0.0
We recommend you to add also IP address ranges of your local Google domain (e.g. google.us for USA, google.it for Italy, google.co.uk for UK, etc.).
Instagraminstagram
The information is not available at the moment. Sorry for the inconvenience.
LinkedInlinkedin
The information is not available at the moment. Sorry for the inconvenience.
Pinterestpinterest
The information is not available at the moment. Sorry for the inconvenience.
Twittertwitter
199.16.156.0/255.255.252.0
199.59.148.0/255.255.252.0
199.96.56.0/255.255.248.0
192.133.76.0/255.255.252.0
Wechatwechat
The information is not available at the moment. Sorry for the inconvenience.
VKontaktevk
87.240.128.0/255.255.224.0




Kiwire 2.0 chapter 12 – Help & tools

The Help & Tool Tab report tab provide your useful tools for diagnostic and assistance to your network and system via Kiwire .

12.1 Online Knowledge Base

The Online Knowledge base module provide a quick and easy way to access our Kiwire online Knowledge base and up to date Documentation .
help_knowledge

12.2 Diagnostic User Account

The Diagnostic user account let you perform account diagnostic using the user’s username and password to check if there is any problem of the account . This feature is also accessible from user account or voucher account view.

Screen Shot 2017-01-06 at 4.43.59 PM

 12.3 Software Update

The Software update module let you perform Software update into the kiwire system , do backup your database before perform upgrade.

Screen Shot 2017-01-06 at 4.45.26 PM

Please follow the following Step to update the software

  1. Click on Step 1 “Download and Update database schema ” this will synchronize your Kiwire Database with the latest Kiwire database schema from our update server
  2. Click on Step 2 ” Download and Update Kiwire update” this will perform software update to the kiwire system , during the upgrade process all user who try to connect to the kiwire system will not be able to do so. thus it recommended to run this process during non peak duration of your network , you can use report : Login frequency to find your non peak hour duration.
  3. Click on Step 3 ” Update Kiwire database data” will update the kiwire new module feature with access control and relevant initial configuration.

 

 

12.4 Database -> Diagnostic Database

The Diagnostic database module , provide you a tools to check and repair the kiwire database engine,use this tools to repair and optimise your database when you have database error or fault.

Screen Shot 2017-01-06 at 4.46.17 PM

12.5  Database – > Database performance

This module provide statistic of key database performance variable

12.6  Database – > Database disk usage

This module provide disk usage of the database system.

Screen Shot 2017-01-06 at 4.48.42 PM

12.7 Database -> Database MRO

The Database MRO ( maintenance / repair / operation ) module let you perform

  • Backup of Kiwire database to your local computer
  • Restore Kiwire database from backup.
  • Purge all Administrator & system activity logs
  • Purge all login transaction record
  • Purge all user device information record
  • Purge Portal Impression record.

Screen Shot 2017-01-06 at 4.47.26 PM

12.8 Service Status

The service status provide you an overview of important services required by Kiwire system to operate optimally.Screen Shot 2017-01-06 at 4.50.05 PM

12.9 System Health

The system health module give you a overall health status.

Screen Shot 2017-01-06 at 4.50.46 PM

Tab Information
Health Report The current snapshot of system usage of system load , ram utilized and free disk space
CPU Usage Real time graph showing the CPU utilisation of the system.
Disk Usage Detail information of disk utilisation by system.

12.10 IP network calculator

The ip network calculator let your perform network ip address calculation based on the ip and subnet given.
help_ipcalc

12.11 Ping Tools

The Ping tools module let you perform network icmp ping to a host and see the response time.

help_ping
12.12 Find Mac Address

Find Mac address module let you find a location and information related to a mac address.It will provide insight of the login time , ip address location of the Mac device is being used in your network. Mac address are unique to a device.

Tab Information
Diagnostic Result: Brand and associated account This provide information of the Brand of the Mac address device if its from known manufacture and username registered with the mac address using mac auto register
Diagnostic : Login history Login history of the login username , ip address using the mac address

 




kiwire 2.0 chapter 11 – Reports

Kiwire Report modules consist of many unique and advance reporting module that provide unique analytic reporting on your user and network. It provide detail technical information for your organisation technical team and provide valuable insight into your users for marketing and business development.

11.1 Account -> Account Summary

The Account summary module provide you a summary overview of your users. It will list no of users with its status and no of voucher/prepaid.

Screen Shot 2017-01-06 at 3.27.39 PM

11.2 Account -> Account Expiry

The account expiry report module will list all expired modules and its interval .

Screen Shot 2017-01-06 at 3.32.35 PM

11.3 Account -> Voucher Activation

The Voucher Activation module , will report actual  voucher that is being used by detecting if the voucher has been use to login to network. This will provide an actual usage revenue generation of the voucher.

11.4 Account -> Voucher Availability

Voucher Availability will report upcoming expire voucher by the date range , this will assist to forecast the availability & voucher inventory.

Screen Shot 2017-01-06 at 3.56.28 PM

 11.5 Login -> Who is Online

The who is online report will list all user who is connected to your network regardless from which NAS equipment or zone.

Column Information
Login Date/Time The date & time the user login into the network
Username The username used by user to login
Mac Addr The Mac address of the user device
Nas ID The name of the NAS equipment the user login from
Ip Adress The ip address of the user device
Action Click on
blockTo disconnect user from networkzoomTo view the user account detail

 


Note : if you detected stale user ( Stale user or ghost account are user who disconnected information are not send by NAS due to NAS equipment failure ) , click the disconnect to disconnect the user manually.


11.6 Login -> Login History

The Login History report module will list all the user logged in history report.

Screen Shot 2017-01-06 at 3.51.01 PM

Column Information
Login Date/Time The date & time the user login into the network
Logout Date/Time The date & time the user log off from the network
Total Time The total time used by the user login session
Username The username used by user to login
Mac Addr The Mac address of the user device
Nas ID The name of the NAS equipment the user login from
Ip Adress The ip address of the user device
Traffic Use The total traffic used by the user during the duration of login in MB
Action View the user account detail

 

11.7 Login ->  Login Transaction

The Login transaction will list all login transaction of user in the network, it will show the success and failure of the user and the reason of login failure.


Note : Not applicable to not radius based NAS.

 

Screen Shot 2017-01-06 at 3.52.16 PM

Column Information
Date/Time The date & time the user try login into the network
Username The username used by user try or used to login
Password Used If user used a correct password the password will be masquerade from view,however if wrong password used it will be shown as clear text.
Login Success or failure of the login attempt

 

11.8 Login -> Login Transaction Summary

The Login transaction will provide a graphical report of the network user login success and failure. This graphical report will tell give you an insight on your network performance , example  if your users are having high rate of issue of wrong password or trouble login in . Use the search option to view specific date range. To view by daily sample data , click on view icon on the row and you be presented the information of login transaction summary group by hourly for the particular date.

Screen Shot 2017-01-06 at 4.24.44 PMScreen Shot 2017-01-06 at 4.24.55 PM

Column Information
Date The date of the sample data
Accept No of success login
Reject No of failure login
Hourly view view the hourly report of the date.

11.9 Login ->  Login Frequency

The Login Frequency report module will provide a graphical chart report on the no of user login frequency over a period of time by no of login vs unique login. This report primary objective is to provide you insight of user behaviour.  Use Search box  date from and date to , to select the report period and zone if you wish to view by zone.

An example use case will be if high total no of login and low unique user , means a user may have problem accessing the network in a wifi environment due signalling issue.

 

Column Information
Date The date of the sample data
Unique ID No of unique login
Total Login No of Login.
Hourly view zoomto view the hourly report of the date.

 

11.9.1 Login -> Login Frequency hourly view.

The hourly report view will let you drill down to login frequency by per hour basis for the particular date.

11.10 Login -> Login Frequency By Profile

The login frequency by profile will show the login frequency report but group by Profile instead this provide you insight on while profile is deem popular and are active during the duration of date selected. Use the date range selection to select the date of reporting you wish to view and if you wish to view by zone , click on the zone selection as well.

Column Information
Date The date of the sample data
Plan Name The Plan name
Unique Login No of unique login
Total Login No of Login.
Hourly view zoomto view the hourly report of the date.

 

11.10.1 Login -> Login Frequency By Plan hourly view

The hourly report view will let you drill down to login frequency by per hour basis for the particular date.

 


11.11 Login -> Login Device Frequency

The device login frequency report module will report the login frequency by device mac address / identity . This will detect if a same device is used with multiple username or vice versa and provide an accurate login frequency as usually the no of device is unique in a public wifi environment. Use Search box  date from and date to , to select the report period and zone if you wish to view by zone.

 

Column Information
Date The date of the sample data
Unique Device No of unique device use for the login
Total Device login To no of device use to login
Hourly view zoomto view the hourly report of the date.

11.12 Login -> Login Concurrency

The login concurrency report will show the concurrency usage of user , as some user may use more than 1 hour or days for their network access. Concurrency report will tell the actual connected user over the period of time . this report provide a graphical report of the concurrency and utilization of the internet . This provide a way to plan for your network upgrade . Use the date range selector to select  the report period and zone if you wish to view by zone.

Column Information
Date The date of the sample data
Total concurrent user No of concurrent connected user during the time.
Hourly view zoomto view the hourly report of the date.

11.13 Login -> Login Error

The login Error report will provide statistic and overview of error encountered by users in the last 24 hour , select the log file to load by the date . The log file date format is log-YYMMDD ( YY = Year, MM = Month , DD = Date ).

report_log_error

11.14 Login -> Login Dwell Time

The login dwell time will provide an analytic on user average usage time within the network.Dwell time will provide insight on your user average usage time.Use Search box  date from and date to , to select the report period and zone if you wish to view by zone.

Column Information
Date The date of the sample data
Total Login No of login recorded by system
Average Dwell time Average dwell time in hour metrics
Detail view view the hourly report of the date.

 

11.14.1 Login -> Login Dwell Time by hourly

The login dwell report hourly view will break down the dwell time by few key metric group such as under 5 minutes , 10 ~ 15 mins and others. Click on the Funnel Chart if you wish to view in funnel chart format instead of pie chart.

Screen Shot 2017-01-06 at 4.29.37 PM

11.15 Login -> Return User

The Return User Report module will provide the information of returning user , or user who has login more than 1 and re-login again over a period of time. Use Search box  date from and date to , to select the report period and zone if you wish to view by zone.

 

11.16 Login -> Top User

The top user report module will show the top 50 repeated login use in the network with the sample date selected.

report_top_user

11.17 Login -> New/Repeat Login

The New vs Repeat user login will overlay 1st time login users vs the return or repeat user  login to your network. Use the date range to select the report date ranges and zone to view by zone.

11.18 Bandwidth -> Bandwidth Usage

The Bandwidth usage report will report the total bandwidth usage used by your users within the network. Use Search box  date from and date to , to select the report period and zone if you wish to view by zone.

Note : the metric for bandwidth usage will be in GB

11.19 Bandwidth -> Bandwidth per user

The Bandwidth Report per user module will show the bandwidth utilisation information send by NAS to Kiwire via radius accounting protocol. it will let you view the specific user bandwidth utilisation .The table will show the average Upload and Download Speed in MBit as well.


Note : A 50MB speed cap will shown max average speed at 5Mbit/s average. using 95% projectile calculations.


 

11.20  Bandwidth -> Historic Top Bandwidth User

The top bandwidth user report will show the top user who utilize the most bandwidth in the network. This report show the Top Bandwidth User . use the date range if you want to sample specific dates for the report. Use Search box  date from and date to , to select the report period and zone if you wish to view by zone.

 

Column Information
Login Date/Time The date & time of the sample data
Username The username of the account used
Usage time The total time used by the user login session
IP IP address of the user device
Download ( GB ) The total utilization of download traffic used by the user
Upload (GB) The total utilization of upload traffic used by user
Average Download Average Download Speed of the user in MBit/s
Average Upload Average Upload Speed of the user in MBit/s

11.21 Bandwidth -> Current Top Bandwidth User

The top bandwidth user report will show the top user who utilize the most bandwidth in the network at the moment .

 

Column  Information
Login Date/Time The date & time of the sample data
Username The username of the account used
Usage time The total time used by the user login session
IP IP address of the user device
Download ( GB ) The total utilization of download traffic used by the user
Upload (GB) The total utilization of upload traffic used by user
Average Download Average Download Speed of the user in MBit/s
Average Upload  Average Upload Speed of the user in MBit/s

11.22 Monitoring -> Current Device Availability

The current device availability report module will show the all the equipment current availability status

Status Information
UP/Online No of device currently on-line and operational
Down/Offline No of device currently off-line and failed
Unknown No of device that is unknown status , which is usually mean the device is recently added and have no status detected yet.

 

11.23 Monitoring -> Device Availability

The Device availability report module will show the device historic operational status over a period of time specific .

Status Information
Date The date of the sample data
UP/Online No of device currently on-line and operational
Down/Offline No of device currently off-line and failed
Unknown No of device that is unknown status , which is usually mean the device is recently added and have no status detected yet.
Availability The overall equipment on-line availability in percentage.

 

11.24 Campaign -> Captive Portal Impression Report

The Captive portal impression report will provide you an impression report of all the impression view by user. this including unauthenticated user as well. this is useful if you want to know how many user have view your message or slider advertisement. The Unique user are unique user that view the impression and Total is the overall view done by user , eg it can have 2 user but view the the impression 4 time it will have 2 as unique user and 4 as Total impression. Use the date selector to select the date range

 

Column Information
Date The date of the sample data
Unique User No of view of the screen by unique user.
Total impression Total impression recorded
Hourly view view the hourly report of the date.

11.25 Campaign -> Impression by zone

The Captive portal impression by zone report will provide you an impression report of all the impression view by user group by the vlan zone. this including unauthenticated user as well. this is useful if you want to know how many user have view your message or slider advertisement in the specific zone, the 8.20 report is an overview report of total , while the by zone will provide breakdown by zone.. The Unique user are unique user that view the impression and Total is the overall view done by user , eg it can have 2 user but view the the impression 4 time it will have 2 as unique user and 4 as Total impression. Use the date selector to select the date range and zone to view the zone you wish to see the report of.

 

Column Information
Date The date of the sample data
Unique User No of view of the screen by unique user.
Total impression Total impression recorded
Hourly view zoomto view the hourly report of the date.

11.26 Campaign -> Impression Vs Login

The Captive portal impression Vs Login will tell provide campaign report of how many user view the login page / campagin page and actual no of login into the network.

 

Column Information
Date The date of the sample data
Total impression Total impression recorded
Total Login Total Login recorded
Hourly view zoomto view the hourly report of the date.

11.27 Campaign -> Campaign Impression 

The campaign impression provide a report on actual impression of the ads campaign by active campaign. Use the search box to see the date range for the report

 

Column Information
Campaign Name The Campaign name
Duration  Campaign running duration
Zone  Zone the campaign will run
Who Who the campaign audience
Trigger Trigger for the campaign
Action Type of media or campaign action
Total Impression Total impression recorded for the campaign.
Action view the date range view of the campaign impression

11.27.1  Campaign Impression date range view

The campaign data range view will provide a selected date range view of the campaign activity.

 

11.28 Campaign -> Campaign Click Engagement

The campaign Click engagement provide a report on actual users click or engage on ads or link of the  all campaign. use the date range to view the date range of the report.

 

Column Information
Campaign Name The Campaign name
Duration  Campaign running duration
Zone  Zone the campaign will run
Who Who the campaign audience
Trigger Trigger for the campaign
Action Type of media or campaign action
Total Click thru Total engagement/click of the campaign.
Action zoomto view the date range view of the campaign impression

11.28.1  Campaign Click Engagement detail

The campaign Click engagement detail view will provide per campaign view of the selected campaign of the date range. Click on Hourly if you wish to drill down to the per date report view of the campaign.

11.29 Report: Campaign : Offline Campaign

The offline campaign will provide overview of engagement of the offline campaign.Engagement of offline campaign are campaign are action such as E-mail send, SMS send or API triggered. use search box to select the date range.

11.29.1 Report: Campaign : Offline Campaign detail

The offline campaign detail view will provide report of the engagement of the offline campaign by per campaign basis on the date range selected.

11.30 Campaign ->  SMS Send Report

The SMS send report will show how many SMS send during the date range selected by the search box. use the Hourly view if you wish to view the sms activity by per hour basis for that date.

11.31 Campaign -> Coupon view report 

The coupon view report will show how many user redeem the coupon by viewing the coupon. select the coupon campaign which you wish to view . and click search to view

11.32 Campaign -> Survey Report

The survey report will display the record for the survery perform by users. Select the survey from the drop down to view the data recorded.

11.33 Insight -> Device Info

The device information report module will provide insight into your network , on what type of device and brand the user is using to connect to the network. Use the date selector to select the date range and zone to view the zone you wish to see the report of.

report_device1report_device2

Column Information
Device Type Connecting to network The total no of device by type such as

  • Computer [ Laptop / PC ]
  • Phone [ Smart phone ]
  • Tablet [ Tablet device ]
Device Brand connecting to network The manufacture brand of the device used.

 

11.34 Insight -> Visitor Registration Data

The visitor registration data report module will display all the information recorded by the user during guest self sign up as well as additional data-field that you may have setup at the datafield module.

 

11.35 Insight -> User access URL history

The User access URL history will list user url access url. This provide you insight with the user browsing history and behaviour. Click on the “Delete all Record” button to purge the data.

 

Column Information
Date The date of the sample data
IP Ip address of user
Username Username of the user
Mac Address Mac Address of user device
URL The URL the user browse to.

11.36 Insight -> Social Network Analytics

The Social Network Analytics will provide an overview and insight of the Social network growth and activity of your network. Use search box to select the date range.

report_sns

11.37 Insight -> Social Users Information

The Social Network information provide you information of user who use social network to login to your network, it provide you demo/bio graphy information of the users that sign up.

report_social_info

11.38 Omaya -> Benchmark

The Omaya benchmark provide reporting of LBS benchmark between all your zone/outlet , if you have omaya product intergrated via Intergration->Omaya

11.39 Omaya -> Unique visit.

The Omaya unique visit provide  LBS data on unique visit to your zone, LBS data include unconnected smart devices . if you have omaya product intergrated via Intergration->Omaya

11.40 Logs -> Radius Log

The radius log report module will display the kiwire built in radius log


Note : only available display for super admin only.


Column Information
Date The date of the log being recorded
Time The time of the log being recorded
Facility The Log facility used ( auth/info/error/etc )
Log The Log messages

 

11.41  Logs -> Nas Log

The NAS log report module will display the compatible NAS syslog log , log by kiwire.


Note : only available display for super admin only.


 

Column Information
Date The date of the log being recorded
Time The time of the log being recorded
Log The Log messages

 

11.42 Logs -> Kiwire Syslog

The Kiwire Syslog log report module will display all the Kiwire platform syslog for the operating system it reside on.


Note : only available display for super admin only.


Column Information
Date The date of the log being recorded
Time The time of the log being recorded
Log The Log messages

11.43 Logs -> Captive Portal Syslog

The captive portal syslog module will provide the report of the user interaction within the captive portal. This report will provide insight into user behaviour.


Note : only available display for super admin only.


 

Column Information
Date The date of the log being recorded
Time The time of the log being recorded
Log The Log messages

11.44 Real time logs ->  Radius

The realtime radius log display the radius log in real-time format to the administrator. This is usefull for diagnostic purpose.


Note : only available display for super admin only.


 

11.45 Real time logs -> Http access 

The Realtime Httpd report module will display real-time log of the apache access server built in Kiwire system


Note : only available display for super admin only.


 

11.46 Real time logs ->  httpd error log

The Realtime Httpd report module will display real-time log of the web server  error log detected server built in Kiwire system


Note : only available display for super admin only.


 

11.47 Logs -> Administrator Activity

Kiwire system log all administrator activity as part of its security audit . The Administrator activity module will list all the activity of the administrator or operator.

report_admin

Status Information
Date The date of the sample data
Username Username of administrator or operator.


*Note : the kiwire have automated scheduler application running , all activity log will be using the username “system”

Activity The activity performed.

 




Kiwire 2.0 Chapter 10 Finance

The Finance tab contain module that is related to financial aspect of Kiwire platform, from billing and revenue generated.

10.1 View Invoice

The view invoice module let you view all charges that is being utilise by profiles that uses internal as its billing module. The system will generate monthly billing invoice automatically.

  • Click search date to search the date range for the invoices
  • use print invoice to view the invoices and print the invoices to printers.

Screen Shot 2017-01-06 at 3.18.39 PM

10.2 Manual Posting

The manual posting module let you post/charge an amount to Integration : PMS module, the charges will be reflected into the guest folio

Screen Shot 2017-01-06 at 3.19.27 PM

Field Purpose
Post to Chose the PMS to post to
UserID / Room No Type in manually or select from the list of user
Charge Amount The amount to charge
Remark Remark of the charges

10.3 PMS Posting Queue

The PMS Posting Queue module , let you view and summary the revenue generated by Integrations : PMS charges. it will also let you view the status of posting of charges. and grand total of charges posted.

10.4 Voucher Creation

The voucher creation module list all list the voucher generated and by who as well as when it was created. This is useful for audit purpose and how much expected revenue generated from prepaid card generation. If your organisation revenue are based on actual activation or usage of prepaid / voucher , please refer to voucher activation module .

Screen Shot 2017-01-06 at 3.20.02 PM

10.5 Print Prepaid Slip

The Print voucher Slip module lets you print or export the voucher to few format.

Screen Shot 2017-01-06 at 3.21.04 PM

  • Print (A4) :
    Screen Shot 2017-01-06 at 3.22.34 PMPrint the bulk voucher account in A4 Format. if you have selected “print admin copy” in general configuration module, all prepaid printed will have 2 copy 1 for user and one for operator/administrator for record keeping in hard copy format.
  • Print (POS) :
    Screen Shot 2017-01-06 at 3.23.53 PM Print the bulk voucher account in label printer format or Point of sales thermal
    printer format.
  • Print (QRCODE) :
    Screen Shot 2017-01-06 at 3.24.15 PM
    Print voucher format , this is useful to Mobile phone as they can scan and utilise autologin to the network using QRCODE.
  • Export :
    Screen Shot 2017-01-06 at 3.25.03 PM
    Export to Excel format, which you can manipulate the printout or send Professional Printer/house and print your own design prepaid card.



kiwire 2.0 chapter 9 – Campaign

The Campaign modules , let you manage all Kiwire precision marketing or campaign within your network. Campaign Engine is a unique wifi marketing application that help you gain new user , engage your users and monetize your  network.

 KiwireChart

9.1 Campaign Management.

Campaign is call to action function of our wifi marketing platform.At the heart of Campaign is Campaign Management, which is the module that let you control and manage all the campaign for your network. Create campaign such as offer welcome coupon on user 1st time login to network. Send sms to users who did not seen or connect to the network for 40 days to reach them. Campaign modules come with approval process flow that required authorised administrator or operator to approve the campaign before the campaign is enabled.
Component listing.

Campaign Name The campaign name given
Status  Status of the campaign.
Duration The campaign duration dates
Sort order The ordering of the campaing.
Zone The Zone the campaign will run on
Who The demographic users the campaign will apply to
Trigger The trigger for the campaign
Action Action type for the campaign.
Target the target action for the campaign
Remark Remark if any for the campaign
Action Modules action.

Screen Shot 2017-01-06 at 2.39.19 PM To edit the campaign entry.

icon_delete To delete the campaign

Screen Shot 2017-01-06 at 2.39.10 PM to approve the campaign.

9.1.1 Create campaign.

To create campaign click  create campaign  button


Note: newly created campaign will required approval to enable the campaign to go live.


Screen Shot 2017-01-06 at 2.57.39 PMScreen Shot 2017-01-06 at 2.57.48 PM

Field Function
Campaign Name The Name of campaign
Start Date Start date of the campaign.
End Date
End date of the campaign.
Remark Remark for the campaign.
Status Enable or disable this campaign


note: if  the the end date have reach even enable the campaign, it will still consider to be stoped.


Who : Target The intended audience of the campaign
Who : Zone Which Zone ( vlan / nas ) the campaign will run on
When : Interval
  • Always
    Run at all time
  • Specific time zone
    run only during in between that hours.
When : Trigger 
  • Connect
    The campaign will run on user 1st time connected to the network. before the login
  • Login
    The campaign will be run on user login into the network.
  • 1st Connect
    The campaign will be run on user 1st time login to network.
  • Disconnect
    The campaign will be run on user disconnected from the network
  • Dwell
    The campaign will run on user dwell time more than campaign define minutes ( min 30 mins ).
  • Recurring
    When user login the define recurring no of user wil run this campaign.
  • Milestone 
    The campaign will run when user login the define milestone no.
  • Last visit
    The campaign will apply on all user who last visit is more than defined days.
Perform : Display ADS the campaign will display ads to user , from the ads library .
Display ADS will only work on Trigger ( Connect, Login,1st Login,Recurring and Milestone. ).
Perform : Send Notification Send SMS, Email or trigger API when the campain is executed. type the message into the Notify Message.
Perform : Redirect to URL The campaign will redirect user to a url.
This will only work on Trigger ( Connect, Login,1st Login,Recurring and Milestone. ).

 

Video example

https://youtu.be/hODKtJ8tn0E

 

9.1.2 Campaign approval.

If the cloud_id or system have more than one administrator, all newly created campaign will require approval before the campaign is set to enabled.  Administrator can add sub administrator or operator with verify/approval status from the role management.


 NOTE : in multi-tenant / cloud edition of kiwire, superadmin can approve other cloud tenant campaign, but superuser cannot create and approved its own campaign. The design is that the superadmin is an approval person not campaign creator.


 

To approve a campaign. 

  1. Operator added or edited a campaign.
  2. campaign added with at the ads listing an approval icon will appear
    campaign_approval
  3. Administrator with approval right will need to click on the approval icon to approve the campaign. To add administrator with approval create administrator with “verify” in the roles via Configuration -> Role modules
  4. Upon approval , the status will changed to Enabled.

9.2 Ads Management

Ads management module is where you mange and upload all Ads into the Ads library.

Ads Name The Ads name given
Message Message to be display when ads is being display.
Ads File The ads filename uploaded , for youtube it will be the url of the youtube video
Media Type The media type
Added Date The date the ads is added
Status Status of ads
Action Modules action.

Screen Shot 2017-01-06 at 2.39.19 PM To edit the ads entry.

icon_delete To delete the ads

Screen Shot 2017-01-06 at 2.39.10 PM to approve the ads.

9.2.1 Add /edit Ads

To add new ads , click on the “create ads” button.

Screen Shot 2017-01-06 at 3.08.17 PM

Field Function
Ads Name The Name of Ads
Message  The message for the ads
Remark The remark for the ads
link Url for the Link, for youtube paste the url of the yourtube ads.


*Note : please put in the watch url link eg “https://www.youtube.com/watch?v=mOO5qRjVFLw” but not the embeded link.


media type The media type

  • Image 
    Image ads type , media type supported ( jpg, png & gif )
  • Video
    Video ads type , media type supported ( mp4 & ogg )
  • Youtube video link
    Youtube video link , put the youtube watch url into the link.
  • Message
    Message ads , display a text message.
Who : Target The intended audience of the campaign
Who : Zone Which Zone ( vlan / nas ) the campaign will run on
Ads File  The ads file to upload to.
Status  enable or disable the ads.

9.2.2 Ads approval step.

Same as campaign management, all ads created or edit will require approval if there is more than one administrator within the platform. To approve an ads.


 NOTE : in multi-tenant / cloud edition of kiwire, superadmin can approve other cloud tenant ads , but superuser cannot create and approved its own ads. The design is that the superadmin is an approval person not ads creator.


  1. Operator added or edited a new ads media
  2. Ads media added with status Disabled  , at the ads listing an approval icon will appearads_apr
  3. Administrator with approval right will need to click on the approval icon to approve the ads and the ads status will be changed to “enabled”.To add administrator with approval create administrator with “verify” in the roles via Configuration -> Role modules

9.3 Offline campaign 

Manage all active offline Campaign. Offline campaign are campaign based on trigger “Dwell ” and ” Last Login “All available non active campaign will be listed on Available Campaign List , and all active campaign will be listed to running campaign.

9.4 Survey 

Survey are form that  let your  gather feedback from your users, our smart survey engine let you Create ,view and manage Survey in your network.

9.4.1  Create new survey.

To  create a survey your need to create a survey then add the questionnaire into the survey. to create survey click on “create survey” button. fill in the survey title and description, this will be displayed at the survey form. when completed, click on edit survey to add the question you wish to ask users.

Screen Shot 2017-01-06 at 3.09.57 PM

General term:

Field Function
Tittle The tittle of the survey
Description The description for the survey.

 

9.4.2 Add Question

To add question to a survey click on “add a question” link , you be prompt on type of question type and expected result such as text , multiple choice or true or false questions.

 

Screen Shot 2017-01-06 at 3.11.16 PM

Field Function
Order The order of question
Is required  is the question required to be filed.
Question  

Type the question into the message box

Question type 
  • True or false
    A true or false question
  • Short/long text
    A short or long text answer.
  • Multiple question – single answer
    user need to select a answer from multiple choice
  • Multiple question – Multiple answer
    User need to select multiple answer from multiple choices
  • Numeric – discrete
    user need to reply a discrete numeric answer.
  • Numeric – continuous
    user need to reply a numeric continuous.
  • email
    user reply email.
  • Date 
    user fill in a date.
  • Drop down
    user select answer from drop down selection

9.5 Coupon Management

coupon management modules let you add coupon that can be redeem by users when connect to your network via the campaign engine or control panel.

Screen Shot 2017-01-06 at 3.12.06 PM

Component listing

  • Title : the title of the coupon
  • Detail : description text for the coupon
  • Code : the coupon code
  • Expiry date : the date the coupon will expiry

9.5.1 Add / edit coupon

To add or edit coupon click on “Create Coupon ” button,

coupon

Field Function
Title Title of the coupon
Coupon images the image for the coupon . this can be a logo or ads
Details The description text which will be displayed with the coupon
Price  The price for the coupon
Expiry date The expiry date for the coupon
Code The assigned Code