node-upgrade
| Command | Description |
|---|---|
node-upgrade
|
A tool for running firmware upgrades on multiple managed console servers with a single command and returns the results in tabular form to stdout. |
| Syntax |
|---|
node-upgrade [-h] [-q | -b | -V | -D] [-l] [-I] [-n NODE_NAME] [-i NODE_ID] [-a NODE_ADDRESS] [-A] [-p {ACM500X,ACM550X,ACM700X,ACM7004-5,CM71XX,CM7196,IM42XX,IM72XX,OMXXXX,CM81XX}]
[-g {Enrolled Nodes 2,Connected Nodes,Disconnected Nodes 2,Cell Health Sim Issues,Cell Health Connectivity Check Failed,retester,Good Health,SamTestFilter,JW Test}]
(-f FIRMWARE_DIR | -F FIRMWARE_FILE) [-v VERSION]
|
| Option | Alternate Syntax | Description |
|---|---|---|
-h
|
--help
|
Display usage information and exit. |
-q
|
--quiet
|
Suppress log messages. |
-b
|
--batch
|
DEPRECATED: use --quiet instead. |
-V
|
--verbose
|
Display logs generated while upgrading. |
-D
|
--debug
|
Display detailed log messages, implies --verbose. |
-l
|
--list-nodes
|
Display nodes and their upgradeable paths without executing upgrade. |
-I
|
--ignore-version
|
Ignore firmware version warnings for upgrade. |
-f <directory>
|
--firmware-dir <directory>
|
The directory of the firmware files(s). This is the directory node-upgrade looks to for the firmware image used as the source for all the firmware upgrade attempts. |
-F <path>
|
--firmware-file <path>
|
The path to the firmware image to use for upgrade. |
-v <version>
|
--version <version>
|
The firmware version to upgrade to. |
-n <name>
|
--node-name=<name>
|
Select a specific node by its name, this option may be used multiple times. |
-i <id>
|
--node-id <id>
|
Select a specific node by its ID, this option may be used multiple times. |
-a <address>
|
--node-address <address>
|
Select a specific node by its Lighthouse VPN address, this option may be used multiple times. |
-A
|
--all
|
Select all nodes. All other node selection options are ignored if used at the same time. |
-p <family>
|
--product <family>
|
Select node by product family where values available are: {ACM500X,ACM550X,ACM700X,ACM7004-5,CM71XX,CM7196,IM42XX,IM72XX,OMXXXX,CM81XX} |
-g <name>
|
--smartgroup <name>
|
Select nodes by smartgroup. When using along side --product, 'product' and 'smartgroup' are used with an 'AND' operator. |
Exit Status
| Exit Status | Description |
|---|---|
| 0 | Command exited normally |
| 1 | Invalid parameter |
| 2 | Unknown argument |
Output Messages
| Result | Causes |
|---|---|
| SUCCESS | Node upgrade succeeded. |
| FileNotFoundError | No upgrade file found matching provided device family or version. |
| UpgradeError | Device already has same or higher firmware version or network connection lost. |
| IncompatibleFirmwareError | Firmware file provided does not match the product family. |
Example
# node-upgrade --all --firmware-dir /mnt/data/nvram/latest-firmware/ --version 4.11.0
NODE (UUID) MODEL FAMILY ADDRESS VERSION RESULT
----------------------------------------------------------------------------------------
cm7116-2 (nodes-4) CM7116-2 CM71XX 192.168.128.5 4.11.0 SUCCESS
im7208-2 (nodes-6) IM7208-2 IM72XX 192.168.128.7 4.10.0 SUCCESS
cm7196a-2 (nodes-5) CM7196A-2 CM7196 192.168.128.6 4.10.0 SUCCESS
acm7004-2 (nodes-2) ACM7004-2 ACM700X 192.168.128.3 4.11.0 SUCCESS
acm5508-2 (nodes-1) ACM5508-2 ACM550X 192.168.128.2 4.1.1u2 SUCCESS
acm7004-5 (nodes-3) ACM7004-5 ACM7004-5 192.168.128.4 4.11.0 SUCCESS
om2216-l (nodes-8) OM2216-L OMXXXX 192.168.128.9 21.Q2.1 FileNotFoundError
om1208-8e (nodes-7) OM1208-8E OMXXXX 192.168.128.8 21.Q2.1 FileNotFoundError
Note: The information in the output shows the device version prior to upgrade.