NVIDIA NVOS User Manual for NVLink Switches v25.02.4282

NVIDIA Docs Hub Homepage NVIDIA Networking Networking Software Switch Software NVIDIA NVOS User Manual for NVLink Switches v25.02.4282 Installation Management Commands

On This Page

Version
- nv show system version
Image
Firmware

Installation Management Commands

Version

nv show system version

	nv show system version Displays system version information, including 'base-os' and 'product-release'.
Syntax Description	N/A
Default	N/A
History	25.02.1884 25.02.4253 Updated output
Example	Copy Copied! `admin@nvos:~$ nv show system version operational ---------- ---------------------------- kernel 5.10.0-30-2-amd64 build-date Wed Jun 18 15:19:56 UTC 2025 image nvos-25.02.4014 onie 2025.05-5.3.0017-115200`
REST API	GET https://<ip>/nvue_v1/system/version
Related Commands	nv show system nv show system image
Notes

Image

nv show system image

	nv show system image Show system image information. Display version information related to system image.
Syntax Description	N/A
Default	N/A
History	25.02.1884 25.02.4253 Updated command output
Example	Copy Copied! `admin@nvos: ~$ nv show system image operational ----------- --------------- current 1 next 1 issu-status no-issu partition1 build-id nvos-25.02.4014`
REST API	GET https://<ip>/nvue_v1/system/image
Related commands	nv show system image files
Notes

nv show system version image

	nv show system version image Displays information about the system's boot image.
Syntax Description	N/A
Default	N/A
History	25.02.4253
Example	Copy Copied! `admin@nvos: ~$ nv show system version image operational ---------- ---------------------------------------- build-id nvos-25.02.2988-001 build-date Wed Mar 5 11:23:22 UTC 2025`
REST API	GET https://<ip>/nvue_v1/system/version/image
Related commands
Notes

nv show system version packages installed

	nv show system version packages installed Lists all currently installed software packages on the system.
Syntax Description	N/A
Default	N/A
History	25.02.4253
Example	Copy Copied! `admin@nvos: ~$ nv show system version packages installed Installed Software Description Package Version ------------------- ------------------------------------- -------- ------- acpi displays information on ACPI devices acpi 1.7-1.2`
REST API	GET https://<ip>/nvue_v1/system/version/packages/installed
Related commands
Notes

nv show system version packages installed id

	nv show system version packages installed <installed-id> Displays detailed information about a specific installed software package. Replace with the actual package name.
Syntax Description	N/A
Default	N/A
History	25.02.4253
Example	Copy Copied! `admin@nvos: ~$ nv show system version packages installed acl operational ----------- ------------------------------- package acl version 2.2.53-10 description access control list - utilities`
REST API	GET https://<ip>/nvue_v1/system/version/packages/installed/<installed-id>
Related commands
Notes

nv show system image files

	nv show system image files Show files in the image directory on the switch file system.
Syntax Description	N/A
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv show system image files Available image file ----------------------------- nvos-amd64-25.01.2434-013.bin nvos-amd64-25.01.2504.bin`
REST API	GET https://<ip>/nvue_v1/system/image/files
Related commands	nv show system image
Notes

nv action fetch system image

	nv action fetch system image <remote-url> Fetch/download a file from a remote server and stores it locally.
Syntax Description	remote-url	Remote url path to fetch file from. Format: [protocol]://username[:password]@hostname/path/filename Supported protocols: SCP, HTTPS, FILE, FTP, and SFTP. The password must be encoded if it contains special characters and is provided as part of the command.
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action fetch system image scp://my_user:my_password@server/path/image.bin admin@nvos:~$ nv action fetch system image https://some.domain.com/path/image.bin admin@nvos:~$ nv action fetch system image file:///path/image.bin`
REST API	POST https://<ip>/nvue_v1/system/image
Related Commands	nv show system image files
Notes	Using https requires the remote server to have a valid CA certificate.

