File system management

This chapter provides information about file system management.

The file system

The 7210 SAS file system is used to store files used and generated by the system; for example, image files, configuration files, logging files and accounting files.

The file commands allow you to copy, create, move, and delete files and directories, navigate to a different directory, and display file or directory contents and the image version.

Compact flash devices

The file system is based on a DOS file system. The 7210 SAS devices provide several storage options, including internal flash and USB.

The following compact flash devices are supported:

  • SD slot, USB slot, or internal flash, cf1:\

  • external USB slot, uf1:\

The preceding device names are relative device names in that they refer to the devices local to the control processor running the current console session. As in the DOS file system, the colon (‟:”) at the end of the name indicates it is a device.

The following table lists the storage locations available on different 7210 SAS platforms.

Table 1. Storage locations on 7210 SAS platforms

7210 SAS platforms

Storage locations

cf1:\

uf1:\1

7210 SAS-D

2

7210 SAS-Dxp

3

7210 SAS-K 2F1C2T

4

7210 SAS-K 2F6C4T

5

7210 SAS-K 3SFP+ 8C

5

1 USB port located on the front panel; allows a supported USB device to be plugged in
2 Supports an internal flash
3 SD card slot located on the front panel
4 Depending on the 7210 SAS-K 2F1C2T model, the cf1:\ storage location is either an SD card slot or USB slot. The slot is located on the rear panel and allows the use of a supported SD card or USB device. Secure access to the SD card or USB device is also supported.
5 SD card slot located on the rear panel; allows the use of a supported SD card. Secure access to the SD card is also supported.

In addition to user-added files and directories, the number of files in the root directory can also increment when the admin save or bof save commands are issued. The system enforces a threshold limit of 80 entries (files and directories) for contents of the root directory on cf1:\; there is no restriction on the number of files and directories that you can add in the subdirectories. A trap (tmnxRootDirFull) is generated if the threshold limit is exceeded, and a warning is generated for each new file or directory created in the root directory on cf1:\ after the threshold limit is exceeded.

Note:

User intervention is required when the system displays the threshold exceeded event (tmnxRootDirFull). You are required to clean the root directory on cf1:\ and ensure that the number of entries (files or directories) is below the enforced threshold limit of 80 entries. Remove unnecessary files and directories from the root directory or move them to a subdirectory that you have created under the root directory. The system does not generate a warning when the number of files and directories is reduced below the threshold limit.

Use the file dir cf1:\ command to determine the number of entries (files or directories) present in the root directory, as shown in the following output example.

In the following listing, the total number of entries in the root directory (files and directories) is 14 files + 2 directories = 16.

*A:7210-SAS #

*A:7210-SAS #file dir

 Volume in drive cf1 on slot A is /flash.

 Volume in drive cf1 on slot A is formatted as FAT32.

Directory of cf1:\

10/12/2011  10:37p             4248394 boot.tim
10/17/2011  07:28a                 524 sasm.sdx
10/26/2011  10:06p                 828 bof.cfg
10/27/2011  09:04p      <DIR>          act-collect
10/27/2011  09:06p      <DIR>          act
10/17/2011  07:30a                   0 test1.txt
10/26/2011  10:43p                5360 sasm.cfg
10/11/2011  06:42a            28821599 both.tim
10/26/2011  10:42p               14597 bootlog.txt
10/19/2011  04:22a                 832 bof.cfg.1
10/17/2011  07:37a                 827 test1
10/17/2011  07:38a                 827 tes2
10/17/2011  07:38a                 827 tes3
10/17/2011  07:39a                 827 tes3567
10/17/2011  07:38a                 827 tes356
10/18/2011  10:46p                5481 sasm.cfg.1

              14 File(s)               33117369 bytes.
               2 Dir(s)                80470016 bytes free.

*A:7210-SAS #

USB storage device

Note:

USB devices are supported on all 7210 SAS platforms as described in this document, except the 7210 SAS-D and 7210 SAS-Dxp.

7210 SAS platforms support the use of the USB interface as an alternate storage location that provides a larger storage capacity than the internal flash. You can use a USB storage device to store TiMOS images, configuration files, accounting records, and log files. The BOF can point to images on the USB and you can use the USB to load TiMOS images and configuration files.

