Reset Search



Comprehensive On-Boarding Guide

« Go Back


TitleComprehensive On-Boarding Guide


  • To add a device to HiveManager and update the firmware.


  • On-boarding a Device
    • Advanced On-boarding
    • Quick On-boarding
  • Some Common On-boarding Issues
  • Updating Firmware/HiveAgent for SR2200 and SR2300 Series Switches
  • Updating HiveOS Firmware
  • Enabling HiveAgent on Dell Switches
  • HiveManager
  • HiveOS Devices
  • SR2200 & SR2300 series switches

On-boarding a Device

Advanced On-boarding

  • Go to Manage

  • Click Add

  • Select Advanced

User-added image

  • Add the device serial number(s) in the Aerohive serial numbers field

User-added image

  • If the device is a Dell device, go to the Dell tab and enter the service tag and Dell serial number

User-added image
  • Click Next in the bottom right hand corner.

  • The message # of # device(s) successfully onboarded should show at the top of the page
User-added image
  • If locations have been created, assign the device to the location it belongs to, or skip to the next step. 

    • To add a location to the device, click on "Assign Location"
User-added image
  • Choose the map the device belongs to, then click "Assign"

User-added image
  • If the device is a router, add a Branch ID. If the device is not a router, this step will be skipped

  • Create a network policy or choose an existing network policy to apply to the AP.

    • This is an optional step. If this is skipped, the device will still connect to the HiveManager, but will not have a configuration on it until one is manually uploaded
User-added image
  • If an existing network policy is chosen, steps 5 and 6 will be skipped as this information is auto-filled by the network policy that was selected.

  • If a new network policy is needed, first create an internal SSID or skip this step if an internal SSID is not needed.

User-added image
  • Configure a Guest SSID, or skip this step if a Guest SSID is not needed
User-added image
  • Review the settings to make sure they are correct, then click Finish
User-added image

Quick On-boarding

  • Go to Monitor
  • Click Add
    • Select Quick Add Devices
User-added image
  • In the menu now visible above the device inventory list on the monitor page, choose the following:

    • Device type (Real or Simulated)
    • Device Make (Aerohive or Other for Dell devices)
    • Entry Type (Manual for serial number entry, CSV for importing serial numbers)
    • Enter the serial number or device tag of the device to be added
    • Choose a network policy or leave this drop down empty to apply no network policy to the device when it connects
    • Click Add Devices
User-added image 

Some Common On-boarding Issues

  • Make sure that the licenses for the devices have been added under Global settings > License management. If there are not enough licenses, the on-boarding will fail

  • If a device fails to on-board, check the failure message displayed by clicking "Get Details":

User-added image



  • If the message the device appears to be in use by another VHM appears, contact support with the serial number of the device so they can remove any conflicting records for the device

User-added image
  • Firewall ports

    • Confirm that the following ports are allowing outbound traffic:

    • UDP 12222

    • TCP 443

    • TCP 22

    • UDP 123

    • TCP 2083
  • AP isn't getting an IP address

    • Manually set the IP address and Default gateway

      • SSH in to the AP How to SSH in to a device using PuTTY

      • 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 be ip route default gateway
  • DNS isn't working

    • Ping to confirm internet connectivity

    • Ping to confirm DNS functionality

      • If the ping to was successful and the ping to failed, then the internet connection is working and the problem is DNS.
    • Set DNS Manually

      • SSH in to the AP How to SSH in to a device using PuTTY

      • 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:

        •  show dns
      • It is also possible to check the DNS settings for the network policy by going to Configure> Open the Network Policy> Additional Settings> DNS Server (left hand side menu).



Updating Firmware/HiveAgent for SR2200 and SR2300 Series Switches

  • Establish an FTP server.

    • This is where the file that we are uploading to the switch will be placed.

  • Once this is done, we have two ways we can proceed, depending on whether Hive Agent is already installed on the switch.

  • If Hive Agent is not already installed:

    • SSH in to the switch and run the following commands.

    • Where XXXXXX is, enter the filepath of where the file was uploaded on the FTP server.

    • Commands:

      • (SR2208P-4) #copy tftp:// XXXXXX /hiveagent_pr nvram:application hiveagent_pr

      • (SR2208P-4) #copy tftp:// XXXXXX /hiveagent nvram:application hiveagent

      • (SR2208P-4) #copy tftp:// XXXXXX /ah_ha.conf nvram:application ah_ha.conf

      • (SR2208P-4) #configure

      • (SR2208P-4) (Config)#application install hiveagent start-on-boot

      • (SR2208P-4) (Config)# do reload

    • After the reload, hive agent is disabled, we need to re-enable it with the following command:

      • (SR2208P-4) # application start hiveagent

  • If Hive Agent is already installed:

    • Use the following CLI to check and confirm the HiveAgent Version.

      • show hivemanager status

    • Note: If the HiveAgent Version is not or later, then HiveAgent needs to be upgraded.

      • Download the hiveagent 1.1.29 from the Hive Community portal (

      • Upload the unzipped files to a ftp or tftp server

      • Use the following CLI to upgrade the hiveAgent on the switch.

        • enable

        • application stop hiveagent

        • copy tftp://x.x.x.x/HiveAgent_Aerohive_1.1.29/hiveagent_pr nvram:application hiveagent_pr

        • copy tftp:// x.x.x.x /HiveAgent_Aerohive_1.1.29/hiveagent_pr nvram:application hiveagent_pr_s

        • copy tftp:// x.x.x.x /HiveAgent_Aerohive_1.1.29/hiveagent nvram:application hiveagent

        • copy tftp:// x.x.x.x /HiveAgent_Aerohive_1.1.29/ah_ha.conf nvram:application ah_ha.conf

        • copy tftp:// x.x.x.x /HiveAgent_Aerohive_1.1.29/ah_ha.conf nvram:application ah_ha.conf_s

        • configure

        • application install hiveagent start-on-boot

        • exit

        • copy system:running-config nvram:startup-config

        • application start hiveagent

      • Wait for about 30 seconds and then use the following CLI to check and confirm that HiveAgent Version reads

        • show hivemanager status


Updating HiveOS Firmware

Note: A HiveOS device needs to be on HiveOS 6.5r3 in order to work with HiveManager. If the device is on a firmware version older than 6.5r3, update the device firmware via the Web UI Upgrading AP firmware via web UI or CLI Updating HiveOS from CLI using SCP, TFTP, or HTTP(s) of the device.
  • Go to Monitor> Select the check box next to the AP> Update Devices.

User-added image
  • This will bring up a small window. Check the box next to Upgrade HiveOS and Aerohive Switch Images.

User-added image

There are two options available for updating HiveOS Firmware in HiveManager; the latest version or a specific version you choose.

  • It is generally recommended that APs stay on the latest version.
  • To add a specific file that isn't the latest release, select Upgrade to the specific version, then click add/remove to add a file from the local machine.

User-added image
  • Once these settings are correct, click Perform Update. The device will need to reboot to use the new HiveOS version. 

Enabling HiveAgent on Dell Switches

  • Access the CLI of the Dell Switch and enter the following commands:

    • console>enable

    • console#config

    • console(config)#eula-consent hiveagent accept

Additional notes



Was this article helpful?



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

Characters Remaining: 255