request system snapshot

Syntax

request system snapshot <partition>

Description

Back up the currently running and active file system partitions on the router 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.

Prior to upgrading the software on the router, when you have a known stable system, you should issue the request system snapshot command to back up the software, including the configuration, onto 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, you should issue the request system snapshot command to back up the new software onto the /altroot and /altconfig file systems. 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.

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. For more information, see the JUNOS Internet Software Configuration Guide: Getting Started.

Options

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. 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. For more information, see the JUNOS Internet Software Configuration Guide: Getting Started.

Required Privilege Level

maintenance

Output Fields

unmount—Unmounting a file system.

Sample Output: request system snapshot

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

Sample Output: request system snapshot when 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

Sample Output: request system snapshot when mirroring is enabled

user@host> request system snapshot 

Snapshot is not possible since mirror-flash-on-disk is configured.