Brocade OS Command Reference Manual Supporting Fabric OS v6.0.0 (53-1000599-01, October 2007)

Fabric OS Command Reference 75
53-1000599-01
configDownload
2
configDownload
Downloads switch configuration and other parameters from a host file.
Synopsis configdownload
configdownload -p ftp | -ftp [”host”,”user”,”path”,[”passwd”]]
configdownload -p scp| -scp [”host”,”user”,”path”,[”passwd”]]
configdownload --local | USB |-U [“file”]
Description This command downloads the switch configuration and other parameters from a host file. The
configuration file may have been generated previously by configUpload, or it may have been
created by a user to download only specific changes. Refer to configUpload for a description of the
configuration file format. The configDownload command supports DNS names, IPv4, and IPv6
addresses.
NOTE
It is not required to change configuration if one of the CPs is running a version of FOS that does not
support IPv6.
The first form of the configdownload command uses FTP (File Transfer Protocol). The FTP server
must be running on the host before a download can occur.
The second form of this command uses SCP, which is a secure file copy tunneled through an SSH
connection. When this form of the command is used, no password should be provided on the
command line. Instead, SCP will prompt for the password if necessary. The SSH service is available
on Unix and Windows hosts.
The third form of the configDownload command retrieves the configuration file from a
predetermined directory on the local chassis or from an attached USB device.
For Admin Domain users, refer to the Fabric OS Administrator's Guide for details regarding upload
and download behavior
The download might fail for some of the following reasons:
• The switch has not been disabled. (Note: As of v5.2.0, configDownload can be invoked without
disabling the switch for configuration files containing only certain SNMP, Fabric Watch, or ACL
parameters. You may wish to attempt configDownload first without disabling the switch, and if
there is at least one changed parameter outside of Fabric Watch/SNMP/ACL, you will be
prompted to disable the switch before proceeding).
• The host name is not known to the switch.
• The host IP address cannot be contacted.
• The user does not have permission on the host.
• The user runs a script that prints something at login.
• The file does not exist on the host.
• The file is not a switch configuration file.
• The FTP server is not running on the host.
• The configuration file contains errors.
If FCS policy is enabled, the following rules and restrictions apply: