Reference Guide

128 Brocade Fabric OS Command Reference
53-1004112-02
configDownload
Description
This command downloads configuration parameters to the local system. Two types of configuration files can be
downloaded with this command: Virtual Fabric configuration parameters and system configuration parameters.
You must download both types of configuration data for the system to behave as expected. You can use FTP or
SCP to download configuration files from a remote host, or you can retrieve the configuration files from a
predetermined directory on the local system, or from an attached USB device.
Use the -vf option to download the Virtual Fabric configuration data. The Virtual Fabric configuration file includes
logical switch definitions and Virtual Fabric status (enabled or disabled). The file should be named vf-conf_xx.txt to
distinguish it from the regular system configuration (config.txt). The xx indicates the platform ID. Virtual Fabric
configuration data can only be shared between switches that belong to the same platform type and share the same
platform ID. If the platform ID contained in the header of the configuration file does not match the platform ID of
the system to which it is downloaded, configDownload fails. When you download a vf-conf_xx.txt file, all attributes
defined in this file are downloaded to the system and take effect with the exception of LISL ports. The LISL ports
on the system are not affected by this download.
Use the -all option to download the system configuration data (which must be downloaded separately from the
Virtual Fabric configuration data). It is grouped into chassis information and switch information. Each configuration
type is managed separately and the behavior of configDownload depends on the environment in which the
command is executed and which part of the system configuration you wish to download.
• In a Virtual Fabric environment, when the configDownload command is executed without chassis
permissions, this command downloads the switch configuration to the current logical switch only. An Admin
user with chassis permissions can use additional parameters to perform the following selective configuration
downloads:
- Download the switch configuration to a specified logical switch (-fid FID).
- Download the chassis configuration only (-chassis).
- Download the entire configuration including the data for all logical switches and for the chassis (-all).
The interactive version of the command (no operands) prompts for input on only the parameters the user is
allowed to execute.
• In a non-Virtual Fabric environment, this command by default downloads the configuration for the default
logical switch only. To download the chassis-level configuration only, use the -chassis option. To download
both the chassis and switch configuration, use the -all option. Chassis permissions are required. The -fid
option is not valid. The -switch option is equivalent to issuing the command default (without options).
Perform the following steps to backup and then restore a configuration in a switch using Virtual Fabrics:
1. Run the configUpload -vf command followed by the configUpload -all command from the old setup.
2. Run the configDownload -vf command followed by the configDownload -all command in the new setup.
The switch must be disabled for configuration download of all parameters with the exception of SNMP and MAPS.