Logo

VHM Management

VHM Management

Manage the Virtual IQ (virtual ExtremeCloud IQ).

Navigation

  admin_name > Global Settings > Administration > Virtual IQ Management

ExtremeCloud IQ administrators with read/write permission can perform the following administrative tasks for their Virtual IQ (virtual ExtremeCloud IQ):

Note

Note

Only HHM administrators have access to the Virtual IQ data tools on this page. These tools are not available to organization administrators. See Hierarchical ExtremeCloud IQ Configuration Guide for more information about HHM.

Each administrative task is described below.

Manual Backup and Restore

Because system-wide backups of ExtremeCloud IQ cloud accounts are performed daily by Extreme Networks cloud operations, your data is always available for restoration by Extreme Networks Technical Support, if needed. This manual VHM backup and restore feature is helpful when it is necessary to recover data in cases of misconfiguration and human error without contacting Extreme Networks Support.

To perform a manual backup, select Backup Now. To ensure data integrity, ExtremeCloud IQ suspends activity in the Virtual IQ during both the backup and the restore process. The current status of the Virtual IQ changes from ACTIVE to SUSPENDING during these processes to indicate its state.

When a backup is complete, ExtremeCloud IQ displays the backup event in the Backup History table. To restore a backup, select Restore for the backup event that you want to use. As with the backup process, restoring the backup disables the Virtual IQ and logs you out until the process is complete.

Although the time required for the backup and restore function can vary depending on the size of the database, it typically takes only a few minutes.

Note

Note

You must restore the Virtual IQ in the same version of ExtremeCloud IQ from which you performed the backup. If the versions are different, a compatibility error message ("Version Mismatch") is displayed.

Delete Data and Reset the VHM Database

You can delete the Virtual IQ database to reset it to its initial state before any inventory or configurations were added. This can be helpful if you need to create a new deployment from the ground up. To delete the database, select the Reset VHM button. When a confirmation message appears, select Yes.

Export and Import VHM Data

Exporting Virtual IQ data and then importing it into another Virtual IQ is an efficient way to create multiple Virtual IQs with similar configurations. After configuring one Virtual IQ with the settings you want to use as a template for other Virtual IQs, you can export it as a .tar.gz file. Then import it into other Virtual IQs and make whatever modifications are necessary to customize it for each one.

Exporting Virtual IQ Data

To export Virtual IQ data:

  1. Select Export Virtual IQ and follow the instructions in the dialog boxes that appear.

ExtremeCloud IQ suspends the Virtual IQ during the export operation and displays a progress report showing its status. When it is complete, a message appears stating that the Virtual IQ was successfully exported. Then a link to the exported .tar.gz file appears on the Virtual IQ Management page to the right of the Export Virtual IQ button.

  1. Select the link to download and save the .tar.gz file to a local directory on your management system.

The tarball contains numerous files for different areas of the Virtual IQ such as certificate files in PEM format; captive web portal files in HTML, JavaScript, and graphic image file formats; background image files for topology maps; and configuration objects and Virtual IQ settings in XML format.

Importing Virtual IQ Data

To import Virtual IQ data:

  1. Select Import Virtual IQ.
  2. In the Virtual IQ Import dialog box, select either Import Virtual IQ from ExtremeCloud IQ or Import Virtual IQ from HM Classic, depending on the source of the data.

When importing data from another ExtremeCloud IQVirtual IQ, you can import everything. When importing from a HM ClassicVirtual IQ, you can currently only import its device inventory and topology maps, including the locations of the devices on the maps. The ability to import more data types from a HM ClassicVirtual IQ will be implemented in future releases.

  1. Either drag the .tar.gz file that you want to import into the first field at the top or select Choose and navigate to the location of the file and select it.
  2. Select Import Now. Optionally, you can change the import timeout, which is 30 minutes by default, and the action to take if an error occurs—abort (default) or continue.

Only HHM (Hierarchical ExtremeCloud IQ) administrators have access to the Virtual IQ data export and import tools. These tools are not available to organization administrators.

Enable Supplemental CLI

The supplemental CLI tool allows you to append CLI commands to a network policy when you upload the configuration to managed devices. You can access this feature in multiple places in the GUI, but for this feature to be visible, you must first enable it on the global level here.

The supplemental CLI tool is disabled by default. To enable it, slide the Supplemental CLI toggle to ON. For more details on how to configure the tool, see Add Supplemental CLI.

Note

Note

The Supplemental CLI tool is designed for network administrators that have experience with using CLI commands, and fully understand how the commands will effect their managed devices.

Enable Out-of-the-box Wireless Onboarding

When you initially deploy an 802.11ac AP (see the list below) running IQ Engine 8.3r2 or later, it probes its vicinity for nearby Extreme Networks APs. If it finds one, it sends a mesh-join request. If the other AP replies with a mesh-join response, the 802.11ac AP securely forms a mesh link with it. It then obtains network settings through DHCP, contacts the Virtual IQ with which its serial number is associated, and acquires its configuration without any admin intervention.

The AP out-of-the-box wireless onboarding setting permits or prohibits APs to respond to mesh-join requests. When it is toggled off, the Virtual IQ prohibits managed APs from responding even if the serial number of the requesting AP is listed in the Virtual IQ. To enable the Virtual IQ to permit APs to respond to mesh-join requests, slide the toggle to ON.

At the time of the IQ Engine 8.3r2 release, the 802.11ac portfolio of access points includes the following models:

Atom AP30 AP230
AP122 AP245X
AP122X AP250
AP130 AP550
AP150W AP1130

Copyright © 2020 Extreme Networks. All rights reserved. Published March 2020.