Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


Migration, Upgrade, and Downgrade Instructions


This section contains information about how to upgrade Junos OS for vSRX using the CLI. Upgrading or downgrading Junos OS can take several hours, depending on the size and configuration of the network.

Direct upgrade of vSRX from Junos OS 15.1X49 Releases to Junos OS Releases 17.4, 18.1, 18.2, 18.3, 18.4, 19.1, or 19.2 is supported.

The following limitations apply:

  • Direct upgrade of vSRX from Junos OS 15.1X49 Releases to Junos OS Release 19.3 and higher is not supported. For upgrade between other combinations of Junos OS Releases in vSRX and vSRX 3.0, the general Junos upgrade policy applies.

  • The file system mounted on /var usage must be below 14% of capacity.

    Check this using the following command:

    show system storage | match " /var$" /dev/vtbd1s1f

    Using the request system storage cleanup command might help reach that percentage.

  • The Junos upgrade image must be placed in the directory /var/host-mnt/var/tmp/. Use the request system software add /var/host-mnt/var/tmp/<upgrade_image>

  • We recommended you deploy a new vSRX VM instead of performing a Junos upgrade. That also gives you the option to move from vSRX to the newer and more recommended vSRX 3.0.

  • Ensure to backup valuable items such as configurations, license-keys, certificates, and other files that you would like to keep.

Upgrading Software Packages

To upgrade to Junos OS 15.1X49-D240 using the CLI:

  1. Verify that Junos OS Release 15.1X49-D15 or later for vSRX is deployed.
  2. Download the Junos OS Release 15.1X49-D240 for vSRX .tgz file from the Juniper Networks website. Note the size of the software image.
  3. Verify that you have enough free disk space on the vSRX to upload the new software image.
  4. Optionally, free up more disk space if needed to upload the image.

    If this command does not free up enough disk space, see [SRX] Common and safe files to remove in order to increase available system storage for details on safe files you can manually remove from vSRX to free up disk space.

  5. Use FTP, SCP, or a similar utility to upload the Junos OS Release 15.1X49-D240 for vSRX .tgz file to /var/tmp on the local file system of your vSRX VM. For example:
  6. From operational mode, install the software upgrade package:

    If no errors occur, Junos OS reboots automatically to complete the upgrade process.

  7. You have successfully upgraded to Junos OS Release 15.1X49-D240 for vSRX. Now log in and use the show version command to verify the upgrade.

You also can upgrade to Junos OS Release 15.1X49-D240 for vSRX using J-Web (see J-Web) or the Junos Space Network Management Platform (see Junos Space).

Validating the OVA Image

If you have downloaded a vSRX .ova image and need to validate it, see Validating the vSRX .ova File for VMware.

Note that only .ova (VMware platform) vSRX images can be validated. The .qcow2 vSRX images for use with KVM cannot be validated the same way. File checksums for all software images are, however, available on the download page.

Migrating from Firefly Perimeter

For Firefly Perimeter users, it is not possible to upgrade directly from Firefly Perimeter to vSRX.

For anyone currently using a version of Firefly Perimeter or vSRX based on Junos OS Release 12.1X46 or 12.1X47, you must start with a completely new install of Junos OS Release 15.1X49-D15 for vSRX.