[Contents] [Prev] [Next] [Index] [Report an Error]

request system snapshot

Syntax

request system snapshot <partition>

Syntax
(routing matrix)

request system snapshot <all-lcc | lcc number | scc> <partition>

Syntax
(J-series)

request system snapshot <as-primary> <config-size size> <data-size size>

<factory> <media type > <partition> <root-size size> 

<swap-size size>

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

NOTE: Prior to 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 to back up the new software to 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.

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.

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 System Basics Configuration Guide.

On the J-series platform, you can use this command with the media option to configure a boot device. You can choose from the following media types:

Options

all-lcc—(Routing matrix only) (Optional) Archive data and executable areas for all T640 routing nodes connected to a TX Matrix platform.

as-primary—(J-series Services Routers only) (Optional) Create a snapshot that can be used to replace the medium in the primary compact flash drive. This option can be used on the removable compact flash only. The option copies the default files that were loaded on the primary compact flash drive when it was shipped from the factory, plus the rescue configuration if one has been set.

This option is useful if you have multiple routers and want to use the same software and configuration on each router.

Once a boot device is created as a primary compact flash drive, it can operate in only a primary compact flash drive slot.

This option causes the boot medium to be partitioned.

config-size size—(J-series Services Routers only) (Optional) Specify size of the config partition, in megabytes. The default value is 10 percent of physical memory on the boot partition.

The config partition is mounted on /config and the configuration files are stored in this partition.

This option causes the boot medium to be partitioned.

data-size size—(J-series Services Routers only) (Optional) Specify size of the data partition, in megabytes. The default value is 0 MB. The data partition is mounted on /data. This space is not used by the router, and can be used for extra storage.

This option causes the boot medium to be partitioned.

factory—(J-series Services Routers only) (Optional) Copy only default files that were loaded on the primary compact flash drive when it was shipped from the factory, plus the rescue configuration if one has been set. Once the boot medium is created with the factory option, it can operate in only the primary compact flash drive.

lcc number—(Routing matrix only) (Optional) Archive data and executable areas for a specific T640 routing node that is connected to a TX Matrix platform. number can be from 0 through 3.

media type—(J-series Services Routers only) (Optional) Specify the boot device the software is copied to. type can be:

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  System Basics Configuration Guide.

root-size size—(J-series Services Routers only) (Optional) Specify size of the root partition, in megabytes. The default value is one-third of the physical memory minus the config, data, and swap partitions.

The root partition is mounted on / and does not include configuration files.

This option causes the boot medium to be partitioned.

scc—(Routing matrix only) (Optional) Archive data and executable areas for a TX Matrix platform.

swap-size size—(J-series Services Routers only) (Optional) Specify size of the swap partition, in megabytes. The default value is one-third of the physical memory on a boot medium larger than 128 MB, or 0 MB on a smaller boot device.

The swap partition is used for swap files and software failure memory snapshots. Software failure memory snapshots are saved to the boot medium only if it is specified as the dump-device in the system dump-device configuration hierarchy.

This option causes the boot medium to be partitioned.

Required Privilege Level

maintenance

Output Fields

unmount—Unmounts 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.

Sample Output: 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
[Contents] [Prev] [Next] [Index] [Report an Error]