Brocade Fabric OS Command Reference Manual - Supporting Fabric OS v5.3.0 (53-1000436-01, June 2007)

90 Fabric OS Command Reference Manual
53-1000436-01
configDownload
2
configDownload
Downloads switch configuration and other parameters from a host file.
Synopsis configdownload [-p ftp]"host","user","file","passwd"
configdownload -p scp "host","user","file"
configdownload
Description Use this command to download a switch configuration and other parameters from a host file. The
configuration file may have been generated previously using 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.
To be able to mention the FTP server by name, you need to setup two DNS servers with dnsConfig.
The first form of this command uses FTP (File Transfer Protocol). The FTP server must be running
before configDownload can happen.
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 also
available on Unix and Windows hosts.
For Admin Domain users, refer to the Fabric OS Administrator's Guide for details regarding upload
and download behavior.
This command can be invoked without any operands, creating an interactive session.
The download might fail for 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 content contains errors.
When the switch is in secure mode, the following rules and restrictions apply:
• Both [Defined Security Policies] and [Active Security Policies] sections must exist and contain
the FCS_POLICY.