Reset Search



How to connect an AP to HiveManager

« Go Back


TitleHow to connect an AP to HiveManager
This article covers how to manually connect a device to a HiveManager. It will also cover basic troubleshooting steps for devices that continue not to connect.
  • HiveManager
  • All HiveOS devices
    • Does not include SR22XX, SR23XX, or any Dell switch models.

How to SSH in to a device using PuTTY

CAPWAP Commands:

Checking the CAPWAP status
  • show capwap client
User-added image
  • This will bring up the current AP settings.
    • Ideally, the RUN state should say "Connected securely to the CAPWAP server" to indicate the device is connected to the HiveManager. 
    • Check that the HiveManager Primary Name is set to the correct HiveManager destination.
      • To confirm, click on the silhouette icon in the top right hand corner, then click on About HiveManager. Check the master host address, or it might be connecting to one of the server hosts, listed directly below the Master host. For example:
User-added imageUser-added image

CAPWAP Commands
  • no hivemanager
    • This will erase the current CAPWAP settings
  • hivemanager <address> primary
    •  To find the HiveManager address (same as above) click on the silhouette icon in the top right hand corner, then click on About HiveManager. For example the command would look like this:
  • capwap client vhm-name <vhm name>
    • To find the VHM name go back in to the HiveManager and click on the silhouette icon at the top> Global Settings> VHM Management> VHM Name. Copy the VHM Name starting after the VHM- portion. So for example if the VHM name was IUJXUYSC, then the command would be:
      • capwap client vhm-name IUJXUYSC

User-added image
  • save config
    • Will save the new settings
  • no capwap client enable
  • capwap client enable
    • These two commands will cycle CAPWAP so the new settings are in use
  • show capwap client
    • Check that the Primary name is set to the correct HiveManager IP address, and that the VHM name is correct.
CAPWAP Troubleshooting
Its normal for a couple minutes to pass after running these commands, eventually the device will re-establish connection to the HiveManager. If it does not connect after running these commands, some troubleshooting steps are:
  • Ping the default gateway
    • If this fails, skip to setting the IP address and default gateway manually (see instructions below).
  • Ping google at
    • If it is successful, we can get out to the internet (skip to pinging to test DNS)
    • If it fails it means the AP doesn t have internet access (skip to setting IP address and default gateway manually).
  • Ping
    • If this fails but the AP was able to get to, then DNS is not working (skip to setting DNS manually).
  • Manually setting IP address and Default gateway
    • Enter the following commands:
      • Int mgt0 ip <ip address> /<netmask>
        • For example if the IP address was and the netmask was, the command would be int mgt0 ip
      • Ip route default gateway <address>
        • For example, if the default gateway was, the command would beip route default gateway
  • Setting DNS manually
    • Enter the following command:
      • Dns server-ip <address>
        • For example, if the DNS address was, the command would be dns server-ipâ
      • To see what the current DNS settings are, run the command show dns
      • It is also possible to check the DNS settings for the network policy by going to Configuration> Select Network Policy> Additional Settings> Management server Settings> DNS Server> Modify> Check what the DNS server is.
  • Check the VLAN
    • Run a VLAN probe by entering the following command:
      • int mgt0 dhcp-probe vlan-range # #
        • To run a range (such as 1-5) enter 1 5. To check a single VLAN (such as 5), enter 5 5. For example, a VLAN probe for VLAN 5: int mgt0 dhcp-probe vlan-range 5 5
      • To set a VLAN manually, run the command: int mgt0 vlan #
        • For example, to set the VLAN to 5, the command would be: int mgt0 vlan 5
      • If the VLAN probe fails, make sure the switch port is set to trunk for multiple VLANs, or native for only one VLAN.
  • Check the ports
    • UDP 12222 and TCP 22 need to allow outbound traffic on any firewall or content filter in the network.
    • To confirm that TCP 22 is open, run the following command: exec _test tcp-service host <HiveManager IP> port 22.
      • For example, using a HiveManager address of, the command would be: exec _test tcp-service host port 22
  • If still does not connect, try switching over to HTTP instead of UDP by running the following commands in order:
    • capwap client transport http
    • save config
    • no CAPWAP client enable
    • CAPWAP client enable
  • Reset the device to factory defaults
  • Run CAPWAP Debugs to send to support or
Additional notes



Was this article helpful?



Please tell us how we can make this article more useful.

Characters Remaining: 255