Purpose of this document
-
This document should be used in conjunction with Ruckus Zone Director user guide for configuring your Zone Director gateways in WiOS Cloud. Please refer to WiOS administrator guide and Zone Director user guide for detail information.It assumes that the user has basic knowledge of networking including configuring subnet mask, RADIUS setting, default gateway and DNS configuration.
-
In order to configure Zone Director you will need a public IP address, Subnet mask, default gateway and DNS information given to you by your Internet Service Provider. Please keep this information handy while setting up your gateway.
-
Configuring WiOS you will need the WAN public IP address, MAC address, RADIUS secret and serial number of your Zone Director gateway.
-
You need an active WiOS account. Please contact Wifi-soft sales to create your WiOS account.
WiOS Setup
Add New Hotspot:
-
Open a web browser and type https://wios.wifi-soft.com/index.php and press Enter. Welcome screen of WiOS Cloud appears.
-
Click the Networks link under Network Administration section.
-
Click on the + sign in the top right corner tab. The New Network page appears.
Fields and Buttons |
Description |
Network Name |
Enter the name of your network/hotspot |
Device Type |
Select the device type (Ruckus Zone Director) of your hotspot gateway or controller |
Venue |
Select the type of venue |
Address |
Displays the address of the network. You need to use the map to locate your address on the map. If you know the address, type the address in the search box on the map and click on search button. The map will display the marker for the address. If you unable to find the exact address, drag the map so the marker is pointing to correct location on the map. |
Country |
The country where the hotspot is located. |
Latitude |
The latitude of the network location |
Longitude |
The longitude of the network location |
Submit |
Click Submit button to save the changes. |
Once the network is added, go back to the List Network page and locate the network that you have recently added.
Then, click on the edit button for the given network.
At the bottom of the page, you will find the Enable hotspot option.
Check this option to enable hotspot for this network. The hotspot settings appear below the form.
Fields & Buttons |
Description |
Enable hotspot |
Check this option if you want to enable hotspot service for this network. |
Autologin |
Enable autologin for this location. Autologin helps end users connect to hotspot automatically without having to login each time. The MAC address of the device is used to identify the device on the network and system automatically validates the MAC address of the device and authenticates it. Please note that you need to enable Mac Authentication feature in the Zone Director. |
Validity Period |
The time period for autologin to remain active. After the given period, the autologin entry is deleted and user will have to relogin. |
Auto MAC Capture |
Instructs the system to capture the user's MAC address automatically during first login. This option will ensure that user will remain online even if he has disconnected on the network for some time. |
NAS ID |
Auto generated NAS ID for the gateway. This NAS Id should be added to the gateway so it can authenticate with the system. You need to copy the NAD ID and enter it in the gateway settings. |
Secret |
Shared secret between gateway and RADIUS server. You need to add the secret to the gateway. The secret is used to encrypt the communication between gateway and RADIUS server. You need to copy the shared secret and enter it in the RADIUS settings of the gateway. |
IP Address |
Enter the Public IP address of the gateway if you know it. Otherwise use the default one. |
Plan |
Select the plan based on your requirements. The plan will restrict the number of concurrent devices allowed on the network. |
Interim Interval |
Enter the interim interval for the accounting packets in seconds. Sometime this setting needs to be done on the gateway. |
Once the hotspot is enabled, WiOS will be ready to start accepting AAA requests from the gateway/controller. When the hotspot is added, WiOS will automatically add a default captive portal for the hotspot. You may go an edit the captive portal and customize it as per your requirements.
Now you will need to design a captive portal for your hotspot and generate a URL that can be configured in the gateway/controller's settings.
Please refer to the captive portal design guide for steps to design your custom captive portal.
Zone Director Setup
To configure Zone Director
- Open a web browser and type web address https://zd-ipaddress/admin/dashboard.jsp, and click Enter. Ruckus Zone Director Login page appears.
2. Enter Admin Name and Password in the given fields, and click Login. Ruckus Zone Director welcome screen appears.
3. Click on Configure tab. System page will appear.
4. Click AAA Servers link (in the left pane). Authentication/Accounting Servers page will appear.
5. Click Create New link. Click the RADIUS radio button.
To add RADIUS server settings
Fields & Buttons |
Description |
Name |
Enter the name of the RADIUS server in the Name field. |
Type |
Select the RADIUS radio button for the Type options. |
Backup RADIUS |
Select the Backup RADIUS check box if Wifisoft has given you IP of the backup server |
IP Address |
Enter the IP address in the IP Address field. The primary RADIUS server IP address is 3.20.135.30. |
Port |
Enter the port number 1812 in the Port field. |
Shared Secret |
Enter the shared secret in the Shared Secret field. The shared secret should match the shared secret configured in WiFiLAN. |
Confirm Secret |
Re-enter the shared secret in the Confirm Secret field. |
OK |
Click OK to save the configuration. |
To add RADIUS Accounting settings
- Click Create New link. Click RADIUS Accounting radio button.
Fields & Buttons |
Description |
Name |
Enter the name of the RADIUS server in the Name field. |
Type |
Select the RADIUS radio button for the Type options. |
Backup RADIUS |
Select the Backup RADIUS check box if Wifisoft has given you IP of the backup server |
IP Address |
Enter the IP address in the IP Address field. The primary RADIUS server IP address is 3.20.135.30. |
Port |
Enter the port number 1813 in the Port field. |
Shared Secret |
Enter the shared secret in the Shared Secret field. The shared secret should match the shared secret configured in WiFiLAN. |
Confirm Secret |
Re-enter the shared secret in the Confirm Secret field. |
OK |
Click OK to save the configuration. |
To add new hotspot
- Click the Hotspot Services link (in the left pane). Hotspot Services page appears. Click Create New link in the table.
Fields & Buttons |
Description |
Name |
Enter name for the hotspot in the Name field. |
Redirection |
|
WISPr Smart Client Support |
Select the radio button for WISPr Smart Client Support. |
Login Page |
Enter the login page URL in the Login page field. You need to copy the captive portal URL from the WiOS -> Authentication -> Captive Portal section. Please copy the URL with all the the parameters for this network. |
Start Page |
Select the radio button for Start Page to redirect to URL page. User will be redirected to this URL page only after successful login. Please enter the following URL: You can enter any login page like http://www.google.com |
User Session |
|
Session Timeout |
Select the check box for the Session Timeout, and enter the minutes. |
Grace Period |
Select the check box for the Grace Timeout, and enter the minutes. |
Authentication/ Accounting Servers |
|
Authentication Server |
Select the RADIUS Server from the Authentication Server drop down menu. |
Accounting Server |
Select the RADIUS Server from the Accounting Server drop down menu. |
Wireless Client Isolation |
Select the Wireless Client Isolation check box to Isolate wireless client traffic from other clients on the same AP. |
Walled Garden |
Click the + sign besides Walled Garden. Click the Create New link. Enter the Wall Garden link in the Destination Address. Click Save. You need to add the Wall garden link for the external login page to load correctly. Enter the Wall Garden link as: · wios.wifi-soft.com . rad01.wios.wifi-soft.com |
WLan Configuration of hotspot
- Click on WLans link in the left pane. The WLans page will appear.
2. Click Create New link in the table.
Fields & Buttons |
Description |
General Options |
|
Name/ESSID |
Enter the name and ESSID of the hotspot in the Name and ESSID field. |
Description |
Enter a short description of the hotspot in the Description field. |
WLAN Usages |
|
Type |
Select Hotspot Service (WISPr) radio button for Type menu. |
Authentication Options |
|
Method |
Under Authentication Options select Open radio button for Authentication Method. |
Encryption Options |
|
Method |
Under Encryption Options select None radio button for Encryption Method. |
Options |
|
Hotspot Services |
Select the hotspot service from the Hotspot Services drop down menu. |
Priority |
Select the priority radio button whether High or Low. |
OK |
Click OK to save the changes. |
Few settings dont have GUI to configure and Ruckus recommends using CLI (command line) to configure them.
For this, you will need to SSH into Zone Director and do the following configuration. To SSH, you can use Putty software.
ssh zd-ip-address (ip address of zone director)
Once you have logged into the zone director , enter the following commands below (please note that you need to copy the NASID from the Edit Network section).
enable
config
wlan "Your-SSID" (name of ssid of your WLAN)
called-station-id-type wlan-bssid
nasid-type user-define NASID (enter the NASID from WiOS under Edit Network section)
end
0 Comments