Brocade Fabric OS Command Reference Manual Supporting Fabric OS v6.3.0 (53-1001337-01, July 2009)

118 Fabric OS Command Reference
53-1001337-01
configUpload
2
You can use FTP or SCP to upload configuration files to an external host, or you can save the
configuration in a predetermined directory on the local chassis or on an attached USB device. If the
specified file already exists, this command prompts you to overwrite the file. Specify -force to
overwrite the file without confirmation. When the local chassis is chosen as the destination, the
resulting file is written to both primary and secondary partitions, and on enterprise-class platforms,
to both Active and Standby Control Processors (CPs).
Refer to the Fabric OS Administrator’s Guide for information on backward compatibility, on
configuration upload and download in Admin Domains (AD), and on the content of the
configuration file.
Notes The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may
be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command
Availability" for details.
Do not manually edit a configuration or a switch-conf.xx file after uploading the file and before
downloading the file to a switch. Manual editing bypasses sanity checks for some configuration
parameters and results in unpredictable system behavior
Operands The following operands are supported:
-p ftp | -ftp or -p scp | -scp
Specifies the data transmission protocol as either File Transfer Protocol (FTP)
or Secure Copy Protocol (SCP). If no protocol is specified, the protocol
defaults to FTP.
-vf Uploads the Virtual fabric configuration to a file. You must specify a filename
when uploading this file. It is recommended to name this file
switch-conf_xx.txt (where xx indicates the platform ID) to distinguish this file
from the system configuration (config.txt). Use switchShow to determine the
platform ID of the system. The platform ID in the header of the configuration
file is the same as the first two digits of the switchType parameter in the
switchShow output. You cannot use the -vf option with any of the regular
configuration upload options (-fid, -chassis, -all).
-fid FID Uploads switch configuration data from a logical switch specified by its fabric
ID. This parameter is valid only in a Virtual Fabric environment and requires
chassis permissions.
-chassis Uploads chassis configuration only.
-all Uploads all system configuration data including chassis and switch
configuration for all logical switches.
“host” Specifies the name or the IP address of the external host to which to upload
the configuration. To be able to mention the FTP server by name, you need to
set up one or more DNS servers with dnsConfig. Quotation marks are
optional.
“user” Specifies the login name for the external host. Quotation marks are optional.
“path” Specifies the file name and path of the configuration file. Absolute path
names may be specified using a forward slash (/). Relative path names
upload the file to the login account’s home directory on UNIX hosts and into
the directory on which the FTP server is running on Windows hosts. This
operand is valid only when the file is uploaded to an external host. Quotation
marks are optional.