nv action install system image files

	nv action install system image files {image-file} [force] [reboot <yes/no>] Install system image from a binary file and reboot the system.
Syntax Description	image-file	Path to the binary file to install on the OS filesystems
	force	Force the action without asking for user confirmation
	reboot	Install image with or without system reboot
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action install system image files nvos.bin The operation will install the image and initiate a reboot. Type [y] to install the image and reboot. Type [N] to abort. Do you want to continue? [y/N] N Image install aborted by user`
REST API	POST https://<ip>/nvue_v1/system/image/files/
Related commands	nv show system image
Notes	Executing the command for an image that is already installed on the other partition will not install the image again, it will only change the "boot-next" image.

nv action rename system image files

	nv action rename system image files <image> <new-name> Rename an image file.
Syntax Description	image	Source image file name
	new-name	Destination image file name
Default	N/A	In case of an empty parameter performs a regular reboot without force.
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action rename system image files old_name.img new_name.img`
REST API	POST https://<ip>/nvue_v1/system/image/files/<file-name>
Related Commands	nv show system image files
Notes

nv action upload system image files

	nv action upload system image files <image> <remote-url> Upload an image file to remote location.
Syntax Description	image	Image file to upload
	remote-url	Destination image file name Remote url path to upload a file to. Format: [protocol]://username[:password]@hostname/path/filename Supported protocols: SCP, FTP, SFTP, and HTTPS
Default	N/A
History	25.02.1884 25.02.4253 Added HTTPS support in remote-url
Example	Copy Copied! `admin@nvos:~$ nv action upload system image image_file.bin scp://my_user:my_password@server/path/image_file.bin`
REST API	POST https://<ip>/nvue_v1/system/image/files/<file-name>
Related commands	nv show system image files
Notes

nv action uninstall system image

	nv action uninstall system image Removes old unused images that are not current or boot-next.
Syntax Description	N/A
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action uninstall system image Cleaning up old unused images... Removing image nvos-old Images cleanup done Action succeeded admin@nvos:~$ nv action uninstall system image Cleaning up old unused images... No image(s) to cleanup Action succeeded`
REST API	POST https://<ip>/nvue_v1/system/image
Related commands	nv show system image
Notes

nv action delete system image files

	nv action delete system image files <image> Delete an image from file system.
Syntax Description	image	Image file name
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action delete system image files nvos.bin`
REST API	POST https://<ip>/nvue_v1/system/image/files/<file-name>
Related Commands	nv show system image files
Notes

nv action uninstall system image force

	nv action uninstall system image force Uninstall the system image. Uninstall old unused images that are not current image.
Syntax Description	image-id	System image identifier
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action uninstall system image force Uninstalling system image: nvos Image nvos uninstalled successfully Action succeeded admin@nvos:~$ nv action uninstall system image Uninstalling system image: nvos Action failed with the following issue: Image nvos can’t be uninstalled. Image does not exist`
REST API	POST https://<ip>/nvue_v1/system/image
Related commands	nv show system image
Notes	Image ID can be retrieved by the "nv show system image" command.

nv action boot-next system image

	nv action boot-next system image <image-id> Set boot-next system image. Set image to boot from at the next boot.
Syntax Description	image-id	System image identifier
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action boot-next system image nvos Setting system image nvos as boot-next.. Image nvos set as boot-next Action succeeded admin@nvos:~$ nv action boot-next system image nvos Setting system image nvos as boot-next.. Action failed with the following issue: Failed to set boot-next: Image nvos does not exist`
REST API	POST https://<ip>/nvue_v1/system/image
Related commands	nv show system image
Notes	Image ID can be retrieved by "nv show system image" command. Select which partition to boot from. Booting to an image with existing DB (with an image that is not freshly installed), will not migrate the configurations from the current image.

Firmware

nv show platform firmware

	nv show platform firmware Show platform firmware information. Show firmware information for platform components like ASIC, BIOS, SSD, CPLD, and transceiver.
