Adds a device (access point, wireless controller, or service platform), as a member, to an existing cluster of devices. Assign a static IP address to the device before adding to a cluster. Note, a cluster can be only formed of devices of the same model type.



This command and its syntax is common to both the User Executable and Privilege Executable configuration modes.

Supported in the following platforms:

  • Service Platforms — NX5500, NX7500, NX9500, NX9600, VX9000


join-cluster <IP> user <USERNAME> password <WORD> {level|mode}
join-cluster <IP> user <USERNAME> password <WORD> {level [1|2]|mode [active|standby]}


join-cluster <IP> user <USERNAME> password <WORD> {level [1|2]|mode [active|standby]}


Adds a access point wireless controller, or service platform to an existing cluster


Specify the cluster member's IP address.


Specify a user account with super user privileges on the new cluster member

password <WORD>

Specify password for the account specified in the user parameter

level [1|2]

Optional. Configures the routing level

  • 1 – Configures level 1 routing

  • 2 – Configures level 2 routing

mode [active|standby]

Optional. Configures the cluster mode

  • active – Configures this cluster as active

  • standby – Configures this cluster to be on standby mode

Usage Guidelines

To add a device to an existing cluster:

  • Configure a static IP address on the device (access point, wireless controller, or service platform).
  • Provide username and password for superuser, network admin, system admin, or operator accounts.

After adding a device to a cluster, execute the "write memory" command to ensure the configuration persists across reboots.

Examples (User Exec Mode)

nx9500-6C8809>join-cluster user admin password superuser level 1
mode standby
... connecting to
... applying cluster configuration
... committing the changes
... saving the changes
nx9500-6C8809>show context
! Configuration of RFS4000 version
version 2.6
 cluster name TechPubs
 cluster mode standby
 cluster member ip level 1
 logging on
 logging console warnings
 logging buffered warnings

Related Commands

create-cluster Creates a new cluster on the specified device
cluster Initiates cluster context. The cluster context enables centralized management and configuration of all cluster members from any one member.