The 7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, and 7210 SAS-K 3SFP+ 8C provide an option to load the boot loader (boot.tim) from the USB storage device plugged into any one of the USB ports.

Note:
  • The USB devices and capacities that are supported for use with 7210 SAS are listed in the 7210 SAS Software Release Notes 24.x.Rx.

  • When a USB device is unplugged or removed from the system, a major alarm is raised. The alarm can be cleared using the shutdown command.

  • 7210 SAS also auto-detects the device type when any of the supported devices are connected to the USB interface. Only approved USB mass storage devices and optical clip-on devices can be plugged in to the USB port and are recognized as valid devices. All other unsupported devices result in an error log being printed.

  • Nokia recommends using the shutdown command before removing the USB storage device.

URLs

The arguments for the 7210 SAS file commands are modeled after standard universal resource locators (URLs). A URL refers to a file (file-url) or a directory (directory-url).

The 7210 SAS supports operations on both the local file system and remote files. For the purposes of categorizing the applicability of commands to local and remote file operations, URLs are divided into three types: local, ftp and tftp. The following table describes the syntax for each of the URL types.

Table 2. URL types and syntax

URL type

Syntax

Notes

local-url

[cflash-id:\]path

[usb-flash-id:\] path

cflash-id is the compact flash device name

Values: cf1:

usb-flash-id is the USB device name

Values: uf1:

ftp-url

ftp://[username[:password]@]host/path

An absolute ftp path from the root of the remote file system

username is the ftp username

password is the ftp user password

host is the remote host

path is the path to the directory or file

ftp://[username[:password]@]host/./path

A relative ftp path from the user’s home directory Note the period and slash (‟./”) in this syntax compared to the absolute path

tftp-url

tftp://host[/path]/filename

tftp is only supported for operations on file URLs

The system accepts either forward slash (‟/”) or backslash (‟\”) characters to delimit directory and filenames in URLs. Similarly, the 7210 SAS SCP client application can use either slash or backslash characters, but not all SCP clients treat backslash characters as equivalent to slash characters. In particular, UNIX systems often interpret the backslash character as an ‟escape” character. This can cause problems when using an external SCP client application to send files to the SCP server. If the external system treats the backslash like an escape character, the backslash delimiter is stripped by the parser and not transmitted to the SCP server.

For example, a destination directory specified as ‟cf1:\dir1\file1” is transmitted to the SCP server as ‟cf1:dir1file1”, where the backslash escape characters are stripped by the SCP client system before transmission. On systems where the client treats the backslash like an ‟escape” character, a double backslash ‟\\” or the forward slash ‟/” can typically be used to correctly delimit directories and the filename.

All the commands can operate on the local file system. The following table describes which commands also support remote file operations.

Table 3. File command local and remote file system support

Command

local-url

ftp-url

tftp-url

attrib

cd

copy

delete

dir

md

move

rd

scp

Source only

type

version

Wildcards

The 7210 SAS supports the standard DOS wildcard characters. The asterisk (*) can represent zero or more characters in a string of characters, and the question mark (?) can represent any one character.

A:ALA-1>file cf1:\ # copy test*.cfg siliconvalley
    cf1:\testfile.cfg
    1 file(s) copied.
    A:ALA-1>file cf1:\ # cd siliconvalley
    A:ALA-1>file cf1:\siliconvalley\ # dir
     Volume in drive cf1 on slot A has no label.
    Directory of cf1:\siliconvalley\
    05/10/2006 11:32p      <DIR>          .
    05/10/2006 11:14p      <DIR>          ..
    05/10/2006 11:32p                7597 testfile.cfg
        1 File(s)                   7597 bytes.
        2 Dir(s)                 1082368 bytes free.
    A:ALA-1>file cf1:\siliconvalley\ #

File management tasks

The following sections contain information about the basic system tasks.

Note:

When a file system operation is performed with a command that can potentially delete or overwrite a file system entry (such as a copy, delete, move, rd, or scp command), a prompt appears to confirm the action. The force keyword performs these file management operations without displaying the confirmation prompt.

