Configuring Ruckus Access Point

Purpose of this document

• This document should be used in conjunction with Ruckus AP user guide for configuring your Ruckus AP gateways in WIOS. Please refer to WIOS administrator guide and Ruckus AP user guide for detail information.
• It is assumed that the user has basic knowledge of networking including configuring subnet mask, RADIUS setting, default gateway and DNS configuration.
• In order to configure Ruckus AP you will need a static 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, AP MAC address, RADIUS secret, serial number and public IP address of your Ruckus AP gateway.
• You need an active WIOS account. Please contact Wifi-soft sales to create your WIOS account. 

WiOS Setup

Add New Network:

1. Open a web browser and type https://wios.wifi-soft.com/index.php and press Enter. Welcome screen of WiOS Cloud appears.

2. Click the Networks link under Network Administration section.

3. 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 ZoneFlex AP) 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 AP settings.
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.

Ruckus AP Setup

It is assumed that that you have properly connected your Ruckus AP gateway with a broadband connection, which has a static or dynamic public IP address.

Open web browser, and enter the Ruckus web address. And press Enter.

Login to Ruckus AP. Ruckus AP Welcome screen appears.

  2. Click Hotspot sub link under Configuration link (in the left pane). Configure:: Hotspot page appears.

Fields & Buttons	Description
Hotspot Service	Select Disabled radio button for Hotspot Service menu.
UAM IP Address	Enter the UAM IP address in the UAM IP Address field.
Redirect unauth. User to	Enter the login page URL in the Redirect unauth. User to field.
After user is authenticated	Enter the URL to which the user will be redirected after successful login. If the user wants to be redirected to different URL. Select the radio button for Redirect to the URL that the user is intended to visit.
Primary RADIUS Server	Enter the primary RADIUS server IP address in the Primary RADIUS Server field. (3.20.135.30)
Secondary RADIUS Server	Enter the secondary RADIUS server IP address in the Secondary RADIUS Server field.
RADIUS Server Secret	Enter the RADIUS server secret in the RADIUS Server Secret field. The secret should match the secret of WiOS. You will find the secret under Edit Network section in WiOS.
Update Settings	Click the Update Settings to save the changes.

Note: Please contact Wifi-soft support to get the correct RADIUS server settings for your hotspots.

3. Click Edit Settings button for More Options on Configure :: Hotspot page.

Configure :: Hotspot :: More Options page appears.

1. Enter a unique name in the NAS ID The same NAS ID needs to be entered in WiOS. You will find the NAS ID under the Edit Network section under Network Management.
2. Select Disabled radio button for MAC Authentication. Select Enabled option only if you want the Autologin feature enabled in WiOS. You also need to enable the Autologin and Auto Mac Capture features in WiOS under Edit Network.
3. Keep the other fields to the default settings.
4. Click Save to save the changes.

 1. Click Edit Settings button for Walled Garden. Configure :: Hotspot :: Wall Garden page will appear.

2. Click Add New Entry button, and enter wios.wifi-soft.com, portal.wios.wifi-soft.com, 3.20.135.30, 3.14.39.19 and 3.20.50.246 for the login and signup process. These are WiFi-soft's IP addresses of WiOS OSS/BSS, Captive portal and Application server respectively.