File Specification
The files may be located on:
-
Network: TFTP servers and/or SCP servers - Network files
-
Active FLASH - Flash files
-
mass-storage connected to a USB port of Active - USB files. Only one mass-storage is supported.
Note. Although inside the switch supports the File System on FLASH of all stack units the File System CLI commands allow access only to flash files on Active unit. Needed file synchronizations between Active unit and other units is performed by the switch automatically.
Uniform Resource Locators (URLs) are used to specify the location of a file or a directory. The URL has the following syntax:
<url> ::= tftp://<location>/<file-path> | scp://[<username>:<password>@]<location>/<file-path> | usb://<file-path> | flash://<file-path> | <current-directory>[/<file-path>] | <higher-directory>[/<file-path>] | <file-path>
<username> ::= string up to 70 characters
<password> :: = string up to 70 characters
<location> ::= <ipv4-address> | <ipv6-address> | <dns-name>
<current-directory> ::= [{usb | flash}:][.]
<higher-directory> ::= [{usb | flash}:]..
<file-path> ::= [<directories-path>/]<filename>
<directories-path> ::= <directory-name> | <directories-path>/<directory-name>
The maximum number of directories in <directories-path> is 16.
<directory-name> ::= string up to 63 characters
<filename> ::= string up to 63 characters
Filenames and directory names consist only of characters from the portable filename character set. The set includes the following characters:
-
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
-
a b c d e f g h i j k l m n o p q r s t u v w x y z
-
<space>
-
0 1 2 3 4 5 6 7 8 9 . _ -
The last three characters are the <period>, <underscore>, and <hyphen> characters, respectively.
If an URL includes spaces it must be enclosed by the " characters.
For example:
"flash://aaa it/alpha/file 125"
The maximal length of URL is 160 characters
The following File systems are supported on USB:
-
FAT32—Full support.
-
NTFS—Partially support: read only.
The switch supports the following predefined URL aliases:
-
active-image—The predefined URL alias specifies the Active Image file. This file has the following permissions:
readable
executable
-
inactive-image—The predefined URL alias specifies the Inactive Image file. This file has the following permissions:
readable
executable
-
running-config—The predefined URL alias specifies the Running Configuration File.
-
startup-config—The predefined URL alias specifies the Startup Configuration File. This file has the following permissions:
readable
-
localization. The predefined URL alias specifies the Secondary Language Dictionary files. These files have the following permissions:
readable
-
logging. The predefined URL alias specifies the Syslog file. This file has the following permissions:
readable
-
mirror-config. The predefined URL alias specifies the Mirror Configuration file. This file has the following permissions:
readable
Examples
Example 1. The following example specifies a file on TFTP server using an IPv4 address:
tftp://1.1.1.1/aaa/dat/file.txt
Example 2. The following example specifies a file on TFTP server using an IPv6 address:
tftp://3000:1:2::11/aaa/dat/file.txt
tftp://files.export.com/aaa/dat/file.txt
Example 4. The following example specifies a file on FLASH:
flash://aaa/dat/file.txt
Example 5. The following example specifies files using the current directory:
./dat/file.txt
dat/file.txt
Example 6. The following example specifies a file using the higher directory:
../dat/file.txt
Example 7. The following example specifies a file on mass-storage device connected to the USB port:
usb://aaa/dat/file.txt
Example 8. The following example specifies files on mass-storage device connected to the USB port using the current directory:
usb:aaa/dat/file.txt
usb:./aaa/dat/file.txt
Example 9. The following example specifies a file on mass-storage device connected to the USB port using the higher directory:
usb:../aaa/dat/file.txt