request system snapshot (Junos OS)
Syntax (ACX Series Routers)
request system snapshot <media type> <partition>
Syntax (EX Series Switches; for EX4600, see QFX Series Syntax)
request system snapshot <all-members | local | member member-id> <media type> <partition> <re0 | re1 | routing-engine routing-engine-id> <slice alternate>
Syntax (MX Series Routers)
request system snapshot <all-members> <config-partition> <local> <member member-id> <media usb-port-number> <partition> <root-partition>
Syntax (PTX Series)
request system snapshot <partition>
Syntax (QFX Series, OCX1100, and EX4600)
request system snapshot <all-members | local | member member-id> <config-partition> <partition> <root-partition> <slice alternate>
Syntax (TX Matrix Routers)
request system snapshot <all-chassis | all-lcc | lcc number | scc> <config-partition> <partition> <root-partition>
Syntax (TX Matrix Plus Routers)
request system snapshot <all-chassis | all-lcc | lcc number | sfc number> <config-partition> <partition> <root-partition>
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.
System snapshot is not supported on QFX10000 and QFX5110-48s-4c switches.
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.
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.
Options
The specific options available depend upon the router or switch:
none |
Back up the currently running software as follows:
|
all-chassis | all-lcc | lcc number |
(TX Matrix and TX Matrix Plus router only) (Optional)
|
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:
|
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. To determine which platforms support Junos OS with upgraded FreeBSD, see Feature Explorer and enter one of the following:
|
media type |
(ACX Series, M320, T640, and MX Series routers) (Optional) Specify the boot device the software is copied to:
|
partition |
(Optional) Repartition the flash drive before a snapshot occurs.
If the partition table on the flash drive is corrupted, the (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 |
re0 | re1 | routing-engine routing-engine-id |
(EX6200 and EX8200 switches only) Specify where to place the snapshot in a redundant Routing Engine configuration.
|
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. 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. To determine which platforms support Junos OS with upgraded FreeBSD, see Feature Explorer and enter one of the following:
|
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 you upgrade the software on the router, when you have a known stable system, issue the
request system snapshotcommand 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 therequest system snapshotcommand again to back up the new software to the /altroot and /altconfig file systems.(Routers only) You cannot issue the
request system snapshotcommand 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 snapshotcommand on the primary Routing Engine, all the primary 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
maintenance
Output Fields
When you enter this command, you are provided feedback on the status of your request.
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 (Routers)
user@host> request system snapshot umount: /altroot: not currently mounted Copying / to /altroot.. (this may take a few minutes) umount: /altconfig: not currently mounted Copying /config to /altconfig.. (this may take a few minutes) The following filesystems were archived: / /config
request system snapshot (EX Series Switches)
user@switch> request system snapshot partition
Clearing current label...
Partitioning external media (/dev/da1) ...
Partitions on snapshot:
Partition Mountpoint Size Snapshot argument
s1a /altroot 179M none
s2a / 180M none
s3d /var/tmp 361M none
s3e /var 121M none
s4d /config 60M none
Copying '/dev/da0s1a' to '/dev/da1s1a' .. (this may take a few minutes)
Copying '/dev/da0s2a' to '/dev/da1s2a' .. (this may take a few minutes)
Copying '/dev/da0s3d' to '/dev/da1s3d' .. (this may take a few minutes)
Copying '/dev/da0s3e' to '/dev/da1s3e' .. (this may take a few minutes)
Copying '/dev/da0s4d' to '/dev/da1s4d' .. (this may take a few minutes)
The following filesystems were archived: /altroot / /var/tmp /var /config
request system snapshot partition (EX4600, QFX Series, QFabric System, and OCX1100)
user@switch> request system snapshot partition Clearing current label... Partitioning external media (da1) ... Verifying compatibility of destination media partitions... Running newfs (334MB) on external media / partition ... Running newfs (404MB) on external media /config partition ... Running newfs (222MB) on external media /var partition ... Copying '/dev/da0s2a' to '/dev/da1s1a' .. (this may take a few minutes) Copying '/dev/da0s3e' to '/dev/da1s3e' .. (this may take a few minutes) Copying '/dev/da0s2f' to '/dev/da1s1f' .. (this may take a few minutes) The following filesystems were archived: / /config /var
request system snapshot (When the Partition Flag Is On)
user@host> request system snapshot partition Performing preliminary partition checks ... Partitioning ad0 ... umount: /altroot: not currently mounted Copying / to /altroot.. (this may take a few minutes) The following filesystems were archived: / /config
request system snapshot (MX104 Routers When Media Device is Missing)
user@host > request system snapshot media usb0 error: usb0 media missing or invalid
request system snapshot (When Mirroring Is Enabled)
user@host> request system snapshot Snapshot is not possible since mirror-flash-on-disk is configured.
request system snapshot all-lcc (Routing Matrix)
user@host> request system snapshot all-lcc lcc0-re0: -------------------------------------------------------------------------- Copying '/' to '/altroot' .. (this may take a few minutes) Copying '/config' to '/altconfig' .. (this may take a few minutes) The following filesystems were archived: / /config lcc2-re0: -------------------------------------------------------------------------- Copying '/' to '/altroot' .. (this may take a few minutes) Copying '/config' to '/altconfig' .. (this may take a few minutes) The following filesystems were archived: / /config
request system snapshot all-members (Virtual Chassis)
user@switch> request system snapshot all-members media internal fpc0: -------------------------------------------------------------------------- Copying '/dev/da0s2a' to '/dev/da0s1a' .. (this may take a few minutes) The following filesystems were archived: / fpc1: -------------------------------------------------------------------------- Copying '/dev/da0s2a' to '/dev/da0s1a' .. (this may take a few minutes) The following filesystems were archived: / fpc2: -------------------------------------------------------------------------- Copying '/dev/da0s2a' to '/dev/da0s1a' .. (this may take a few minutes) The following filesystems were archived: / fpc3: -------------------------------------------------------------------------- Copying '/dev/da0s2a' to '/dev/da0s1a' .. (this may take a few minutes) The following filesystems were archived: / fpc4: -------------------------------------------------------------------------- Copying '/dev/da0s2a' to '/dev/da0s1a' .. (this may take a few minutes) The following filesystems were archived: / fpc5: -------------------------------------------------------------------------- Copying '/dev/da0s2a' to '/dev/da0s1a' .. (this may take a few minutes) The following filesystems were archived: /
Release Information
Command introduced before Junos OS Release 7.4.
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.
Options <config-partition>, <root-partition>, and <slice> deprecated for Junos OS with Upgraded
FreeBSD in Junos OS Release 15.1
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.