Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

request vmhost software add

MX Series

PTX Series

Description

Install Junos OS and host software packages on the device.

For installing the host software as well as Junos OS, specify the package name junos-vmhost-install-x.tgz in the request vmhost software add command. Junos OS installation alone can be achieved by specifying the regular package name junos-install-x.tgz in the request system software add command. However, installation using the vmhost package is recommended as it upgrades both the host software and Junos OS.

Note:

You must load the PTX1000, PTX10008, PTX10016, PTX10002-60C, and QFX10002-60C devices only with junos-vmhost-install-x.tgz package using the request vmhost software add command. The junos-vmhost-install-x.tgz package upgrades both the host software and Junos OS. The PTX1000, PTX10008, PTX10016, PTX10002-60C, and QFX10002-60C devices do not support Junos only upgrade. If you try to load Junos only image, then these devices go down or vmhost commands do not work or the device state is unpredictable.

Options

none—Install Junos OS and host software packages on the Routing Engine on the local Virtual Chassis member.

package-name

Location from which the software package or bundle is to be installed. For example:

  • /var/tmp/package-name—For a software package or bundle that is being installed from a local directory on the device.

  • protocol://hostname/pathname/package-name—For a software package or bundle that is to be downloaded and installed from a remote location. Replace protocol with one of the following:

    • ftp—File Transfer Protocol (FTP).

      Use ftp://hostname/pathname/package-name. To specify authentication credentials, use ftp://<username>:<password>@hostname/pathname/package-name. To have the system prompt you for the password, specify prompt in place of the password. If a password is required, and you do not specify the password or prompt, an error message is displayed.

    • http—Hypertext Transfer Protocol (HTTP).

      Use http://hostname/pathname/package-name. To specify authentication credentials, use http://<username>:<password>@hostname/pathname/package-name. If a password is required and you omit it, you are prompted for it.

    • scp—Secure Copy Protcol (SCP)(not available for limited editions).

      Use scp://hostname/pathname/package-name. To specify authentication credentials, use scp://<username>:<password>@hostname/pathname/package-name.

Note:

  • The pathname in the protocol is the relative path to the user’s home directory on the remote system and not the root directory.

  • Do not use the scp protocol in the request vmhost software add command to download and install a software package or bundle from a remote location. The software upgrade is handled by the mgd process that does not support SCP.

    To install a software package or bundle from a remote location:

    1. Use the file copy command to copy the software package or bundle from the remote location to the /var/tmp directory on the hard disk:

      file copy scp://source/package-name /var/tmp

    2. Install the software package or bundle by using the request vmhost software add command:

      request vmhost software add /var/tmp/package-name
no-validate

(Optional) When loading a software package or bundle with a different release, suppress the default behavior of the validate option.
re0 | re1

(Optional) Load a software package or bundle on the Routing Engine in slot 0 (re0) or the Routing Engine in slot 1 (re1).

Note:

The option re1 is not supported on the PTX1000 Packet Transport Router.
reboot

(Optional) After adding the software package or bundle, reboot the system.
set [package-names]

(Optional)

Additional Information

Before upgrading the software on the device, when you have a known stable system, issue the request vmhost snapshot command to back up the software. After you have upgraded the software on the device and are satisfied that the new package or bundle is successfully installed and running, issue the request vmhost snapshot command again to back up the new software to the backup disk.

After you run the request vmhost snapshot command, you cannot return to the previous version of the snapshot, because the previous snapshot is replaced by the new snapshot.

Before installing software on a device that has one or more custom YANG data models added to it, back up and remove the configuration data corresponding to the custom YANG data models from the active configuration. For more information see Managing YANG Packages and Configurations During a Software Upgrade or Downgrade.

Required Privilege Level

maintenance

Sample Output

request vmhost software add (Multiple Packages)

Release Information

Command introduced in Junos OS Release 15.1F3.

Note:

PTX3000 router supports the Routing and Control Board, RCBPTX.

Related Documentation