Find Technical Content
  • Home
  • Ruckus Support Portal
  • Ruckus Networks
  • Table of Contents
  • Dark Mode

Powered by Titania Delivery

⚠ This cached page may be outdated. Click refresh to get the latest content.
Cached Version You are Offline

You are viewing a cached version of this page.

You are currently offline. This page was loaded from cache.

RUCKUS ZoneDirector 10.5.1 User Guide 800-73085-001 Rev E

  • Preface Ruckus
    • 3 Contact Information, Resources, and Conventions
      • 3.1 Contacting RUCKUS Customer Services and Support
      • 3.2 Document Feedback
      • 3.3 RUCKUS Product Documentation Resources
      • 3.4 Online Training Resources
      • 3.5 Document Conventions
      • 3.6 Command Syntax Conventions
  • About This Document
    • 4 About This Guide
      • 4.1 Overview
      • 4.2 Related Documentation
      • 4.3 New in This Document
  • 5 Introducing ZoneDirector
    • 5.1 Overview of ZoneDirector
    • 5.3 Introduction to the Ruckus Network
    • 5.5 Ensuring That APs Can Communicate with ZoneDirector
      • 5.5.1 How APs Discover ZoneDirector on the Network
      • 5.5.2 How to Ensure that APs Can Discover ZoneDirector on the Network
        • 5.5.2.1 Option 1: Perform Auto Discovery on Same Subnet then Transfer the AP to Intended Subnet
        • 5.5.2.2 Option 2: Customize Your DHCP Server
          • 5.5.2.2.1 Configuring the DHCP Server for ZoneDirector-AP Communication
          • 5.5.2.2.2 For ZoneDirector information (sub-option code 03)
          • 5.5.2.2.3 For UMM information (sub-option code 01)
          • 5.5.2.2.4 Configure Vendor Class Identifier and Vendor Specific Info sub-options on Microsoft DHCP server
          • 5.5.2.2.5 IPv6 Configuration for ZoneDirector Discovery Using DHCPv6
        • 5.5.2.3 Option 3: Register ZoneDirector with a DNS Server
          • 5.5.2.3.1 Step 1: Set the DNS Domain Name on the DHCP Server
          • 5.5.2.3.2 Step 2: Set the DNS Server IP Address on the DHCP Server
          • 5.5.2.3.3 Step 3: Register the ZoneDirector IP Addresses with a DNS Server
      • 5.5.3 Firewall Ports that Must be Open for ZoneDirector Communications
    • 5.7 Using the ZoneDirector Web Interface
      • 5.7.1 Navigating the Dashboard
    • 5.8 Registering Your Product
  • 6 Managing Access Points
    • 6.1 Managing Access Points Overview
    • 6.2 Adding New Access Points to the Network
      • 6.2.1 Connecting the APs to the Network
      • 6.2.2 Verifying or Approving New APs
    • 6.3 Working with Access Point Groups
      • 6.3.1 Modifying the System Default AP Group
      • 6.3.2 Creating a New Access Point Group
      • 6.3.3 Modifying Access Point Group Membership
      • 6.3.4 Modifying Model Specific Controls
        • 6.3.4.1 Configuring AP Ethernet Ports
          • 6.3.4.1.1 DHCP Option 82
            • 6.3.4.1.1.1 DHCP Option 82 Sub Options
          • 6.3.4.1.2 Designating Ethernet Port Type
            • 6.3.4.1.2.1 Trunk Ports
            • 6.3.4.1.2.2 Access Ports
            • 6.3.4.1.2.3 General Ports
          • 6.3.4.1.3 Using Port Based 802.1X
            • 6.3.4.1.3.1 AP Ethernet Port as Authenticator
            • 6.3.4.1.3.2 AP Ethernet Port as Supplicant
          • 6.3.4.1.4 Viewing AP Ethernet Port Status
        • 6.3.4.2 Configuring AP USB Ports
    • 6.4 Configuring Global Access Point Policies
      • 6.4.1 Using Limited ZD Discovery for N+1 Redundancy
    • 6.5 Importing a USB Software Package
    • 6.6 Managing Access Points Individually
      • 6.6.1 Configuring Hotspot 2.0 Venue Settings for an AP
    • 6.7 Optimizing Access Point Performance
      • 6.7.1 Assessing Current Performance Using the Access Point Table
      • 6.7.2 Adjusting AP Settings
      • 6.7.3 Prioritizing WLAN Traffic
  • 7 Managing a Wireless Local Area Network
    • 7.1 Overview of Wireless Networks
    • 7.2 About RUCKUS WLAN Security
    • 7.3 Creating a Wireless LAN
      • 7.3.1 General Options
      • 7.3.2 WLAN Usage Types
        • 7.3.2.1 Autonomous WLANs
      • 7.3.3 Authentication Method
        • 7.3.3.1 Fast BSS Transition
        • 7.3.3.2 Authentication Options
      • 7.3.4 Encryption Options
        • 7.3.4.1 Method
        • 7.3.4.2 Algorithm
        • 7.3.4.3 SAE Passphrase (Only for WPA3 and WPA2/WPA3-Mixed WLANs)
        • 7.3.4.4 WEP Key/Passphrase
        • 7.3.4.5 802.11w Management Frame Protection
      • 7.3.5 Advanced WLAN Options
        • 7.3.5.1 Bypass Apple CNA
        • 7.3.5.2 PMK Caching and Opportunistic Key Caching
    • 7.4 Creating a Copy of an Existing WLAN for Workgroup Use
    • 7.5 Customizing WLAN Security
      • 7.5.1 Reviewing the Initial Security Configuration
      • 7.5.2 Fine Tuning the Current Security Mode
      • 7.5.3 Switching to a Different Security Mode
      • 7.5.4 Using the Built in EAP Server
      • 7.5.5 Authenticating with an External RADIUS Server
      • 7.5.6 If You Change the Internal WLAN to WEP or 802.1X
        • 7.5.6.1 If Switching to WEP-based Security
        • 7.5.6.2 If Switching to 802.1X-based Security
    • 7.6 Working with WLAN Groups
      • 7.6.1 Creating a WLAN Group
      • 7.6.2 Viewing a List of APs That Belong to a WLAN Group
    • 7.7 Deploying ZoneDirector WLANs in a VLAN Environment
      • 7.7.1 Tagging Management Traffic to a VLAN
      • 7.7.2 Using VLAN Override
      • 7.7.3 How Dynamic VLAN Works
        • 7.7.3.1 Priority of VLAN Dynamic VLAN and Tunnel Mode
        • 7.7.3.2 How It Works
        • 7.7.3.3 Required RADIUS Attributes
      • 7.7.4 Working with VLAN Pools
  • Managing User Acces
    • 8 Managing User Access
      • 8.1 Enabling Automatic User Activation with Zero-IT
        • 8.1.1 Clients that Support Zero-IT
        • 8.1.2 Self-Provisioning Clients with Zero-IT
        • 8.1.3 Self-Provisioning Clients without Ethernet Ports
        • 8.1.4 Provisioning Clients that Do Not Support Zero-IT
      • 8.2 Working with Dynamic Pre-Shared Keys
        • 8.2.1 Enabling Dynamic Pre-Shared Keys on a WLAN
          • 8.2.1.1 Using External DPSK with RADIUS Authentication
            • 8.2.1.1.1 External DPSK RADIUS Attribute Value Pairs
        • 8.2.2 Setting Dynamic Pre-Shared Key Expiration
        • 8.2.3 Generating Multiple Dynamic PSKs
          • 8.2.3.1 Creating a Batch Dynamic PSK Profile
        • 8.2.4 Downloading Generated DPSKs
      • 8.3 Adding New User Accounts to ZoneDirector
        • 8.3.1 Internal User Database
      • 8.4 Managing Current User Accounts
        • 8.4.1 Changing an Existing User Account
        • 8.4.2 Deleting a User Record
      • 8.5 Creating New User Roles
        • 8.5.1 Role Based Access Control Policy
      • 8.6 Managing Generated Dynamic PSKs
      • 8.7 Managing Generated Guest Passes
      • 8.8 Using an External Server for User Authentication
      • 8.9 Enabling Web Authentication
        • 8.9.1 Captive Portal Redirect on Initial Browser HTTPS Request
  • 9 Managing Guest Access
    • 9.1 Configuring Guest Access
    • 9.2 Creating a Guest Access Service
      • 9.2.1 Using Guest Pass Self-Service
        • 9.2.1.1 Accessing a Self-Service Guest WLAN
        • 9.2.1.2 Requiring Sponsor Approval for Self-Service Guest Pass Authentication
      • 9.2.2 Configuring Guest Subnet Restrictions
      • 9.2.3 Guest Access Walled Garden
    • 9.3 Creating a Guest WLAN
    • 9.4 Using the BYOD Onboarding Portal
    • 9.5 Working with Guest Passes
      • 9.5.1 Generating a Guest Pass from the Clients Page
      • 9.5.2 Configuring Guest Pass Generation
        • 9.5.2.1 Controlling Guest Pass Generation Privileges
        • 9.5.2.2 Creating a Guest Pass Generation User Role
        • 9.5.2.3 Assigning a Pass Generator Role to a User Account
      • 9.5.3 Generating and Delivering a Single Guest Pass
      • 9.5.4 Generating and Printing Multiple Guest Passes at Once
        • 9.5.4.1 Creating a Guest Pass Profile
      • 9.5.5 Monitoring Generated Guest Passes
      • 9.5.6 Creating a Custom Guest Pass Printout
        • 9.5.6.1 Guest Pass Printout Tokens
      • 9.5.7 Delivering Guest Passes via Email
      • 9.5.8 Delivering Guest Passes via SMS
    • 9.6 Social Auth WLANs
      • 9.6.1 About the Ruckus Facebook Wi-Fi Implementation
      • 9.6.2 OAuth Social Media Types
        • 9.6.2.1 Allowing Users From Specified Domains
        • 9.6.2.2 OAuth Setup Procedure for Google+ Social Media Login
        • 9.6.2.3 OAuth Setup Procedure for LinkedIn Social Media Login
        • 9.6.2.4 OAuth Setup Procedure for Microsoft Live Social Media Login
      • 9.6.3 Create an OAuth2.0 WLAN on ZoneDirector
      • 9.6.4 User Login to Social Media WLAN
      • 9.6.5 WeChat WLANs
        • 9.6.5.1 Connecting to a WeChat WLAN
    • 9.7 Working with Hotspot Services
      • 9.7.1 Creating a Hotspot Service
      • 9.7.2 Assigning a WLAN to Provide Hotspot Service
      • 9.7.3 Common WISPr Attribute Abbreviations
    • 9.8 Creating a Hotspot 2.0 Service
      • 9.8.1 Create a Service Provider Profile
      • 9.8.2 Create an Operator Profile
      • 9.8.3 Create a Hotspot 2.0 WLAN
    • 9.9 Customizing the Captive Portal
      • 9.9.1 Replacing the Captive Portal Logo
  • 10 Troubleshooting
    • 10.1 Troubleshooting Failed User Logins
    • 10.2 Performing Client Connectivity Diagnostics
    • 10.3 Fixing User Connections
      • 10.3.1 Troubleshooting Client Connections
      • 10.3.2 Using the Ping and Traceroute Tools
      • 10.3.3 If WLAN Connection Problems Persist
    • 10.4 Measuring Wireless Network Throughput with SpeedFlex
      • 10.4.1 Using SpeedFlex in a Multi-Hop Smart Mesh Network
      • 10.4.2 Allowing Users to Measure Their Own Wireless Throughput
    • 10.5 Starting a Radio Frequency Scan
    • 10.6 Generating a Debug File
    • 10.7 Viewing and Saving Current System Logs
    • 10.8 Saving Client Connection Logs
    • 10.9 Viewing Current AP Logs
    • 10.10 Packet Capture and Analysis
      • 10.10.1 Local Capture
      • 10.10.2 Streaming Mode
        • 10.10.2.1 Using Ruckus Custom Indicators
    • 10.11 AP Diagnostic Information
    • 10.12 Importing a Script
    • 10.13 Enabling Remote Troubleshooting
    • 10.14 Disabling SpeedFlex
    • 10.15 Restarting an Access Point
    • 10.16 Restarting ZoneDirector
  • Configuring Security and Other Services
    • 11 Configuring Services and Profiles
      • 11.1 Application Recognition and Control
        • 11.1.1 Configure Application Policies
          • 11.1.1.1 Configuring an Application Policy
          • 11.1.1.2 Applying an Application Policy to a WLAN
        • 11.1.2 Configure IP Based User Defined Applications
        • 11.1.3 Configure Port Based User Defined Applications
        • 11.1.4 Well-Known Service and Destination Port Mappings Defined in Application Visibility
      • 11.2 Configuring Network Access Controls
        • 11.2.1 Creating Layer 2/MAC Address Access Control Lists
        • 11.2.2 Creating Layer 3/Layer 4/IP Address Access Control Lists
        • 11.2.3 Configuring Device Access Policies
        • 11.2.4 Configuring Precedence Policies
        • 11.2.5 Blocking Client Devices
          • 11.2.5.1 Temporarily Disconnecting Specific Client Devices
          • 11.2.5.2 Permanently Blocking Specific Client Devices
          • 11.2.5.3 Reviewing a List of Previously Blocked Clients
        • 11.2.6 Configuring Client Isolation White Lists
      • 11.3 URL Filtering
        • 11.3.1 Creating a URL Filtering Profile
        • 11.3.2 Applying a URL Filtering Policy to a WLAN
        • 11.3.3 Applying a URL Filtering Policy to a Role
        • 11.3.4 Working with URL Filtering Licenses
      • 11.4 Configuring Maps
        • 11.4.1 Configuring Floorplan Maps
      • 11.5 Guest Access
      • 11.6 Hotspot Services
      • 11.7 Mesh Configuration
      • 11.8 Using an External AAA Server
        • 11.8.1 Active Directory
          • 11.8.1.1 Active Directory for 802.1X
          • 11.8.1.2 Single Domain Active Directory Authentication
          • 11.8.1.3 Multi-Domain Active Directory Authentication
        • 11.8.2 LDAP
          • 11.8.2.1 Advanced LDAP Filtering
          • 11.8.2.2 Group Extraction
        • 11.8.3 RADIUS /RADIUS Accounting
          • 11.8.3.1 Configuring a Backup RADIUS/RADIUS Accounting Server
          • 11.8.3.2 MAC Authentication with an External RADIUS Server
          • 11.8.3.3 Using 802.1X EAP + MAC Address Authentication
          • 11.8.3.4 Using 802.1X with EAP-MD5
          • 11.8.3.5 RADIUS Attributes
            • 11.8.3.5.1 RADIUS Authentication attributes
            • 11.8.3.5.2 RADIUS Accounting attributes
          • 11.8.3.6 Configuring Microsoft IAS for PAP Authentication
        • 11.8.4 TACACS+
        • 11.8.5 Testing Authentication Settings
      • 11.9 Services
        • 11.9.1 Self Healing
          • 11.9.1.1 Automatically Adjust AP Power
          • 11.9.1.2 Automatic Channel Selection
            • 11.9.1.2.1 Background Scanning
            • 11.9.1.2.2 ChannelFly
        • 11.9.2 Load Balancing
        • 11.9.3 Band Balancing
          • 11.9.3.1 Adaptive Band Balancing
        • 11.9.4 Radar Avoidance Pre-Scanning
        • 11.9.5 AeroScout RFID Tag Detection
        • 11.9.6 Ekahau Tag Detection
        • 11.9.7 Active Client Detection
        • 11.9.8 Tunnel Configuration
        • 11.9.9 Packet Inspection Filter
      • 11.10 Configuring Wireless Intrusion Prevention
        • 11.10.1 DoS Protection
        • 11.10.2 Intrusion Detection and Prevention
          • 11.10.2.1 Rogue Access Points
        • 11.10.3 Rogue DHCP Server Detection
      • 11.11 DHCP Relay
      • 11.12 Bonjour Gateway
        • 11.12.1 Bridge Service Rules
        • 11.12.2 Bridge Service Records
        • 11.12.3 Creating a Bonjour Gateway Rule - ZD Site
        • 11.12.4 Creating a Bonjour Gateway Rule AP Site
        • 11.12.5 Applying a Bonjour Policy to an AP
        • 11.12.6 Example Network Setup
      • 11.13 Bonjour Fencing
        • 11.13.1 Configuring Bonjour Fencing Policies
        • 11.13.2 Applying a Bonjour Fencing Policy to an AP or AP Group
      • 11.14 SPoT Location Services
  • 12 Configuring System Settings
    • 12.1 System Configuration Overview
      • 12.1.1 Changing the System Name
    • 12.2 Changing the Network Addressing
      • 12.2.1 IPv6 Configuration
      • 12.2.2 Enabling an Additional Management Interface
    • 12.3 Creating Static Route Entries
      • 12.3.1 Static Route Example
    • 12.4 Enabling Smart Redundancy
      • 12.4.1 Configuring ZoneDirector for Smart Redundancy
      • 12.4.2 Managing Smart Redundancy AP License Pools
    • 12.5 Configuring the Built-in DHCP Server
      • 12.5.1 Enabling the Built-in DHCP server
      • 12.5.2 Viewing DHCP Clients
    • 12.6 Controlling ZoneDirector Management Access
    • 12.7 Setting the System Time
      • 12.7.1 Configuring a User-Defined Time Zone
    • 12.8 Setting the Country Code
      • 12.8.1 Channel Optimization
    • 12.9 Configuring System Log Settings
      • 12.9.1 Reviewing the Current Log Contents
      • 12.9.2 Customizing the Current Log Settings
        • 12.9.2.1 Configuring Remote Syslog Advanced Settings
        • 12.9.2.2 Configuring Syslogs for Firewall Integration
          • 12.9.2.2.1 Log Format
    • 12.10 Setting Up Email Alarm Notifications
      • 12.10.1 Customizing Email Alarms
    • 12.11 Configuring SMS Settings for SMS Guest Pass Delivery
    • 12.12 Enabling Login Warning Messages
    • 12.13 Configuring Dashboard Map Settings
    • 12.14 Enabling Network Management Systems
      • 12.14.1 Enabling SmartCell Insight Communication
      • 12.14.2 Enabling Management via UMM
        • 12.14.2.1 Monitoring ZoneDirector Performance from UMM
      • 12.14.3 Enabling Northbound Portal Interface Support
      • 12.14.4 Configuring SNMP Support
        • 12.14.4.1 Enabling the SNMP Agent
        • 12.14.4.2 Enabling SNMP Trap Notifications
          • 12.14.4.2.1 Trap Notifications That ZoneDirector Sends
      • 12.14.5 Enabling Telnet
  • 13 Setting Administrator Preferences
    • 13.1 Changing the Web Interface Display Language
    • 13.2 Changing the ZoneDirector Administrator User Name and Password
      • 13.2.1 Using an External Server for Administrator Authentication
      • 13.2.2 Setting Administrator Login Session Timeout
    • 13.3 Working with Backup Files
      • 13.3.1 Backing Up a Network Configuration
      • 13.3.2 Restoring Archived Settings to ZoneDirector
        • 13.3.2.1 Restoring AP Configuration Settings Only
    • 13.4 Restoring ZoneDirector to Default Factory Settings
      • 13.4.1 Alternate Factory Default Reset Method
    • 13.5 Upgrading ZoneDirector and Connected APs
      • 13.5.1 Importing an AP Firmware Bundle
      • 13.5.2 Enabling Legacy AP Image Upgrade
      • 13.5.3 Performing an Upgrade with Smart Redundancy
    • 13.6 Working with Licenses and Support
      • 13.6.1 Upgrading the AP License
      • 13.6.2 Support Entitlement
      • 13.6.3 Working with URL Filtering Licenses
    • 13.7 Working with SSL Certificates
      • 13.7.1 Basic Certificate Installation
      • 13.7.2 Generating a Certificate Signing Request
      • 13.7.3 Importing an SSL Certificate
      • 13.7.4 SSL Certificate Advanced Options
        • 13.7.4.1 Importing Ruckus PKI Certificate Packages
        • 13.7.4.2 Wildcard Certificate Installation
          • 13.7.4.2.1 Wildcard Certificates In Smart Redundancy With Captive Portals
  • 14 Monitoring Your Wireless Network
    • 14.1 Reviewing the ZoneDirector Monitoring Options
    • 14.2 Monitoring Access Points
      • 14.2.1 Using the AP Status Overview Page
        • 14.2.1.1 Currently Managed APs
        • 14.2.1.2 Exporting the AP List to a CSV File
        • 14.2.1.3 Currently Managed AP Groups
        • 14.2.1.4 Events/Activities
      • 14.2.2 Monitoring Individual APs
        • 14.2.2.1 Using Action Icons to Manage and Troubleshoot APs
          • 14.2.2.1.1 Migrating an AP from ZoneDirector to Another Controller
        • 14.2.2.2 RF Pollution FAQ
        • 14.2.2.3 Spectrum Analysis
        • 14.2.2.4 Neighbor APs
        • 14.2.2.5 Access Point Sensor Information
    • 14.3 Monitoring WLAN Status
    • 14.4 Reviewing Current User Activity
      • 14.4.1 Active Client Action Icons
      • 14.4.2 Viewing Application Usage Statistics
        • 14.4.2.1 Viewing Application Usage by Client
        • 14.4.2.2 Viewing the Top 10 Clients by Usage
      • 14.4.3 Monitoring Individual Clients
        • 14.4.3.1 Monitoring Client Performance
    • 14.5 Monitoring Wired Clients
    • 14.6 Monitoring AAA Server Statistics
    • 14.7 Reviewing Recent System Events
    • 14.8 Reviewing Current Alarms
    • 14.9 Monitoring Location Services
    • 14.10 Monitoring Mesh Status
    • 14.11 Real Time Monitoring
    • 14.12 Detecting Rogue Access Points
    • 14.13 Monitoring System Information
      • 14.13.1 Monitoring System Ethernet Port Status
  • 15 Deploying a Smart Mesh Network
    • 15.1 Overview of Smart Mesh Networking
    • 15.2 Smart Mesh Networking Terms
    • 15.3 Supported Mesh Topologies
      • 15.3.1 Standard Topology
      • 15.3.2 Wireless Bridge Topology
      • 15.3.3 Hybrid Mesh Topology
    • 15.4 Viewing the Mesh Topology
    • 15.5 Deploying a Wireless Mesh via ZoneDirector
      • 15.5.1 Step 1: Prepare for Wireless Mesh Deployment
      • 15.5.2 Step 2: Enable Mesh Capability on ZoneDirector
      • 15.5.3 Step 3: Provision and Deploy Mesh Nodes
        • 15.5.3.1 Zero Touch Mesh
          • 15.5.3.1.1 Onboarding Mesh APs with Zero Touch Mesh
      • 15.5.4 Step 4: Verify That the Wireless Mesh Network Is Up
    • 15.6 Optional Mesh Configuration Features
    • 15.7 Understanding Mesh-related AP Statuses
    • 15.8 Using the AP LEDs to Determine the Mesh Status
      • 15.8.1 On Dual-band Ruckus APs
        • 15.8.1.1 Indoor Dual-band APs
        • 15.8.1.2 Outdoor Dual-band APs
    • 15.9 Using Action Icons to Configure and Troubleshoot APs in a Mesh
    • 15.10 Setting Mesh Uplinks Manually
    • 15.11 Troubleshooting Isolated Mesh APs
      • 15.11.1 Understanding Isolated Mesh AP Statuses
      • 15.11.2 Recovering an Isolated Mesh AP
        • 15.11.2.1 Step 1: Obtain the Mesh SSID and Passphrase
        • 15.11.2.2 Step 2: Ensure that the AP's Mesh Mode is set to Auto
        • 15.11.2.3 Step 3: Locate the AP's Mesh Recovery SSID
        • 15.11.2.4 Step 4: Connect to the AP and update its Mesh settings
    • 15.12 Best Practices and Recommendations
  • 16 Mesh Networking Best Practices
    • 16.1 Calculating the Number of APs Required
    • 16.2 Placement and Layout Considerations
    • 16.3 Signal Quality Verification
    • 16.4 Mounting and Orientation of APs
      • 16.4.1 Indoor APs - Typical Orientation
      • 16.4.2 Outdoor APs - Typical Horizontal Orientation
      • 16.4.3 Elevation of RAPs and MAPs
    • 16.5 Mesh Best Practice Checklist
  • 17 Access Point Power Supply Considerations
    • 17.1 AP Power Warnings
    • 17.2 Power Limitations by PoE Mode and AP Model

Best Practices and Recommendations

For recommendations and best practices in planning and deploying a Ruckus Smart Mesh network, refer to Mesh Networking Best Practices.

Parent topic: Deploying a Smart Mesh Network

Did you find what you were looking for?

Thanks!

Ruckus Wireless

© 2026 Ruckus Wireless LLC All rights reserved.

  • Accessibility
  • Privacy & Cookies
  • Do Not Sell My Information
  • Trademarks
  • Terms
  • Feedback