Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)

Fabric OS Command Reference Manual 2-93
Publication Number: 53-1000240-01
configUpload
2
Note: Enter commands in lowercase only; mixed case is for readability.
configUpload
Uploads the switch configuration file to a host file.
Synopsis configupload [-p ftp]"host","user","file","passwd"
configupload -p scp "host","user","file"
configupload
Description Use this command to upload the switch configuration to a host file.
The first form of this command uses FTP (File Transfer Protocol). The FTP Server must be running in
the host before an upload can occur.
The second form of the configUpload 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.
This command can be invoked without any operands, creating an interactive session.
The upload might fail for the following reasons:
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 FTP server is not running on the host.
The configuration file contains three types of lines: licenses, section headers and name:value pairs
License keys are encrypted ASCII strings and are listed one key per line. It is very important to note
that keys should not be moved from one section to another.
Section headers have a bracket ( [ ) as the first character of the line. (When read by configDownload,
a line beginning with any punctuation is treated as a comment.)
Name:value pairs have the following syntax:
line whitespace name whitespace ":" whitespace value
name component {“.” component}
whitespace {“ ” | t”}
component {“a” - “z” | “A” - “Z” | “0” - “9” | “_” | “-”}
value {<any character not including n”>}
Note
Elements enclosed in curly braces ( {...} ) indicate zero or more occurrences of the enclosed
elements.
The configuration file is written as a number of sections.
The first section contains the version of the Fabric OS from which this configuration was uploaded and
the time stamp for the uploaded file creation.
The[Boot Parameters] section contains the switch boot parameters, also known as the switch’s identity.