Modifying file attributes

The system administrator can change the read-only attribute in the local file. Enter the attrib command with no options to display the contents of the directory and the file attributes.

Use the following CLI syntax to modify file attributes.

file>
        attrib [+r | -r] file-url

Modifying file attributes command syntax

# file
    file cf3:\ # attrib
    file cf3:\ # attrib +r BOF.SAV
    file cf3:\ # attrib

File configuration

A:ALA-1>file cf1:\ # attrib
cf1:\bootlog.txt
cf1:\bof.cfg
cf1:\boot.ldr
cf1:\bootlog_prev.txt
cf1:\BOF.SAV
A:ALA-1>file cf1:\ # attrib +r BOF.SAV
A:ALA-1>file cf1:\ # attrib
cf1:\bootlog.txt
cf1:\bof.cfg
cf1:\boot.ldr
cf1:\bootlog_prev.txt
R cf1:\BOF.SAV

Creating directories

Use the md command to create a new directory in the local file system, one level at a time.

Enter the cd command to navigate to different directories.

Use the following CLI syntax to create a new directory:

file> 
        md file-url

Creating directories command syntax

file cf1:\ # md test1
    file cf1:\ # cd test1
    file cf1:\test1\ # md test2
    file cf1:\test1\ # cd test2
    file cf1:\test1\test2\ # md test3
    file cf1:\test1\test2\ # cd test3
    file cf1:\test1\test2\test3 #

Copying files

Use the copy command to upload or download an image file, configuration file, or other file types to or from a flash card or a TFTP server.

The scp command copies files between hosts on a network. It uses SSH for data transfer, and uses the same authentication and provides the same security as SSH.

The source file for the scp command must be local. The file must reside on the router. The destination file has to be of the following format: user@host:file-name. The destination does not need to be local.

Use the following CLI syntax to copy files.

file> 
        copy source-file-url dest-file-url [force]
        scp local-file-url destination-file-url [router router-name | service-id] [force]

Copy command syntax

A:ALA-1>file cf1:\ # copy 104.cfg cf1:\test1\test2\test3\test.cfg
    A:ALA-1>file cf1:\ # scp file admin@192.168.x.x:cf1:\file1
    A:ALA-1>file cf1:\ # scp file2 user2@192.168.x.x:/user2/file2
    A:ALA-1>file cf1:\ # scp cf1:/file3 admin@192.168.x.x:cf1:\file3

Moving files

Use the move command to move a file or directory from one location to another.

Use the following CLI syntax to move files.

file> 
        move old-file-url new-file-url [force]

Move command syntax

A:ALA-1>file cf1:\test1\test2\test3\ # move test.cfg cf1:\test1
    cf1:\test1\test2\test3\test.cfg
    A:ALA-1>file cf1:\test1\test2\test3\ # cd ..
    A:ALA-1>file cf1:\test1\test2\ # cd ..
    A:ALA-1>file cf1:\test1\ # dir
    
    Directory of cf1:\test1\
    05/04/2006 07:58a      <DIR>          .
    05/04/2006 07:06a      <DIR>          ..
    05/04/2006 07:06a      <DIR>          test2
    05/04/2006 07:58a               25278 test.cfg
     1 File(s)                  25278 bytes.
     3 Dir(s)                 1056256 bytes free.
    A:ALA-1>file cf1:\test1\ #

Removing files and deleting directories

Use the delete and rd commands to delete files and remove directories. Directories must be empty before they can be removed. When files or directories are deleted, they cannot be recovered.

Use the following CLI syntax to delete files and remove directories.

file> 
        delete file-url [force]
        rd file-url [force]

Command syntax

A:ALA-1>file cf1:\test1\ # delete test.cfg
A:ALA-1>file cf1:\test1\ # delete abc.cfg
A:ALA-1>file cf1:\test1\test2\ # cd test3
A:ALA-1>file cf1:\test1\test2\test3\ # cd ..
A:ALA-1>file cf1:\test1\test2\ # rd test3
A:ALA-1>file cf1:\test1\test2\ # cd ..
A:ALA-1>file cf1:\test1\ # rd test2
A:ALA-1>file cf1:\test1\ # cd ..
A:ALA-1>file cf1:\ # rd test1
A:ALA-1>file cf1:\ #

