Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

request system recover

date_range 12-Dec-24

Syntax

content_copy zoom_out_map
request system recover (junos-volume | oam-volume)

Syntax (EX Series Switches)

content_copy zoom_out_map
request system recover (junos-volume | oam-volume)
<(all-members | local | member member-id)>

Description

For devices running FreeBSD 10 or above, use this command to recover a specified volume of the system.

Guest network functions (GNFs) do not support the recover option under the request system command. See Components of Junos Node Slicing for more details on GNF.

Options

(all-members | local | member member-id)

(EX Series Virtual Chassis only) (Optional) Specify the members who need to recover archive data and executable areas in a Virtual Chassis:

  • all-members—Recover archive data and executable areas for all members of the Virtual Chassis.

  • local—Recover archive data and executable areas for the member of the Virtual Chassis that you are currently logged into.

  • member member-id—Recover archive data and executable areas for the specified member of the Virtual Chassis.

junos-volume

Specify the /junos volume to be recovered. The /junos volume is the main drive and contains all the software and files needed for the day-to-day running of the device, including configuration information and logs. The/junos volume also contains non-recovery snapshots, which are new with Junos OS with upgraded FreeBSD. Non-recovery snapshots cannot be used for recovery of a failed system.

oam-volume

Specify the /oam volume to be recovered. The compact flash drive is the /oam volume and stores recovery snapshot backup information. In case of failure of the /junos volume, the /oam volume can be used to boot the system. The /oam volume has the recovery snapshot, which is created with the request system snapshot recovery command. A recovery snapshot is always replaced when a new recovery snapshot is taken.

Additional Information

If you try to recover the /junos volume while you are booted on the /junos volume, you will get an error message.

To recover the /junos volume, do the following:

  1. Recover the /oam volume.

    content_copy zoom_out_map
    user@host> request system recover oam-volume
    
  2. Reboot on the /oam volume.

    content_copy zoom_out_map
    user@host> request system reboot oam-volume
    

Required Privilege Level

view

Sample Output

request system recover junos-volume (While booted on the /junos volume)

content_copy zoom_out_map
user@host> request system recover junos-volume
ERROR: You are currently running on the Junos volume
ERROR: A recovery of the Junos volume is not possible

request system recover junos-volume (While booted on the /oam volume)

content_copy zoom_out_map
user@host> request system recover junos-volume
NOTICE: Recovering the Junos volume ...
ada0p3 deleted
ada0 created
ada0p1 added
bootcode written to ada0
ada0p3 added
ada0p2 added
/dev/gpt/junos: 20303.9MB (41582448 sectors) block size 32768, fragment size 4096
        using 33 cylinder groups of 626.22MB, 20039 blks, 80256 inodes.
super-block backups (for fsck_ffs -b #) at:
 192, 1282688, 2565184, 3847680, 5130176, 6412672, 7695168, 8977664, 10260160,
 11542656, 12825152, 14107648, 15390144, 16672640, 17955136, 19237632,
 20520128, 21802624, 23085120, 24367616, 25650112, 26932608, 28215104,
 29497600, 30780096, 32062592, 33345088, 34627584, 35910080, 37192576,
 38475072, 39757568, 41040064
NOTICE: Junos volume recovered

request system recover oam-volume

content_copy zoom_out_map
user@host> request system recover oam-volume
NOTICE: Recovering the OAM volume ...
ada1p2 deleted
ada1 created
ada1p1 added
bootcode written to ada1
ada1p2 added
/dev/gpt/oam: 3831.6MB (7847136 sectors) block size 32768, fragment size 4096
        using 7 cylinder groups of 626.09MB, 20035 blks, 80256 inodes.
super-block backups (for fsck_ffs -b #) at:
 192, 1282432, 2564672, 3846912, 5129152, 6411392, 7693632
Verified oam signed by PackageProductionEc_2017 method ECDSA256+SHA256
Installing OAM volume contents ...
The OAM volume is now installed
NOTICE: Creating a recovery snapshot on the OAM volume ...
Creating image ...
Compressing image ...
Image size is 1717MB
Recovery snapshot created successfully
NOTICE: OAM volume recovered

Release Information

Command introduced in Junos OS Release 15.1.

Command introduced for all platforms using Junos OS with upgraded FreeBSD. To find which platforms in which releases use Junos OS with upgraded FreeBSD, see Feature Explorer, enter freebsd, and select Junos kernel upgrade to FreeBSD 10+.

Options (all-members | local | member member-id) introduced in Junos OS Release 24.4R1.

footer-navigation