Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Backing Up an Installation Using Snapshots

 

The installation process removes all stored files on the device except the juniper.conf and SSH files. Therefore, you should back up your current configuration in case you need to return to the current software installation after running the installation program. You can also recover the configuration file and the Junos OS if required.

Understanding How to Back Up an Installation on Switches

You can create copies of the software running on a switch using the system snapshot feature. The system snapshot feature takes a “snapshot” of the files currently used to run the switch—the complete contents of the /config and /var directories, which include the running Junos OS, the active configuration, and the rescue configuration—and copies all of these files into an alternate (internal, meaning internal flash, or an external, meaning USB flash) memory source. You can then use this snapshot to boot the switch at the next boot up or as a backup boot option.

On devices running Junos OS Evolved, this command only copies the contents of the /soft directory, which includes the running version of Junos OS Evolved.

Understanding System Snapshot on QFX Switches

Note

On QFX3500 and QFX3600 switches running Enhanced Layer 2 Software, all of the directories that reside in the “/” partition are read only.

Note

System snapshot is not supported on QFX10000 switches.

You can only use snapshots to move files to external memory if the switch was booted from internal memory, or to move files to internal memory if the switch was booted from external memory. You cannot create a snapshot in the memory source that booted the switch even if the snapshot is being created on a different partition in the same memory source.

Snapshots are particularly useful for moving files onto USB flash drives. You cannot use the copy command or any other file-moving technique to move files from an internal memory source to USB memory on the switch.

System snapshots on the switch have the following limitations:

  • You cannot use snapshots to move files to any destination outside of the switch other than an installed external USB flash drive.

  • Snapshot commands are always executed on a local switch.

Understanding System Snapshot on EX Series Switches

The switch can boot from either internal flash media or external (USB) flash media. The contents of the snapshot vary depending on whether you create the snapshot on the media that the switch booted from or on the media that it did not boot from.

Snapshots are particularly useful for moving files onto USB flash drives. You cannot use the copy command or any other file-moving technique to move files from an internal memory source to USB memory on the switch.

  • If you create the snapshot on the media that the switch did not boot from, the following partitions on the boot media are included in the snapshot: root, altroot, var, var/tmp, and config.

    The root partition is the primary boot partition, and the altroot partition is the backup boot partition.

  • If you create the snapshot on the media that the switch booted from, the root partition that the switch booted from is copied to the alternate root partition. The var, var/tmp, and config partitions are not copied as part of the snapshot because they already exist on the boot media.

The system snapshot feature has the following limitations:

  • You cannot use snapshots to move files to any destination outside the switch other than an installed external USB flash drive or switches that are members of the same Virtual Chassis as the switch on which you created the snapshot.

  • Snapshot commands, like all commands executed on a Virtual Chassis, are executed on the local member switch. If different member switches request the snapshot, the snapshot command is pushed to the Virtual Chasis member creating the snapshot and is executed on that member, and the output is then returned to the switch that initiated the process. For instance, if the command to create an external snapshot on member 3 is entered on member 1, the snapshot of internal memory on member 3 is taken on external memory on member 3. The output of the process is seen on member 1. No files move between the switches.

Creating a Snapshot and Using It to Boot a QFX Series Switch

The system snapshot feature takes a “ snapshot” of the files currently used to run the device— the complete contents of the /config directories, which include the running Juniper Networks Junos OS, the active configuration, and the rescue configuration, as well as the host OS— and copies all of these files into an external USB flash drive.

Note

EX4600 and QFX Series products except for QFabric only support snapshot via external USB. QFabric does not support request system snapshot at all.

You can use the snapshot to boot the device at the next bootup or as a backup boot option.

The system snapshot feature is especially effective as a bootup option after a partition corruption, as it is the only recovery option that allows you to completely restore the Junos OS and configuration in the event of a corrupted partition on a switch.

Note

EX4600 and most QFX Series switches support snapshot via external USB.

Note

The following products do not support system snapshot: QFabric and QFX5200 and QFX10000 switches.

This topic includes the following tasks:

Creating a Snapshot on an External USB Flash Drive and Using It to Boot a QFX Series Switch

A snapshot can be created on an external USB flash drive after a device is booted using files stored in internal memory.

Ensure that you have the following tools and parts available before creating a snapshot on an external USB flash drive:

To create a snapshot on the external USB flash drive and use it to boot the device:

  1. Insert the external USB flash drive.
  2. Issue the request system snapshot command.
  3. (Optional) Perform this step if you want to boot the device now using the snapshot stored on the external USB flash drive. If you created the snapshot as a backup, do not perform this step.
    • Insert the external USB flash drive.

    • Power cycle the device.

      The external USB flash drive is detected.

    • The software prompts you with the following options:

    • Select Install Junos Snapshot to install the snapshot located on the external USB flash drive to the device.

      The device copies the software from the external USB flash drive, occasionally displaying status messages. When the software is finished being copied from the external USB flash drive to the device, the device then reboots from the internal flash storage on which the software was just installed. When the reboot is complete, the device displays the Junos OS login prompt:

Creating a Snapshot and Using It to Boot a QFX3500 and QFX3600 Series Switch

The system snapshot feature takes a “snapshot” of the files currently used to run the QFX Series switch—the complete contents of the /config and /var directories, which include the running Juniper Networks Junos OS, the active configuration, and the rescue configuration—and copies all of these files into an alternate (internal, meaning internal flash, or an external, meaning USB flash) memory source. You can then use these snapshots to boot the switch at the next bootup or as a backup boot option.

The system snapshot feature is especially effective as a bootup option after a partition corruption, as it is the only recovery option that allows you to completely restore the Junos OS and configuration in the event of a corrupted partition.

This topic includes the following tasks:

Creating a Snapshot on a USB Flash Drive and Using It to Boot the Switch

Note

Creating a snapshot is not supported on QFX10000 switches.

A snapshot can be created on USB flash memory after a switch is booted using files stored in internal memory.

Ensure that you have the following tools and parts available before creating a snapshot on a USB Flash drive:

To create a snapshot on USB flash memory and use it to boot the switch:

  1. Place the snapshot into USB flash memory:
    Note

    This example uses the partition option. If you have already created a partition for the snapshot, you don’t need to use the partition option.

  2. (Optional) Perform this step if you want to boot the switch now using the snapshot stored on the external USB flash drive. If you created the snapshot as a backup, do not perform this step.
    • To reboot the switch using the most recently created snapshot:

    • To reboot the switch using a snapshot in a specific partition on the USB flash drive:

Creating a Snapshot on an Internal Flash Drive and Using it to Boot the Switch

A snapshot can be created on internal memory after a switch is booted using files stored in external memory.

To create a snapshot in internal memory and use it to boot the switch:

  1. Place the snapshot files in internal memory:
    Note

    This example uses the partition option. If you have already created a partition for the snapshot, you don’t need to use the partition option.

  2. (Optional) Perform this step if you want to boot the switch now using the newly created snapshot. If you created the snapshot as a backup, do not perform this step.
    • To reboot the switch using the most recently created snapshot:

    • To reboot the switch using a snapshot in a specific partition in internal memory:

Creating a Snapshot on the Alternate Slice of the Boot Media

The alternate slice of the boot media contains a backup software image that the switch can boot from if it is unable to boot from the primary slice. When you upgrade software, the new software image gets copied only to the primary slice of the boot media.

To create a snapshot of the currently booted software image on the backup slice of the boot media:

After the system boots up, you will see the following message before the login prompt:

WARNING: THIS DEVICE HAS BOOTED FROM THE BACKUP JUNOS IMAGE

It is possible that the primary copy of JUNOS failed to boot up properly, and so this device has booted up from the backup copy.

Please re-install JUNOS to recover the primary copy in case it has been corrupted.

The system will generate an alarm indicating that the switch has booted from the backup slice.

Creating a Snapshot and Using It to Boot an EX Series Switch

The system snapshot feature takes a “snapshot” of the files currently used to run the switch and copies them to an alternate storage location. You can then use this snapshot to boot the switch at the next bootup or as a backup boot option.

This topic includes the following tasks:

Creating a Snapshot on a USB Flash Drive and Using It to Boot the Switch

You can create a snapshot on USB flash memory after a switch is booted by using files stored in internal memory.

Ensure that you have the following tools and parts available before creating a snapshot on a USB flash drive:

To create a snapshot on USB flash memory and use it to boot the switch:

  1. Place the snapshot into USB flash memory:
    user@switch> request system snapshot partition media usb
  2. (Optional) Perform this step if you want to boot the switch now using the snapshot stored on the USB flash drive.
    user@switch> request system reboot media usb

Creating a Snapshot and Using It to Boot an SRX Series device

Creating a Snapshot and Using It to Boot an SRX Series device