Displaying directory and file information

Use the dir command to display a list of files on a file system. Use the type command to display the contents of a file. Use the version command to display the version of a cpm.tim or iom.tim file.

Use the following CLI syntax to display directory and file information.

file> 
        dir [file-url]
        type file-url
        version file-url

Command syntax

*A:card-1>file cf1:\ # dir
  Volume in drive cf1 on slot A is /flash.

  Volume in drive cf1 on slot A is formatted as FAT32.

Directory of cf1:\

10/22/2008  10:30a                8849 bootlog.txt
10/22/2008  10:30a                 733 bof.cfg
10/22/2008  10:29a                5531 bootlog_prev.txt
02/01/2001  09:25a             3528373 boot.tim
02/01/2001  09:21a                4860 config.cfg
10/22/2008  11:07a      <DIR>          test1
10/17/2008  07:32p                 724 env.cfg
10/15/2008  03:38p                9499 snake.cfg
                7 File(s)                3558569 bytes.
                1 Dir(s)                53135360 bytes free.

File command reference

Command hierarchy

Configuration commands

file 
    - attrib [+r | -r] file-url
    - attrib
    - cd [file-url]
    - copy source-file-url dest-file-url [force]
    - delete file-url [force]
    - dir [file-url] [sort-order {d | n | s}] [reverse]
    - format cflash cflash-id [reliable]
    - md file-url
    - move old-file-url new-file-url [force]
    - rd file-url rf [force]
    - repair [cflash-id]
    - scp local-file-url destination-file-url [router router-instance] [force]
    - [no] shutdown cflash-id
    - type file-url
    - version file-url [check]

Configuration commands

File commands

shutdown
Syntax

[no] shutdown [cflash-id]

Context

file

Platforms

7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C

Description

This command disables the drive. This command is available for use only with removable storage drives. The removable storage drives differ among the 7210 SAS platforms. It cannot be used with the internal non-removable compact flash.

The no form of this command enables the drive.

Default

no shutdown

Parameters
cflash-id

Specifies the device identifier.

Values

cf1:, uf1:

attrib
Syntax

attrib [+r | -r] file-url

attrib

Context

file

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command sets or clears the read-only attribute for a file in the local file system. To list all files and their current attributes enter attrib or attrib x where x is either the filename or a wild-card (*).

When an attrib command is entered to list a specific file or all files in a directory, the file’s attributes are displayed with or without an ‟R” preceding the filename. The ‟R” implies that the +r is set and that the file is read-only. Files without the ‟R” designation implies that the -r is set and that the file is read-write-all.

Parameters
file-url

Specifies the URL for the local file.

Values

file-url local-url | remote-url

local-url — [cflash-id/ | usb-flash-id] [file-path]

remote-url — [{ftp:// | tftp://} login:pswd@remote-locn/] [file- path]

remote-locn — [hostname | ipv4-address | ipv6-address]

ipv4-address — a.b.c.d

ipv6-address — x:x:x:x:x:x:x:x[-interface]

  • x:x:x:x:x:x:d.d.d.d[-interface]
  • x — 0 to FFFF (hexadecimal)
  • d — 0 to 255 (decimal)

interface — a string up to 32, for link local addresses

cflash-id or usb-flash-id —

cf1: (7210 SAS-D, 7210 SAS-Dxp)

cf1:, uf1: (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C)

+r

Keyword to set the read-only attribute on the specified file.

-r

Keyword to clears/reset the read-only attribute on the specified file.

cd
Syntax

cd [file-url]

Context

file

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays or changes the current working directory in the local file system.

Parameters
file-url

Specifies the URL for the local file.

Values

file-url local-url | remote-url

local-url — [cflash-id/ | usb-flash-id] [file-path]

remote-url — [{ftp:// | tftp://} login:pswd@remote-locn/] [file- path]

remote-locn — [hostname | ipv4-address | ipv6-address]

ipv4-address — a.b.c.d

ipv6-address — x:x:x:x:x:x:x:x[-interface]

  • x:x:x:x:x:x:d.d.d.d[-interface]
  • x — 0 to FFFF (hexadecimal)
  • d — 0 to 255 (decimal)

interface — a string up to 32, for link local addresses

cflash-id or usb-flash-id —

cf1: (7210 SAS-D, 7210 SAS-Dxp)

cf1:, uf1: (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C)

none

Displays the current working directory.

..

Specifies the parent directory. This can be used in place of an actual directory name in a directory-url.

directory-url

Specifies the destination directory.

copy
Syntax

copy source-file-url dest-file-url [force]

Context

file

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command copies a file or all files in a directory from a source URL to a destination URL. At least one of the specified URLs should be a local URL. The optional wild-card (*) can be used to copy multiple files that share a common (partial) prefix and/or (partial) suffix. When a file is copied to a destination with the same file name, the original file is overwritten by the new file specified in the operation. The following prompt appears if the destination file already exists:

‟Overwrite destination file (y/n)?”

For example:

To copy a file named ‟srcfile” in a directory called test on cf1 to a file called ‟destfile‟ in a directory called production on cf1, the syntax is:

sr1>file cf1:\ # copy cf2-/test/srcfile/production/destfile

To FTP a file named ‟121201.cfg” in directory mydir stored on cf1 to a network FTP server with IP address 192.0.2.79 in a directory called backup with a destination file name of ‟121201.cfg” the FTP syntax is:

copy /mydir/121201.cfg 192.0.2.79/backup/121201.cfg

Parameters
source-file-url

Specifies the location of the source file or directory to be copied.

dest-file-url

Specifies the destination of the copied file or directory.

Values

file-url local-url | remote-url

local-url — [cflash-id/ | usb-flash-id] [file-path]

remote-url — [{ftp:// | tftp://} login:pswd@remote-locn/] [file- path]

remote-locn — [hostname | ipv4-address | ipv6-address]

ipv4-address — a.b.c.d

ipv6-address — x:x:x:x:x:x:x:x[-interface]

  • x:x:x:x:x:x:d.d.d.d[-interface]
  • x — 0 to FFFF (hexadecimal)
  • d — 0 to 255 (decimal)

interface — a string up to 32, for link local addresses

cflash-id or usb-flash-id —

cf1: (7210 SAS-D, 7210 SAS-Dxp)

cf1:, uf1: (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C)

force

Keyword to force an immediate copy of the specified files. The file copy force command is executed without displaying a user prompt message.

delete
Syntax

delete file-url [force]

Context

file

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command deletes the specified file.

The optional wild-card ‟*” can be used to delete multiple files that share a common (partial) prefix and/or (partial) suffix. When the wild-card is entered, the following prompt displays for each file that matches the wild-card:

‟Delete file <filename> (y/n)?”

Parameters
file-url

Specifies the file name to delete.

Values

file-url local-url | remote-url

local-url — [cflash-id/ | usb-flash-id] [file-path]

remote-url — [{ftp:// | tftp://} login:pswd@remote-locn/] [file- path]

remote-locn — [hostname | ipv4-address | ipv6-address]

ipv4-address — a.b.c.d

ipv6-address — x:x:x:x:x:x:x:x[-interface]

  • x:x:x:x:x:x:d.d.d.d[-interface]
  • x — 0 to FFFF (hexadecimal)
  • d — 0 to 255 (decimal)

interface — a string up to 32, for link local addresses

cflash-id or usb-flash-id —

cf1: (7210 SAS-D, 7210 SAS-Dxp)

cf1:, uf1: (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C)

force

Keyword to force an immediate deletion of the specified files. The file delete * force command is executed without displaying a user prompt message.

dir
Syntax

dir [file-url] [sort-order {d | n | s}] [reverse]

Context

file

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays a list of files and subdirectories in a directory.

Parameters
file-url

Specifies the path or directory name; use the file-url with the optional wildcard (*) to reduce the number of files to list.

Values

file-url local-url | remote-url

local-url — [cflash-id/ | usb-flash-id] [file-path]

remote-url — [{ftp:// | tftp://} login:pswd@remote-locn/] [file- path]

remote-locn — [hostname | ipv4-address | ipv6-address]

ipv4-address — a.b.c.d

ipv6-address — x:x:x:x:x:x:x:x[-interface]

  • x:x:x:x:x:x:d.d.d.d[-interface]
  • x — 0 to FFFF (hexadecimal)
  • d — 0 to 255 (decimal)

interface — a string up to 32, for link local addresses

cflash-id or usb-flash-id —

cf1: (7210 SAS-D, 7210 SAS-Dxp)

cf1:, uf1: (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C)

sort-order {d | n | s}

Specifies the sort order.

Values

d — date

n — name

s — size

reverse

Specifies to reverse the sort order.

file
Syntax

file

Context

root

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context enter and perform file system operations. When entering the file context, the prompt changes to reflect the present working directory. Navigating the file system with the cd command results in a changed prompt.

The exit all command leaves the file system/file operation context and returns to the <root> CLI context. The state of the present working directory is maintained for the CLI session. Entering the file command returns the cursor to the working directory where the exit command was issued.

format
Syntax

format cflash cflash-id

Context

root>file

Platforms

7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C

Description

This command formats the compact flash. The compact flash must be shut down before starting the format.

Parameters
cflash-id

Specifies the compact flash type.

Values

cf1:, uf1:

md
Syntax

md file-url

Context

file

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command creates a new directory in a file system.

Directories can only be created one level at a time.

Parameters
file-url

Specifies the directory name to be created.

Values

file-url local-url | remote-url

local-url — [cflash-id/ | usb-flash-id] [file-path]

remote-url — [{ftp:// | tftp://} login:pswd@remote-locn/] [file- path]

remote-locn — [hostname | ipv4-address | ipv6-address]

ipv4-address — a.b.c.d

ipv6-address — x:x:x:x:x:x:x:x[-interface]

  • x:x:x:x:x:x:d.d.d.d[-interface]
  • x — 0 to FFFF (hexadecimal)
  • d — 0 to 255 (decimal)

interface — a string up to 32, for link local addresses

cflash-id or usb-flash-id —

cf1: (7210 SAS-D, 7210 SAS-Dxp)

cf1:, uf1: (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C)

move
Syntax

move old-file-url new-file-url [force]

Context

file

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command moves a local file, system file, or a directory. If the target already exists, the command fails and an error message displays.

The following prompt appears if the destination file already exists:

‟Overwrite destination file (y/n)?”

Parameters
old-file-url

Specifies the file or directory to be moved.

new-file-url

Specifies the new destination to place the old-file-url.

Values

file-url local-url | remote-url

local-url — [cflash-id/ | usb-flash-id] [file-path]

remote-url — [{ftp:// | tftp://} login:pswd@remote-locn/] [file- path]

remote-locn — [hostname | ipv4-address | ipv6-address]

ipv4-address — a.b.c.d

ipv6-address — x:x:x:x:x:x:x:x[-interface]

  • x:x:x:x:x:x:d.d.d.d[-interface]
  • x — 0 to FFFF (hexadecimal)
  • d — 0 to 255 (decimal)

interface — a string up to 32, for link local addresses

cflash-id or usb-flash-id —

cf1: (7210 SAS-D, 7210 SAS-Dxp)

cf1:, uf1: (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C)

force

Keyword to force an immediate move of the specified files. The file move force command is executed without displaying a user prompt message.

rd
Syntax

rd file-url rf [force]

Context

file

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command is used to delete a directory.

If a directory has files and no sub-directories, the force option must be used to force delete the directory and files it contains.

Parameters
file-url

Specifies the directory to be removed.

Values

file-url local-url | remote-url

local-url — [cflash-id/ | usb-flash-id] [file-path]

remote-url — [{ftp:// | tftp://} login:pswd@remote-locn/] [file- path]

remote-locn — [hostname | ipv4-address | ipv6-address]

ipv4-address — a.b.c.d

ipv6-address — x:x:x:x:x:x:x:x[-interface]

  • x:x:x:x:x:x:d.d.d.d[-interface]
  • x — 0 to FFFF (hexadecimal)
  • d — 0 to 255 (decimal)

interface — a string up to 32, for link local addresses

cflash-id or usb-flash-id —

cf1: (7210 SAS-D, 7210 SAS-Dxp)

cf1:, uf1: (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C)

rf

Specifies that the parameter forces a recursive delete.

force

Keyword to force an immediate deletion of the specified directory.

The rd file-url force command is executed without displaying a user prompt message.

repair
Syntax

repair [cflash-id]

Context

file

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command checks a compact flash device for errors and repairs any errors found.

Parameters
cflash-id

Specifies the compact flash slot ID.

Values

cf1: (7210 SAS-D, 7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C)

Default

the current compact flash device

scp
Syntax

scp local-file-url destination-file-url [router router-instance] [force]

Context

file

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command copies a local file to a remote host file system. It uses SSH for data transfer, and uses the same authentication and provides the same security as SSH. The following prompt appears:

‟Are you sure (y/n)?” The destination must specify a user and a host.

Parameters
local-file-url

Specifies the local source file or directory.

local-file-url — [cflash-id/] [file-path]

cflash-id or usb-flash-id

cf1: (7210 SAS-D, 7210 SAS-Dxp)

cf1:, uf1: (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C)

destination-file-url

Specifies the destination file.

user

Specifies the SSH user.

host

Specifies the remote host IP address of DNS name.

file-path

Specifies the destination path.

router-instance

Specifies the router name or service ID.

Values

router-instanceuser@hostname:file-path] | router-name

user — up to 32 characters

hostname — [dns-name | ipv4-address | ipv6-address]

ipv4-address — a.b.c.d

ipv6-address — x:x:x:x:x:x:x:x[-interface]

  • x:x:x:x:x:x:d.d.d.d[-interface]
  • x — 0 to FFFF (hexadecimal)
  • d — 0 to 255 (decimal)

interface — up to 32 characters max, for link local addresses

dns-name — up to 128 characters

file-path — up to 200 characters

directory length, up to 99 characters each

router-name — Base, Management

Default - Base

force

Keyword to force an immediate copy of the specified file. The file scp local-file-url destination-file-url [router] force command is executed without displaying a user prompt message.

type
Syntax

type file-url

Context

file

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays the contents of a text file.

Parameters
file-url

Specifies the file name of the target file.

Values

file-url local-url | remote-url

local-url — [cflash-id/ | usb-flash-id] [file-path]

remote-url — [{ftp:// | tftp://} login:pswd@remote-locn/] [file- path]

remote-locn — [hostname | ipv4-address | ipv6-address]

ipv4-address — a.b.c.d

ipv6-address — x:x:x:x:x:x:x:x[-interface]

  • x:x:x:x:x:x:d.d.d.d[-interface]
  • x — 0 to FFFF (hexadecimal)
  • d — 0 to 255 (decimal)

interface — a string up to 32, for link local addresses

cflash-id or usb-flash-id —

cf1: (7210 SAS-D, 7210 SAS-Dxp)

cf1:, uf1: (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C)

version
Syntax

version file-url [check]

Context

file

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays the version of a -TiMOS file.

Parameters
file-url

Specifies the file name of the target file.

Values

file-url local-url | remote-url

local-url — [cflash-id/ | usb-flash-id] [file-path]

remote-url — [{ftp:// | tftp://} login:pswd@remote-locn/] [file- path]

remote-locn — [hostname | ipv4-address | ipv6-address]

ipv4-address — a.b.c.d

ipv6-address — x:x:x:x:x:x:x:x[-interface]

  • x:x:x:x:x:x:d.d.d.d[-interface]
  • x — 0 to FFFF (hexadecimal)
  • d — 0 to 255 (decimal)

interface — a string up to 32, for link local addresses

cflash-id or usb-flash-id —

cf1: (7210 SAS-D, 7210 SAS-Dxp)

cf1:, uf1: (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, 7210 SAS-K 3SFP+ 8C)

check

Keyword to validate the .tim file.