Syntax Description	N/A
Default	N/A
History	25.02.1884
Example	Copy Copied! admin@nvos:~$ nv show platform firmware Name Actual FW Part Number FW Source ----------- ------------------- ------------------------------ --------- ASIC 35.2014.1498 920-9K36F-00MV-JS0_IPN_Ax default BIOS 00.00.018 N/A N/A BMC 88.0002.0590 N/A N/A CPLD1 CPLD000370_REV0202 0x0172 N/A CPLD2 CPLD000377_REV0308 0x0179 N/A CPLD3 CPLD000373_REV0205 0x0175 N/A CPLD4 CPLD000390_REV0103 0x0186 N/A EROT 01.03.0235.0000_n04 N/A N/A EROT-ASIC1 01.03.0235.0000_n04 N/A N/A EROT-ASIC2 01.03.0235.0000_n04 N/A N/A EROT-BMC 01.03.0235.0000_n04 N/A N/A EROT-CPU 01.03.0235.0000_n04 N/A N/A EROT-FPGA 01.03.0235.0000_n04 N/A N/A FPGA 302e3139 N/A N/A SSD CE00A400 Virtium VTPM24CEXI080-BM110006 N/A transceiver N/A N/A N/A
REST API	GET https://<ip>/nvue_v1/platform/firmware
Related commands
Notes

nv show platform firmware id

	nv show platform firmware <component-id> Show platform firmware information for specific component. Show firmware information for platform components such as ASIC, BIOS, CPLD, SSD, and transceiver.
Syntax Description	component-id	Platform component name: ASIC, BIOS, CPLD1, SSD, and transceiver. For systems with BMC, additional firmware components are supported: EROT, FPGA, BMC.
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv show platform firmware ASIC operational applied --------------- ------------------ ------- part-number 920-9K36F-00MV-JS0 actual-firmware 35.2014.1476 auto-update enabled fw-source default`
REST API	GET https://<ip>/nvue_v1/platform/firmware/<component-id>
Related Commands	nv show platform firmware
Notes

nv show platform firmware

	nv show platform firmware <erot-id> Show platform firmware information for specific ERoT component. Show firmware information for platform components such as EROT-BMC, EROT-CPU, EROT-FPGA, EROT-ASIC1, EROT-ASIC2.
Syntax Description	erot-id	Platform ERoT names: EROT-BMC, EROT-CPU, EROT-FPGA, EROT-ASIC1, EROT-ASIC
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv show platform firmware EROT-CPU operational applied --------------- ------------------ ------- part-number 920-9K36F-00MV-JS0 actual-firmware 35.2014.1476 auto-update enabled fw-source default background-copy-status pending debug-token-status not-installed active flash1 inactive flash2 ap-boot-status 0x01234567`
REST API	GET https://<ip>/nvue_v1/platform/firmware/<erot-id>
Related Commands	nv show platform firmware
Notes

nv show platform firmware files

	nv show platform firmware <component-id> files Display the list of available firmware files for specific component. Display the list of available firmware files for platform components such as ASIC, BIOS, CPLD and transceiver.
Syntax Description	component-id	Platform component name: ASIC, BIOS, CPLD, and transceiver. For system with BMC, more firmware like EROT/FPGA/BMC are supported.
Default	N/A
History	25.02.1884
Example	Copy Copied! admin@nvos:~$ nv show platform firmware ASIC files Available firmware files File path -------------------------------- ------------------------------------------------ fw-NVL5-rel-35_2014_1476.mfa /host/fw-images/fw-NVL5-rel-35_2014_1476.mfa admin@nvos:~$ nv show platform firmware transceiver files Available Firmware Files File Path ------------------------------ ----------------------------------------------------- fw_47_150_03003_dev_signed.bin /host/fw-images/module/fw_47_150_03003_dev_signed.bin
REST API	GET https://<ip>/nvue_v1/platform/firmware/{component-id}/files
Related commands	nv show platform firmware nv action install platform firmware <component-id> files <file-name> nv action install platform transceiver <transceiver-id> firmware files <file-name>
Notes