This example shows how to configure a boot device.

Requirements

Before you begin, ensure that the backup device has a storage capacity of at least 1 GB. See Ensuring Sufficient Disk Space for Junos OS Upgrades on SRX Devices.

Overview

You can configure a boot device to replace the primary boot device on your SRX Series device or to act as a backup boot device. Use either the J-Web user interface or the CLI to take a snapshot of the configuration currently running on the device, or of the original factory configuration and a rescue configuration, and save it to an alternate medium.

Note

For media redundancy, we recommend that you keep a secondary storage medium attached to the SRX Series device and updated at all times.

If the primary storage medium becomes corrupted and no backup medium is in place, you can recover the primary internal media from the TFTP installation.

You can also configure a boot device to store snapshots of software failures for use in troubleshooting.

Note

You cannot copy software to the active boot device.

Note

After a boot device is created with the default factory configuration, it can operate only in an internal media slot.

This example configures a boot device to back up the currently running and active file system partitions by rebooting from internal media and including only files shipped from the factory.

Configuration

CLI Quick Configuration

To quickly configure this section of the example, copy the following commands, paste them into a text file, remove any line breaks, change any details necessary to match your network configuration, copy and paste the commands into the CLI at the [edit] hierarchy level, and then enter commit from configuration mode.

From operational mode, enter:

GUI Step-by-Step Procedure

To configure a boot device:

  1. In the J-Web user interface, select Maintain>Snapshot.
  2. On the Snapshot page, specify the boot device to copy the snapshot to. From the Target Media list, select the internal boot device.
  3. Select the Factory check box to copy only default files that were loaded on the internal media when it was shipped from the factory, plus the rescue configuration if one has been set.
  4. Select the Partition check box to partition the medium that you are copying the snapshot to. This process is usually necessary for boot devices that do not already have software installed on them.
  5. Click Snapshot.
  6. Click OK to check your configuration and save it as a candidate configuration.
  7. If you are done configuring the device, click Commit Options>Commit.

Step-by-Step Procedure

The following example requires you to navigate various levels in the configuration hierarchy. For instructions on how to do that, see Using the CLI Editor in Configuration Mode.

To configure a boot device:

Results

From configuration mode, confirm your configuration by entering the show system snapshot media internal command. If the output does not display the intended configuration, repeat the configuration instructions in this example to correct it.

If you are done configuring the device, enter commit from configuration mode.

Backing Up the Current Installation on SRX Series Devices

This topic includes the following sections:

Backing Up the Current Installation on SRX5800, SRX5600, and SRX5400 Devices

Back up the current installation so that you can return to the current software installation. The installation process using the installation package (jinstall*, for example) removes all stored files on the device except the juniper.conf and SSH files. Therefore, you should back up your current configuration in case you need to return to the current software installation after running the installation program.

To back up Junos OS on the SRX Series devices, issue the request system snapshot CLI operational command. This command saves the current software installation on the hard disk, external USB storage media device, or solid-state drive (SSD).

When the request system snapshot command is issued, 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 devices’s CompactFlash card, and the /altroot and /altconfig file systems are on the devices’s hard disk or or solid-state drive (SSD). When the backup is completed, the current and backup software installations are identical.

To copy the files to the device’s hard disk or solid-state drive (SSD), use the following command:

user@host> request system snapshot media

Backing Up the Current Installation on SRX300, SRX320, SRX340, SRX345, SRX550M, SRX3400, and SRX3600 Devices

On SRX Series devices, you can backup the current Junos OS image and configuration files onto a media (such as a USB or CompactFlash) so that you can retrieve it back if something goes wrong.

To back up the currently running and active file system partitions on the device, use the following command:

user@host> request system snapshot media

Following options are supported:

  • internal— Copies the snapshot to internal media.

  • usb— Copies the snapshot to the USB storage device. This is the default option for SRX300, SRX320, SRX340, SRX345, and SRX550M devices.

  • external— Copies the snapshot to an external storage device. This option is available for the compact flash on the SRX650 Services Gateway only.

Configuring External CompactFlash for SRX650 Devices

Following procedure shows how to backup current installation on an SRX650 device.

The SRX650 Services Gateway includes the following 2 GB CompactFlash (CF) storage device:

  • The Services and Routing Engine (SRE) contains a hot-pluggable external CF storage device used to upload and download files.

  • The chassis contains an internal CF used to store the operating system.

