Upgrading the Junos OS on NFX Devices
To upgrade the Junos OS version on NFX150, NFX250 NextGen, and NFX350 devices:
-
Download the software package from the Downloads page to the /var/public directory on the NFX device.
-
Verify the Junos OS version that is currently installed on the device. The following sample output for NFX250 NextGen shows that Junos OS Release 22.3R2.12 is installed on the device.
user@host> show version root@host> show version Hostname: host Model: nfx250 Junos: 22.3R2.12 JUNOS OS Kernel 64-bit [20221212.98a33a0_builder_stable_12_223] JUNOS OS libs [20221212.98a33a0_builder_stable_12_223] JUNOS OS runtime [20221212.98a33a0_builder_stable_12_223] JUNOS OS time zone information [20221212.98a33a0_builder_stable_12_223] JUNOS network stack and utilities [20230223.221505_builder_junos_223_r2] JUNOS libs [20230223.221505_builder_junos_223_r2] JUNOS OS libs compat32 [20221212.98a33a0_builder_stable_12_223] JUNOS OS 32-bit compatibility [20221212.98a33a0_builder_stable_12_223] JUNOS libs compat32 [20230223.221505_builder_junos_223_r2] JUNOS runtime [20230223.221505_builder_junos_223_r2] JUNOS Packet Forwarding Engine Simulation Package [20230223.221505_builder_junos_223_r2] JUNOS sflow mx [20230223.221505_builder_junos_223_r2] JUNOS py extensions [20230223.221505_builder_junos_223_r2] JUNOS py base [20230223.221505_builder_junos_223_r2] JUNOS OS vmguest [20221212.98a33a0_builder_stable_12_223] JUNOS OS package [20230213.192558_builder_stable_12] JUNOS OS crypto [20221212.98a33a0_builder_stable_12_223] JUNOS OS boot-ve files [20221212.98a33a0_builder_stable_12_223] JUNOS na telemetry [22.3R2.12] JUNOS Wireless WAN Module [20230223.221505_builder_junos_223_r2]
You can use the
show vmhost version detail
command to view the Junos OS version that is installed on the disk partitions. Note that the NFX150 and NFX250 NextGen have a single disk with two partitions whereas the NFX350 has dual disks that provide four partitions.Here's a sample output for an NFX250 NextGen device. You'll notice that the primary partition is the active partition.
user@host> show vmhost version detail Partition set : primary Software version : 22.3R2.12 Host kernel release : 4.1.27-rt30-WR8.0.0.34_ovp Host kernel version : #1 SMP Sun Dec 4 22:30:10 PST 2022 Partition set : primary Software version : 22.3R2.12 Installed/Upgraded at : Tue Feb 28 10:12:50 UTC 2023 Status : Boot success Partition set : alternate Software version : 22.3R2.12 Installed/Upgraded at : Tue Feb 28 10:17:48 UTC 2023 Status : Factory installation setup complete, ready for boot
-
Upgrade the Junos OS by using the
request vmhost software
command.user@host> request vmhost software add /var/public/jinstall-host-nfx-3-x86-64-22.4R2.1-secure-signed.tgz Verified jinstall-host-nfx-3-x86-64-22.4R2.1-secure-signed signed by PackageProductionECP256_2023 method ECDSA256+SHA256 Pushing Junos image package to the host... File already present in Host. Skipping pushing the image Mounting alternate partitions to stage upgrade operation Installing /var/tmp/preinstall/install-media-nfx-3-junos-22.4R2.1-secure.tgz Extracting the package ... Validate linux image... upgrade_platform: ------------------- upgrade_platform: Parameters passed: upgrade_platform: silent=0 upgrade_platform: package=/var/tmp/tmp.27UZct4newjunos_cli_upg/jinstall-nfx-3-junos-22.4R2.1-secure-linux.tgz upgrade_platform: clean install=0 upgrade_platform: Need reboot after staging=1 upgrade_platform: ------------------- upgrade_platform: upgrade_platform: Checking input /var/tmp/tmp.27UZct4newjunos_cli_upg/jinstall-nfx-3-junos-22.4R2.1-secure-linux.tgz ... upgrade_platform: Input package /var/tmp/tmp.27UZct4newjunos_cli_upg/jinstall-nfx-3-junos-22.4R2.1-secure-linux.tgz is valid. Secure Boot is enforced. ALLOW:usr/secureboot/grub/BOOTX64.EFI ALLOW:boot/bzImage-intel-x86-64.bin ALLOW:boot/initramfs.cpio.gz Setting up Junos host applications for installation ... Installing Host OS ... upgrade_platform: ------------------- upgrade_platform: Parameters passed: upgrade_platform: silent=0 upgrade_platform: package=/var/tmp/tmp.27UZct4newjunos_cli_upg/jinstall-nfx-3-junos-22.4R2.1-secure-linux.tgz upgrade_platform: clean install=0 upgrade_platform: Need reboot after staging=0 upgrade_platform: ------------------- upgrade_platform: upgrade_platform: Checking input /var/tmp/tmp.27UZct4newjunos_cli_upg/jinstall-nfx-3-junos-22.4R2.1-secure-linux.tgz ... upgrade_platform: Input package /var/tmp/tmp.27UZct4newjunos_cli_upg/jinstall-nfx-3-junos-22.4R2.1-secure-linux.tgz is valid. Secure Boot is enforced. ALLOW:usr/secureboot/grub/BOOTX64.EFI ALLOW:boot/bzImage-intel-x86-64.bin ALLOW:boot/initramfs.cpio.gz upgrade_platform: Backing up boot assets.. upgrade_platform: Staging the upgrade package - /var/tmp/tmp.27UZct4newjunos_cli_upg/jinstall-nfx-3-junos-22.4R2.1-secure-linux.tgz.. upgrade_platform: Checksum verified and OK... Setting up boot environment ... Setting up boot environment completed upgrade_platform: Staging of /var/tmp/tmp.27UZct4newjunos_cli_upg/jinstall-nfx-3-junos-22.4R2.1-secure-linux.tgz completed upgrade_platform: System needs *REBOOT* to complete the upgrade Host OS upgrade staged. Reboot the system to complete installation!
If you run the
show vmhost version
command now, you notice that the software version still shows 22.3R2.12. Note that the status of the alternate partition indicates that the new Junos OS version is staged on the alternate partition.root@host> show vmhost version detail | no-more Partition set : primary Software version : 22.3R2.12 Host kernel release : 4.1.27-rt30-WR8.0.0.34_ovp Host kernel version : #1 SMP Sun Dec 4 22:30:10 PST 2022 Reboot is pending for a software upgrade Partition set : primary Software version : 22.3R2.12 Installed/Upgraded at : Tue Feb 28 10:12:50 UTC 2023 Status : Boot success Partition set : alternate Software version : 22.3R2.12 Installed/Upgraded at : Tue Feb 28 10:17:48 UTC 2023 Status : Software upgrade staged, boot to partition-set pending
-
Reboot the device to load the new version of Junos OS on the device.
root@host> request vmhost reboot Reboot the vmhost ? [yes,no] (no) yes Initiating vmhost reboot... root@host> show version Hostname: host Model: nfx250_att_ls1_10_t Junos: 22.4R2.1 JUNOS OS Kernel 64-bit [20230213.5295c32_builder_stable_12_224] JUNOS OS libs [20230213.5295c32_builder_stable_12_224] JUNOS OS runtime [20230213.5295c32_builder_stable_12_224] JUNOS OS time zone information [20230213.5295c32_builder_stable_12_224] JUNOS network stack and utilities [20230301.213842_builder_junos_224_r2] JUNOS libs [20230301.213842_builder_junos_224_r2] JUNOS OS libs compat32 [20230213.5295c32_builder_stable_12_224] JUNOS OS 32-bit compatibility [20230213.5295c32_builder_stable_12_224] JUNOS libs compat32 [20230301.213842_builder_junos_224_r2] JUNOS runtime [20230301.213842_builder_junos_224_r2] JUNOS Packet Forwarding Engine Simulation Package [20230301.213842_builder_junos_224_r2] JUNOS sflow mx [20230301.213842_builder_junos_224_r2] JUNOS py extensions [20230301.213842_builder_junos_224_r2] JUNOS py base [20230301.213842_builder_junos_224_r2] JUNOS OS vmguest [20230213.5295c32_builder_stable_12_224] JUNOS OS package [20230213.192558_builder_stable_12] JUNOS OS crypto [20230213.5295c32_builder_stable_12_224] JUNOS OS boot-ve files [20230213.5295c32_builder_stable_12_224] JUNOS na telemetry [22.4R2.1]
-
After the device reboots, verify the status of the disk partitions. The following output shows that the image on the alternate partition is upgraded. The alternate partition is the active partition now.
root@host> show vmhost version detail Partition set : alternate Software version : 22.4R2.1 Host kernel release : 4.1.27-rt30-WR8.0.0.34_ovp Host kernel version : #1 SMP Mon Feb 27 04:48:57 PST 2023 Partition set : primary Software version : 22.3R2.12 Installed/Upgraded at : Tue Feb 28 10:12:50 UTC 2023 Status : Boot success Partition set : alternate Software version : 22.4R2.1 Installed/Upgraded at : Tue Mar 7 16:05:24 UTC 2023 Status : Boot success
To upgrade the release to the same version on all the disk partitions, see Upgrading Dual-Disk Partitions on NFX250 NextGen and NFX350 Devices.