nv set/unset platform firmware

	nv set platform firmware [ASIC \| BIOS] [auto-update {enabled,disabled} \| fw-source {default,custom}] nv unset platform firmware [ASIC \| BIOS] [auto-update {enabled,disabled} \| fw-source {default,custom}] Update the platform ASIC or BIOS component configuration.
Syntax Description	auto-update	Firmware component auto-update state
	fw-source	Firmware component default source
Default	auto-update	enabled
	fw-source	default
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set platform firmware ASIC fw-source custom admin@nvos:~$ nv set platform firmware ASIC auto-update disabled`
REST API	PATCH https://<ip>/nvue_v1/platform/firmware/ASIC
Related commands
Notes	The configuration on BIOS is not available on system with BMC.

nv action install platform firmware files

	nv action install platform firmware <component_id> files <file_path> [force] [skip-reboot][skip-version-check] Install platform firmware image. ASIC Image will be installed to stage location and will be installed at the next reboot time.
Syntax Description	component_id	Platform component name: ASIC, BIOS, CPLD1, SSD, and transceiver. For systems with BMC, additional firmware components are supported: EROT, FPGA, BMC.
	file_path	Path to the firmware file.
	force	Force the action without asking for user confirmation.
	skip-reboot	Skip reboot after firmware installation. If force was specified, the reboot will still be skipped.
	skip-version-check	Skip version check. When this option is specified, the CLI will force the installation even if the same version is already installed. If not specified, the CLI will skip installation when the version matches the existing version.
Default	N/A
History	25.02.1884 25.02.4253 Added `skip-version-check` option
Example	Copy Copied! `admin@nvos:~$ nv action install platform firmware ASIC files fw-NVL5.mfa Installing firmware: /tmp/fw-NVL5.mfa Firmware fw-NVL5.mfa successfully installed Action succeeded`
REST API	POST https://<ip>/nvue_v1/platform/firmware/{platform-component-id}/files/{file-name}
Related commands	nv set/unset platform firmware ASIC auto-update nv action reboot system
Notes	ASIC Image will be installed to stage location and will be installed at the next reboot time Installation respects "auto-update" and "fw-source" configuration To install firmware on a transceiver, use the following command: nv action install platform transceiver firmware files After installing firmware, initiating system reboot via the "nv action reboot system" command will perform a power-cycle to load the new firmware. `skip-version-check` is only relevant to BMC managed firmware (FPGA/BIOS/EROT/BMC) and CPLD.

nv action delete platform firmware files

	nv action delete platform firmware <component-id> files <file-name> Delete firmware file from the filesystem for specific component such as ASIC, BIOS, CPLD and transceiver.
Syntax Description	file-name	firmware file name
	component-id	Platform component name: ASIC, BIOS, CPLD, and transceiver. For system with BMC, more firmware like EROT/FPGA/BMC are supported.
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action delete platform firmware ASIC files fw-test.mfa File delete successfully Action succeeded admin@nvos:~$ nv action delete platform firmware transceiver files fw-test.bin File delete successfully Action succeeded`
REST API	POST https://<ip>/nvue_v1/platform/firmware/{component-id}/files/{file-name}
Related commands	nv show platform firmware <component-id> files nv action fetch platform firmware <component-id> <url> nv action upload platform firmware <component-id> files <file-name> <remote-url> nv action rename platform firmware <component-id> files <file-name> <new-name> nv action install platform firmware <component-id> files <file-name> [force] nv show platform transceiver <transceiver-id> firmware nv action install platform transceiver <transceiver-id> firmware files
Notes

nv action rename platform firmware files

	nv action rename platform firmware <component-id> files <file-name> <new-name> Rename available firmware file for platform components such as ASIC, BIOS, CPLD and transceiver.
