request system snapshot (Junos OS with FreeBSD Prior to Release 10)

Back up the currently running software as follows:

• On the router or firewall, 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 flash drive, and the /altroot and /altconfig file systems are on the 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.

(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.

(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.

(EX Series Virtual Chassis, MX Series routers, QFX Series switches, QFabric System, OCX1100, SRX Series Firewalls, 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:

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

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

(ACX Series, M320, T640, and MX Series routers, SRX Series Firewalls) (Optional) Specify the boot device the software is copied to:

• compact-flash—(SRX5800, SRX5600, and SRX5400 devices only) Copy software to the primary compact flash drive.

• external—(Switches and SRX650 Services Gateway 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. This option is available for the compact flash on the SRX650 Services Gateway.

• hard-disk—(SRX5800, SRX5600, and SRX5400 devices only) Copy software to the hard disk drive.

• internal—(SRX300, SRX320, SRX340, SRX345, SRX380 devices only) Copy software to an internal flash drive. This is the default option.

• removable-compact-flash—(ACX Series, M320, T640, and MX Series routers only) Copy software to the removable compact flash drive.

• usb—(ACX Series, SRX Series Firewalls, M320, T640, and, except for MX104, MX Series routers) 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.

(SRX Series Firewalls only) (Optional) Specify the archive data and executable areas of a specific node. If you do not specify the node option, the device considers the current node as the default option.

• node-id—Specify for node (0, 1).

• all—Specify for all nodes.

• local—Specify for local nodes.

• primary— Specify for primary nodes.

(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.

(SRX Series Firewalls only) (Default) The target media is partitioned whether or not it is specified in the command, because this is a mandatory option. For example:

(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.

(M, MX, T, and TX Series routers; EX Series Virtual Chassis; QFX Series switches; QFabric System; SRX Series Firewalls; 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.

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

(SRX Series Firewalls) The slice option cannot be used along with the other request system snapshot options, because the options are mutually exclusive. If you use the factory, media, or partition option, you cannot use the slice option; if you use the slice option, you cannot use any of the other options.

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:

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

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

(TX Matrix router only) (Optional) Archive data and executable areas for a TX Matrix router (or switch-card chassis).

(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.