Download This Guide
Supported Platforms
Performing a QFabric System Recovery Installation on the Director Group
If the software on your QFabric system is damaged in some way that prevents the software from loading correctly, or you need to upgrade the software on your QFabric system, you may need to perform a recovery installation on the Director group.
If possible, perform the following steps before you perform the recovery installation:
- Ensure that you have an emergency boot device (for example,
an external USB flash drive) for each of your Director devices to
use during the recovery installation.
You can either use the external USB flash drive containing the software supplied by Juniper Networks, or you can use an external USB flash drive supplied by Juniper Networks on which you install the QFabric system install media.
- Because the recovery installation process completely overwrites
the entire contents of the Director device, make sure you back up
any configuration files and initial setup information on a different
external USB flash drive before you begin a recovery installation.
You will need to restore this information as part of recovery process.
Use the request system software configuration-backup command to back up your configuration files and initial setup information:
user@switch> request system software configuration-backup path
 | Note: To recover the Director group, you must upgrade both Director devices in parallel. If you are recovering only one Director device in a Director group, and the software version will remain the same between the two Director devices, make sure that the other Director device is powered on and operational. If the software version of the Director device you are recovering will be different, make sure that the other Director device is powered off and is not operational. |
(Optional) Creating an Emergency Boot Device Using a Juniper Networks External Blank USB Flash Drive
If you do not have an external USB flash drive preloaded with the software from Juniper Networks to use as an emergency boot device, you can create your own, using a blank external USB flash drive provided by Juniper Networks. Download the install media from the Juniper Networks Support website onto your UNIX workstation, uncompress and untar the software, and then burn the software image onto your Juniper Networks external USB (4-gigabyte) flash drive. Make sure you create two emergency boot devices, one for each Director device, so you can perform a recovery installation in parallel.
- Using a Web browser, navigate to the https://www.juniper.net/support .
- Click Download Software.
- In the Switching box, click Junos OS Platforms.
- In the QFX Series section, click the name of the platform for which you want to download software.
- Click the Software tab and select the release number from the Release drop-down list.
- Select the complete install media you want to download
in the QFabric System Install Media section.
A login screen appears.
- Enter your name and password and press Enter.
- Read the End User License Agreement, click the I agree radio button, and then click Proceed.
- Log in and save the install media file to your UNIX workstation.
- Use FTP to access the UNIX workstation where the install
media resides.
ftp ftp://hostname/pathname install-media-qfabric-<version>.img.tgz - When prompted, enter your username and password.
- Make sure you are in binary mode by entering binary at the prompt.
binary - Use the get command to transfer
the installation package from the FTP host to your UNIX workstation.
get install-media-qfabric-<version>.img.tgz - Close the FTP session:
bye - Untar the install-media-qfabric-<version> .img.tgz file on your UNIX workstation.
tar -xvzf install-media-qfabric-11.3X30.6.img.tgz - Insert a blank external USB (4-gigabyte) flash drive supplied by Juniper Networks into your UNIX workstation.
- Burn the software image you just downloaded to your UNIX
workstation onto your external USB flash drive using the dd command:
dd if=install-media-qfabric-11.3X30.6.img of=/dev/sdb bs=16k250880+0 records in 250880+0 records out 4110417920 bytes (4.1 GB) copied, 5.10768 seconds, 805 MB/s
- Perform the steps in Performing a Recovery Installation Using a Juniper Networks External USB Flash Drive with Preloaded Software to continue with the recovery installation.
Performing a Recovery Installation Using a Juniper Networks External USB Flash Drive with Preloaded Software
This procedure describes how to perform a recovery installation using an external USB flash drive that contains Junos OS software.
| Note: Since the recovery installation process completely overwrites the entire contents of the Director device, you will need to restore the required configuration files and initial setup information. The following procedure assumes you previously saved these backup files with the request system software configuration-backup command. Ensure that you have these backup files available on an external USB flash drive before you perform the following steps. |
- Insert the external USB flash drive into the Director device.
- Perform one of the following tasks:
- If you have access to the default partition, reboot the Director device by issuing the request system reboot director-group command.
- If you do not have access to the default partition, power cycle the Director device.
The following menu appears on the Director device console when the Director device boots up:
Juniper Networks QFabric Director Install/Recovery Media - To boot from the local disk, wait 10 seconds or press the Enter key. - To reinstall the QFabric software on this Director device, type: install
- Type install and then press Enter to install the software on the Director device.
Once the installation process is complete, the Director device reboots, and the following menu appears on the Director device console:
Juniper Networks QFabric Director Install/Recovery Media - To boot from the local disk, wait 10 seconds or press the Enter key. - To reinstall the QFabric software on this Director device, type: install
- Press Enter.
The Director device reboots from the local disk on which the software was just installed.
- Log in as root on the Director device.
The following menu appears on the Director device console:
Before you can access the QFabric system, you must complete the initial setup of the Director group by using the steps that follow. If the initial setup procedure does not complete successfully, log out of the Director device and then log back in to restart this setup menu. Continue?[y/n]
- Enter n to bypass the initial setup script and enter the Director device root directory, where you can mount the external USB flash drive containing the configuration files and initial setup information.
- Issue the ls /mnt command to
list the mount directory.
root@dg0 ~]# ls /mnt - Issue the mkdir command to
create a directory within the mount directory.
root@dg0 ~]# mkdir /mnt/myusb - Issue the mount /dev/sdb2 /mnt/myusb/ command to mount the external USB flash drive to the local drive
of the Director device.
root@dg0 ~]# mount /dev/sdb2 /mnt/myusb/ - Issue the ls -la /mnt/myusb/ command to verify the contents of your mounted external USB flashdrive.
root@dg0 ~]# ls -la /mnt/myusb/total 1770884 drwxr-xr-x 2 root root 4096 Sep 7 05:16 . drwxr-xr-x 3 root root 4096 Sep 7 10:15 .. -rw-r--r-- 1 root root 4249 Sep 7 03:52 mybackup-20110907
- Exit the Director device and log back in as root on the
Director device.
The following menu appears:
Before you can access the QFabric system, you must complete the initial setup of the Director group by using the steps that follow. If the initial setup procedure does not complete successfully, log out of the Director device and then log back in to restart this setup menu. Continue?[y/n] y Initial Configuration You may enter the configuration manually or restore from a backup. Specify a backup file? [y/n] : y Please specify the full path of the configuration backup file. : /mnt/myusb/mybackup-20110907
- Enter y to continue.
- Enter y and specify the path
to the backup configuration file located on the external USB flash
drive.
/mnt/myusb/mybackup-20110907The following messages appear:
Saving temporary configuration... Configuring peer... connect error for 1.1.1.2:9001 Configuring local interfaces... Configuring interface eth0 with [10.49.213.163/24:10.49.213.254] Configured interface eth0 with [10.49.213.163/24:10.49.213.254] Configuring QFabric software with initial pool of 4000 MAC addresses [00:10:00:00:00:00 - 00:10:00:00:0f:3b] Configuring QFabric address [10.49.213.50] Reconfiguring QFabric software static configuration Applying the new Director Device password Applying the QFabric component password First install initial configuration, generating and sharing SSH keys. First install initial configuration, generating SSH keys. connect error for 1.1.1.2:9001 Shared SSH keys. Configuration complete. Director Group services will auto start within 30 seconds.
The Director device reboots from the local disk on which the software was just installed. Exit the Director device session and log in to the QFabric default partition CLI.
- Issue the request system software configuration-restore command and specify the path to the backup configuration file located on the external USB flash drive to load the previously saved QFabric system configuration.
- From the default partition, issue the request
system reboot node-group all command to reboot all of
the Node groups in the QFabric system to ensure that all Node devices
are running the same version of software as the Director-group.
user@switch> request system reboot node-group all - From the default partition, issue the request
system reboot fabric command to reboot the Interconnect
devices and the other components in the fabric in the QFabric system
to ensure that Interconnect devices are running the same version of
software as the Director group.
user@switch> request system reboot fabric - Log in to the default partition and issue the show version component all command to verify that all
components are running the same version of software.
user@switch> show version component alldg1: - Hostname: qfabric Model: qfx3100 JUNOS Base Version [11.3X30.6] dg0: - Hostname: qfabric Model: qfx3100 JUNOS Base Version [11.3X30.6] NW-NG-0: - Hostname: qfabric Model: qfx-jvre JUNOS Base OS boot [11.3X30.6] JUNOS Base OS Software Suite [11.3X30.6] JUNOS Kernel Software Suite [11.3X30.6] JUNOS Crypto Software Suite [11.3X30.6] JUNOS Online Documentation [11.3X30.6] JUNOS Enterprise Software Suite [11.3X30.6] JUNOS Packet Forwarding Engine Support (QFX RE) [11.3X30.6] JUNOS Routing Software Suite [11.3X30.6] FC-0: - Hostname: qfabric Model: qfx-jvre JUNOS Base OS boot [11.3X30.6] JUNOS Base OS Software Suite [11.3X30.6] JUNOS Kernel Software Suite [11.3X30.6] JUNOS Crypto Software Suite [11.3X30.6] JUNOS Online Documentation [11.3X30.6] JUNOS Enterprise Software Suite [11.3X30.6] JUNOS Packet Forwarding Engine Support (QFX RE) [11.3X30.6] JUNOS Routing Software Suite [11.3X30.6] FC-1: Hostname: qfabric Model: qfx-jvre JUNOS Base OS boot [11.3X30.6] JUNOS Base OS Software Suite [11.3X30.6] JUNOS Kernel Software Suite [11.3X30.6] JUNOS Crypto Software Suite [11.3X30.6] JUNOS Online Documentation [11.3X30.6] JUNOS Enterprise Software Suite [11.3X30.6] JUNOS Packet Forwarding Engine Support (QFX RE) [11.3X30.6] JUNOS Routing Software Suite [11.3X30.6] DRE-0: - Hostname: dre-0 Model: qfx-jvre JUNOS Base OS boot [11.3X30.6] JUNOS Base OS Software Suite [11.3X30.6] JUNOS Kernel Software Suite [11.3X30.6] JUNOS Crypto Software Suite [11.3X30.6] JUNOS Online Documentation [11.3X30.6] JUNOS Enterprise Software Suite [11.3X30.6] JUNOS Packet Forwarding Engine Support (QFX RE) [11.3X30.6] JUNOS Routing Software Suite [11.3X30.6] FM-0: - Hostname: qfabric Model: qfx-jvre JUNOS Base OS boot [11.3X30.6] JUNOS Base OS Software Suite [11.3X30.6] JUNOS Kernel Software Suite [11.3X30.6] JUNOS Crypto Software Suite [11.3X30.6] JUNOS Online Documentation [11.3X30.6] JUNOS Enterprise Software Suite [11.3X30.6] JUNOS Packet Forwarding Engine Support (QFX RE) [11.3X30.6] JUNOS Routing Software Suite [11.3X30.6] nodedevice1: - Hostname: qfabric Model: QFX3500 JUNOS Base OS boot [11.3X30.6] JUNOS Base OS Software Suite [11.3X30.6] JUNOS Kernel Software Suite [11.3X30.6] JUNOS Crypto Software Suite [11.3X30.6] JUNOS Online Documentation [11.3X30.6] JUNOS Enterprise Software Suite [11.3X30.6] JUNOS Packet Forwarding Engine Support (QFX RE) [11.3X30.6] JUNOS Routing Software Suite [11.3X30.6] interconnectdevice1: - Hostname: qfabric Model: QFX3108 JUNOS Base OS boot [11.3X30.6] JUNOS Base OS Software Suite [11.3X30.6] JUNOS Kernel Software Suite [11.3X30.6] JUNOS Crypto Software Suite [11.3X30.6] JUNOS Online Documentation [11.3X30.6] JUNOS Enterprise Software Suite [11.3X30.6] JUNOS Packet Forwarding Engine Support (QFX RE) [11.3X30.6] JUNOS Routing Software Suite [11.3X30.6] warning: from interconnectdevice0: Disconnected