Syntax Description	file-name	Firmware file name
	new-name	New name for firmware file
	component-id	Platform component name: ASIC, BIOS, CPLD, and transceiver. For system with BMC, more firmware like EROT/FPGA/BMC are supported.
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action rename platform firmware ASIC files fw-NVL5.mfa new-fw-NVL5.mfa File renamed successfully Action succeeded admin@nvos:~$ nv action rename platform firmware transceiver files fw-test.bin new-fw-test.bin File renamed successfully Action succeeded`
REST API	POST https://<ip>/nvue_v1/platform/firmware/{component-id}/files/{file-name}
Related commands	nv show platform firmware <component-id> files nv action fetch platform firmware <component-id> <url> nv action upload platform firmware <component-id> files <file-name> <remote-url> nv action delete platform firmware <component-id> files <file-name> nv action install platform firmware <component-id> files <file-name> [force] nv show platform transceiver <transceiver-id> firmware nv action install platform transceiver <transceiver-id> firmware files
Notes

nv action fetch platform firmware

	nv action fetch platform firmware <component-id> <remote-url> Fetch remote firmware file to local filesystem for platform components such as ASIC, BIOS, CPLD and transceiver.
Syntax Description	component-id	Platform component name: ASIC, BIOS, CPLD, and transceiver. For system with BMC, more firmware like EROT/FPGA/BMC are supported.
	remote-url	Remote url path to fetch file from. Format: [protocol]://username[:password]@hostname/path/filename Supported protocols: SCP, HTTPS, FILE, FTP, and SFTP. The password must be encoded if it contains special characters and is provided as part of the command.
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action fetch platform firmware ASIC scp://my_user:my_password@hostname/dir/file.mfa Fetching file … File fetched successfully Action succeeded admin@nvos:~$ nv action fetch platform firmware transceiver scp://my_user:my_password@hostname/dir/file.bin Fetching file … File fetched successfully Action succeeded admin@nvos:~$ nv action fetch platform firmware ASIC file:///dir/file.mfa Fetching file … File fetched successfully Action succeeded`
REST API	POST https://<ip>/nvue_v1/platform/firmware/{component-id}/files/{file-name}
Related commands	nv show platform firmware <component-id> files nv action rename platform firmware <component-id> files <file-name> <new-name> nv action upload platform firmware <component-id> files <file-name> <remote-url> nv action delete platform firmware <component-id> files <file-name> nv action install platform firmware <component-id> files <file-name> [force] nv show platform transceiver <transceiver-id> firmware nv action install platform transceiver <transceiver-id> firmware files
Notes

nv action upload platform firmware files

	nv action upload platform firmware <component-id> files <file-name> <remote-url> Upload available firmware file for platform components such as ASIC, BIOS, CPLD and transceiver to remote server.
Syntax Description	component-id	Platform component name: ASIC, BIOS, CPLD, and transceiver. For system with BMC, more firmware like EROT/FPGA/BMC are supported.
	file-name	Firmware file name
	remote-url	Destination image file name Remote url path to upload a file to. Format: [protocol]://username[:password]@hostname/path/filename Supported protocols: SCP, FTP, SFTP, and HTTPS
Default	N/A
History	25.02.1884 25.02.4253 Added HTTPS support in remote-url
Example	Copy Copied! `admin@nvos:~$ nv action upload platform firmware ASIC files fw-NVL5.mfa new-fw-NVL5.mfa Action executing ... File upload successfully Action succeeded`
REST API	POST https://<ip>/nvue_v1/platform/firmware/{component-id}/files/{file-name}
Related commands	nv show platform firmware <component-id> files nv action fetch platform firmware <component-id> <url> nv action delete platform firmware <component-id> files <file-name> nv action install platform firmware <component-id> files <file-name> [force] nv show platform transceiver <transceiver-id> firmware nv action install platform transceiver <transceiver-id> firmware files
Notes

© Copyright 2025, NVIDIA. Last updated on Sep 22, 2025.