Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

request system snapshot

 

List of Syntax

Syntax (ACX Series Routers)

Syntax (EX Series Switches; for EX4600, see QFX Series Syntax)

Syntax (MX Series Routers)

Syntax (PTX Series)

Syntax (QFX Series, OCX1100, and EX4600)

Syntax (TX Matrix Routers)

Syntax (TX Matrix Plus Routers)

Syntax (ACX Series Routers)

Syntax (EX Series Switches; for EX4600, see QFX Series Syntax)

Syntax (MX Series Routers)

Syntax (PTX Series)

Syntax (QFX Series, OCX1100, and EX4600)

Syntax (TX Matrix Routers)

Syntax (TX Matrix Plus Routers)

Release Information

Command introduced before Junos OS Release 7.4.

Command introduced in Junos OS Release 10.0 for EX Series switches.

Command introduced in Junos OS Release 11.3 for the QFX Series.

Command introduced in Junos OS Release 12.2 for ACX Series routers.

Options <config-partition> and <root-partition> introduced in Junos OS Release 13.1 for M Series, MX Series, T Series, and TX Series routers.

Option media usb-port-number introduced in Junos OS Release 13.2 for MX104 routers.

Command introduced in Junos OS Release 14.1X53-D20 for the OCX Series.

Options <config-partition>, <root-partition>, and <slice> deprecated for Junos OS with Upgraded FreeBSD in Junos OS Release 15.1

Note

To determine which platforms support Junos OS with upgraded FreeBSD, see Feature Explorer and enter one of the following:

  • For non-virtualized, enter freebsd and select Junos kernel upgrade to FreeBSD 10+.

  • For virtualized, enter virtualization and select Virtualization of the Routing Engine.

Description

  • On routers running Junos OS, back up the currently running and active file system partitions to standby partitions that are not running. Specifically, the root file system (/) is backed up to /altroot, and /config is backed up to /altconfig. The root and /config file systems are on the router's flash drive, and the /altroot and /altconfig file systems are on the router's hard drive.

  • On switches running Junos OS, take a snapshot of the files currently used to run the switch—the complete contents of the root (/) , /altroot, /config, /var, and /var-tmp directories, which include the running version of Junos OS, the active configuration, and log files.

  • On devices running Junos OS Evolved, take a snapshot of the contents of the /soft directory, which includes the running version of Junos OS Evolved.

Caution

After you run the request system snapshot command, you cannot return to the previous version of the software, because the running and backup copies of the software are identical.

Note

System snapshot is not supported on QFX10000 switches.

Note

Starting with Junos OS Release 15.1F3, the command request system snapshot creates a snapshot of the guest OS image only for the PTX5000 with RE-DUO-C2600-16G, and the MX240, MX480, and MX960 routers with RE-S-1800X4-32G-S.

Starting with Junos OS Release 15.1F5, the command request system snapshot creates a snapshot of the guest OS image only for the MX2010 and MX2020 routers with REMX2K-1800-32G-S.

On these routers, in order to create snapshot of the host OS image along with Junos OS image, use the request vmhost snapshot command.

Options

The specific options available depend upon the router or switch:

noneBack up the currently running software as follows:
  • On the router, back up the currently running and active file system partitions to standby partitions that are not running. Specifically, the root file system (/) is backed up to /altroot, and /config is backed up to /altconfig. The root and /config file systems are on the router's flash drive, and the /altroot and /altconfig file systems are on the router's hard drive.

  • On the switch, take a snapshot of the files currently used to run the switch and copy them to the media that the switch did not boot from. If the switch is booted from internal media, the snapshot is copied to external (USB) media. If the switch is booted from external (USB) media, the snapshot is copied to internal media.

    • If the snapshot destination is external media but a USB flash drive is not connected, an error message is displayed.

    • If the automatic snapshot procedure is already in progress, the command returns the following error: Snapshot already in progress. Cannot start manual snapshot. For additional information about the automatic snapshot feature, see Configuring Dual-Root Partitions.

all-chassis | all-lcc | lcc number (TX Matrix and TX Matrix Plus router only) (Optional)
  • all-chassis—On a TX Matrix router, archive data and executable areas for all Routing Engines in the chassis. On a TX Matrix Plus router, archive data and executable areas for all Routing Engines in the chassis.

  • all-lcc—On a TX Matrix router, archive data and executable areas for all T640 routers (or line-card chassis) connected to a TX Matrix router. On a TX Matrix Plus router, archive data and executable areas for all routers (or line-card chassis) connected to a TX Matrix Plus router.

  • lcc number—On a TX Matrix router, archive data and executable areas for a specific T640 router (or line-card chassis) that is connected to a TX Matrix router. On a TX Matrix Plus router, archive data and executable areas for a specific router (line-card chassis) that is connected to a TX Matrix Plus router.

    Replace number with the following values depending on the LCC configuration:

    • 0 through 3, when T640 routers are connected to a TX Matrix router in a routing matrix.

    • 0 through 3, when T1600 routers are connected to a TX Matrix Plus router in a routing matrix.

    • 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with 3D SIBs in a routing matrix.

    • 0, 2, 4, or 6, when T4000 routers are connected to a TX Matrix Plus router with 3D SIBs in a routing matrix.

all-members | local | member member-id(EX Series Virtual Chassis, MX Series routers, QFX Series switches, QFabric System, and OCX1100 only) (Optional) Specify where to place the snapshot (archive data and executable areas) in a Virtual Chassis:
  • all-members—Create a snapshot (archive data and executable areas) for all members of the Virtual Chassis.

  • local—Create a snapshot (archive data and executable areas) on the member of the Virtual Chassis that you are currently logged into.

  • member member-id—Create a snapshot (archive data and executable areas) for the specified member of the Virtual Chassis.

