Summary

Question

RUCKUS Switch disconnected in Unleashed, how to Add a it to the RUCKUS Unleashed System via Web Browser?

Customer Environment

Symptoms

• The switch does not appear in the Unleashed Switch Management list.

• Switch shows “Connecting” for a long time (1–5+ minutes) without completing.

• Switch status shows “Disconnected” or “Failed” after attempting to add.

• Unable to access switch from Unleashed Web UI.

• Device details (IP, model, firmware) do not populate in the management list.

• Errors related to authentication failure if credentials are incorrect.

• Network or ping issues indicated if the Master AP cannot reach the switch IP.

Root Cause

Workaround

• Verify the switch is powered on and connected to the same LAN as the Master AP.

• Check IP connectivity: Ping the switch from the Master AP or a PC on the same network.

• Ensure the switch is running supported firmware (UFI 08.0.90+).

• Confirm admin credentials (username/password) are correct for the switch and Unleashed system.

• Make sure Automatic Switch Approval is enabled in Unleashed (Admin & Services ? System info).

• Check for firewall/port restrictions, especially TCP port 22 (SSH) between AP and switch.

• If the switch shows disconnected, try rebooting the switch and retry adding it.

• Verify that the Unleashed network is set up and accessible.

Resolution

Steps to Add a Switch to RUCKUS Unleashed via Web Browser:

Step 1: Access the Unleashed Web UI

1. Open a browser (Chrome/Firefox/Edge).

2. Enter the IP address of the Unleashed Master Access Point or navigate to https://unleashed.ruckuswireless.com. (Refer to the article on how to locate the IP address if Master AP IP Address is unknown)

3. Log in using your RUCKUS Unleashed System admin credentials. (Figure 1)

Figure 1: RUCKUS Unleashed Web UI Login

Step 2: Turn on the Automatic Switch Approval

1. From the Unleashed Dashboard, click on Admin & Services. (Figure 2)

2. Navigate to: Admin & Services > System > System info

3. Ensure that the 'Switch Approval' option is selected and then click 'Apply' to save the changes.

Figure 2: Automatic Switch Approval

Step 3: Add a New Switch

1. Click the “+ Add” button on the Switch Management page. (Figure 3)

2. A pop-up will appear asking for switch details.

Figure 3: Adding a New Switch

Step 4: Enter Switch Information

Fill in the required fields: (Figure 4)

• Switch IP Address: IP address of the switch you want to add.
• Username: Admin username for the switch (default: super).
• Password: Admin password for the switch (default: sp-admin).
• Model: Will be auto-detected after successful login.

Figure 4: Adding the Switch IP Address and its login Credentials

Make sure the Switch IP is reachable from the Unleashed AP. If unreachable, the connection will fail.

Step 5: Apply and Wait

• Click “OK” or “Add” to begin the process with the ‘Connecting’ message. (Figure 5)
• Unleashed will try to connect and register the switch.
• It might take 1–5 minutes, depending on the network.

Figure 5: Switch displayed in the 'Connecting' state

Step 6: Verify Switch Addition

Once added, the switch should appear in the Switch Management list: (Figure 6)

• Status: Should show as Working or Connected.
• You’ll see details like:
• IP Address
• Model
• Firmware
• Number of Connected Devices
• Port Info Etc.,

Figure 6: Switch displayed in the Connected/Working state