NetQ CLI Changes

A number of commands have changed in this release to accommodate the addition of new options or to simplify their syntax. Additionally, new commands have been added and others have been removed. A summary of those changes is provided here.

New Commands

The following table summarizes the new commands available with this release. They include event configuration commands.

netq add events-config [events_config_id <text-events-config-id-anchor>] [events_config_name <text-events-config-name-anchor>] [message_type <text-message-type-anchor>] [scope <text-events-scope-anchor>] [is_active true | is_active false] [suppress_until <text-suppress-until>]Configures the suppression of events generated by NetQ.3.1.0
netq del events-config events_config_id <text-events-config-id-anchor>Removes an event suppression configuration.3.1.0
netq show events-config [events_config_id <text-events-config-id-anchor>] [show-filter-conditions | message_type <text-message-type-anchor> show-filter-conditions] [json]Displays event suppression configurations.3.1.0
netq add notification channel email <text-channel-name> to <text-email-toids> [smtpserver <text-email-hostname>] [smtpport <text-email-port>] [login <text-email-id>] [password <text-email-password>] [severity info | severity warning | severity error | severity debug]Configures an email channel for NetQ notifications.3.1.0
netq lcm add netq-image <text-image-path>Lifecycle management command for adding a Cumulus NetQ disk image.3.1.0
netq install update-settings <text-key> <text-value>Advanced setting for overriding system variables after encountering issues during installation. File a support ticket with the Cumulus Networks Global Support Services team before trying this command.3.1.0
netq [<hostname>] show dom type (laser_rx_power|laser_output_power|laser_bias_current) [interface <text-dom-port-anchor>] [channel_id <text-channel-id>] [around <text-time>] [json]Displays digital optical monitoring information for laser bias current, laser output power and received signal average optical power.3.1.0
netq [<hostname>] show dom type (module_temperature|module_voltage) [interface <text-dom-port-anchor>] [around <text-time>] [json]Displays digital optical monitoring information for module temperature and voltage.3.1.0
netq trace (<mac> vlan <1-4096>) from <mac-src> [around <text-time>] [json|detail|pretty]Ability to run a trace from a source MAC address.3.1.0

Modified Commands

The following table summarizes the commands that have been changed with this release.

Updated CommandOld CommandWhat ChangedVersion
netq lcm upgrade name <text-job-name> cl-version <text-cumulus-linux-version> netq-version <text-netq-version> hostnames <text-switch-hostnames> [run-restore-on-failure] [run-before-after]netq lcm upgrade name <text-job-name> image-id <text-image-id> license <text-cumulus-license> hostnames <text-switch-hostnames> [order <text-upgrade-order>] [run-before-after]You now specify the Cumulus Linux and NetQ versions instead of an image ID. You can also specify whether to run LCM restore if there is a failure during the upgrade, and you can specify whether to run LCM before or after the upgrade.3.1.0
netq lcm add credentials username <text-switch-username> (password <text-switch-password> | ssh-key <text-ssh-key>)netq lcm add credentials (username <text-switch-username> password <text-switch-password> | ssh-key <text-ssh-key>)username is now a required parameter.3.1.0
netq lcm add cl-image <text-image-path>netq lcm add image <text-image-path>Option name changed to cl-image, for specifying a Cumulus Linux disk image to add. This was required because you can add Cumulus NetQ images now with the netq lcm add netq-image command.3.1.0
netq bootstrap worker tarball <text-tarball-name> master-ip <text-master-ip> [password <text-password>]netq bootstrap worker tarball <text-tarball-name> master-ip <text-master-ip>You can now specify a password to the host.3.1.0