If you are using the current version of Cumulus NetQ, the content on this page may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.

Lifecycle Management

Lifecycle management is enabled for on-premises deployments by default and disabled for cloud deployments by default. Contact your local NVIDIA sales representative or submit a support ticket to activate LCM on cloud deployments. Only administrative users can perform the tasks described in this topic.

Using the NetQ UI or CLI, lifecycle management (LCM) allows you to:

  • Manage Cumulus Linux and NetQ images in a local repository
  • Configure switch access credentials (required for installations and upgrades)
  • Manage Cumulus Linux switch inventory and roles
  • Create snapshots of the network state at various times
  • Install or upgrade NetQ (Agents and CLI) on Cumulus Linux switches
  • View a result history of upgrade attempts

Access Lifecycle Management in the UI

To access LCM, open the Manage Switch Assets page in one of the following ways:

  • Expand the Menu, then select Manage switches
  • Click Upgrade in a workbench header
  • Click Devices in a workbench header, then select Manage switches

The Manage Switch Assets view provides access to switch management, image management, NetQ Agent configurations, and job history.

dashboard displaying switch management tab

LCM Summary

To manage the various lifecycle management features using the NetQ CLI, use the netq lcm command set. The following table summarizes LCM’s capabilities:

NetQ UI Cards
NetQ CLI Commands
Switch ManagementDiscover switches, view switch inventory, assign roles, set user access credentials, perform software installation and upgrade networkwide
  • Switches
  • Access
  • netq lcm show switches
  • netq lcm add role
  • netq lcm upgrade
  • netq lcm add/del/show credentials
  • netq lcm discover
Image ManagementView, add, and remove images for software installation and upgrade
  • Cumulus Linux Images
  • NetQ Images
  • netq lcm add/del/show netq-image
  • netq lcm add/del/show cl-images
  • netq lcm add/show default-version
Job HistoryView the results of installation, upgrade, and configuration assignment jobs
  • CL Upgrade History
  • NetQ Install and Upgrade History
  • Config Assignment History
  • netq lcm show status
  • netq lcm show upgrade-jobs