Fabric OS Reference Manual (Version 3.0)

Fabric OS Reference 1-33
Telnet Commands
1
configDownload
Load the switch configuration file from a host system.
Synopsis configDownload ["host","user","file"[,"passwd"]]
Availability admin
Description Use this command to load the switch configuration file from a host system. The configuration file
is ASCII text and may have been generated using configUpload, or it may have been created by a
user to download specific configuration changes.
The download process uses either FTP or the RSHD protocol (TCP service 514).
To restore the configuration file from a Windows NT system using FTP, the FTP server may have
to be installed from the distribution media and enabled.
To restore the configuration file from a Windows NT system using RSHD, two utilities are
supplied, RSHD.EXE and CAT.EXE. The FTP server or RSHD must be running before a download
can be initiated.
This command can be invoked without any operands, and becomes an interactive session where
you are prompted for input, including choice of FTP or RSHD. If invoked with three operands
RSHD is used; otherwise, presence of the password operand selects FTP.
A switch’s identity cannot be changed by configDownload. These parameters (such as the switch’s
name and IP address) are ignored.
The download process is additive; that is, the lines read from the file are added to the current switch
configuration. This enables you to change a single configuration variable by downloading a file
with a single line. All other variables remain unchanged. This is particularly important when
downloading a zoning configuration. Since the new zoning information is added to the current
configuration, there may not be any conflicts. Typically this command is used to add a consistent
change to the current zoning configuration, or to replace the current zoning configuration, in which
case cfgClear must be invoked before configDownload.
Operands This command has the following operands:
host Specify a host name or IP address in quotation marks; for example, “citadel”
or “192.168.1.48”. The configuration file is downloaded from this host
system. This operand is optional.
user Specify a user name in quotation marks; for example, “jdoe”. This user name is
used to gain access to the host system. This operand is optional.
file Specify a file name in quotation marks; for example, “config.txt”. Absolute
path names may be specified using forward slash (/). Relative path names search
for the file in the user’s home directory on UNIX hosts, and in the directory
where the FTP server is running on Windows hosts. This operand is optional.
passwd Specify a password in quotation marks. If present, the command uses FTP to
transfer the file. This operand is optional.