config-partition(EX Series Virtual Chassis, MX Series routers, QFX Series switches, QFabric System, OCX1100, and T and TX Series routers only) Create a snapshot of the configuration partition only and store it onto the default /altconfig on the hard disk device or an /altconfig on a USB device. Option deprecated for Junos OS with Upgraded FreeBSD in Junos OS Release 15.1.
Note

To determine which platforms support Junos OS with upgraded FreeBSD, see Feature Explorer and enter one of the following:

  • For non-virtualized, enter freebsd and select Junos kernel upgrade to FreeBSD 10+.

  • For virtualized, enter virtualization and select Virtualization of the Routing Engine.

media type(ACX Series, M320, T640, MX960 routers only)(Optional) Specify the boot device the software is copied to:
  • compact-flash—Copy software to the primary compact flash drive.

  • external—(Switches only) Copy software to an external mass storage device, such as a USB flash drive. If a USB drive is not connected, the switch displays an error message.

  • internal—Copy software to an internal flash drive.

  • removable-compact-flash—Copy software to the removable compact flash drive.

  • usb—(ACX Series, M320, T640, MX960 routers only) Copy software to the device connected to the USB port.

  • usb0—(MX104 routers only) Copy software to the device connected to the USB0 port.

  • usb1—(MX104 routers only) Copy software to the device connected to the USB1 port.

partition(Optional) Repartition the flash drive before a snapshot occurs. If the partition table on the flash drive is corrupted, the request system snapshot command fails and reports errors. The partition option is only supported for restoring the software image from the hard drive to the flash drive.

(Routers only) You cannot issue the request system snapshot command when you enable flash disk mirroring. We recommend that you disable flash disk mirroring when you upgrade or downgrade the software.

(EX Series switches only) If the snapshot destination is the media that the switch did not boot from, you must use the partition option.

re0 | re1 | routing-engine routing-engine-id(EX6200 and EX8200 switches only) Specify where to place the snapshot in a redundant Routing Engine configuration.
  • re0—Create a snapshot on Routing Engine 0.

  • re1—Create a snapshot on Routing Engine 1.

  • routing-engine routing-engine-id—Create a snapshot on the specified Routing Engine.

root-partition(M, MX, T, and TX Series routers; EX Series Virtual Chassis; QFX Series switches; QFabric System; and OCX1100 only) Create a snapshot of the root partition only and store it onto the default /altroot on the hard disk device or an /altroot on a USB device. Option deprecated for Junos OS with Upgraded FreeBSD in Junos OS Release 15.1.
Note

To determine which platforms run Junos OS with Upgraded FreeBSD, see the information in Release Information for Junos OS with Upgraded FreeBSD.

slice alternate(EX Series switches, EX Series Virtual Chassis, QFX Series switches, QFabric System, and OCX1100 only) (Optional) Take a snapshot of the active root partition and copy it to the alternate slice on the boot media.

Option deprecated for Junos OS with Upgraded FreeBSD in Junos OS Release 15.1.

Note

To determine which platforms support Junos OS with upgraded FreeBSD, see Feature Explorer and enter one of the following:

  • For non-virtualized, enter freebsd and select Junos kernel upgrade to FreeBSD 10+.

  • For virtualized, enter virtualization and select Virtualization of the Routing Engine.

scc(TX Matrix router only) (Optional) Archive data and executable areas for a TX Matrix router (or switch-card chassis).
sfc number(TX Matrix Plus router only) (Optional) Archive data and executable areas for a TX Matrix Plus router (or switch-fabric chassis). Replace number with 0.

Additional Information

  • (Routers only) Before upgrading the software on the router, when you have a known stable system, issue the request system snapshot command to back up the software, including the configuration, to the /altroot and /altconfig file systems. After you have upgraded the software on the router and are satisfied that the new packages are successfully installed and running, issue the request system snapshot command again to back up the new software to the /altroot and /altconfig file systems.

  • (Routers only) You cannot issue the request system snapshot command when you enable flash disk mirroring. We recommend that you disable flash disk mirroring when you upgrade or downgrade the software.

  • (TX Matrix and TX Matrix Plus router only) On a routing matrix, if you issue the request system snapshot command on the master Routing Engine, all the master Routing Engines connected to the routing matrix are backed up. If you issue this command on the backup Routing Engine, all the backup Routing Engines connected to the routing matrix are backed up.

Required Privilege Level

view

List of Sample Output

request system snapshot (Routers)

request system snapshot (EX Series Switches)

request system snapshot partition (EX4600, QFX Series, QFabric System, and OCX1100)

request system snapshot (When the Partition Flag Is On)

request system snapshot (MX104 Routers When Media Device is Missing)

request system snapshot (When Mirroring Is Enabled)

request system snapshot all-lcc (Routing Matrix)

request system snapshot all-members (Virtual Chassis)

request system snapshot (Junos OS Evolved)

Output Fields

When you enter this command, you are provided feedback on the status of your request.

Sample Output

request system snapshot (Routers)

user@host> request system snapshot

request system snapshot (EX Series Switches)

user@switch> request system snapshot partition

request system snapshot partition (EX4600, QFX Series, QFabric System, and OCX1100)

user@switch> request system snapshot partition

request system snapshot (When the Partition Flag Is On)

user@host> request system snapshot partition

request system snapshot (MX104 Routers When Media Device is Missing)

user@host > request system snapshot media usb0

request system snapshot (When Mirroring Is Enabled)

user@host> request system snapshot

request system snapshot all-lcc (Routing Matrix)

user@host> request system snapshot all-lcc

request system snapshot all-members (Virtual Chassis)

user@switch> request system snapshot all-members media internal

request system snapshot (Junos OS Evolved)

user@host> request system snapshot