By default, only the internal CF is enabled and an option to take a snapshot of the configuration from the internal CF to the external CF is not supported. This can be done only by using a USB storage device.

To take a snapshot of the configuration from the external CF:

  1. Take a snapshot from the internal CF to a USB storage device using the request system snapshot media usb command.
  2. Reboot the device from the USB storage device using the request system reboot media usb command.
  3. Go to the U-boot prompt.
  4. Stop at U-boot and set the following variables:
  5. Once the system is booted from the USB storage device, take a snapshot from the external CF using the request system snapshot media external command.Note

    Once the snapshot is taken on the external CF, we recommend that you set the ext.cf.pref to 0 at the U-boot prompt.

Creating a Snapshot and Using It to Boot an ACX Series Router

Understanding System Snapshot on an ACX Series Router

The system snapshot feature enables you to create copies of the software running on an ACX Series router. You can use the system snapshot feature to take a “snapshot” of the files currently used to run the router—the complete contents of the root (/) and /config directories, which include the running Juniper Networks Juniper operating system (Junos OS) and the active configuration—and copy all of these files to another media, such as a universal serial bus (USB) storage device, the active slice of a dual-root partitioned router, or the alternate slice of a dual-root partitioned router.

Note

Junos OS automatically uses the backup software if the currently running software goes bad. For example, if the da0s1 slice goes bad, Junos OS automatically comes up using the da0s2 slice, and takes a snapshot of the da0s2 slice and copies it to the da0s1 slice if the auto snapshot functionality is configured, which is disabled by default. However, you can also do this manually using the system snapshot feature.

Note

In ACX5048 and ACX5096 routers, the system snapshot feature is applicable only when a USB storage device is used.

Typically, you can take a snapshot prior to the upgrade of an image on the dual internal NAND flash device (da0s1 or da0s2), or to remedy a bad image, thereby preventing the bad image from rendering the system useless. A snapshot to another media ensures that the device can boot from the other media in case the system does not boot up from the current image.

You can take a snapshot of the currently running software and configuration on a router in the following situations:

  • The router's active slice (for example, da0s1) is updated with a new Junos OS image (using the jinstall package). In such a case, you must update the other slice (da0s2) with the new image.

    Note

    The active slice can be da0s1 or da0s2.

  • The router's active slice (for example, da0s1) is corrupted and the router is rebooted from the backup slice (that is, from da0s2). Therefore, you must restore a new image on the active slice—that is, on da0s1.

  • Both slices of the router's dual internal NAND flash device are corrupted and the router continues trying to reboot. In this situation, you can insert a USB storage device, boot the router from that device, and restore the NAND flash device slices—da0s1 and da0s2.

    Note

    Before you attempt to take a snapshot from the USB storage device, ensure that the USB storage device contains an image of Junos OS from which the router can boot up.

Example: Taking a Snapshot of the Software and Configuration

This example includes six scenarios in which you can take a snapshot of the currently running software and configuration on an ACX Series router, prior to the upgrade of an image or to remedy a bad image, thereby preventing the bad image from rendering the system useless.

Requirements

This example uses the following hardware and software components:

  • One ACX Series router

  • Junos OS Release 12.2 or later

Overview

In this example, the request system snapshot command is used to take a copy of the currently running software and configuration on another media—for example, a universal serial bus (USB) storage device, the active slice (da0s1 or da0s2) of a dual-root partitioned router, or the alternate slice (da0s1 or da0s2) of a dual-root partitioned router. A snapshot to another media ensures that the device can boot from the other media in case the system does not boot up from the current image.

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.

Taking a Snapshot

Scenario: To take a snapshot from a NAND flash device slice to a USB storage device:

  1. Boot up the router from the NAND flash device and make sure that a formatted USB storage device is plugged in to the router’s USB port. The USB storage device must be formatted for the root (/) and /config directories.
  2. Issue the request system snapshot command.
    user@host> request system snapshot

    The root (/) and /config directories from the currently mounted NAND flash slice are copied to the USB storage device.

Scenario: To take a snapshot from a NAND flash device slice to a USB storage device with formatting:

  1. Boot up the router from the NAND flash device and make sure that a USB storage device is plugged in to the router’s USB port. Note

    Formatting a USB storage device deletes all the data on the USB storage device.

  2. Issue the request system snapshot partition command.
    user@host> request system snapshot partition

    After the USB storage device is formatted, the root (/) and /config directories from the currently mounted NAND flash slice are copied to the USB storage device.

Scenario: To take a snapshot from the active slice of the NAND flash device to the alternate slice:

  1. Boot up the router from the NAND flash device.
  2. Issue the request system snapshot slice alternate command.
    user@host> request system snapshot slice alternate

    The root (/) and /config directories from the currently mounted NAND flash slice are copied to the other slice.

Scenario: To take a snapshot from an active slice of the NAND flash device to the alternate slice after partitioning:

  1. Boot up the router from the NAND flash device.
  2. Issue the request system snapshot partition slice alternate command.
    user@host> request system snapshot partition slice alternate

    The BSD label (disk partitioning information) for the active flash slice is installed and then the root (/) and /config directories from the currently mounted NAND flash slice are copied to the other slice.

Scenario: To take a snapshot from a USB storage device to the active slice of the NAND flash device:

  1. Boot up the router from a USB storage device containing the required Junos OS image.
  2. Issue the request system snapshot command.
    user@host> request system snapshot

    The root (/) and /config directories from the USB storage device are copied to the active NAND flash slice.

Scenario: To take a snapshot from a USB storage device to the active slice of the NAND flash device after partitioning:

  1. Boot up the router from a USB storage device containing the required Junos OS image.
  2. Issue the request system snapshot partition command.
    user@host> request system snapshot partition

    The BSD label (disk partitioning information) for the active flash slice is installed and then the root (/) and /config directories from the USB storage device are copied to the active NAND flash slice.

Creating a Snapshot and Using It to Boot an MX Router

During a successful upgrade, the upgrade package completely reinstalls the existing Junos OS. It retains configuration files, log files, and similar information from the previous version, that is, all stored files except the juniper.conf and SSH files are removed. Creating a backup has the following advantages:

  • The device can boot from a backup and come back online in case of failure or corruption of the primary boot device in the event of power failure during an upgrade.

  • Your active configuration files and log files are retained.

  • The device can recover from a known, stable environment in case of an unsuccessful upgrade.

You can use either the J-Web user interface or the CLI to back up the primary boot device on to the secondary storage device.

As of Junos OS Release 15.1, certain platforms run Junos OS based on an upgraded FreeBSD kernel (Junos OS with upgraded FreeBSD). For information about backing up Junos OS with upgraded FreeBSD, see Upgrading Junos OS with Upgraded FreeBSD. For information on which platforms use Junos OS with upgraded FreeBSD, see Release Information for Junos OS with Upgraded FreeBSD.

After a successful upgrade, remember to back up the new current configuration to the secondary device.

On routers, you should back up the existing installation so that you can return to it if needed.

In a dual Routing Engine system, you need to back up both Routing Engines.

To back up files to the router’s hard disk or solid-state drive (SSD):

  • Issue the request system snapshot CLI operational command:

    When the request system snapshot command is issued, 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 CompactFlash card, and the /altroot and /altconfig file systems are on the router’s hard disk or SSD. When the backup is completed, the current and backup software installations are identical.

Note

On routers without a CompactFlash card, where the hard disk is the primary boot device, you cannot back up your software installation. On MX104 routers, which do not have a CompactFlash card, you can back up your software installation on an external USB storage media device.

To back up files on an MX104 to a specified external storage media device:

  • Issue the request system snapshot media CLI operational command. For example:

    On MX104 routers, when you issue the request system snapshot operational command to back up the current software installation, the backup is done on the first USB storage media device.

To back up files from the NAND flash device to a USB storage media device:

  • Issue the request system snapshot CLI operational command:

    When you issue the request system snapshot operational command to back up the NAND flash device, the backup is done on the first USB storage media device.

On ACX Series routers, when you issue the request system snapshot slice alternate command, the command backs up the files to the router’s NAND flash.

  • Issue the request system snapshot slice alternate CLI operational command. For example:

    When this command is issued, the /root file system is backed up to /altroot, and /config is backed up to /altconfig on the router’s NAND flash device.

    To back up the files to an external USB storage device, you need to run the following command:

On ACX5000 line of routers, when you issue the request system snapshot slice alternate command, the command backs up the files to an external USB storage device.

Note

ACX5000 line of routers do not have a NAND flash memory and alternate slice for Junos OS. Junos OS for ACX5000 line of routers runs as a VM on a host image.

  • Issue the request system snapshot slice alternate CLI operational command. For example:

    If an external USB is not inserted to the router, then the command shows the following error: