Cisco SN 5420 Storage Router Software Configuration Guide, Release 2.1
Chapter 11 - Command Line Interface Reference
Downloads: This chapterpdf (PDF - 2.67MB) The complete bookPDF (PDF - 4.58MB) | Feedback

Command Line Interface Reference

Table Of Contents

Command Line Interface Reference

About CLI Commands

CLI Usage Tips

CLI Commands

aaa authentication iscsi

aaa new-model

aaa test authentication

accesslist

accesslist A.B.C.D/bits

accesslist description

admin contactinfo

admin password

cdp enable

cdp holdtime

cdp interface

cdp timer

clear conf

clear conf {all | system}

clear counters interface

clear counters fc-server

clear counters scsirouter

clear log

clear scsirouter failover

clock set

clock timezone

copy

debug aaa

debug scsirouter

debug scsirouter target

delete accesslist

delete fc-server

delete savedconfig

delete script

delete scsirouter

delete software version

download software

enable

exit

failover scsirouter

fc-server autoconfig

fc-server description

fc-server deviceif

fc-server enable

fc-server log

fc-server password

fc-server server

fc-server serverif

fc-server username

halt

help

hostname

interface fc?

interface ge?

interface ha ip-address

interface mgmt ip-address

ip default-gateway

ip domain-name

ip name-server

ip route

logging

logging buffered

logging console

logging facility

logout

monitor password

ntp peer

ping

radius-server host

radius-server key

radius-server retransmit

radius-server timeout

read

reboot

restore aaa

restore accesslist

restore all

restore scsirouter

restore system

restore vlan

restrict

restrict console

save aaa

save accesslist

save all

save fc-server

save scsirouter

save system

save vlan

scsirouter

scsirouter authenticate

scsirouter description

scsirouter deviceif

scsirouter enable

scsirouter failover

scsirouter log

scsirouter lun reset

scsirouter primary

scsirouter reserveproxy

scsirouter serverif

scsirouter target accesslist

scsirouter target description

scsirouter target {enabled | disabled}

scsirouter target {loopid | serial | lunwwn | wwpn} #?

scsirouter target loopid

scsirouter target lun loopid lun

scsirouter target lun lunwwn

scsirouter target lun serial

scsirouter target lun wwpn lun

scsirouter target wwpn

setup

setup access

setup cluster

setup mgmt

setup netmgmt

setup scsi

setup time

show aaa

show accesslist

show admin

show boot

show bootconfig

show buffers

show cdp

show cdp entry

show cdp interface

show cdp neighbors

show cdp traffic

show cli

show clock

show cluster

show cpu

show crash

show debug

show devices

show diagnostics

show fc-server

show ha

show interface

show ip

show logging

show memory

show modules

show restrict

show route

show runningconfig

show savedconfig

show script

show scsirouter

show sessions

show snmp

show software version

show stack

show system

show task

show tech-support

show version

show vlan

show vtp

snmp-server

software http url

software http username

software proxy

software proxy url

software proxy username

software tftp

software version

tacacs-server host

tacacs-server key

tacacs-server timeout

username password

verify software version

vlan

vtp domain

vtp mode


Command Line Interface Reference


The Cisco SN 5420 Storage Router provides three interfaces for operation, configuration, administration, maintenance, and support tasks: command line interface (CLI), web-based GUI, and SNMP. CiscoWorks can also be used to perform these tasks.

This chapter documents the SN 5420 CLI. For help on the web-based GUI, point your browser to the storage router's management interface IP address. After logging on, click the Help link to access the online help system.

This chapter provides information about the following CLI topics:

About CLI Commands

CLI Usage Tips

CLI Commands

About CLI Commands

This chapter lists all possible CLI commands. However, the set of CLI commands and keywords that are available to you depends on the level of authority associated with your CLI management session and the deployment option selected for the storage router during initial configuration.

For example, a Monitor mode CLI management session to a storage router deployed for iSCSI SAN interconnect will include commands to display information about the FC server instance, such as show fc-server, that are not available for CLI management sessions to a storage router deployed for SCSI routing. Administrator mode CLI management sessions to a storage router deployed for SCSI routing have access to scsirouter commands to create and manage SCSI routing instances. A subset of these scsirouter commands are also available for Administrator mode CLI management sessions to a storage router deployed for transparent SCSI routing. However, scsirouter commands are not available to any CLI management sessions to a storage router deployed for iSCSI SAN interconnect.

Use the show cli command to view all CLI commands and keywords that are valid for your current CLI management session.

CLI Usage Tips

Commands and keywords can be truncated at any point after they are unique.

Use the Tab key to complete the current word.

Use the question mark ( ? ) key to list all of the options available at that point in the command line.

CLI commands and keywords are not case-sensitive. Commands and keywords can be entered in any case (including mixed case).

User-defined strings are case-sensitive. User-defined strings must be entered in the appropriate case (including mixed case). Case for user-defined strings is preserved in the configuration.

An asterisk ( * ) at the beginning of the CLI command prompt indicates that the system configuration has been changed but not saved.

CLI Commands

This section lists all CLI commands in alphabetical order. The no form of any command is shown with the primary command entry. Command information includes syntax, defaults, mode, history, usage guidelines, examples, and related commands.

aaa authentication iscsi

To configure authentication, authorization and accounting (AAA) authentication services for iSCSI authentication of IP host and FC server instances requesting access to storage devices via SCSI routing instances, use the aaa authentication iscsi command. To disable this authentication, use the no form of this command.

aaa authentication iscsi default services1 [services2...]

no aaa authentication iscsi default

Syntax Description

default

The name of the authentication list. The list name must be default.

services1 [services2...]

At least one of the services described in Table 11-1.


Defaults

If iSCSI authentication is enabled and the default authentication list is not configured, only the local user database is selected. This has the same effect as the following command:

aaa authentication iscsi default local

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

iSCSI authentication uses AAA authentication services to provide authentication of IP hosts and FC server instances that request access to storage devices from SCSI routing instances that have authentication enabled.

AAA attempts to use each service in the order listed in the iSCSI default authentication list, until authentication succeeds or fails.If the authentication service fails to find a user name match, authentication fails. If AAA returns an error (because the RADIUS or TACACS+ server is not available, for example), AAA attempts to use the next service in the list for authentication.

If either the local or local-case authentication service is the first service on the iSCSI authentication list and AAA fails to find a user name match, AAA attempts to use the next method on the list for authentication. If the local or local-case authentication service is in any other position on the list and AAA fails to find a user name match, authentication fails and access is denied. If a RADIUS or TACACS+ server fails to find a user name match (regardless of position on the iSCSI authentication list), authentication fails and access is denied.

Use the show runningconfig command to display the current list of authentication services.


Note In Table 11-1, the group radius and group tacacs+ methods refer to a set of previously defined RADIUS or TACACS+ servers. Use the radius-server host and tacacs-server host commands to configure the servers.


Table 11-1 aaa authentication iscsi default services

Keyword
Description

group radius

Uses the list of all RADIUS servers for authentication.

group tacacs+

Uses the list of all TACACS+ servers for authentication.

local

Uses the local username database for authentication.

local-case

Uses case-sensitive local username authentication.

none

Uses no authentication.



Note If the local authentication service is selected, the user name validation is not case-sensitive. If local-case authentication service is selected, the user name validation is case-sensitive. The password validation for both the local service and the local-case service is case-sensitive.


Examples

The following example creates a new AAA authentication list. When iSCSI authentication is required, AAA first tries to use the local username database for authentication. If no match is found, AAA attempts to contact a TACACS+ server. If no server is found, TACACS+ returns an error and the user is allowed access with no authentication.

[SN5420A]# aaa authentication iscsi default local group tacacs+ none

Related Commands

Command
Description

aaa test authentication

Enable testing of the default AAA authentication list.

debug aaa

Enable debugging for the AAA authentication services.

radius-server host

Configure remote RADIUS servers for AAA authentication services.

restore aaa

Restore AAA authentication services from a saved configuration file.

save aaa

Save the current AAA configuration information.

scsirouter authenticate

Enable iSCSI authentication for the named SCSI routing instance.

show aaa

Display AAA configuration information.

tacacs-server host

Configure remote TACACS+ servers for AAA authentication services.


aaa new-model

To enable the AAA access control model, issue the aaa new-model command.

aaa new-model

no aaa new-model

Syntax Description

This command has no arguments or keywords.

Defaults

AAA is enabled. AAA cannot be disabled on the storage router.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

This command enables the AAA access control model. The no aaa new-model command is available for completeness only; AAA cannot be disabled for the storage router.

AAA authentication services are used to provide iSCSI authentication of IP hosts and FC server instances requiring access to storage devices via SCSI routing instances. iSCSI authentication is disabled by default, and can be enabled for specific SCSI routing instances using the scsirouter authenticate CLI command.

Examples

The following example initializes AAA:

[SN5420A]# aaa new-model

Related Commands

Command
Description

aaa authentication iscsi

Configure the AAA authentication services to be used for iSCSI authentication.

aaa test authentication

Enable testing of the default AAA authentication list.

debug aaa

Enable debugging for the AAA authentication services.

radius-server host

Configure remote RADIUS servers for AAA authentication services.

restore aaa

Restore AAA authentication services from a saved configuration file.

save aaa

Save the current AAA configuration information.

scsirouter authenticate

Enable iSCSI authentication for the named SCSI routing instance.

show aaa

Display AAA configuration information.

tacacs-server host

Configure remote TACACS+ servers for AAA authentication services.


aaa test authentication

To test authentication using the iSCSI default authentication list, use the aaa test authentication command.

aaa test authentication iscsi default username password

aaa test authentication cancel

Syntax Description

iscsi default

Use the services in the iSCSI authentication list for testing. The name of the list must be default.

username

The user name to be tested.

password

The password associated with the specified user name.

cancel

Cancel any outstanding test authentication requests.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

AAA uses the services in the iSCSI default authentication list to authenticate the specified user name and password. Use this command to test iSCSI authentication prior to enabling authentication for SCSI routing instances or for troubleshooting purposes.

Use the cancel keyword to terminate any outstanding test authentication requests. For example, if a RADIUS or TACACS+ server is configured with a very long timeout value, you can cancel the request rather than waiting for the timeout to occur.

Examples

The following example tests AAA authentication for the user named, user1, with a password of password1:

[SN5420A]# aaa test authentication iscsi default user1 password1

Related Commands

Command
Description

aaa authentication iscsi

Configure the AAA authentication services to be used for iSCSI authentication.

debug aaa

Enable debugging for the AAA authentication services.

radius-server host

Configure remote RADIUS servers for AAA authentication services.

restore aaa

Restore AAA authentication services from a saved configuration file.

save aaa

Save current AAA configuration information.

scsirouter authenticate

Enable iSCSI authentication for the named SCSI routing instance.

show aaa

Display AAA configuration information.

tacacs-server host

Configure remote TACACS+ servers for AAA authentication services.


accesslist

To create an access list entity, use the accesslist command.

accesslist name

Syntax Description

name

The name of the access list entity created by this command. Enter a maximum of 31 characters.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the create accesslist command.


Usage Guidelines

Access lists specify the IP addresses of the IP hosts or FC server instances allowed to access a common set of storage resources via the SN 5420 Storage Router. Access lists are associated with specific storage targets.

In a cluster environment, all access lists must be created and maintained on the first storage router to join the cluster. If you issue the accesslist command from another storage router in the cluster, the CLI displays an informational message with the IP address of the storage router that is currently handling all access list functions. For more information on operating the storage router in a cluster, see "Maintaining and Managing the Storage Router."

Examples

The following command creates an access list named webserver2:

[SN5420A]# accesslist webserver2

Related Commands

Command
Description

accesslist A.B.C.D/bits

Add IP addresses to an access list.

accesslist description

Add a description to an access list.

delete accesslist

Delete a specific access list entry or an entire access list.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

save accesslist

Save configuration data for the named access list or all access lists.

scsirouter target accesslist

Associate an access list with a specific SCSI routing instance target or all targets.

show accesslist

Display the contents of the named access list or all access lists.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


accesslist A.B.C.D/bits

To add the IP address and subnet mask of IP hosts and FC server instances to the named access list, use the accesslist A.B.C.D/bits command.

accesslist name A.B.C.D/bits A.B.C.D/1.2.3.4 [A.B.C.D/bits A.B.C.D/1.2.3.4] . . . [A.B.D.F/bits A.B.C.D/1.2.3.4]

Syntax Description

name

The name of an access list to which you are adding information.

A.B.C.D/bits

IP address and subnet mask of the IP host or FC server instance being added to the access list. A.B.C.D is the dotted quad notation of the IP address. The /bits specifies the subnet mask in CIDR style.

A.B.C.D/1.2.3.4

The IP address and subnet mask of the IP host or FC server instance being added to the access list. A.B.C.D is the dotted quad notation of the IP address. 1.2.3.4 is the dotted quad notation of the subnet mask.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the add accesslist command.


Usage Guidelines

Access lists specify the IP addresses of the IP hosts and FC server instances allowed to access a common set of storage resources via the SN 5420 Storage Router. The IP address of the FC server instance is the Gigabit Ethernet interface IP address configured for the instance.

Use the accesslist A.B.C.D/bits command after creating an access list entity to populate the list. Enter multiple addresses and masks, separating each by a space.


Note In a cluster environment, all access lists must be created and maintained on the first storage router to join the cluster. If you issue the accesslist A.B.C.D/bits command from another storage router in the cluster, the CLI displays an informational message with the IP address of the storage router that is currently handling all access list functions. For more information on operating the storage router in a cluster, see "Maintaining and Managing the Storage Router."


Examples

The following commands add the specified entries to the named access lists:

[SN5420A]# accesslist myAccessList 192.168.54.12/32 192.168.54.15/32
*[SN5420A]# accesslist Webserver5 209.165.201.1/255.255.255.0 209.165.201.5/255.255.255.0

Related Commands

Command
Description

accesslist

Create an access list entity.

accesslist description

Add a description to an access list.

delete accesslist

Delete a specific access list entry or an entire access list.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

save accesslist

Save configuration data for the named access list or all access lists.

scsirouter target accesslist

Associate an access list with a specific SCSI routing instance target or all targets.

show accesslist

Display the contents of the named access list or all access lists.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


accesslist description

To add a description to an existing access list entity, use the accesslist description command.

accesslist name description "text"

Syntax Description

name

The name of an existing access list entity.

description text

User-defined identification information associated with this access list. Enclose the description string in quotes. Enter a maximum of 64 characters.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set accesslist description command.


Usage Guidelines

Access lists specify the IP addresses of the IP hosts and FC server instances allowed to access a common set of storage resources via the SN 5420 Storage Router. Access lists are associated with specific storage targets.

In a cluster environment, all access lists must be created and maintained on the first storage router to join the cluster. If you issue the accesslist command from another storage router in the cluster, the CLI displays an informational message with the IP address of the storage router that is currently handling all access list functions. For more information on operating the storage router in a cluster, see "Maintaining and Managing the Storage Router."

Examples

The following command adds a description to the access list named webserver2:

[SN5420A]# accesslist webserver2 description "Access list for company web servers"

Related Commands

Command
Description

accesslist

Create an access list entity.

accesslist A.B.C.D/bits

Add IP addresses to an access list.

delete accesslist

Delete a specific access list entry, or an entire access list.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

save accesslist

Save configuration data for the named access list or all access lists.

scsirouter target accesslist

Associate an access list with a specific SCSI routing instance target or all targets.

show accesslist

Display the contents of the named access list or all access lists.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


admin contactinfo

To provide basic contact information for the system administrator of this SN 5420 Storage Router, use the admin contactinfo command.

admin contactinfo [name "string" | email "string" | phone "string" | pager "string"]

admin contact info name "string" email "string" phone "string" pager "string"

Syntax Description

name string

(Optional) The name of the storage router administrator.

email string

(Optional) The e-mail address of the storage router administrator. This is an address to which alerts may be sent.

phone string

(Optional) The phone number of the storage router administrator.

pager string

(Optional) The pager number of the storage router administrator.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set admin contactinfo command.


Usage Guidelines

Use the admin contactinfo command to provide site-specific information for the system administrator of the storage router. The command accepts each parameter separately, or all parameters together. If all parameters are specified, they must be in the sequence shown. Usage is completely site-specific.

Enclose each string containing spaces in single or double quotes. If a string contains a single quote, enclose it is double quotes; if it contains a double quote, enclose it in single quotes. A string cannot contain both single and double quotes.

Examples

The following commands set the system administrator name and e-mail address:

[SN5420A]# admin contactinfo name "Pat Hurley" 
[SN5420A]# admin contactinfo email "hurley@abc123z.com"

The following command sets all system administrator contact information:

[SN5420A]# admin contactinfo name "Chris Smith" email "chris.smith@zxy478x.com" phone 
"123.555.5555 ext 97" pager "555.3444 pin 2234"

Related Commands

Command
Description

admin password

Set the login password for administrative access to the storage router management interface.

save all

Save all configuration information, including the system administrator contact information.

save system

Save selected system configuration information, including the system administrator contact information.

show admin

Display system administrator contact information.


admin password

To set the password used for administrative access to the SN 5420 Storage Router management interface, use the admin password command. Access may be via Telnet (for CLI), or web-based GUI.

admin password string

Syntax Description

string

The password associated with administrative access to the storage router management interface. The string can be enclosed in quotes, and must be enclosed in quotes if the password includes one or more spaces. A string value of "" clears the password. The default password is cisco.


Defaults

The default password is cisco.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set admin password command.


Usage Guidelines

The storage router's management interface is password protected. You must enter passwords when accessing the storage router via Telnet (for CLI) or web-based GUI. The Monitor mode password provides view-only access to the management interface, while the Administrator mode password allows the user to create entities and make changes to the configuration of the storage router. Password protection can also be extended to the storage router console, using the restrict console command.

The password can contain one or more spaces, if the password string is enclosed in quotes. A string value of "" clears the password, effectively setting it to nothing.


Note The password is displayed in clear text as the command is entered, but it is changed to a series of number signs (#####) when the change is acknowledged.


Examples

The following example sets the Administrator mode password to foo73G. All passwords are case sensitive.

[SN5420A]# admin password foo73G

The following example sets the Administrator mode password to "xZm! 673":

[SN5420A]# admin password "xZm! 673"

Related Commands

Command
Description

enable

Enter Administrator mode.

exit

Leave Administrator mode and enter Monitor mode.

monitor password

Set the login password for view-only access to the storage router management interface.

restrict console

Enable or disable password checking on the storage router console interface.

save all

Save all configuration information, including the administrator password.

save system

Save selected system configuration information, including the administrator password.

setup access

Run the wizard to configure Monitor mode and Administrator mode passwords.


cdp enable

To enable Cisco Discovery Protocol (CDP) on the SN 5420 Storage Router, use the cdp enable command. To disable CDP on the storage router, use the no form of this command.

cdp enable

no cdp enable

Syntax Description

This command has no arguments or keywords.

Defaults

CDP is enabled.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

CDP is enabled by default in order to send or receive CDP information. CDP can be switched on or off for each specific interface. See the cdp interface command for more information.

Examples

The following example enables CDP on the storage router:

[SN5420A]# cdp enable

Related Commands

Command
Description

cdp holdtime

Specify the amount of time the receiving device should hold a CDP packet from the SN 5420 Storage Router before discarding it.

cdp interface

Switch CDP on or off for the specified interface.

cdp timer

Specify the amount of time between transmissions of CDP packets from the SN 5420 Storage Router.


cdp holdtime

To specify the amount of time the receiving device should hold a CDP packet from the SN 5420 Storage Router before discarding it, use the cdp holdtime command. To revert to the default setting, use the no form of this command.

cdp holdtime nn

no cdp holdtime

Syntax Description

nn

The holdtime to be sent in the CDP update packets, in seconds.


Defaults

The default holdtime is 180 seconds.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

The CDP holdtime must be set to a higher number of seconds than the time between CDP transmissions, which is set using the cdp timer command.

Examples

The following example sets the CDP holdtime to 60, meaning that the CDP packet being sent from the storage router should be held by the receiving device for 60 seconds before being discarded. You may want to set the holdtime lower than the default setting of 180 seconds if information about the storage router changes frequently.

[SN5420A]# cdp holdtime 60

Related Commands

Command
Description

cdp enable

Enable or disable CDP on the SN 5420 Storage Router.

cdp interface

Switch CDP on or off for the specified interface.

cdp timer

Specify the amount of time between transmissions of CDP packets from the SN 5420 Storage Router.


cdp interface

To enable CDP for a specific interface, use the cdp interface command. To disable CDP for a specific interface, use the no form of this command.

cdp interface if-name enable

no cdp interface if-name enable

Syntax Description

if-name

The name of the interface for which you are enabling or disabling CDP. CDP can be enabled on the management (mgmt), HA, and Gigabit Ethernet (ge2) interfaces. When you type the cdp interface ? command, the CLI lists the interfaces available. You cannot specify a nonexistent interface.


Defaults

CDP is enabled for all interfaces.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

CDP must be enabled for the SN 5420 Storage Router, using the cdp enable command, before it can be enabled for a specific interface.

Examples

The following example enables CDP for the Gigabit Ethernet interface, ge2:

[SN5420A]# cdp interface ge2 enable

The following example disables CDP for the management interface:

[SN5420A]# no cdp interface mgmt enable

Related Commands

Command
Description

cdp enable

Enable or disable CDP on the SN 5420 Storage Router.

cdp holdtime

Specify the amount of time the receiving device should hold a CDP packet from the SN 5420 Storage Router before discarding it.

cdp timer

Specify the amount of time between transmissions of CDP packets from the SN 5420 Storage Router.


cdp timer

To specify the amount of time between transmissions of CDP packets from the SN 5420 Storage Router, use the cdp timer command. To revert to the default setting, use the no form of this command.

cdp timer nn

no cdp timer

Syntax Description

nn

The number of seconds between transmissions of CDP packets from the SN 5420 Storage Router.


Defaults

The default is 60 seconds.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

The time between CDP transmissions must be set to a lower number than the CDP holdtime, which is set using the cdp holdtime command. There is a trade-off between sending more frequent CDP updates and bandwidth utilization.

Examples

The following example sets the CDP timer to 90, meaning that CDP updates are sent every 90 seconds, which is less frequently than the default of 60 seconds. You may want to make this change if you are concerned about preserving bandwidth.

[SN5420A]# cdp timer 90

Related Commands

Command
Description

cdp enable

Enable or disable CDP on the SN 5420 Storage Router.

cdp holdtime

Specify the amount of time the receiving device should hold a CDP packet from the SN 5420 Storage Router before discarding it.

cdp interface

Switch CDP on or off for the specified interface.


clear conf

To return certain configuration settings to factory defaults, use the clear conf wizard. The clear conf wizard prompts the user to enter the Administrator mode password and then to indicate which settings to restore to factory defaults.

clear conf

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the clearconf wizard.


Usage Guidelines

The clear conf wizard is only available when the storage router is deployed for SCSI routing. If the storage router is deployed for transparent SCSI routing or iSCSI SAN interconnect, use the clear conf {all | system} command to return the storage router configuration to factory default settings.

Follow these guidelines when using the clear conf wizard:

Select apps to remove all SCSI routing instances but retain system configuration settings.

Select system to remove all SCSI routing instances and system configuration settings.

Select saved to delete all backup configuration files from disk.

Select all to remove all SCSI routing instances, system configuration settings, and saved configuration files.

The system will reboot if you select apps, system, or all.

System configuration settings include:

The management and HA interface IP addresses

Domain name servers

NTP server and time zone information

SNMP information

Administrator and Monitor passwords, and administrator contact information

AAA authentication configuration information

VLAN and VTP information

Deleting system configuration makes the storage router unavailable to Telnet or web-based GUI sessions until the management interface is reconfigured with an IP address via a console connection. See the "Initial System Configuration Script" section in "First-Time Configuration," for details.

Examples

The following example removes all SCSI routing instances from the storage router. The system configuration settings are retained.

[SN5420_A1]# clear conf

Enter admin password: *****

This process can restore factory default settings for the SN5420.
* Select "apps" to remove active applications and retain system
  configuration settings.
* Select "system" to remove active applications and system
  configuration settings.
* Select "saved" to remove all backup configurations from disk.
* Select "all" to remove active applications, system configuration,
  and saved configurations.

The system configuration includes the management port, dns, admin and
monitor login, ntp, and snmp. You will need to use the console
to reconfigure the management port if you erase the system configuration.

The system will reboot if you select "apps", "system", or "all".

Erase what? [apps/system/saved/all/cancel (cancel)]apps

Configuration cleared. System configuration settings retained.
System halting.............!

System has been halted

Related Commands

Command
Description

clear conf {all | system}

Reset certain configuration settings to factory defaults.

setup access

Run the wizard to configure Monitor mode and Administrator mode passwords.

setup cluster

Change the configuration of the storage router's high availability environment.

setup mgmt

Run the wizard to configure the management interface.

setup netmgmt

Run the wizard to configure network management.

setup scsi

Run the wizard to configure a SCSI routing instance.

setup time

Run the wizard to configure the system date and time.


clear conf {all | system}

To return certain configuration settings to factory defaults, use the clear conf {all | system} command.

clear conf {all | system} password

Syntax Description

all

Remove all storage router configuration information, including system configuration settings, saved configuration files, SCSI routing instances or FC server instances, access lists, and cluster configuration settings.

system

Remove all system configuration settings, SCSI routing instances or FC server instances, access lists and cluster configuration settings. Saved configuration files will be retained.

password

The Administrator mode password.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

System configuration settings include:

The management and HA interface IP addresses

Domain name servers

NTP server and time zone information

SNMP information

Administrator and Monitor passwords, and administrator contact information

AAA authentication information

VLAN and VTP information

Issuing the clear conf command with either the system or all keyword causes the storage router to reboot.

Deleting system configuration makes the storage router unavailable to Telnet or web-based GUI sessions until the management interface is reconfigured with an IP address via a console connection. See the "Initial System Configuration Script" section in "First-Time Configuration," for details.

Examples

The following example removes all storage router configuration information, returning the storage router to its initial default configuration. The example uses the default Administrator mode password, cisco.

[SN5420_A1]# clear conf all cisco

Clearing configuration...


Current configuration and named configurations cleared.
System halting.........

Related Commands

Command
Description

clear conf

Run the wizard to reset the storage router to factory defaults.

setup access

Run the wizard to configure Monitor mode and Administrator mode passwords.

setup cluster

Change the configuration of the storage router's high availability environment.

setup mgmt

Run the wizard to configure the management interface.

setup netmgmt

Run the wizard to configure network management.

setup scsi

Run the wizard to configure a SCSI routing instance.

setup time

Run the wizard to configure the system date and time.


clear counters interface

To clear all counters associated with the specified interface, or all interfaces, use the clear counters interface command.

clear counters interface {ifname | all}

Syntax Description

ifname

The name of the interface. Counters can be cleared for the management (mgmt), Fibre Channel (fc1) and Gigabit Ethernet (ge2) interfaces, and the HA interface (if available). When you type the clear counters interface ? command, the CLI lists the interfaces available. You cannot specify a nonexistent interface.

all

Clear counters for all interfaces.


Defaults

None.

Command Modes

Administrator or Monitor.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the show interface stats clear command.


Usage Guidelines

This command resets all accumulated operational statistics for the specified interface. Operational statistics can include counters for packets received and transmitted, collisions, octets, multicast packets, dropped and unsupported protocol, exception status IOCBs (such as LIP reset aborts, port unavailable or logged out, DMA errors, port configuration changed, command timeout, data overrun, write or read data underrun, and queue full), Fibre Channel errors, and other general events.

Examples

The following example clears all accumulated operational statistics counters for the Fibre Channel interface fc1.

[SN5420A]# clear counters interface fc1

Related Commands

Command
Description

show interface

Display operational and configuration information for the specified interface or all interfaces.


clear counters fc-server

To reset accumulated operational statistics for the specified FC server instance, use the clear counters fc-server command.

clear counters fc-server {name | all} connection

Syntax Description

name

The name of the FC server instance for which counters will be cleared.

all

Clear counters for all FC server instances.

connection

Clear operational statistics related to connections only.


Defaults

None.

Command Modes

Administrator or Monitor.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

This command resets the specified operational statistics. It does not display the accumulated statistics before resetting the counters.

Examples

The following example clears the connection counters for the FC server instance FCLab1. You may want to clear various statistics if you want to troubleshoot a connection problem.

[SN5420A]# clear counters scsirouter FCLab1connection

Command
Description

show fc-server

Display configuration and operational information for the named FC server instance.


clear counters scsirouter

To reset accumulated operational statistics for the specified SCSI routing instance, use the clear counters scsirouter command.

clear counters scsirouter {name | all} {connection | host | target {name | all}}

Syntax Description

name

The name of the SCSI routing instance for which counters will be cleared.

all

Clear counters for all SCSI routing instances.

connection

Clear operational statistics related to connections only.

host

Clear operational statistics related to currently connected hosts only.

target name

Clear operational statistics related to the specified target.

target all

Clear operational statistics related to all targets.


Defaults

None.

Command Modes

Administrator or Monitor.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the show scsirouter stats clear command.


Usage Guidelines

This command resets the specified operational statistics. It does not display the accumulated statistics before resetting the counters.

Examples

The following example clears the connection counters for the SCSI routing instance myScsi1. You may want to clear various statistics if you want to troubleshoot a connection problem.

[SN5420A]# clear counters scsirouter myScsi1 connection

Related Commands

Command
Description

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


clear log

To clear the SN 5420 Storage Router log file of all entries, issue the clear log command.

clear log

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1.

This command was introduced, replacing the set log file empty command.


Usage Guidelines

You may want to clear the log file if it is large, or if you are going to perform testing and want to be sure the log file only reflects information from the testing session.

Examples

The following example clears all entries from the storage router log file:

[SN5420A]# clear log

Related Commands

Command
Description

logging buffered

Set the event-logging threshold for messages logged to the storage router log file.

show logging

Display current logging thresholds and the contents of the storage router log file.


clear scsirouter failover

To clear the designated primary or secondary storage router from the HA failover list for the specified SCSI routing instance, use the clear scsirouter failover command.

clear scsirouter name failover {primary | secondary}

Syntax Description

name

The name of the SCSI routing instance.

primary

Delete the current primary storage router from the HA failover list.

secondary

Delete the secondary storage router from the HA failover list.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

Use the clear scsirouter failover command to reset the primary or secondary storage router on the HA failover list for the specified SCSI routing instance. If there is no primary or secondary storage router on the HA failover list when the SCSI routing instance fails over, the cluster attempts to run the instance on the first storage router that is available.

Use the scsirouter failover command to add a storage router to the HA failover list.


Note This command causes the SCSI routing instance configuration information to be saved and all nodes in the cluster to be updated.


Examples

The following example removes the current secondary storage router from the HA failover list for SCSI routing instance foo:

[SN5420A]# clear scsirouter foo failover secondary

Related Commands

Command
Description

failover scsirouter

Cause the named SCSI routing instance to cease running on the storage router.

scsirouter failover

Add a storage router to the HA failover list for the specified SCSI routing instance.


clock set

To set the storage router system clock to the given date and time, use the clock set command. Date and time information is used for log files and the user interface.

set clock hh:mm:ss mm dd yyyy

Syntax Description

hh:mm:ss mm dd yyyy

The current time in hours, minutes, and seconds, followed by the current month, day, and year. For example, 13:55:22 06 22 2001.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set clock command.


Usage Guidelines

If the storage router should synchronize its date and time with a network time protocol (NTP) server, see the ntp peer command.

Examples

The following example sets the storage router date and time to June 22, 2001 at 14:39:00.

[SN5420A]# clock set 14:39:00 06 22 2001

Related Commands

Command
Description

clock timezone

Specify the time zone for the storage router.

ntp peer

Specify the name or IP address of the NTP server with which the storage router will synchronize date and time.

setup time

Run the wizard to configure the system date and time.

show clock

Display the current system date and time, including the system timezone.


clock timezone

To specify the time zone for the storage router, use the clock timezone command.

clock timezone {string | ?}

Syntax Description

string

A character string representing the time zone of the storage router. For example, America/Chicago or Europe/Amsterdam.

?

Display a list of all valid time zones. Use any time zone in this list for the string parameter to set the storage router to that time zone.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set timezone and tzselect commands.


Usage Guidelines

Unless you specify the time zone, the clock setting is assumed to be in Universal time, also known as Greenwich Mean Time (GMT).

You can use the setup time wizard to select a time zone, set the clock and date, and identify an NTP server for the storage router.

To use the clock timezone command, you must know the appropriate time zone string. Use the "?" to display a list of valid time zone strings.

Examples

The following example sets the storage router time zone to US/Mountain:

[SN5420A]# clock timezone US/Mountain

Related Commands

Command
Description

clock set

Set the storage router system clock.

ntp peer

Specify the name or IP address of the NTP server with which the storage router will synchronize date and time.

setup time

Run the wizard to configure the system date and time.

show clock

Display the current system date and time, including the system time zone.


copy

To copy the named configuration file or script file from the specified location to the savedconfig or script directory, or from the storage router to the specified location, use the copy command. The exchange is via HTTP or TFTP. When copying files to the storage router, any file of the same name in the savedconfig or script directory is overwritten.

copy http://FileUrl {savedconfig:configfilename | script:scriptfilename}

copy tftp://Location/Directory/Filename {savedconfig:configfilename | script:scriptfilename}

copy {savedconfig:configfilename | script:scriptfilename} tftp://Location/Directory/Filename

Syntax Description

FileUrl

The URL (including the file name) of the configuration or script file to be copied to the storage router, such as http://acme/~myhome/allconf.xml. (In this example, the host name acme can be used if the ip name-server command was previously issued.) Configuration files are transferred to the savedconfig directory; script files are transferred to the script directory.

configfilename

The name of the saved configuration file. If the file is being copied from the storage router to a TFTP server, it must exist in the storage router's savedconfig directory.

scriptfilename

The name of the saved script file. If the file is being copied from the storage router to a TFTP server, it must exist in the storage router's script directory.

Location/Directory/Filename

The name of the TFTP server and default directory, followed by the file name. The file must currently exist in the directory. It will be overwritten by the file copied from the storage router.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the import savedconfig command.


Usage Guidelines

The copy http: command does not affect the running or persistent configuration of the storage router or cluster. However, the restore command can be used to copy the contents of a saved configuration file into persistent memory, while the read command can be used to execute the commands in a script file to rebuild a storage router configuration.

Examples

The following example copies the saved configuration file myFoo.xml from a server with an IP address of 10.1.40.10 to the storage router. The file name is changed to myFoo_restore.xml when it is written to the storage router's savedconfig directory.

[SN5420A]# copy http://10.1.40.10/usr/SN5420/savedconfig/myFoo.xml 
savedconfig:myFoo_restore.xml

The following example copies the script file SN5420_Lab from a server named acme. The file name is unchanged when it is written to the storage router's script directory.

[SN5420A]# copy http://acme/~myhome/SN5420_Lab script:SN5420_Lab

The following example copies the saved configuration file backup_23.xml to the daily_backup.xml file in the tftpboot directory of the tftp_primary server. The file daily_backup.xml must already exist in the tftpboot directory of the tftp_primary server. This command will overwrite the existing daily_backup.xml file.

[SN5420A]# copy savedconfig:backup_23.xml tftp://tftp_primary/tftpboot/daily_backup.xml

Related Commands

Commands
Description

read

Read and execute the CLI commands in the named script file.

restore aaa

Restore AAA authentication services from a saved configuration file.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

restore all

Restore the contents of the named configuration file into memory.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

restore system

Restore selected system information from the named configuration file.

restore vlan

Restore VLAN configuration information from the named configuration file.

save aaa

Save the current AAA configuration information.

save accesslist

Save configuration data for the named access list or all access lists.

save all

Save all configuration information.

save fc-server

Save configuration information for the named FC server instance.

save scsirouter

Save configuration information for the named SCSI routing instance.

save system

Save selected system configuration information.

save vlan

Save configuration information for the named VLAN or for all VLANs.

show savedconfig

Display the contents of the savedconfig directory or the contents of the named configuration file.

show script

Display the contents of the script directory or the contents of the named command file.


debug aaa

To enable debugging for authentication, authorization, and accounting (AAA) services, which provide iSCSI authentication for IP hosts and FC server instances requesting access to storage devices via SCSI routing instances, use the debug aaa command. To disable debugging for AAA authentication services, use the no form of this command.

debug aaa

no debug aaa

Syntax Description

This command has no arguments or keywords.

Defaults

Debugging is not enabled.

Command Modes

Administrator.

Command History

Release
Modifications

2.1.1

This command was introduced.


Usage Guidelines

Use this command to debug problems with iSCSI authentication or general AAA authentication services. Change the logging level for the console or the log file to debug to capture the AAA debug message. Debug messages are only written if the logging level is debug.

Examples

The following example enables AAA debugging:

[SN5420A]# debug aaa

Related Commands

Command
Description

aaa authentication iscsi

Configure the AAA authentication services to be used for iSCSI authentication.

aaa test authentication

Enable testing of AAA authentication services.

debug scsirouter

Enable debugging for the named SCSI routing instance.

logging buffered

Set the event-logging threshold for messages logged to the storage router log file.

logging console

Set the event-logging threshold for messages logged to the storage router console.

restore aaa

Restore AAA configuration services from a saved configuration file.

save aaa

Save the current AAA configuration information.

scsirouter authenticate

Enable iSCSI authentication for the named SCSI routing instance.

scsirouter log

Set the event-logging threshold for trace and debug messages related to the specified SCSI routing instance.

show aaa

Display AAA configuration information.


debug scsirouter

To enable trace facilities for debugging SCSI routing instances, use the debug scsirouter command. To disable debugging, use the no form of this command.

debug scsirouter name scsitrace

no debug scsirouter name scsitrace

Syntax Description

name

The name of the SCSI routing instance to be debugged.

scsitrace

Keyword indicating tracing services will be enabled.


Defaults

All trace facilities are disabled by default.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

When enabled at this level, debug tracing will trace traffic to and from all targets associated with the named SCSI routing instance. The logging level for the specified SCSI routing instance must be set to debugging. Change the logging level for the console or the log file to debugging to capture the trace and debug message. Trace and debug messages are only written if the logging level is debugging.

Examples

The following example enables debug tracing facilities for a SCSI routing instance named foo:

[SN5420A]# debug scsirouter foo scsitrace

Related Commands

Command
Description

debug aaa

Enable debugging for AAA authentication services.

debug scsirouter target

Enable debugging for a specific SCSI routing instance target and LUN combination.

logging buffered

Set the event-logging threshold for messages logged to the storage router log file.

logging console

Set the event-logging threshold for messages logged to the storage router console.

scsirouter log

Set the event-logging threshold for trace and debug messages related to the specified SCSI routing instance.


debug scsirouter target

To enable trace facilities for debugging a specific SCSI routing instance target and LUN combination, use the debug scsirouter target command. To disable debugging, use the debug scsirouter target no form of this command.

debug scsirouter name target name lun nn scsitrace

no debug scsirouter name target name lun nn scsitrace

Syntax Description

name

The name of the SCSI routing instance to be debugged.

target name

The name of the target to be included in the trace.

lun nn

The specific LUN associated with the target.

scsitrace

Keyword indicating tracing services will be enabled.


Defaults

All trace facilities are disabled by default.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

When enabled at this level, SCSI tracing will trace traffic to and from the specified target and LUN combination associated with the named SCSI routing instance. The logging level for the specified SCSI routing instance must be set to debugging. Change the logging level for the console or the log file to debugging to capture the trace and debug message. Trace and debug messages are only written if the logging level is debugging.

Examples

The following example enables SCSI tracing facilities for the target and LUN combination myTarget, LUN 0, associated with the SCSI routing instance named foo:

[SN5420A]# debug scsirouter foo target myTarget lun 0 scsitrace

Related Commands

Command
Description

debug aaa

Enable debugging for AAA authentication services.

debug scsirouter

Enable debugging for the named SCSI routing instance.

logging buffered

Set the event-logging threshold for messages logged to the storage router log file.

logging console

Set the event-logging threshold for messages logged to the storage router console.

scsirouter log

Set the event-logging threshold for trace and debug messages related to the specified SCSI routing instance.


delete accesslist

To delete an entire access list, all access lists, or a specified IP address from the named access list, use the delete accesslist command. This command does not change the persistent storage router configuration until the relevant configuration information has been saved using the appropriate save command with the bootconfig keyword.

delete accesslist {name [A.B.C.D/bits | A.B.C.D/1.2.3.4 | all] | all}

Syntax Description

name

The name of the access list.

A.B.C.D/bits

(Optional) IP address and subnet mask of the IP host or FC server instance being deleted from the access list. A.B.C.D is the dotted quad notation of the IP address. The /bits specifies the subnet mask in CIDR style.

A.B.C.D/1.2.3.4

(Optional) IP address and subnet mask of the IP host or FC server instance being deleted from the access list. A.B.C.D is the dotted quad notation of the IP address. 1.2.3.4 is the dotted quad notation of the subnet mask.

name all

Delete all entries from the named access list.

all

Delete all access lists.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

1.1.3

This command was introduced.


Usage Guidelines

Because access lists are cluster entities, this operation affects all targets associated with this access list, regardless of where the associated SCSI routing instance is running within the SN 5420 cluster.

Use the delete accesslist name all to clear all entries from the access list, but retain the access list entity.

Use the delete accesslist name command with no additional parameters to completely delete the named access list.


Note In a cluster environment, all access lists must be created and maintained on the first storage router to join the cluster. If you issue the delete accesslist command from another storage router in the cluster, the CLI displays an informational message with the IP address of the storage router that is currently handling all access list functions. For more information on operating the SN 5420 in a cluster, see "Maintaining and Managing the Storage Router."


Examples

The following example completely deletes the access list named fooList from the storage router's currently running configuration:

[SN5420A]# delete accesslist fooList

The following example deletes all entries from the access list named fooList1. The access list entity itself is not deleted from the storage router's currently running configuration:

[SN5420A]# delete accesslist fooList1 all

The following example deletes all access lists from the storage router's currently running configuration:

[SN5420A]# delete accesslist all

The following example deletes the specified IP address from the named access list, fooList2. This command does not update the storage router's bootable configuration until a save accesslist bootconfig or save all bootconfig command is issued.

[SN5420A]# delete fooList2 192.168.54.12/32

Related Commands

Command
Description

accesslist

Create an access list entity.

accesslist A.B.C.D/bits

Add the IP addresses to an access list.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

save accesslist

Save configuration data for the named access list or for all access lists.

scsirouter target accesslist

Associate an access list with a specific SCSI routing target or all targets.

show accesslist

Display the contents of the named access list or all access lists.


delete fc-server

To delete the named elements from the FC server instance, use the delete fc-server command. This command does not change the persistent storage router configuration until the relevant configuration information has been saved using the appropriate save command with the bootconfig keyword.

delete fc-server {all | name} [deviceif fc? | serverif {fc? | ge? [vlan vid]}]

delete fc-server {all | name} [server {name | all}]

Syntax Description

all

Delete the specified elements from all FC server instances.

name

The name of the FC server instance.

deviceif fc?

(Optional) Delete the Fibre Channel interface associated with the named FC server instance.

serverif ge?

(Optional) Delete the Gigabit Ethernet interface for the named FC server instance.

vlan vid

(Optional) Delete the specified VLAN from the named FC server Gigabit Ethernet interface.

server name

(Optional) Delete the named connection to a SCSI routing instance from the configuration for the named FC server instance.

server all

(Optional) Delete all connections to SCSI routing instances from the configuration for the named FC server instance.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

FC server instances connect to SCSI routing instances running in remote storage routers to obtain access to storage targets. The default FC server instance that is automatically created during initial system configuration is called defaultFC. The local name (server name) of the SCSI routing instance running in a remote storage router is also automatically created during initial system configuration and is called remoteIscsi.

Examples

The following example deletes all connections to SCSI routing instances associated with the FC server instance named defaultFC:

[SN5420A]# delete fc-server defaultFC server all

The following example deletes the Gigabit Ethernet interface associated with the FC server instance named defaultFC:

[SN5420A]# delete fc-server defaultFC serverif ge2


Note All examples update the storage router's currently running configuration only. To make a deletion permanent, issue the appropriate save all bootconfig or save fc-server bootconfig command.


Related Commands

Command
Description

fc-server deviceif

Assign a Fibre Channel interface to the named FC server instance.

fc-server enable

Start and stop the named FC server instance.

fc-server server

Assign a local name to the SCSI routing instance that provides access to storage devices for FC hosts connected to the named FC server instance.

fc-server serverif

Assign a Gigabit Ethernet interface and IP address to the named FC server instance.

save all

Save all configuration information.

save fc-server

Save configuration information for the named FC server instance.

save system

Save selected system configuration information.

show fc-server

Display configuration and operational information for the named FC server instance.


delete savedconfig

To remove the named file from the savedconfig directory, use the delete savedconfig command.

delete savedconfig {filename | all}

Syntax Description

filename

The name of the configuration file to be deleted. This file must exist in the savedconfig directory.

all

Keyword, indicating that all configuration files in the savedconfig directory are to be deleted.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

1.1.3

This command was introduced.

2.1.1

The keyword all was added.


Usage Guidelines

Use the show savedconfig command to display the contents of the savedconfig directory.

Examples

The following example removes the configuration file named foo_config from the storage router:

[SN5420A]# delete savedconfig foo_config

Related Commands

Command
Description

copy

Copy the named configuration or script file from a remote location to the storage router, or from the storage router to a remote location.

restore all

Restore the contents of the named configuration file into memory.

save all

Save all configuration information.

save system

Save selected system configuration information

show savedconfig

Display the contents of the savedconfig directory or the contents of the named configuration file.

show script

Display the contents of the script directory or the contents of the named command file.


delete script

To remove the named command file from the script directory, use the delete script command.

delete script {filename | all}

Syntax Description

filename

The name of the command file to be deleted. This file must exist in the script directory.

all

Keyword, indicating that all command files in the script directory are to be deleted.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

Use the show script command to display the contents of the script directory or the specified command file.

Examples

The following example removes the command file named foo_script from the storage router:

[SN5420A]# delete script foo_script

Related Commands

Command
Description

copy

Copy the named configuration or script file from a remote location to the storage router, or from the storage router to a remote location.

read

Read and execute the CLI commands in the named script file.

restore all

Restore the contents of the named configuration file into memory.

save all

Save all configuration information.

save system

Save selected system configuration information.

show bootconfig

Display the storage router's bootable configuration, or create a command file based on the storage router's bootable configuration.

show runningconfig

Display the storage router's running configuration, or create a command file based on the storage router's running configuration.

show savedconfig

List the contents of the savedconfig directory or the contents of the named configuration file.

show script

Display the contents of the script directory or the contents of the named command file.


delete scsirouter

To delete the named elements from the SCSI routing instance, use the delete scsirouter command. This command does not change the persistent storage router configuration until the relevant configuration information has been saved using the appropriate save command with the bootconfig keyword.

delete scsirouter {all | name} [connection nn | deviceif fc? | serverif {fc? | ge? [vlan vid]}]

delete scsirouter {all | name} target {name | all} [lun nn]

delete scsirouter {all | name} target {name | all} [lun nn] force

delete scsirouter {all | name} force

Syntax Description

all

Delete all SCSI routing instances from the storage router.

name

The name of the SCSI routing instance.

connection nn

(Optional) Delete the specified connection from the named instance or all instances. Use the show scsirouter command with the connection keyword to display connection IDs.

deviceif fc?

(Optional) Delete the device interface for the named SCSI routing instance.

serverif ge?

(Optional) Delete the server interface for the named SCSI routing instance or all instances.

target all

Delete all targets from the named instance.

target name

The name of the specific target to delete.

lun nn

(Optional) Delete the specified iSCSI LUN from the named target or all targets.

vlan vid

(Optional) Delete the specified VLAN from the named SCSI routing instance or all instances.

force

(Optional) Keyword that overrides normal protections, allowing the action to be performed.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

1.1.3

This command was introduced.

1.1.5

The force keyword was added.

2.1.1

The connection and vlan keywords were added.


Usage Guidelines

In a cluster environment, a storage router that is currently running a SCSI routing instance is known as the current primary for that instance. Under normal circumstances, changes to the SCSI routing instance can only be made on the storage router that is the current primary for that instance. The SCSI routing instance may be in a stopped state at the time it is deleted.

The force option overrides the normal protections that prevent the deletion of an instance from a storage router that is not the current primary for that instance. The force option should only be used when the storage router, or a specific SCSI routing instance, is in an abnormal state and cannot be recovered without rebooting.

When used with the target or LUN keywords, the force option allows the specified object to be deleted, even if in use by an iSCSI driver. Under normal circumstances, a target or LUN cannot be deleted if an iSCSI driver is logged in.


Note When making changes to SCSI routing instances (such as adding or deleting targets or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of IP hosts using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers and readme and example configuration files from Cisco.com.


Examples

The following example deletes all targets associated with the SCSI routing instance named foo:

[SN5420A]# delete scsirouter foo target all

The following example deletes the Fibre Channel interface to storage devices used by the SCSI routing instance named foo:

[SN5420A]# delete scsirouter foo deviceif fc1

The following example deletes the specified VLAN from the Gigabit Ethernet interface used by the SCSI routing instance named foo2:

[SN5420A]# delete scsirouter foo2 serverif ge2 vlan 101

The following example deletes the entire SCSI routing instance named foo4:

[SN5420A]# delete scsirouter foo4


Note All examples update the storage router's currently running configuration only. To make a deletion permanent, issue the appropriate save all bootconfig or save scsirouter bootconfig command.


Related Commands

Command
Description

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Start and stop the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

setup scsi

Run the wizard to configure a SCSI routing instance.

show accesslist

Display the contents of the named access list or all access lists.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


delete software version

To delete a version of software from the storage router, use the delete software version command.


Note The version of software currently running and the version that will be booted when the system is restarted may not be deleted.


delete software version {x.y.z | all}

Syntax Description

x.y.z

The version of storage router software to be deleted.

all

Delete all non-bootable and non-current software versions.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

1.1.3

This command was introduced.


Usage Guidelines

Use this command to remove old versions of software from the storage router.

Examples

The following example removes version 2.0.1 from the storage router:

[SN5420A]# delete software version 2.0.1

Related Commands

Command
Description

download software

Download the list of available software versions or the specified version of software from the named location.

software http url

Specify the default location from which to download updated storage router software via HTTP.

software proxy url

Specify the default location from which to download updated storage router software via HTTP, using a proxy server.

software tftp

Specify the default location from which to download updated storage router software via TFTP.

verify software version

Check the specified software version for problems.


download software

To fetch the specified object from the named location or the default download location, use the download software list command.

download software {http | proxy} {list | url full_url | version x.y.z}

download software tftp {hostname host filename file | list | version x.y.z}

Syntax Description

http

Download using the HTTP protocol.

proxy

Download using a proxy server.

list

(Optional) Download a list of available versions.

url

(Optional) Keyword indicating that the download is from the specified URL.

full_url

The fully qualified URL from which to download this version of storage router software. For example, http://anywebserver.com/2.1.1.tar.

version x.y.z

(Optional) Download the specified version of storage router software from the default location.

tftp

Download using the TFTP protocol

hostname host

The name of the TFTP host.

filename file

The name of the file to be downloaded, such as 2.1.1.tar. This file contains the storage router software.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

1.1.3

This command was introduced.

2.1.1

The readme keyword was removed, and the http, proxy, tftp hostname, and filename keywords were added.


Usage Guidelines

The list of available software versions is stored in the file named sw-version.txt. This text file must contain one line for each version of software that is available from the download location. If you store and download software from a site other than the system default (http://www.cisco.com), create this file and update it whenever a new version of software is available.

Software is either downloaded from the default locations set for the specified protocol or from the location specified as part of the command. Always verify software after it has downloaded to assure no errors were encountered. See the "Installing Updated Software" section for details on verification and making updated software available to the storage router.

A maximum of two versions of software can be stored on the storage router.

Examples

The following example downloads storage router software version 2.1.1 from the default location via standard Hypertext Transfer Protocol (HTTP):

[SN5420A]# download software http version 2.1.1

The following example downloads a file named sn5420v211.tar from the TFTP host named my_tftpHost. The file must exist in the default TFTP directory.

[SN5420A]# download software tftp hostname my_tftpHost filename sn5420v211.tar

The following file downloads the list of available software from the default location using the storage router's proxy configuration:

[SN5420A]# download software proxy list

Related Commands

Command
Description

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

software http url

Specify the default location from which to download updated storage router software via HTTP.

software http username

Configure the user name and optional password required to access the default download location.

software proxy

Configure HTTP proxy information.

software proxy url

Specify the default location from which to download updated storage router software via HTTP, using a proxy server.

software proxy username

Configure the user name and optional password required to access the proxy URL.

software tftp

Specify the default location from which to download updated storage router software via TFTP.

verify software version

Check the specified software version for problems.


enable

To change the management session from Monitor mode to Administrator mode, use the enable command. Monitor mode, which is the default mode, provides view-only access to the storage router's management interface. Administrator mode allows the user to create entities and make changes to the configuration of the storage router.

enable

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

Monitor.

Command History

Release
Modification

1.1.3

This command was introduced.


Usage Guidelines

Issue the enable command after a successful CLI login to change to Administrator mode. You are prompted to enter the Administrator mode password, if required. Use the exit command to return to Monitor mode.

Examples

The following example changes the session from Monitor mode to Administrator mode.

[SN5420A]# enable

Enter admin password: *****
[Entering Administrator mode]

Related Commands

Command
Description

exit

Leave Administrator mode and enter Monitor mode.

logout

Terminate the management session.


exit

To return the management session to Monitor mode from Administrator mode, use the exit command.

exit

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

1.1.3

This command was introduced.


Usage Guidelines

Issue the exit command to return to Monitor mode after previously issuing the enable command.

Examples

The following example returns the CLI session to Monitor mode:

[SN5420A]# exit
[Leaving Administrator mode]

Related Commands

Command
Description

enable

Enter Administrator mode.

logout

Terminate the management session.


failover scsirouter

To cause the named SCSI routing instance to cease running on this storage router and start running on another storage router in the cluster, use the failover scsirouter command.


Note If no eligible storage router is found, the SCSI routing instance will start running again on the same storage router. If the storage router is configured as a standalone system, failover is not allowed.


failover scsirouter name [pri | sec | to systemname]

failover scsirouter all [to systemname]

Syntax Description

name

The name of the SCSI routing instance to be failed over.

all

Failover all instances currently running on this storage router.

pri

Force failover to the designated primary storage router in the failover list.

sec

Force failover to the designated secondary storage router in the failover list.

to systemname

Perform the failover to the specified storage router. This storage router must be active in the cluster.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

1.1.3

This command was introduced.

2.1.1

The pri, sec, and to keywords were added.


Usage Guidelines

Use the all keyword to failover all SCSI routing instances currently running on this storage router. Each storage router can run a maximum of 12 SCSI routing instances; there is a maximum of 12 SCSI routing instances per cluster.

Examples

The following example causes the SCSI routing instance named foo to failover to another storage router in the cluster:

[SN5420A]# failover scsirouter foo

The following example causes all SCSI routing instances to failover to the storage router named TestLab1:

[SN5420A]# failover scsirouter all to TestLab1

Related Commands

Command
Description

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter failover

Add a storage router to the HA failover list for the specified SCSI routing instance.


fc-server autoconfig

To enable automatic configuration of storage targets seen by FC hosts connected to the named FC server instance, use the fc-server autoconfig command.

fc-server name autoconfig {yes | no}

Syntax Description

name

The name of the FC server instance.

yes

Enable automatic configuration of storage targets for the named FC server instance. This is the default setting.

no

Disable automatic configuration of storage targets for the named FC server instance.


Defaults

Automatic configuration of storage targets is enabled for FC server instances.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

The autoconfiguration feature allows the FC server instance to automatically connect to all associated SCSI routing instances and display a list of available storage targets to the FC hosts. Up to 31 targets can be presented to the FC hosts via the FC server instance.

If there is a problem with the FC server instance, or if you want to completely prevent FC hosts from seeing storage targets for any reason, use the fc-server autoconfig no command. The associated targets will reappear when the autoconfiguration option is enabled.

Each storage router can have only one FC server instance using automatic configuration of storage targets.

Examples

The following example enables automatic configuration of storage targets for the FC server instance named defaultFC:

[SN5420B]# fc-server defaultFC autoconfig yes

The following example disables automatic configuration mode for the FC server instance named defaultFC:

[SN5420B]# fc-server defaultFC autoconfig no

Related Commands

Command
Description

fc-server deviceif

Assign a Fibre Channel interface to the named FC server instance.

fc-server enable

Start and stop the named FC server instance.

fc-server password

Configure an optional password associated with the specified FC server instance to be used for iSCSI authentication purposes.

fc-server server

Assign a local name to the SCSI routing instance that provides access to storage devices for FC hosts connected to the named FC server instance.

fc-server serverif

Assign a Gigabit Ethernet interface and IP address to the named FC server instance.

fc-server username

Configure the user name associated with the specified FC server instance to be used for iSCSI authentication purposes.

interface fc?

Configure various operational parameters associated with the Fibre Channel interface.

save fc-server

Save configuration information for the named FC server instance.

show fc-server

Display configuration and operational information for the named FC server instance.


fc-server description

To add user-defined identification information to the named FC server instance, use the fc-server description command.

fc-server name description "user text"

Syntax Description

name

The name of this FC server instance.

description "user text"

User-defined identification information associated with this FC server instance. If the string contains spaces, enclose it in quotes. Enter a maximum of 64 characters.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

The fc-server description command allows you to add a new description or change an existing description. Descriptions are site specific.

Examples

The following example adds the description "Access to WebServer4 WebServer5" to the FC server instance defaultFC:

[SN5420B]# fc-server foo1 description "Access to WebServer4 WebServer5"

Related Commands

Command
Description

delete fc-server

Delete the specified element from the named FC server instance or all FC server instances.

fc-server autoconfig

Enable automatic configuration of storage targets for the named FC server instance.

fc-server deviceif

Assign a Fibre Channel interface to the named FC server instance.

fc-server enable

Start and stop the named FC server instance.

fc-server password

Configure an optional password associated with the specified FC server instance to be used for iSCSI authentication purposes.

fc-server server

Assign a local name to the SCSI routing instance that provides access to storage devices for FC hosts connected to the named FC server instance.

fc-server serverif

Assign a Gigabit Ethernet interface and IP address to the named FC server instance.

fc-server username

Configure the user name associated with the specified FC server instance to be used for iSCSI authentication purposes.

save fc-server

Save configuration information for the named FC server instance.

show fc-server

Display configuration and operational information for the named FC server instance.


fc-server deviceif

To assign a Fibre Channel interface to the named FC server instance, use the fc-server deviceif command. The interface acts as the SCSI protocol initiator to FC hosts on a Fibre Channel network.

fc-server name deviceif fc?

Syntax Description

name

Name of the FC server instance to which you are adding the Fibre Channel interface.

deviceif fc?

The name of the Fibre Channel interface. When you type the fc-server deviceif command, followed by ?, the CLI lists the interfaces available. You cannot specify a nonexistent interface.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

Each FC server instance requires three active elements:

The server element associates the FC server instance with a SCSI routing instance in a remote storage router. The specified SCSI routing instance provides the FC server instance access to storage devices.

The deviceif element specifies the interface available for the FC hosts on a Fibre Channel network. The instance becomes active when this interface is added.

The serverif element assigns an interface and IP address used to communicate with storage devices via a SCSI routing instance in a remote storage router.

Examples

The following example assigns the Fibre Channel interface fc1 to the FC server instance named defaultFC:

[SN5420B]# fc-server defaultFC deviceif fc1

Related Commands

Command
Description

delete fc-server

Delete the specified element from the named FC server instance or all FC server instances.

fc-server autoconfig

Enable automatic configuration of storage targets for the named FC server instance.

fc-server enable

Start and stop the named FC server instance.

fc-server password

Configure an optional password associated with the specified FC server instance to be used for iSCSI authentication purposes.

fc-server server

Assign a local name to the SCSI routing instance that provides access to storage devices for FC hosts connected to the named FC server instance.

fc-server serverif

Assign a Gigabit Ethernet interface and IP address to the named FC server instance.

fc-server username

Configure the user name associated with the specified FC server instance to be used for iSCSI authentication purposes.

save fc-server

Save configuration information for the named FC server instance.

show fc-server

Display configuration and operational information for the named FC server instance.


fc-server enable

To start the named FC server instance, use the fc-server enable command. To stop the named FC server instance, use the no form of this command.

fc-server {name | all} enable

no fc-server {name | all} enable

Syntax Description

name

The name of the FC server instance to be started.

all

Keyword, indicating all instances or extensions on this storage router.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

To restart a stopped FC server instance, use the fc-server enable command. Use the all keyword to start all instances on the storage router. All instances previously stopped on this storage router will be started.


Note FC server instances are automatically started by the storage router when the Fibre Channel interface is added. See the fc-server deviceif command for additional information.


Examples

The following example starts the FC server instance named defaultFC. This instance must have been previously stopped.

[SN5420B]# fc-server defaultFC enable

The following example stops all FC server instances running on the storage router:

[SN5420B]# no fc-server all enable

Related Commands

Command
Description

delete fc-server

Delete the specified element from the named FC server instance or all FC server instances.

fc-server autoconfig

Enable automatic configuration of storage targets for the named FC server instance.

fc-server deviceif

Assign a Fibre Channel interface to the named FC server instance.

fc-server password

Configure an optional password associated with the specified FC server instance to be used for iSCSI authentication purposes.

fc-server server

Assign a local name to the SCSI routing instance that provides access to storage devices for FC hosts connected to the named FC server instance.

fc-server serverif

Assign a Gigabit Ethernet interface and IP address to the named FC server instance.

fc-server username

Configure the user name associated with the specified FC server instance to be used for iSCSI authentication purposes.

save fc-server

Save configuration information for the named FC server instance.

show fc-server

Display configuration and operational information for the named FC server instance.


fc-server log

To set the event-logging threshold for trace and debug messages related to the specified FC server instance, use the fc-server log command.

fc-server name log notification-level

Syntax Description

name

The name of the FC server instance to be logged at the specified level.

notification-level

Limit logging to messages of a specified level and lower. See Table 11-2 in the Usage Guidelines section for a list of valid names that can be used for the notification-level argument.


Defaults

None.

Command Modes

Administration.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

This setting controls the event-logging threshold level of trace and debug messages that will occur for the specified FC server instance.

Specifying a threshold causes messages at that level and numerically lower levels to be logged. Table 11-2 lists the valid names that can be used for the notification-level argument and information about those levels.

Table 11-2 Error Message Logging Priorities and Corresponding Level Names and Numbers

Notification Level
Level Number
Description
Syslog Definition

emergencies

0

System unusable

LOG_EMERG

alerts

1

Immediate action needed

LOG_ALERT

critical

2

Critical conditions

LOG_CRIT

errors

3

Error conditions

LOG_ERR

warnings

4

Warning conditions

LOG_WARNING

notification

5

Normal but significant condition

LOG_NOTICE

informational

6

Informational messages only

LOG_INFO

debugging

7

Debugging messages

LOG_DEBUG


Examples

The following example sets the event-logging level to critical for all debug and trace messages related to FC server instance named defaultFC. This means that only emergency messages, alerts and critical debug and trace messages will be logged for this instance or extension.

[SN5420B]# fc-server defaultFC log critical

Related Commands

Command
Description

delete fc-server

Delete the specified element from the named FC server instance or all FC server instances.

fc-server autoconfig

Enable automatic configuration of storage targets for the named FC server instance.

fc-server deviceif

Assign a Fibre Channel interface to the named FC server instance.

fc-server enable

Start and stop the named FC server instance.

fc-server password

Configure an optional password associated with the specified FC server instance to be used for iSCSI authentication purposes.

fc-server server

Assign a local name to the SCSI routing instance that provides access to storage devices for FC hosts connected to the named FC server instance.

fc-server serverif

Assign a Gigabit Ethernet interface and IP address to the named FC server instance.

fc-server username

Configure the user name associated with the specified FC server instance to be used for iSCSI authentication purposes.

save fc-server

Save configuration information for the named FC server instance.

show fc-server

Display configuration and operational information for the named FC server instance.


fc-server password

To configure a password for iSCSI authentication using AAA authentication services, use the fc-server password command.

fc-server name password password

Syntax Description

name

The name of the FC server instance.

password

The password associated with the FC server instance.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

FC server instances connect to SCSI routing instances (running in remote SN 5420 Storage Routers) to provide access to storage for FC hosts. If the SCSI routing instance in the remote storage router is configured for iSCSI authentication using AAA authentication services, the FC server instance must supply a valid user name and password to gain access to storage. Use this command to configure the FC server instance password for iSCSI authentication using AAA authentication services.

To configure the associated user name, use the fc-server username command.


Note The AAA authentication service username database must include a matching user name and password entry.


Examples

The following example associates the password m78G41 with the FC server instance named defaultFC.

[SN5420B]# fc-server defaultFC password m78G41

Related Commands

Command
Description

aaa authentication iscsi

Configure the AAA authentication services to be used for iSCSI authentication.

fc-server autoconfig

Enable automatic configuration of storage targets for the named FC server instance.

fc-server deviceif

Assign a Fibre Channel interface to the named FC server instance.

fc-server enable

Start and stop the named FC server instance.

fc-server server

Assign a local name to the SCSI routing instance that provides access to storage devices for FC hosts connected to the named FC server instance.

fc-server serverif

Assign a Gigabit Ethernet interface and IP address to the named FC server instance.

fc-server username

Configure the user name associated with the specified FC server instance to be used for iSCSI authentication purposes.

interface fc?

Configure various operational parameters associated with the Fibre Channel interface.

restore aaa

Restore AAA authentication services from a saved configuration file.

save aaa

Save the current AAA configuration information.

save fc-server

Save configuration information for the named FC server instance.

scsirouter authenticate

Enable iSCSI authentication for the named SCSI routing instance.

show aaa

Display AAA configuration information.

show fc-server

Display configuration and operational information for the named FC server instance.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


fc-server server

To identify the Gigabit Ethernet IP addresses of the SCSI routing instances (running in remote SN 5420 Storage Routers) that provide access to storage resources for the named FC server instance, use the fc-server server command.

fc-server name server name ip-address

Syntax Description

name

The name of the FC server instance.

server name

A meaningful name to associate with the IP address of the SCSI routing instance providing the FC server instance access to storage devices.

ip-address

The IP address of the Gigabit Ethernet interface associated with the SCSI routing instance in the remote SN 5420 Storage Router.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

Use this command to identify a SCSI routing instance in a remote SN 5420 Storage Router that is available to the FC server instance via its Gigabit Ethernet interface. You can associate multiple SCSI routing instances (running in one or more remote storage routers) with a single FC server instance by issuing this command multiple times. The specified SCSI routing instance provides the FC server instance access to storage targets. Up to 31 storage targets can be made available to the FC server instance. The server name keyword-and-variable pair allows you to associate a meaningful local name with the IP address.

Examples

The following example associates the name labserver1 to the SCSI routing instance with the Gigabit Ethernet IP address 10.1.10.145 for the FC server instance named defaultFC. All storage targets available through the Fibre Channel interface of the SCSI routing instance at 10.1.10.145 are made available to the FC server instance named defaultFC.

[SN5420B]# fc-server defaultFC server labserver1 10.1.10.145

Related Commands

Command
Description

fc-server autoconfig

Enable automatic configuration of storage targets for the named FC server instance.

fc-server deviceif

Assign a Fibre Channel interface to the named FC server instance.

fc-server enable

Start and stop the named FC server instance.

fc-server password

Configure an optional password associated with the specified FC server instance to be used for iSCSI authentication purposes.

fc-server serverif

Assign a Gigabit Ethernet interface and IP address to the named FC server instance.

fc-server username

Configure the user name associated with the specified FC server instance to be used for iSCSI authentication purposes.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save fc-server

Save configuration information for the named FC server instance.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

show fc-server

Display configuration and operational information for the named FC server instance.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


fc-server serverif

To assign a Gigabit Ethernet interface and IP address to the named FC server instance, use the fc-server serverif command. The interface allows access to storage devices through a SCSI routing instance running on a remote storage router.

fc-server name serverif ge? {A.B.C.D/bits | A.B.C.D/1.2.3.4}

fc-server name serverif ge? vlan vid {A.B.C.D/bits | A.B.C.D/1.2.3.4}

Syntax Description

name

Name of the FC server instance to which you are adding the Gigabit Ethernet interface.

serverif ge?

The name of the interface. When you type the fc-server serverif command, followed by ?, the CLI lists the interfaces available. You cannot specify a nonexistent interface.

A.B.C.D/bits

The IP address of the named interface. If the keyword vlan is used, the IP address is on the specified VLAN. A.B.C.D is the dotted quad notation of the IP address. The /bits specifies the subnet mask in CIDR style.

A.B.C.D/1.2.3.4

The IP address of the named interface. If the keyword vlan is used, the IP address is on the specified VLAN. A.B.C.D is the dotted quad notation of the IP address. 1.2.3.4 is the dotted quad notation of the subnet mask.

vlan vid

The keyword and the VLAN identifier.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

Each FC server instance requires three active elements:

The server element associates the FC server instance with a SCSI routing instance in a remote storage router. The specified SCSI routing instance provides the FC server instance access to storage devices.

The deviceif element specifies the interface available for the FC hosts on a Fibre Channel network. The instance becomes active when this interface is added.

The serverif element assigns the Gigabit Ethernet interface and IP address used to communicate with storage devices via a SCSI routing instance in a remote storage router.

The fc-server serverif vlan command is used to associate a VLAN with a FC server instance. All traffic using the specified Gigabit Ethernet interface will be considered as part of the VLAN.

When the FC server instance is started, a logical interface name (for example, ge2VLAN100) is created, which incorporates the physical interface and the VID. This logical interface can be displayed via the show interface command and can be used when adding static routes to the system.

Examples

The following command adds the Gigabit Ethernet interface ge2, with the IP address 10.1.10.255/24, to the FC server instance named defaultFC.

[SN5420B]# fc-server defaultFC serverif ge2 10.1.10.255/24

Related Commands

Command
Description

delete fc-server

Delete the specified element from the named FC server instance or all FC server instances.

fc-server autoconfig

Enable automatic configuration of storage targets for the named FC server instance.

fc-server deviceif

Assign a Fibre Channel interface to the named FC server instance.

fc-server enable

Start and stop the named FC server instance.

fc-server password

Configure an optional password associated with the specified FC server instance to be used for iSCSI authentication purposes.

fc-server server

Assign a local name to the SCSI routing instance that provides access to storage devices for FC hosts connected to the named FC server instance.

fc-server username

Configure the user name associated with the specified FC server instance to be used for iSCSI authentication purposes.

save fc-server

Save configuration information for the named FC server instance.

show fc-server

Display configuration and operational information for the named FC server instance.

show vlan

Display configuration and operational information for the specified VLAN or all VLANs.

show vtp

Display configuration and operational information for VTP.


fc-server username

To configure the user name for iSCSI authentication using AAA authentication services, use the fc-server username command.

fc-server name username user-name

Syntax Description

name

The name of the FC server instance.

user-name

The user name associated with the FC server instance. An appropriate matching entry must exist in any designated AAA authentication service database.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

FC server instances connect to SCSI routing instances running in remote SN 5420 Storage Routers to provide access to storage for FC hosts. If the SCSI routing instance is configured for iSCSI authentication using AAA authentication services, the FC server instance must supply a valid user name and password to gain access to storage. Use this command to configure the FC server instance user name for iSCSI authentication using AAA authentication services.

To configure the associated password, use the fc-server password command.


Note The AAA authentication service username database must include a matching user name and password entry.


Examples

The following example configures a user name of lab001 for the FC server instance named defaultFC:

[SN5420B]# fc-server defaultFC username lab001

Related Commands

Command
Description

aaa authentication iscsi

Configure the AAA authentication services to be used for iSCSI authentication.

fc-server autoconfig

Enable automatic configuration of storage targets for the named FC server instance.

fc-server deviceif

Assign a Fibre Channel interface to the named FC server instance.

fc-server enable

Start and stop the named FC server instance.

fc-server password

Configure an optional password associated with the specified FC server instance to be used for iSCSI authentication purposes.

fc-server server

Assign a local name to the SCSI routing instance that provides access to storage devices for FC hosts connected to the named FC server instance.

fc-server serverif

Assign a Gigabit Ethernet interface and IP address to the named FC server instance.

interface fc?

Configure various operational parameters associated with the Fibre Channel interface.

restore aaa

Restore AAA authentication services from a saved configuration file.

save aaa

Save the current AAA configuration information.

save fc-server

Save configuration information for the named FC server instance.

scsirouter authenticate

Enable iSCSI authentication for the named SCSI routing instance.

show aaa

Display AAA configuration information.

show fc-server

Display configuration and operational information for the named FC server instance.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


halt

To prepare the storage router to be powered down, issue the halt command.

halt [force] [fast]

Syntax Description

fast

(Optional) Bypassing hardware diagnostics when the storage router is next restarted.

force

(Optional) Force an immediate halt of the storage router.


Defaults

If there are unsaved configuration changes when the command is issued, the default is to save all changes before halting. If the command is issued with the optional force keyword, any unsaved configuration changes are discarded.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

The halt command prepares the storage router file system to be powered down. If the storage router is participating in a cluster, the halt command will cause any SCSI routing instances running on this storage router to failover to another storage router in the cluster.

If the halt command is issued with no keywords and there are unsaved changes to the current configuration, you are prompted to save or discard the changes.

Use the force keyword to cause an immediate halt of the storage router, discarding any unsaved configuration changes. Append the optional fast keyword to bypass diagnostics when the storage router is restarted.

When the halt command completes, the storage router displays the following system prompt:

[HALTED]# 

The storage router can be safely powered down when the HALTED system prompt appears. The only CLI command that can be issued from the storage router at the HALTED system prompt is the reboot command.


Note When the storage router is restarted, the cluster determines any SCSI routing instances that should start on the storage router. If the storage router is identified as the preferred storage router for any SCSI routing instance (via the scsirouter primary command), that instance will start running on the storage router.


Examples

The following prompt is received if you issue a halt command (without the force keyword) when the storage router has unsaved configuration changes.

[SN5420A]# halt

*** Warning: This will halt the system.
Do you want to continue? [yes/no (no)] yes

Changes have been made to the current configuration of the system which
have not been saved.
yes    - all of the configuration data will be saved,
no     - modifications to the configuration data will not be saved.

Save ALL configuration data? [yes/no (yes)] no
Halting system............!
[HALTED]# 

The following example halts the storage router (after prompting the user to save any unsaved configuration changes), but bypasses diagnostics when the storage router is restarted.

[SN5420A]# halt fast


Related Commands

Command
Description

reboot

Cause the storage router to shut down and then restart.


help

To display information on how to use the CLI, issue the help command.

help

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

Administrator or Monitor.

Command History

Release
Modification

1.1.3

This command was introduced.


Usage Guidelines

The help command displays information about the various CLI commands that can be issued, based on the mode currently in use. The help command also displays information about the special keys that can be used in the CLI.

Examples

The following example shows the special key information returned as a result of the help command:

[SN5420A]# help

Special keys:
  ?                     list choices
  Backspace or Delete   delete character backward
  Tab                   complete current word
  Ctrl-A                go to beginning of line
  Ctrl-B or Arrow Left  go backward one character
  Ctrl-D                delete character
  Ctrl-E                go to end of line
  Ctrl-F or Arrow Right go forward one character
  Ctrl-K                delete from current position to end of line
  Ctrl-N or Arrow Down  go to next line in history buffer
  Ctrl-P or Arrow Up    go to previous line in history buffer
  Ctrl-T                transpose current character and previous character
  Ctrl-U                delete line
  Ctrl-W                delete previous word

Related Commands

Command
Description

enable

Enter Administrator mode.

exit

Leave Administrator mode and enter Monitor mode.


hostname

To specify the system name for the storage router, use the hostname command. The storage router is recognized by this name through the management interface.

This command takes effect immediately, and the new system name is automatically integrated into the prompt string.

hostname sysname

Syntax Description

sysname

The name of the storage router. This may be the fully qualified domain name. Maximum length is 19 characters. The name cannot contain blanks, white space, or control characters.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set systemname command.


Usage Guidelines

All storage routers must have a system name.

If you wish to enable network management on the storage router using the facilities of a Domain Name Server (DNS), you must make the storage router's system name and IP address known to that DNS. Use the system name specified in this command.

Examples

The following example shows the storage router name set to sn5420lab1.

[SN5420A]# hostname sn5420lab1

Related Commands

Command
Description

save all

Save all configuration information.

save system

Save selected system configuration information.

show system

Display selected system information, including system name.


interface fc?

To set various operational parameters associated with the Fibre Channel interface, such as the size of the maximum transfer unit (MTU), use the interface fc? command.

interface fc? {mtusize {nn | default}

interface fc? topology {loop | looppref | ptp | ptppref}}

Syntax Description

fc?

The name of the Fibre Channel interface for which you are setting this parameter. When you type the interface fc? command, the CLI lists the interfaces available. You cannot specify a nonexistent interface.

mtusize nn

The size of the MTU, in bytes. nn is an integer between 100 and 65280. The Fibre Channel interface supports a variable size MTU.

mtusize default

Reset the value to the factory default of 65280 bytes.

topology loop

Set the Fibre Channel topology for this interface to loop. This is the default setting for a storage router deployed for transparent SCSI routing or iSCSI SAN interconnect.

topology looppref

Set a preference for Fibre Channel loop topology for this interface. If the Fibre Channel interface does not accept the attempt to establish loop activation, point-to-point topology will be assumed. This is the default setting for a storage router deployed for SCSI routing.

topology ptp

Set the Fibre Channel topology for this interface to point-to-point.

topology ptppref

Set a preference for Fibre Channel point-to-point topology for this interface. If the Fibre Channel interface does not accept the attempt to establish point-to-point link activation, loop topology will be assumed.


Defaults

MTU size defaults to 65280 bytes. If the storage router is deployed for SCSI routing, the topology defaults to looppref; if the storage router is deployed for transparent SCSI routing or iSCSI SAN interconnect, the topology defaults to loop and cannot be changed.

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set interface fc? command.


Usage Guidelines

For storage routers deployed for SCSI routing:

All storage routers in a cluster should be configured with the same MTU size and other interface-specific parameters, allowing failover of applications to provide consistent performance characteristics.

If storage devices are all connected to a hub with the intention of running in an arbitrated loop, you should set the device interface topology to loop.

If storage devices are all connected in a point-to-point topology, you should set the device interface topology to ptp.

For storage routers deployed for transparent SCSI routing or iSCSI SAN interconnect, the only supported topology setting is loop.

You must save all configuration information and reboot the storage router for a new MTU size or topology selection to take effect.

Examples

The following example sets the topology for the storage router's Fibre Channel interface fc1 to point-to-point. (This storage router is deployed for SCSI routing.)

[SN5420A]# interface fc1 topology ptp

The following example sets the MTU size to 58000.

[SN5420A]# interface fc1 mtusize 58000

Related Commands

Command
Description

show interface

Display operational and configuration information for the specified interface or all interfaces.


interface ge?

To set various operational parameters associated with the Gigabit Ethernet interface, such as the size of the maximum transfer unit (MTU) or the use of VLANs, use the interface ge? command. To specify that autonegotiation will never be used on this interface, use the interface ge? no autonegotiation command.

interface ge? {autonegotiation [autodetect] | mtusize {nn | default} 

interface ge? no autonegotiation

interface ge? vlan enable

no interface ge? vlan enable

Syntax Description

ge?

The name of the interface for which you are setting this parameter. When you type the interface ge? command, the CLI lists the interfaces available. You cannot specify a nonexistent interface.

autonegotiation

Autonegotiation will always be used on this interface.

autonegotiation autodetect

Automatically detect if autonegotiation should be used for this interface. This is the default setting.

mtusize nn

The size of the MTU, in bytes. nn is an integer between 60 and 16128. Gigabit Ethernet interfaces may support jumbo frames.

mtusize default

Reset the value to the factory default of 1500 bytes.

vlan enable

Enable VLANs for this interface. This is the default.


Defaults

MTU size defaults to 1500 bytes. Autonegotiation defaults to autodetect. For storage routers deployed for SCSI routing, the use of VLANs is enabled by default.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set interface ge? command.


Usage Guidelines

All storage routers in a cluster should be configured with the same MTU size and other interface-specific parameters, allowing failover of applications to provide consistent performance characteristics.

Use the no interface ge? vlan enable command to quickly restrict VLAN functionality on the storage router's Gigabit Ethernet interface for troubleshooting purposes.

Examples

The following example enables autonegotiation on the Gigabit Ethernet interface and sets the MTU size to 1400 bytes:

[SN5420A]# interface ge2 autonegotiation mtusize 1400

The following example disables VLANs for the storage router Gigabit Ethernet interface, ge2:

[SN5420A]# no interface ge2 vlan enable

Related Commands

Command
Description

show interface

Display operational and configuration information for the specified interface or all interfaces.


interface ha ip-address

To specify the IP address and subnet mask for this system's high availability interface, use the interface ha ip-address command.

interface ha ip-address {A.B.C.D/bits A.B.C.D/1.2.3.4}

Syntax Description

A.B.C.D/nn

The IP address of the HA interface. A.B.C.D is the dotted quad notation of the IP address. The /bits specifies the subnet mask in CIDR style.

A.B.C.D/1.2.3.4

The IP address of the HA interface. A.B.C.D is the dotted quad notation of the IP address. 1.2.3.4 is the dotted quad notation of the subnet mask.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set ha ipaddress command.


Usage Guidelines

The HA features are used within a cluster of storage routers. Each member of the cluster communicates over the HA and management interfaces, exchanging heartbeats and other configuration information, allowing for failover in case of system problems.

The HA interface and the management interface must be on unique IP subnets. In a cluster, the HA interfaces for all storage routers should be on the same IP subnet.

After initial system configuration, use the setup cluster command to change the configuration of the storage router's high availability environment.

For storage routers deployed for iSCSI SAN interconnect or transparent SCSI routing, or standalone storage routers deployed for SCSI routing, the HA interface is optional.

Examples

The following example assigns the IP address of 10.1.20.56/24 to the storage router's HA interface:

[SN5420B]# interface ha ip-address 10.1.20.56/24

Related Commands

Command
Description

interface mgmt ip-address

Specify the management interface IP address and subnet mask.

save all

Save all configuration information.

save system

Save selected system configuration information, including HA IP address.

setup cluster

Change the configuration of the storage router's high availability environment.

show cluster

Display cluster-related operational statistics, including heartbeat information.

show ha

Display HA operational statistics for the storage router or for a specific application.


interface mgmt ip-address

To specify the IP address and subnet mask of the interface labeled MGMT on the front panel of the SN 5420 Storage Router, use the interface mgmt ip-address command. This address is used to manage the storage router via Telnet, the web-based GUI, or SNMP.

interface mgmt ip-address {A.B.C.D/bits A.B.C.D/1.2.3.4}

Syntax Description

A.B.C.D/bits

The IP address of the management interface. A.B.C.D is the dotted quad notation of the IP address. The /bits specifies the subnet mask in CIDR style.

A.B.C.D/1.2.3.4

The IP address of the management interface. A.B.C.D is the dotted quad notation of the IP address. 1.2.3.4 is the dotted quad notation of the subnet mask.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set mgmt ipaddress command.


Usage Guidelines

The management and HA interfaces must be on unique IP subnets. In a cluster, the management interfaces for all storage routers should be on the same IP subnet.

Examples

The following example assigns the IP address of 10.1.10.244/24 to the storage router's management interface:

[SN5420A]# interface mgmt ip-address 10.1.10.244/24

Related Commands

Command
Description

interface ha ip-address

Specify the HA interface IP address and subnet mask.

ip route

Add a static route to the SN 5420 Storage Router routing table.

save all

Save all configuration information.

save system

Save selected system configuration information, including management and HA interface information.

setup mgmt

Run the wizard to configure the management interface.

show cluster

Display cluster-related operational statistics, including heartbeat information.

show interface

Display operational and configuration information for the specified interface or all interfaces.


ip default-gateway

To add a gateway to the default route in the SN 5420 routing table, use the ip default-gateway command. To delete the gateway, use the no form of this command.

ip default-gateway E.F.G.H

no ip default-gateway [A.B.C.D]

Syntax Description

E.F.G.H

The default gateway IP address.

A.B.C.D

(Optional) The IP address of the default route. The gateway to this route will be removed.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the add route default gw command.


Usage Guidelines

All IP interfaces in the storage router use the routing table to reach services and networks outside their local network. Other facilities, such as SNMP and connections to an NTP server or DNS servers, may also use the routing table. Use the ip default-gateway command to add a gateway to the default route in this table.

Examples

The following example adds the gateway 10.3.40.1 to the default route in the SN 5420 routing table:

[SN5420A]# ip default-gateway 10.3.40.1

Related Commands

Command
Description

ip route

Add a static route to the SN 5420 Storage Router routing table.

show ip

Display entries from the SN 5420 Storage Router routing table and statistics about the protocols used in the storage router network.

show route

Display the default routes.


ip domain-name

To specify the name of the storage router domain, use the ip domain-name command. To remove a domain name, use the no form of this command.

ip domain-name name

no ip domain-name

Syntax Description

name

The name of the storage router domain.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set nameserver domain command.


Usage Guidelines

Use the ip domain-name command in conjunction with the ip name-server command. The storage router requires access to a DNS if any IP addresses are entered as host names via any of the SN 5420 management interfaces, or if the SN 5420 management interface IP address is to be correlated with a DNS host name.


Note If the DNS is outside the storage router management subnet, use the ip route command to add an appropriate gateway IP address to the SN 5420 routing table.


Examples

The following example assigns the domain name abc123z.com to the storage router.

[SN5420A]# ip domain-name abc123z.com

Related Commands

Command
Description

ip default-gateway

Configure a gateway for the storage router's default route.

ip name-server

Specify the IP addresses of a primary (and optional secondary) DNS.

ip route

Add a static route to the SN 5420 Storage Router routing table.

setup mgmt

Run the wizard to configure the management interface.


ip name-server

To specify the IP address of the primary and optional secondary Domain Name Server (DNS), use the ip name-server command. To remove the settings for current domain name servers, use the no form of this command.

ip name-server A.B.C.D [E.F.G.H]

no ip name-server

Syntax Description

A.B.C.D

The IP address of a primary Domain Name Server, accessible by the storage router. A.B.C.D is the dotted quad notation of the IP address.

E.F.G.H

(Optional) The IP address of a secondary DNS, accessible by the storage router. E.F.G.H is the dotted quad notation of the IP address.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Configuration

2.1.1

This command was introduced, replacing the set nameserver and set secnameserver commands.


Usage Guidelines

The storage router requires access to a DNS if any IP addresses are entered as host names via any of the SN 5420 management interfaces, or if the SN 5420 management interface IP address is to be correlated with a DNS host name. To use the services of a DNS, you must also assign a domain name to the storage router via the ip domain-name command.


Note If the DNS is outside the storage router management subnet, use the ip route command to add an appropriate gateway IP address to the SN 5420 routing table.


Examples

The following example assigns the domain name abc123z.com to the storage router, and assigns the IP address of the primary DNS to 10.1.40.243 and the secondary DNS to 10.1.50.249:

[SN5420A]# ip domain-name abc123z.com
[SN5420A]# ip name-server 10.1.40.243 10.1.50.249

Related Commands

Command
Description

ip default-gateway

Configure a gateway for the storage router's default route.

ip domain-name

Specify the name of the storage router's domain.

ip route

Add a static route to the SN 5420 Storage Router routing table.

setup mgmt

Run the wizard to configure the management interface.


ip route

To add a static route to the SN 5420 routing table, use the ip route command. The specified IP address is accessed via the gateway specified in the command. To remove a static route from the routing table, use the no form of this command.

ip route {A.B.C.D/bits | A.B.C.D/1.2.3.4} E.F.G.H [interface {ha | mgmt | ge? [vlan vid]}]

no ip route {A.B.C.D/bits | A.B.C.D/1.2.3.4}

Syntax Description

A.B.C.D/bits

The IP address of the static route. A.B.C.D is the dotted quad notation of the IP address. The /bits specifies the subnet mask in CIDR style.

A.B.C.D/1.2.3.4

The IP address of the static route. A.B.C.D is the dotted quad notation of the IP address. 1.2.3.4 is the dotted quad notation of the subnet mask.

E.F.G.H

The gateway IP address through which the static route (A.B.C.D/bits or A.B.C.D/1.2.3.4) is accessed.

interface ha

(Optional) Keyword indicating the static route is associated with the HA interface.

interface mgmt

(Optional) Keyword indicating the static route is associated with the management interface.

interface ge?

(Optional) Keyword indicating the static route is associated with the Gigabit Ethernet interface.

vlan vid

(Optional) Associates the static route with the specified VLAN on the Gigabit Ethernet interface.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the add route gw command.


Usage Guidelines

All IP interfaces in the storage router use the routing table to reach services and networks outside their local network. Other facilities, such as SNMP and connections to an NTP server or DNS servers, may also use the routing table. Use the ip route command to specify routes for servers or networks outside the local networks associated with the storage router's IP interfaces.


Note A route is not added to the routing table until the associated interface is configured.


Examples

The following command adds a unique route for the Gigabit Ethernet interface, specifying the subnet mask in dotted quad notation:

[SN5420A]# ip route 10.1.30.0/255.255.255.0 10.1.30.10 interface ge2

Related Commands

Command
Description

ip default-gateway

Configure a gateway for the storage router's default route.

ip domain-name

Specify the name of the storage router's domain.

ip name-server

Specify the IP addresses of a primary (and optional secondary) DNS.

show ip

Display entries from the SN 5420 Storage Router routing table, and statistics about the protocols used in the storage router network.


logging

To log messages to a syslog server, use the logging command. To stop logging messages to syslog servers, use the no form of this command.

logging A.B.C.D

no logging

Syntax Description

A.B.C.D

The IP address of the server to be used as the syslog server.


Defaults

Logging to a syslog sever is disabled by default.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

This command identifies a syslog server to receive logging messages.

Use the logging facility command to configure the syslog facility in which error messages are sent.

Use the no logging command to disable logging to a syslog server.

Use the show system command to display syslog server and facility information.

Use the save system command to save remote logging configuration information.

Examples

The following example identifies the syslog server as the server at IP address 10.1.1.144:

[SN5420A]# logging 10.1.1.144

Related Commands

Command
Description

logging buffered

Set the event-logging threshold for messages logged to the storage router log file.

logging console

Set the event-logging threshold for messages logged to the storage router console.

logging facility

Configure the syslog facility in which storage router error messages are sent.

save all

Save all configuration information, including the remote logging configuration.

save system

Save selected system configuration information, including remote logging information.

show system

Display selected system information, including syslog server address and facility setting.


logging buffered

To set the event-logging threshold for messages that are logged to the storage router's log file, use the logging buffered command. To cancel the use of the log file, use the no form of this command.

logging buffered level notification-level

no logging buffered

Syntax Description

level notification-level

Limit logging to messages of a specified level or lower. See Table 11-3 in the Usage Guidelines section for a list of valid names that can be used for the notification-level argument.


Defaults

The default event logging threshold is notification.

Command Modes

Monitor and Administrator. The no form of this command is limited to Administrator mode.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set log file level command.


Usage Guidelines

This command impacts the logging of messages but does not impact the operation of the storage router. Use the show logging command to display the current threshold before issuing this command.

Specifying a threshold causes messages at that level and numerically lower levels to be logged in an internal buffer and written to the storage router's log file. Table 11-3 lists the valid names that can be used for the notification-level argument and information about those levels.


Note Logging levels are not retained in the storage router when it is rebooted.


Table 11-3 Error Message Logging Priorities and Corresponding Level Names and Numbers

Notification Level
Level Number
Description
Syslog Definition

emergencies

0

System unusable

LOG_EMERG

alerts

1

Immediate action needed

LOG_ALERT

critical

2

Critical conditions

LOG_CRIT

errors

3

Error conditions

LOG_ERR

warnings

4

Warning conditions

LOG_WARNING

notification

5

Normal but significant condition

LOG_NOTICE

informational

6

Informational messages only

LOG_INFO

debugging

7

Debugging messages

LOG_DEBUG


Examples

The following example sets the logging threshold to critical, which means that critical conditions, alerts, and emergencies are logged:

[SN5420A]# logging buffered level critical

Related Commands

Command
Description

logging

Enable remote logging to the specified syslog server.

logging console

Set the event-logging threshold for messages logged to the console.

show logging

Display current logging thresholds and the contents of the storage router log file.


logging console

To set the event-logging threshold for messages that are logged to the storage router's console, use the logging console command. To stop logging messages to the console, use the no form of this command.

logging console level notification-level

no logging console

Syntax Description

level notification-level

Limit logging to messages of a specified level or lower levels. See Table 11-4 in the Usage Guidelines section for a list of valid names that can be used for the notification-level argument.


Defaults

The default event logging threshold is notification.

Command Modes

Monitor and Administrator. The no form of this command is limited to Administrator mode.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set log cli level command.


Usage Guidelines

This command impacts the logging of messages but does not impact the operation of the storage router. Use the show logging command to display the current threshold before issuing this command.

Specifying a threshold causes messages at that level and numerically lower levels to be logged to the console. Table 11-4 lists the valid names that can be used for the notification-level argument and information about those levels.


Note Console logging levels are valid only for the session in which they are set. Logging levels are not retained after the user logs out or when the storage router is rebooted.


Table 11-4 Error Message Logging Priorities and Corresponding Level Names and Numbers 

Notification Level
Level Number
Description
Syslog Definition

emergencies

0

System unusable

LOG_EMERG

alerts

1

Immediate action needed

LOG_ALERT

critical

2

Critical conditions

LOG_CRIT

errors

3

Error conditions

LOG_ERR

warnings

4

Warning conditions

LOG_WARNING

notification

5

Normal but significant condition

LOG_NOTICE

informational

6

Informational messages only

LOG_INFO

debugging

7

Debugging messages

LOG_DEBUG


Examples

The following example sets the console logging threshold to alerts, which means that only conditions requiring immediate action or conditions that cause the system to be unusable will be logged to the console:

[SN5420A]# logging console level alert

Related Commands

Command
Description

logging buffered

Set the event-logging threshold for messages logged to the storage router log file.

show logging

Display current logging thresholds and the contents of the storage router log file.


logging facility

To configure the syslog facility in which SN 5420 Storage Router error messages are sent, use the logging facility command.

logging facility facility-type

Syntax Description

facility-type

Syslog facility. See Table 11-5 in the Usage Guidelines section for a list of valid names for the facility-type argument.


Defaults

Remote logging is, by default, disabled. If it is enabled, the facility defaults to syslog.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set log remote command.


Usage Guidelines

Every SN 5420 event message handed over to syslogd is assigned a level of importance, based on the facility and message level. The SN 5420 message level maps to the syslogd level parameter. The syslogd configuration specifies an action or action for all messages matching various facility and message levels. Remote Syslog messages are UDP messages sent to UDP port 514. Syslogd, or an equivalent facility, must be appropriately configured on the designed host.

Issue the logging command to specify the IP address of the host to be used as the syslog server. If the logging command is issued with a host IP address, the facility defaults to syslog.

Use the no logging command to disable logging to a syslog server.

Use the show system command to display syslog server and facility information.

Use the save system command to save remote logging configuration information.


Note Normal logging of SN 5420 event message to the SN 5420 log buffer and console is not impacted by this command.


Table 11-5 Valid Names for the facility-type Argument

Facility-Type Keyword
Description

local0

Reserved for locally defined messages

local1

Reserved for locally defined messages

local2

Reserved for locally defined messages

syslog

System log

user

User process


Examples

The following example enables remote logging to the syslog server at IP address 10.1.1.144 and sets the syslog facility to syslog.

[SN5420A]# logging 10.1.1.144
[SN5420A]# logging facility syslog

This is an example of a recorded syslog line from a Solaris host:

Feb 14 14:55:42 [10.1.0.150.4.0] Feb 14 14:55:45:fc1:AS_CRIT:Interface Up

Related Commands

Command
Description

logging

Enable remote logging to the specified syslog server.

logging buffered

Set the event-logging threshold for messages logged to the storage router log file.

logging console

Set the event-logging threshold for messages logged to the storage router console.

save all

Save all configuration information, including the remote logging configuration.

save system

Save selected system configuration information, including remote logging information.

show system

Display selected system information, including syslog server address and facility setting.


logout

To terminate the current CLI management session, use the logout command.

logout

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

Administrator or Monitor.

Command History

Release
Modification

1.1.3

This command was introduced.


Usage Guidelines

If a user is connected to the storage router in Administrator mode or Monitor mode via a Telnet session, the logout command terminates the CLI management session. No CLI commands can be issued until you log in again.

If a user is connected to the storage router in Administrator mode via the console interface, the logout command returns the session to Monitor mode (like the exit command).

If a user is connected to the storage router in Monitor mode via the console interface, the logout command has no effect.

Related Commands

Command
Description

enable

Enter Administrator mode.

exit

Leave Administrator mode and enter Monitor mode.


monitor password

To set the password used for view-only access to the storage router management interface, use the monitor password command. Access may be via Telnet (for CLI) or web-based GUI.

monitor password string

Syntax Description

password string

A case-sensitive password associated with view-only access to the storage router's management interface. The default password is cisco.


Defaults

The default password is cisco.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set monitor password command.


Usage Guidelines

The storage router's management interface is password protected. You must enter passwords when accessing the storage router via the CLI or web-based GUI. (Passwords can also be applied to the console interface. See the restrict console command for additional information.) The Monitor mode password provides view-only access to the storage router's management interface, while the Administrator mode password allows the user to create entities and make changes to the configuration of the SN 5420 system.

Set the password string to "" to clear the password, effectively setting it to nothing.


Note The password is displayed in clear text as the command is entered, but it is changed to a series of number signs (#####) when the change is acknowledged.


Examples

The following example sets the Monitor mode password to M17g23. All passwords are case sensitive.

[SN5420A]# monitor password M17g23

Related Commands

Command
Description

admin password

Set the login password for administrative access to the storage router management interface.

enable

Enter Administrator mode.

exit

Leave Administration mode and enter Monitor mode.

save all

Save all configuration information, including the Monitor mode password.

save system

Save selected system information, including the Monitor mode password.

setup access

Run the wizard to configure Monitor mode and Administrator mode passwords.


ntp peer

To specify the name or IP address of a Network Time Protocol (NTP) server with which the storage router will synchronize date and time, use the ntp peer command. To clear the current NTP server setting, use the no form of this command.

ntp peer{A.B.C.D | server-name}

no ntp peer

Syntax Description

A.B.C.D

The IP address of the NTP server with which the storage router synchronizes date and time. A.B.C.D is the dotted quad notation of the IP address.

server-name

The name of the NTP server with which the storage router synchronizes date and time. In order to specify a server name, the storage router must be configured to use a DNS server using the ip name-server command.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set ntpserver command.


Usage Guidelines

The storage router must provide accurate date and time information for log files and user interfaces. It will use the services of the NTP server to keep the date and time synchronized with the rest of the network.

If the NTP server is outside the storage router management subnet, use the ip route command to add an appropriate gateway IP address to the SN 5420 routing table.

Examples

The following example specifies the IP address of the NTP server for the SN 5420 to 10.1.60.86.

[SN5420A]# ntp peer 10.1.60.86

Related Commands

Command
Description

clock set

Set the storage router system clock.

clock timezone

Specify the time zone associated with the storage router.

ip route

Add a static route to the SN 5420 Storage Router routing table.

save all

Save all configuration information.

save system

Save selected system information, including NTP server name.

setup time

Run the wizard to configure the system date and time.

show clock

Display the current system date and time, including the system time zone.

show system

Display selected system information, including NTP server address.


ping

To verify communication with another storage router or system in the network, use the ping command.

ping {ip-address | servername} [numpkts nn] [size sn]

Syntax Description

ip-address

The IP address of another system or storage router.

servername

The name of another server. The storage router must be configured to use the services of a Domain Name Server (DNS).

numpkts

(Optional) Keyword indicating the maximum number of pings that may be sent.

nn

(Optional) The maximum number of pings. The default value is five.

size

(Optional) Keyword indicating the size of each ping packet.

sn

(Optional) The size of each packet, in bytes. The default is 64 bytes; the maximum size is 4096 bytes.


Defaults

The default setting is to attempt five 64-byte pings.

Command Modes

Administrator or Monitor.

Command History

Release
Modification

1.1.3

This command was introduced.

2.1.1

The num keyword was changed to numpkts, and the size keyword was added.


Usage Guidelines

Use this command to verify that there is a TCP/IP communication path to another storage router or system in the network.

Examples

The following example attempts to verify the communication path to the IP address 10.1.30.17, using the default size and maximum number of packets:

[SN5420A]# ping 10.1.30.17

The following example attempts to reach the IP address 10.1.30.17 by sending up to three pings, each consisting of a 20-byte packet:

[SN5420A]# ping 10.1.30.17 numpkts 3 size 20

Related Commands

Command
Description

show ip

Display entries from the SN 5420 Storage Router routing table and statistics about the protocols used in the storage router network.


radius-server host

To specify a RADIUS server to be used for AAA authentication services, use the radius-server host command. To delete the specified RADIUS server, use the no form of this command.

radius-server host ip-address [auth-port port-number] [timeout seconds] [retransmit retries] [key key-string]

no radius-server host ip-address [auth-port port-number]

Syntax Description

ip-address

The IP address of the RADIUS server.

auth-port port-number

(Optional) The UDP destination port for authentication requests. If unspecified, the port number defaults to 1645.

key key-string

(Optional) The authentication and encryption key for all RADIUS communications between the storage router and the RADIUS server. This key must match the encryption used on the RADIUS daemon. If spaces are used in the key, enclose the key in quotation marks. This key overrides the global setting of the radius-server key command. If no key string is specified, the global value is used.

timeout seconds

(Optional) The host-specific time interval that the storage router waits for the RADIUS server to reply before retransmitting. Enter a value in the range of 1 to 1000. This setting overrides the global value of the radius-server timeout command. If no timeout value is specified, the global value is used.

retransmit retries

(Optional) The number of times a RADIUS request is resent to the RADIUS server, if the server is not responding or responding slowly. Enter a value in the range of 1 to 100. This setting overrides the global setting of the radius-server retransmit command. If no retransmit value is specified, the global value is used.


Defaults

No RADIUS server is specified.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

AAA authentication services are used to provide iSCSI authentication for IP hosts and FC server instances requesting access to storage devices.

You can use multiple radius-server host commands to specify multiple RADIUS servers. The software searches for servers in the order in which you specify them.

If no host-specific timeout, retransmit, or key values are specified, the global values apply to each RADIUS server.

If you use spaces in the key, enclose the key in quotation marks.

Examples

The following example identifies the server with IP address 10.5.0.53 as the RADIUS server and uses the default port for authentication:

[SN5420A]# radius-server 10.5.0.53

The following example identifies port 1612 as the destination port for authentication requests on the RADIUS server 10.6.0.61:

[SN5420A]# radius-server host 10.6.0.61 auth-port 1612

The following example identifies the server with IP address 10.5.0.53 as the RADIUS server, uses ports 1612 as the authorization port, sets the timeout value to 6, sets the retransmit value to 5, and sets "rad123" as the encryption key, matching the key on the RADIUS server:

[SN5420A]# radius-server host 10.5.0.53 auth-port 1612 timeout 6 retransmit 5 key rad123

Related Commands

Command
Description

aaa authentication iscsi

Configure the AAA authentication services to be used for iSCSI authentication.

aaa test authentication

Enable testing of the default AAA authentication list.

debug aaa

Enable debugging for the AAA authentication services.

radius-server key

Sets the global authentication and encryption key for all RADIUS communications between the storage router and the RADIUS daemon.

radius-server retransmit

Specifies how many times the storage router resends the RADIUS request to a server before giving up.

radius-server timeout

Sets the interval the storage router waits for a RADIUS server to reply before retransmitting.

restore aaa

Restore AAA authentication services from a saved configuration file.

save aaa

Save the current AAA configuration information.

scsirouter authenticate

Enable iSCSI authentication for the named SCSI routing instance.

show aaa

Display AAA configuration information.

tacacs-server host

Configure remote TACACS+ servers for AAA authentication services.


radius-server key

To set the authentication and encryption key to be used for all RADIUS communications between the SN 5420 Storage Router and the RADIUS daemon, use the radius-server key command. To disable the key, use the no form of this command.

radius-server key key-string

no radius-server key

Syntax Description

key-string

The authentication and encryption key string to be used for all RADIUS communications, in clear text. If spaces are used in the key, enclose the key in quotation marks.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

After configuring authentication services for iSCSI authentication with the aaa authentication iscsi command, use the radius-server key command to set the global authentication and encryption key. The key entered as part of the command must match the key used on the RADIUS daemon. If the key includes spaces, enclose the key in quotation marks.

To override the global key for a specific RADIUS server, use the radius-server host command with the key keyword.

Examples

The following example sets the global authentication and encryption key to my key string:

[SN5420A]# radius-server key "my key string"

Related Commands

Command
Description

aaa authentication iscsi

Configure the AAA authentication services to be used for iSCSI authentication.

aaa test authentication

Enable testing of the default AAA authentication list.

debug aaa

Enable debugging for the AAA authentication services.

radius-server host

Configure remote RADIUS servers for AAA authentication services.

radius-server retransmit

Specifies how many times the storage router resends the RADIUS request to a server before giving up.

radius-server timeout

Sets the interval the storage router waits for a RADIUS server to reply before retransmitting.

restore aaa

Restore AAA authentication services from a saved configuration file.

save aaa

Save the current AAA configuration information.

scsirouter authenticate

Enable iSCSI authentication for the named SCSI routing instance.

show aaa

Display AAA configuration information.

tacacs-server host

Configure remote TACACS+ servers for AAA authentication services.


radius-server retransmit

To specify the number of times the SN 5420 Storage Router resends the RADIUS request to each server in the list of configured RADIUS servers after a timeout occurs, use the radius-server retransmit command. To disable retransmission, use the no form of this command.

radius-server retransmit retries

no radius-server retransmit

Syntax Description

retries

The number of times the request can be resent to each server in the list. The default is 3.


Defaults

The number of possible resends defaults to three.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

If multiple RADIUS servers are configured for AAA authentication, the storage router attempts to reach each server in the list before incrementing the retransmit count.

To override the global retransmit count for a specific RADIUS server, use the radius-server host command with the retransmit keyword.

Examples

The following example sets the retransmit count to six, meaning the request can be resent up to six times for every RADIUS server:

[SN5420A]# radius-server retransmit 6

Related Commands

Command
Description

aaa authentication iscsi

Configure the AAA authentication services to be used for iSCSI authentication.

aaa test authentication

Enable testing of the default AAA authentication list.

debug aaa

Enable debugging for the AAA authentication services.

radius-server host

Configure remote RADIUS servers for AAA authentication services.

radius-server key

Sets the global authentication and encryption key for all RADIUS communications between the storage router and the RADIUS daemon.

radius-server timeout

Sets the interval the storage router waits for a RADIUS server to reply before retransmitting.

restore aaa

Restore AAA authentication services from a saved configuration file.

save aaa

Save the current AAA configuration information.

scsirouter authenticate

Enable iSCSI authentication for the named SCSI routing instance.

show aaa

Display AAA configuration information.

tacacs-server host

Configure remote TACACS+ servers for AAA authentication services.


radius-server timeout

To set the global interval that the SN 5420 Storage Router waits for a RADIUS server to reply, use the radius-server timeout command. To restore the default, use the no form of this command.

radius-server timeout seconds

no radius-server timeout

Syntax Description

seconds

The global timeout value in seconds. Enter a value in the range of 1 to 1000. The default is 5.


Defaults

The timeout value defaults to five seconds.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

Use this command to set the number of seconds the storage router waits for a RADIUS server to reply before timing out.

To override the global timeout value for a specific RADIUS server, use the radius-server host command with the timeout keyword.

Examples

The following example sets the global timeout value to 10. You may want to increase the timeout value if you have network problems or if the RADIUS servers are slow to response, which causes consistent timeouts when a lower timeout value is used.

[SN5420A]# radius-server timeout 10

Related Commands

Command
Description

aaa authentication iscsi

Configure the AAA authentication services to be used for iSCSI authentication.

aaa test authentication

Enable testing of the default AAA authentication list.

debug aaa

Enable debugging for the AAA authentication services.

radius-server host

Configure remote RADIUS servers for AAA authentication services.

radius-server key

Sets the global authentication and encryption key for all RADIUS communications between the storage router and the RADIUS daemon.

radius-server retransmit

Specifies how many times the storage router resends the RADIUS request to a server before giving up.

restore aaa

Restore AAA authentication services from a saved configuration file.

save aaa

Save the current AAA configuration information.

scsirouter authenticate

Enable iSCSI authentication for the named SCSI routing instance.

show aaa

Display AAA configuration information.

tacacs-server host

Configure remote TACACS+ servers for AAA authentication services.


read

To read and execute the CLI commands in a command file, use the read command.

read script command-file [force]

Syntax Description

command-file

The name of the command file. The command file must exist in the script directory.

force

(Optional) Suppress warning prompts and messages.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

Use the show bootconfig and show runningconfig commands with the to keyword to create basic files containing many of the CLI commands that were issued to create the storage router's bootable or currently running configuration. These files can be modified and used as command files to automate common tasks.

You can also manually create a command file. If you have a set of CLI commands that you run periodically, you can place them in a command file, transfer that file to the storage router's script directory and use the read command to execute them when needed. Each command should be on a separate line or contain a backslash ( \ ) as the line continuation character at the end of the line. At the end of a continuation sequence, add a blank line as a separator between the sequence and any following command. Any line beginning with an exclamation mark (!) or a number sign (#) is considered to be a comment and will not be executed.

When the command is issued without the force keyword, you are reminded that the action may change the configuration of the storage router and are then prompted to confirm your actions.

Examples

The following example reads and executes the CLI commands in the command file named myCommands.

[SN5420A]# read script myCommands
*** Warning: this script may change your configuration.
Do you want to continue? [yes/no (yes)] yes

Related Commands

Command
Description

show bootconfig

Display the storage router's bootable configuration, or create a command file based on the storage router's bootable configuration.

show cli

Display the syntax of CLI commands.

show runningconfig

Display the storage router's running configuration, or create a command file based on the storage router's running configuration.

show script

Display the contents of the script directory or the contents of the named command file.


reboot

To cause the storage router to shut down and then restart, issue the reboot command.


Note Rebooting may cause the storage router to run a different version of software. See the software version command for details.


reboot [force] [fast]

Syntax Description

fast

(Optional) Force a soft reboot of the storage router, bypassing hardware diagnostics.

force

(Optional) Force an immediate reboot of the storage router.


Defaults

If there are unsaved configuration changes when the command is issued, the default is to save all changes before rebooting. If the command is issued with the optional force keyword, any unsaved configuration changes are discarded.

Command Modes

Administrator.

Command History

Release
Modification

1.1.3

This command was introduced.

2.1.1

The force keyword was added.


Usage Guidelines

If the storage router is participating in a cluster, the reboot command will cause any SCSI routing instances running on this storage router to failover to another storage router in the cluster. At restart, the cluster determines any SCSI routing instances that should start on the storage router. If the storage router is identified as the preferred storage router for any SCSI routing instance (via the scsirouter primary command), that instance will start running on the storage router.

If the reboot command is issued with no keywords and there are unsaved changes to the current configuration, you can choose to either save all changes, save specific areas that have been modified, or reboot without saving any changes.

Use the force keyword to cause an immediate reboot of the storage router, discarding any unsaved configuration changes. Append the optional fast keyword to bypass diagnostics during the reboot sequence.

Examples

The following prompt is received if you issue a reboot command (without the force keyword) when the storage router has unsaved configuration changes.

[SN5420A]# reboot
*** Warning: This will reboot the system.
Do you want to continue? [yes/no (no)] yes

Changes have been made to the current configuration of the system which
have not been saved.
yes    - all of the configuration data will be saved,
no     - modifications to the configuration data will not be saved.

Save ALL configuration data? [yes/no (yes)] yes
Halting system.........

The following example reboots the storage router (after prompting the user to save any unsaved configuration changes) but bypasses diagnostics during the reboot process:

[SN5420A]# reboot fast


Related Commands

Command
Description

halt

Prepare the storage router to be powered down.

software version

Specify the version of software to run when the storage router is restarted.


restore aaa

To cause the AAA authentication configuration to be copied from the specified configuration file into persistent memory, use the restore aaa command. The configuration file must exist in the savedconfig directory. To display the contents of the savedconfig directory, issue the show savedconfig command.

restore aaa from filename

Syntax Description

from filename

The name of the configuration file containing the information to be restored. This file must exist in the savedconfig directory.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was implemented.


Usage Guidelines

The restore command overwrites all existing AAA configuration information, including any user name and passwords in the local username database, RADIUS and TACACS+ configuration information, and the default AAA authentication list used for iSCSI authentication.

Examples

The following example restores the AAA authentication configuration from the saved configuration file named aaa_backup:

[SN5420A]# restore aaa from aaa_backup

Related Commands

Command
Description

aaa authentication iscsi

Configure the AAA authentication services to be used for iSCSI authentication.

debug aaa

Enable debugging for the AAA authentication services.

delete savedconfig

Remove a saved configuration file from the storage router.

radius-server host

Configure remote RADIUS servers for AAA authentication services.

save aaa

Save the current AAA configuration information.

scsirouter authenticate

Enable iSCSI authentication for the named SCSI routing instance.

show aaa

Display AAA configuration information.

show savedconfig

List the contents of the savedconfig directory or the contents of the named configuration file.

tacacs-server host

Configure remote TACACS+ servers for AAA authentication services.


restore accesslist

To cause the named access list or all access lists to be copied from the specified configuration file into persistent memory, use the restore accesslist command. The configuration file must exist in the savedconfig directory. To display the contents of the savedconfig directory, issue the show savedconfig command.


Note If the storage router belongs to a cluster, the restored access list information will automatically be propagated to other members of that cluster.


restore accesslist {name | all} from filename

Syntax Description

name

The name of the access list to be restored.

all

Keyword to restore all access lists.

from filename

The name of the configuration file containing the information to be restored. This file must exist in the savedconfig directory.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

1.1.3

This command was introduced.

2.1.1

The command was changed to require the access list name or the keyword all.


Usage Guidelines

If the access list currently exists in some form, the restore command does not delete existing information. The restore command adds missing entries, or overwrites existing entries of the same name, but never purges or deletes existing access list entries. If necessary, you can delete an access list and all its entries and then restore it from a saved configuration file.


Note In a cluster environment, all access lists must be created and maintained on the first storage router to join the cluster. If you issue the restore accesslist command from another storage router in the cluster, the CLI displays an informational message with the IP address of the storage router that is currently handling all access list functions. For more information on operating the storage router in a cluster, see "Maintaining and Managing the Storage Router."


Examples

The following example restores the access list named fooList from the saved configuration file named accessList_backup:

[SN5420A]# restore accesslist fooList from accessList_backup

Related Commands

Command
Description

accesslist

Create an access list entity.

accesslist A.B.C.D/bits

Add IP addresses to an access list.

delete accesslist

Delete a specific access list entry or an entire access list.

restore all

Restore all the contents of the named configuration file into memory.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save accesslist

Save configuration data for the named access list or for all access lists.

save scsirouter

Save configuration information for the named SCSI routing instance.

save system

Save selected system configuration information.

scsirouter target accesslist

Associate an access list with a specific SCSI routing instance target or all targets.

show accesslist

Display the contents of the named access list or all access lists.

show savedconfig

List the contents of the savedconfig directory or the contents of the named configuration file.


restore all

To cause all the previously saved configuration information to be copied from the specified configuration file into persistent memory, use the restore all command. The configuration file must exist in the savedconfig directory. Use the show savedconfig command to display the contents of the savedconfig directory.


Note This command may change the running configuration of the storage router.


restore all from filename

Syntax Description

from filename

The name of the configuration file containing the information to be restored. This file must exist in the savedconfig directory.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

1.1.3

This command was introduced.


Usage Guidelines

The restore all command restores all information from the named configuration file. Depending on the information that is restored, the running configuration of the storage router will be changed.

A restore command may overwrite or delete existing items. However, the restore command will not purge or delete existing items from access lists, but will add missing items or overwrite existing items of the same name. If necessary, you may delete access lists, or any other item to be restored, before restoring from a saved configuration file.

SCSI routing instances must be stopped before they can be restored. Use the no scsirouter enable command to stop active SCSI routing instances.


Note In a cluster environment, all access lists and VLANs must be created and maintained on the first storage router to join the cluster. If you issue the restore all command from another storage router in the cluster, any saved access lists or VLANs will not be restored. The CLI displays an informational message with the IP address of the storage router that is currently handling all access list and VLAN functions. For more information on operating the storage router in a cluster, see "Maintaining and Managing the Storage Router."


Examples

The following example restores all configuration data contained in the configuration file named foo_backup into persistent memory:

[SN5420A]# restore all from foo_backup

Related Commands

Command
Description

failover scsirouter

Cause the named SCSI routing instance to cease running on the storage router.

fc-server enable

Start and stop the named FC server instance.

restore aaa

Restore AAA authentication services from a saved configuration file.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

restore system

Restore selected system information from the named configuration file.

restore vlan

Restore VLAN configuration information from the named configuration file.

save aaa

Save the current AAA configuration information.

save accesslist

Save configuration data for the named access list or all access lists.

save all

Save all configuration information.

save fc-server

Save configuration information for the named FC server instance.

save scsirouter

Save configuration information for the named SCSI routing instance.

save system

Save selected system configuration information.

save vlan

Save configuration information for the named VLAN or all VLANs.

scsirouter enable

Stop or start the named SCSI routing instance.

show savedconfig

List the contents of the savedconfig directory or the contents of the named configuration file.


restore scsirouter

To cause the previously saved configuration information related to the named SCSI routing instance to be copied from the specified configuration file into persistent memory, use the restore scsirouter command. The configuration file must exist in the savedconfig directory. Use the show savedconfig command to display the contents of the savedconfig directory.


Note This does not change the running configuration of the storage router.


restore scsirouter {name | all} from filename

Syntax Description

name

The name of the SCSI routing instance to be restored.

all

Keyword to restore all SCSI routing instances.

from filename

The name of the configuration file containing the information to be restored. This file must exist in the savedconfig directory.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

1.1.3

This command was introduced.

2.1.1

The command was changed to require name of the SCSI routing instance, or the keyword all.


Usage Guidelines

A SCSI routing instance must be inactive before it can be restored. Use the no scsirouter enable command to stop an active SCSI routing instance so it can be restored. After the specified SCSI routing instance is restored, issue the scsirouter enable command to start the instance and update the storage router's running configuration.

A restore command never deletes existing SCSI routing instances. The restore command will add missing instances and will overwrite configuration information for existing instances of the same name. If necessary, you can delete a SCSI routing instance and then restore it from a saved configuration file.

Examples

The following example restores the SCSI routing instance foo1 from the configuration file named scsi_backup001:

[SN5420A]# restore scsirouter foo1 from scsi_backup001

Related Commands

Command
Description

failover scsirouter

Cause the named SCSI routing instance to cease running on the storage router.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

restore all

Restore the contents of the named configuration file into memory.

save accesslist

Save configuration data for the named access list or all access lists.

save all

Save all configuration information.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter primary

Identify a storage router as the preferred storage router to run the named SCSI routing instance.

show savedconfig

List the contents of the savedconfig directory or the contents of the named configuration file.


restore system

To cause previously saved system configuration information to be copied from the specified configuration file into persistent memory, use the restore system command. The configuration file must exist in the savedconfig directory. Use the show savedconfig command to display the contents of the savedconfig directory.

restore system all from  filename

restore system {cdp |contactinfo | name-server | ntp | remotelog | restrict | snmp | software} from  filename

Syntax Description

all

Restore all restorable system information from the saved configuration file. Restorable system information includes CDP configuration, administrator contact data, DNS and NTP information, restrict configuration, remote logging data, and the default download location for updated storage router software.

cdp

Restore CDP configuration information.

contactinfo

Restore administrator contact information.

name-server

Restore DNS configuration information.

ntp

Restore NTP server configuration information.

remotelog

Restore remote logging configuration information, including the syslog host and the syslog facility.

restrict

Restore the storage router restrict configuration.

snmp

Restore SNMP configuration information.

software

Restore the default software download location and user name and password information for HTTP, proxy, and TFTP.

from filename

The name of the configuration file containing the information to be restored. This file must exist in the savedconfig directory.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

Some system information that is saved when the save system command is issued is not available for restoration from a saved configuration file. Use the show savedconfig command to display the contents of the specified configuration file. The following configuration information is available for display but cannot be restored:

Management and HA interface IP addresses

Fibre Channel and Gigabit Ethernet interface configuration information

Administrator mode and Monitor mode passwords

HA configuration mode

Examples

The following example restores all restorable system configuration information from the saved configuration file system_backup:

[SN5420A]# restore system all from system_backup

The following example restores the SNMP configuration information from the saved configuration file sys_SN5420A:

[SN5420A]# restore system snmp from sys_SN5420A

Related Commands

Commands
Description

delete savedconfig

Remove a saved configuration file from the storage router.

restore all

Restore the contents of the named configuration file into memory.

save all

Save all configuration information.

save system

Save selected system configuration information.

show savedconfig

List the contents of the savedconfig directory or the contents of the named configuration file.


restore vlan

To cause the specified VLAN to be copied from the named configuration file into persistent memory, use the restore vlan command. The configuration file must exist in the savedconfig directory. To display the contents of the savedconfig directory, issue the show savedconfig command.

restore vlan {all | vid} from filename

Syntax Description

all

Restore all VLAN definitions.

vid

The VLAN identification number.

from filename

The name of the configuration file containing the information to be restored. This file must exist in the savedconfig directory.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

If the VLAN currently exists, the restore vlan command overwrites existing configuration information with the information from the named configuration file. The restore vlan command also restores the VTP configuration information.


Note In a cluster environment, all VLANs must be created and maintained on the first storage router to join the cluster. If you issue the restore vlan command from another storage router in the cluster, any saved VLANs will not be restored. The CLI displays an informational message with the IP address of the storage router that is currently handling all VLAN functions. For more information on operating the storage router in a cluster, see "Maintaining and Managing the Storage Router."


Examples

The following example restores VLAN 100 from the vlanBackup file:

[SN5420A]# restore vlan 100 from vlanBackup

Related Commands

Command
Description

fc-server serverif

Assign a Gigabit Ethernet interface and IP address to the named FC server instance.

save vlan

Save configuration information for the named VLAN or all VLANs

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

show savedconfig

List the contents of the savedconfig directory or the contents of the named configuration file.

show vlan

Display configuration and operational information for the specified VLAN or all VLANs.

show vtp

Display configuration and operational information for VTP.

vlan

Configure a non-VTP VLAN on the storage router.

vtp domain

Assign a VTP domain name to the storage router.

vtp mode

Configure the storage router to operate in client or transparent VTP mode.


restrict

To close access to the specified interface via FTP, HTTP, SNMP, or Telnet, use the restrict command. To allow FTP, HTTP, SNMP, or Telnet access, use the no form of this command.

restrict all [service]

restrict interface {all | service}

no restrict all [service]

no restrict interface {all | service}

Syntax Description

all

Restrict all interface or all services.

interface

Restrict access to the specified interface. See Table 11-6 in the Usage Guidelines section for a list of interface names.

service

Restrict access via the specified service or protocol. See Table 11-7 in the Usage Guidelines section for a list of service names.


Defaults

The following are factory default settings:

FTP using port 21 is restricted on all interfaces

HTTP using port 80 is allowed on the management and HA interfaces. It is restricted on the Gigabit Ethernet interface. (HTTP access cannot be restricted on the management or HA interface.)

SNMP using port 161 is allowed on the management interface. It is restricted on the HA and Gigabit Ethernet interfaces.

Telnet using port 23 is allowed on the management interface only. It is restricted on the HA and Gigabit Ethernet interfaces.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

Use the restrict command to restrict unauthorized access to storage router interfaces. Use the show restrict command to display the current interface and service restrictions.

You can restrict access on the interfaces listed in Table 11-6.

Table 11-6 restrict interface 

Interface Keyword
Description

ge?

The storage router Gigabit Ethernet interface (including all logical interfaces created by associating a VLAN with a Gigabit Ethernet IP address for a SCSI routing instance). This interface is open to Telnet and HTTP by default.

ha

The storage router HA interface. This interface is open to Telnet and HTTP by default. HTTP access cannot be disabled for the HA interface.

mgmt

The storage router management interface. This interface is open to Telnet, SNMP and HTTP by default. HTTP access cannot be disabled for the management interface.


You can restrict access to the storage router interfaces by the services or protocols, shown in Table 11-7.

Table 11-7 restrict interface service 

Service Keyword
Description

ftp

File Transfer Protocol. FTP access is restricted on all interfaces, by default.

http

Hypertext Transfer Protocol. HTTP access is available on all interfaces, by default. It cannot be restricted on the management or HA interfaces.

snmp

Simple Network Management Protocol. SNMP is enabled on the management interface by default.

telnet

Telnet. Telnet access is enabled on all interfaces by default.


Examples

The following example restricts HTTP access to the Gigabit Ethernet interface, ge2:

[SN5420A]# restrict ge2 http

The following example restricts Telnet access to the HA interface:

[SN5420A]# restrict ha telnet

The following example restricts access to all interfaces via FTP.

[SN5420A]# restrict all ftp

Related Commands

Command
Description

restrict console

Enable or disable password checking on the storage router console interface.

show restrict

Display configurable security settings for the storage router's interfaces.


restrict console

To enable password checking on the storage router console interface, use the restrict console command. The Administrator mode and Monitor mode passwords will be required when accessing the storage router via a console connected to the RS-232 port. To disable password checking on the console interface, use the no form of this command.

restrict console

no restrict console

Syntax Description

This command has no arguments or keywords.

Defaults

Passwords are disabled on the console interface.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

Use this command if you need to restrict access to the storage router's console interface.

Examples

The following example enabled password checking on the storage router's console interface:

[SN5420A]# restrict console

Related Commands

Command
Description

restrict

Secure access to storage router interfaces by communications protocols and services.

show restrict

Display configurable security settings for the storage router's interfaces.


save aaa

To save the current AAA settings to nonvolatile memory, use the save aaa command.

save aaa {bootconfig | filename}

Syntax Description

bootconfig

Save the AAA settings to the storage router's bootable configuration, which is used when the SN 5420 Storage Router is restarted.

filename

The name of the file where the AAA configuration information will be written. This file is stored in the savedconfig directory.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

You must save configuration data from the running configuration to the bootable configuration for it to be retained in the storage router when it is restarted. Use the filename parameter to save the AAA configuration to a file. Configurations saved to a file can be moved between storage routers and can be restored at a later time.

The following information is saved:

The AAA authentication list

The username database

All RADIUS server configuration information

All TACACS+ server configuration information

Examples

The following example saves the running AAA settings to the bootable configuration, used when the storage router is restarted:

[SN5420A]# save aaa bootconfig

The following example saves the running AAA settings to a file named aaa_SN5420A:

[SN5420A]# save aaa aaa_SN5420A

Related Commands

Command
Description

aaa authentication iscsi

Configure the AAA authentication services to be used for iSCSI authentication.

aaa test authentication

Enable testing of the default AAA authentication list.

debug aaa

Enable debugging for the AAA authentication services.

delete savedconfig

Remove a saved configuration file from the storage router.

radius-server host

Configure remote RADIUS servers for AAA authentication services.

restore aaa

Restore AAA authentication services from a saved configuration file.

save accesslist

Save configuration data for the named access list or for all access lists.

save all

Save all configuration information.

save fc-server

Save configuration information for the named FC server instance.

save scsirouter

Save configuration information for the named SCSI routing instance.

save system

Save selected system configuration information.

save vlan

Save configuration information for the named VLAN or all VLANs.

scsirouter authenticate

Enable iSCSI authentication for the named SCSI routing instance.

show aaa

Display AAA configuration information.

show savedconfig

List the contents of the savedconfig directory or the contents of the named configuration file.

tacacs-server host

Configure remote TACACS+ servers for AAA authentication services.

username password

Add a user name and optional password to the local username database.


save accesslist

To save configuration data to nonvolatile memory for the named accesslist or for all access lists, use the save accesslist command.

save accesslist {name | all} {bootconfig | filename}

Syntax Description

name

The name of the access list to be saved.

all

Save all access lists associated with this storage router.

bootconfig

Save the access list from the running configuration to the storage router's bootable configuration, used when the SN 5420 Storage Router is restarted.

filename

The name of the file where the running access list configuration data will be written. This file is stored in the savedconfig directory.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

1.1.3

This command was introduced.

2.1.1

The bootconfig keyword was added.


Usage Guidelines

You must save configuration data from the running configuration to the bootable configuration for it to be retained in the storage router when it is restarted. Configurations saved to a file can be moved between storage routers, and can be restored at a later time.


Note In a cluster environment, all access lists must be created and maintained on the first storage router to join the cluster. If you issue the save accesslist command from another storage router in the cluster, the CLI displays an informational message with the IP address of the storage router that is currently handling all access list functions. For more information on operating the storage router in a cluster, see "Maintaining and Managing the Storage Router."


Examples

The following example saves the current configuration for all access lists to the bootable configuration, used when the storage router is restarted:

[SN5420A]# save accesslist all bootconfig

The following example saves the access list fooList to a configuration file named fooList_SN5420A:

[SN5420A]# save accesslist fooList fooList_SN5420A

Related Commands

Command
Description

accesslist

Create an access list entity.

accesslist A.B.C.D/bits

Add IP addresses to an access list.

delete accesslist

Delete a specific access list entry or an entire access list.

delete savedconfig

Remove a saved configuration file from the storage router.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

save aaa

Save the current AAA configuration information.

save all

Save all configuration information.

save fc-server

Save configuration information for the named FC server instance.

save scsirouter

Save configuration information for the named SCSI routing instance.

save system

Save selected system configuration information.

save vlan

Save configuration information for the named VLAN or all VLANs.

scsirouter target accesslist

Associate an access list with a specific SCSI routing instance target or all targets.

show accesslist

Display the contents of the named access list or all access lists.

show savedconfig

List the contents of the savedconfig directory or the contents of the named configuration file.


save all

To save all configuration data for a storage router to nonvolatile memory, use the save all command.

save all {bootconfig | filename}

Syntax Description

bootconfig

Save the current running configuration information to the storage router's bootable configuration, used when the SN 5420 Storage Router is restarted.

filename

The name of the file where the configuration data will be written. This file is stored in the savedconfig directory.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

1.1.3

This command was introduced.

2.1.1

The bootconfig keyword was added.


Usage Guidelines

You must save configuration data from the running configuration to the bootable configuration for it to be retained in the storage router when it is restarted. Depending on the storage router deployment, the save all command saves AAA configuration, SCSI routing instances or FC server instances, access lists, VLANs, and selected system configuration information. Configurations saved to a file can be moved between storage routers and can be restored at a later time.


Note In a cluster environment, all access lists and VLANs must be created and maintained on the first storage router to join the cluster. If you issue the save all command from another storage router in the cluster, the CLI displays an informational message with the IP address of the storage router that is currently handling all access list and VLAN functions. For more information on operating the storage router in a cluster, see "Maintaining and Managing the Storage Router."


Examples

The following example saves the current running configuration to the bootable configuration, used when the storage router is restarted:

[SN5420A]# save all bootconfig

The following example saves the current running configuration to the file named SN5420A_03Nov2001. You may want to do this as a means of archiving the current running configuration of the storage router on a regular basis.

[SN5420A]# save all SN5420A_03Nov2001

Related Commands

Command
Description

delete savedconfig

Remove a saved configuration file from the storage router.

restore all

Restore the contents of the named configuration file into memory.

save aaa

Save current AAA configuration information.

save accesslist

Save configuration data for the named access list or for all access lists.

save fc-server

Save configuration information for the named FC server instance.

save scsirouter

Save configuration information for the named SCSI routing instance.

save system

Save selected system configuration information.

save vlan

Save configuration information for the named VLAN or all VLANs.

show savedconfig

List the contents of the savedconfig directory or the contents of the named configuration file.


save fc-server

To save all configuration data associated with the named FC server instance to nonvolatile memory, use the save fc-server command.

save fc-server {name | all} {bootconfig | filename}

Syntax Description

name

The name of the FC server instance.

all

Save configuration data for all FC server instances.

bootconfig

Save the FC server instance from the running configuration to the storage router's bootable configuration, used when the SN 5420 Storage Router is restarted.

filename

The name of the file where the configuration data will be written. This file is stored in the savedconfig directory.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Maintenance

2.1.1

This command was introduced.


Usage Guidelines

You must save configuration data from the running configuration to the bootable configuration for it to be retained in the storage router when it is restarted. Configurations saved to a file can be moved between storage routers and can be restored at a later time.

Examples

The following example saves the FC server instance defaultFC currently running on this storage router to the bootable configuration, used when the storage router is restarted:

[SN5420B]# save fc-server defaultFC bootconfig

Related Commands

Commands
Description

delete savedconfig

Remove a saved configuration file from the storage router.

delete fc-server

Delete the specified element from the named FC server instance or all FC server instances.

save aaa

Save the current AAA configuration information.

save accesslist

Save configuration data for the named access list or all access lists.

save all

Save all configuration information.

save scsirouter

Save configuration information for the named SCSI routing instance.

save system

Save selected system configuration information.

save vlan

Save configuration information for the named VLAN or all VLANs.

show savedconfig

List the contents of the savedconfig directory or the contents of the named configuration file.


save scsirouter

To save all configuration data associated with the named SCSI routing instance to nonvolatile memory, use the save scsirouter command.

save scsirouter {name | all} {bootconfig | filename}

Syntax Description

name

The name of the SCSI routing instance.

all

Save configuration data for all SCSI routing instances.

bootconfig

Save the SCSI routing instance from the running configuration to the storage router's bootable configuration, used when the SN 5420 Storage Router is restarted.

filename

The name of the file where the configuration data will be written. This file is stored in the savedconfig directory.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Maintenance

1.1.3

This command was introduced.

2.1.1

The bootconfig keyword was added.


Usage Guidelines

You must save configuration data from the running configuration to the bootable configuration for it to be retained in the storage router when it is restarted. Configurations saved to a file can be moved between storage routers and can be restored at a later time.

In a cluster environment, a storage router that is currently running a SCSI routing instance is known as the current primary for that instance. The SCSI routing instance can only be saved on the storage router that is the current primary for that instance.

Examples

The following example saves all SCSI routing instances currently running on this storage router to the bootable configuration, used when the storage router is restarted:

[SN5420A]# save scsirouter all bootconfig

The following example saves the SCSI routing instance named foo to the file named foo_SN5420A:

[SN5420A]# save scsirouter foo foo_SN5420A

Related Commands

Commands
Description

delete savedconfig

Remove a saved configuration file from the storage router.

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save aaa

Save the current AAA configuration information.

save accesslist

Save configuration data for the named access list or all access lists.

save all

Save all configuration information.

save fc-server

Save configuration information for the named FC server instance.

save system

Save selected system configuration information.

save vlan

Save configuration information for the named VLAN or all VLANs.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

setup scsi

Run the wizard to configure a SCSI routing instance.

show savedconfig

List the contents of the savedconfig directory or the contents of the named configuration file.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


save system

To save selected system configuration information to nonvolatile memory, use the save system command.

save system {bootconfig | filename}

Syntax Description

bootconfig

Save the current running system configuration to the storage router's bootable configuration, used when the SN 5420 Storage Router is restarted.

filename

The name of the file where the system configuration data will be written. This file is stored in the savedconfig directory.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

1.1.3

This command was introduced.

2.1.1

The bootconfig keyword was added.


Usage Guidelines

You must save configuration data from the running configuration to the bootable configuration for it to be retained in the storage router when it is restarted. Configurations saved to a file can be moved between storage routers and can be restored at a later time.

The following system configuration data is saved:

Monitor and Administrative passwords

Administrative contact information

Network Time Protocol (NTP) server name

Primary and optional secondary Domain Name Server (DNS)

Default location for downloading SN 5420 software

System and cluster name

Management and high availability (HA) interface addresses

Static routes

SNMP settings

CDP settings

Restrict settings

Remote logging settings

Examples

The following example saves the current system configuration to the bootable configuration, used when the storage router is restarted:

[SN5420A]# save system bootconfig

The following example copies the current system configuration to the file named sys_SN5420A:

[SN5420A]# save system sys_SN5420A

Related Commands

Commands
Description

delete savedconfig

Remove a saved configuration file from the storage router.

hostname

Specify the storage router's system name.

restore system

Restore selected system information from the named configuration file.

save aaa

Save the current AAA configuration information.

save accesslist

Save configuration data for the named access list or all access lists.

save all

Save all configuration information.

save fc-server

Save configuration information for the named FC server instance or all FC server instances.

save scsirouter

Save configuration information for the named SCSI routing instance.

save vlan

Save configuration information for the named VLAN or all VLANs.

show savedconfig

List the contents of the savedconfig directory or the contents of the named configuration file.

show system

Display selected system information, including system name.


save vlan

To save VLAN and VTP configuration information for the specified VLAN or for all VLANs to nonvolatile memory, use the save vlan command.

save vlan {vid | all} {bootconfig | filename}

Syntax Description

vid

The VLAN identification number of the VLAN configuration to be saved.

all

Save all VLANs associated with this storage router.

bootconfig

Save the current VLAN configuration to the system's bootable configuration, to be used when the storage router is restarted.

filename

The name of the file where the current VLAN configuration data will be written. This file is stored in the savedconfig directory.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

You must save configuration data from the running configuration to the bootable configuration for it to be retained in the storage router when it is restarted. Configurations saved to a file can be moved between storage routers and can be restored at a later time.

VTP mode and domain information is saved, along with the specified VLAN configuration information.


Note In a cluster environment, all VLANs must be created and maintained on the first storage router to join the cluster. If you issue the save VLAN command from another storage router in the cluster, the CLI displays an informational message with the IP address of the storage router that is currently handling all VLAN functions. For more information on operating the storage router in a cluster, see "Maintaining and Managing the Storage Router."


Examples

The following example saves the current configuration for all VLANs to the system's bootable configuration, to be used when the storage router is restarted:

[SN5420A]# save vlan all bootconfig

The following example saves VLAN 12 to the file named vlanbackup:

[SN5420A]# save vlan 12 vlanbackup

Related Commands

Command
Description

restore vlan

Restore VLAN configuration information from the named configuration file.

save aaa

Save current AAA configuration information.

save accesslist

Save configuration data for the named access list or all access lists.

save all

Save all configuration information.

save fc-server

Save configuration information for the named FC server instance.

save scsirouter

Save configuration information for the named SCSI routing instance.

save system

Save selected system configuration information.

show savedconfig

List the contents of the savedconfig directory or the contents of the named configuration file.

show vlan

Display configuration and operational information for the specified VLAN or all VLANs.

show vtp

Display configuration and operational information for VTP.

vlan

Configure a non-VTP VLAN on the storage router.

vtp domain

Assign a VTP domain name to the storage router.

vtp mode

Configure the storage router to operate in client or transparent VTP mode.


scsirouter

To create a SCSI routing instance, use the scsirouter command.

scsirouter name

Syntax Description

name

The name of the SCSI routing instance created by this command. Enter a maximum of 31 characters.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the create scsirouter command.


Usage Guidelines

SCSI routing is the routing of SCSI requests and responses between IP hosts or FC server instances in an IP network and storage devices in a storage network. The SCSI routing instance becomes a binding point for the association of other configuration parameters. A SCSI routing instance provides IP hosts and FC server instances access to storage devices

There can be a maximum of 12 SCSI routing instances defined per storage router; if the storage router is a member of a cluster, no more than 12 instances can be defined across the cluster.


Note If the storage router is deployed for transparent SCSI routing, there can be only one SCSI routing instance. The SCSI routing instance is named transparent and is automatically created during initial system configuration.


Examples

The following command creates a SCSI routing entity named myCompanyWebserver2.

[SN5420A]# scsirouter myCompanyWebserver2

Related Commands

Command
Description

accesslist

Create an access list entity.

accesslist A.B.C.D/bits

Add IP addresses to an access list.

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

failover scsirouter

Cause the named SCSI routing instance to cease running on the storage router.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save accesslist

Save configuration data for the named access list or all access lists.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter authenticate

Enable iSCSI authentication for the named SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

setup scsi

Run the wizard to configure a SCSI routing instance.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter authenticate

To enable iSCSI authentication using AAA authentication services for the named SCSI routing instance, use the scsirouter authenticate command.

scsirouter name authenticate {no | yes}

Syntax Description

name

The name of this SCSI routing instance.

no

Disable AAA authentication for the named SCSI routing instance.

yes

Enable AAA authentication for the named SCSI routing instance.


Defaults

AAA authentication is disabled.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

Use the scsirouter authenticate command to enable iSCSI authentication for IP hosts and FC server instances requesting access to storage devices using the named SCSI routing instance. AAA performs authentication using the services configured on the iSCSI authentication list. Use the aaa authentication iscsi command to configure the iSCSI authentication list.


Note If authentication is enabled for a SCSI routing instance, but no AAA authentication list is available, AAA attempts to use the "local" authentication method.


Examples

The following example enables iSCSI authentication for the SCSI routing instance named foo:

[SN5420A]# scsirouter foo authenticate yes

Related Commands

Command
Description

aaa authentication iscsi

Configure the AAA authentication services to be used for iSCSI authentication.

debug aaa

Enable debugging for the AAA authentication services.

radius-server host

Configure remote RADIUS servers for AAA authentication services.

restore aaa

Restore AAA authentication services from a saved configuration file.

save aaa

Save the current AAA configuration information.

save scsirouter

Save configuration information for the named SCSI routing instance.

show aaa

Display AAA configuration information.

tacacs-server host

Configure remote TACACS+ servers for AAA authentication services.

username password

Add a user name and optional password to the local username database.


scsirouter description

To add user-defined identification information to the named SCSI routing instance, use the scsirouter description command.

scsirouter name description "user text"

Syntax Description

name

The name of this SCSI routing instance.

description "user text"

User-defined identification information associated with this SCSI routing instance. If the string contains spaces, enclose it in quotes. Enter a maximum of 64 characters.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set scsirouter description command.


Usage Guidelines

The scsirouter description command allows you to add a new description or change an existing description. Descriptions are site-specific.

Examples

The following example adds the description "Access to WebServer4 WebServer5" to the SCSI routing instance foo1:

[SN5420A]# scsirouter foo1 description "Access to WebServer4 WebServer5"

Related Commands

Command
Description

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

setup scsi

Run the wizard to configure a SCSI routing instance.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter deviceif

To assign a Fibre Channel interface to the named SCSI routing instance, use the scsirouter deviceif command.The specified interface acts as the SCSI protocol initiator to the storage devices.

scsirouter name deviceif fc?

Syntax Description

name

Name of the SCSI routing instance to which you are adding the Fibre Channel interface.

deviceif fc?

The name of the Fibre Channel interface. When you type the scsirouter deviceif command, followed by ?, the CLI lists the interfaces available. You cannot specify a nonexistent interface.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the add scsirouter deviceif command.


Usage Guidelines

Each SCSI routing instance requires three active elements:

The deviceif element specifies the interface available for the storage devices or other devices on a Fibre Channel network. The instance becomes active when this interface is added.

The serverif element assigns an interface and IP address for use by the IP hosts and FC server instances requiring IP access to storage devices.

The target element is a complex item that specifies the mapping between LUNs on the storage devices and the host systems.

Examples

The following example assigns the Fibre Channel interface fc1 to the SCSI routing instance named foo2:

[SN5420A]# scsirouter foo2 deviceif fc1

Related Commands

Command
Description

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

setup scsi

Run the wizard to configure a SCSI routing instance.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter enable

To start the named SCSI routing instance on this storage router, use the scsirouter enable command. To stop the named SCSI routing instance, use the no form of this command.

scsirouter {name | all} enable

no scsirouter {name | all} enable

Syntax Description

name

The name of the SCSI routing instance to be started.

all

Start all SCSI routing instances on this storage router.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the start scsirouter and stop scsirouter commands.


Usage Guidelines

SCSI routing instances that are in a stopped state are not running anywhere in the cluster. To restart a stopped SCSI routing instance, use the scsirouter enable command. Use the all keyword to start all instances on the storage router. All instances previously stopped on this storage router or available instances not running elsewhere in the cluster will start on this storage router.

Under normal circumstances, the SCSI routing instance can only be started from the storage router on which it was stopped.

Use the scsirouter enable command to bring a restored SCSI routing instance into the running configuration. A restored instance must be started before you can make any additional configuration changes to that instance.


Note SCSI routing instances are automatically started by the storage router when the Fibre Channel interface is added. See the scsirouter deviceif command for additional information.


Examples

The following example starts the SCSI routing instance named foo2. This instance must have been previously stopped.

[SN5420A]# scsirouter foo2 enable

The following example stops all SCSI routing instances running on the storage router:

[SN5420A]# no scsirouter all enable

Related Commands

Command
Description

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

failover scsirouter

Cause the named SCSI routing instance to cease running on the storage router.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter primary

Identify a storage router as the preferred storage router to run the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

setup scsi

Run the wizard to configure a SCSI routing instance.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter failover

To build a list of storage routers to be used for failover purposes, use the scsirouter failover command.

scsirouter name failover {primary | secondary} sysname

Syntax Description

name

The name of the SCSI routing instance.

primary sysname

The name of a storage router in the cluster. In case of failure, the specified SCSI routing instance will be failed over to this storage router.

secondary sysname

(Optional) The name of a storage router in the cluster. If the primary storage router in the list cannot run the SCSI routing instance, it will be failed over to this storage router.


Defaults

None. By default, the HA failover list is not populated.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

Use the scsirouter failover command to build a list of storage routers that will be used during the failover process. If the specified SCSI routing instance fails over, the cluster attempts to start running the instance on the storage router designated as the primary in the HA failover list. If that storage router cannot run the SCSI routing instance, the cluster will attempt to start the instance on the storage router designated as the secondary in the HA failover list.

If there is no primary or secondary storage router on the HA failover list when the SCSI routing instance fails over, the cluster attempts to run the instance on the first storage router that is available.

The storage routers specified as primary and secondary should be active in the cluster when the command is issued. If the specified storage router is not currently active in the cluster, the setting will not take affect until the storage router is added to the cluster and the SCSI routing instance is restarted.

Use the clear scsirouter failover command to remove the current primary or secondary storage router from the HA failover list.


Note This command causes the SCSI routing instance configuration information to be saved and all nodes in the cluster to be updated.


Examples

The following example builds the HA failover list for the SCSI routing instance named foo. The primary storage router in the HA failover list is SN5420A and the secondary is SN5420B.

[SN5420A]# scsirouter foo failover primary SN5420A 
*[SN5420A]# scsirouter foo failover secondary SN5420B

Related Commands

Command
Description

clear scsirouter failover

Remove the designated primary or secondary storage router from the HA failover list for the specified SCSI routing instance.

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

failover scsirouter

Cause the named SCSI routing instance to cease running on the storage router.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter primary

Identify a storage router as the preferred storage router to run the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

setup scsi

Run the wizard to configure a SCSI routing instance.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter log

To set the event-logging threshold for trace and debug messages related to the specified SCSI routing instance, use the scsirouter log command.

scsirouter name log notification-level

Syntax Description

name

The name of the SCSI routing instance to be logged at the specified level.

notification-level

Limit logging to messages of a specified level or lower levels. See Table 11-8 in the Usage Guidelines section for valid names that can be used for the notification-level argument.


Defaults

None.

Command Modes

Administration.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set scsirouter loglevel command.


Usage Guidelines

This setting controls the event-logging threshold level of trace and debug messages that will occur for the specified SCSI routing instance when trace is enabled. If trace is enabled, this setting may impact all system performance. The scsirouter log command should only be used under the guidance of a Cisco Technical Support professional.

Specifying a threshold causes messages at that level and numerically lower levels to be logged. Table 11-8 lists the valid names that can be used for the notification-level argument and information about those levels.

Table 11-8 Error Message Logging Priorities and Corresponding Level Names and Numbers

Notification Level
Level Number
Description
Syslog Definition

emergencies

0

System unusable

LOG_EMERG

alerts

1

Immediate action needed

LOG_ALERT

critical

2

Critical conditions

LOG_CRIT

errors

3

Error conditions

LOG_ERR

warnings

4

Warning conditions

LOG_WARNING

notification

5

Normal but significant condition

LOG_NOTICE

informational

6

Informational messages only

LOG_INFO

debugging

7

Debugging messages

LOG_DEBUG


Examples

The following example sets the event-logging level to critical for all debug and trace messages related to SCSI routing instance named foo2. This means that only emergency messages, alerts, and critical debug and trace messages will be logged for this instance.

[SN5420A]# scsirouter foo2 log critical

Related Commands

Command
Description

debug scsirouter

Enable debugging for the named SCSI routing instance.

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter primary

Identify a storage router as the preferred storage router to run the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

setup scsi

Run the wizard to configure a SCSI routing instance.

show debug

Display debug trace information for the specified SCSI routing instance.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter lun reset

To specify that "LUN reset" rather than "clear task" commands will be sent to storage devices opened by the specified SCSI routing instance, use the scsirouter lun reset command.

scsirouter name lun reset {yes | no}

Syntax Description

name

The name of the SCSI routing instance. The specified SCSI routing instance must be running on a storage router in a cluster.

yes

Send "lun reset" to storage devices when they are opened.

no

Send "clear task" to storage devices when they are opened.


Defaults

The default is to send "clear task" command to storage devices.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

It is preferable to send "LUN reset" commands if the device supports them. The specified SCSI routing instance must be running on a storage router in a cluster.

Examples

The following example enables "LUN resets" to all storage devices opened by the SCSI routing instance foo2:

[SN5420A]# scsirouter foo2 lun reset yes

Related Commands

Command
Description

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter primary

Identify a storage router as the preferred storage router to run the named SCSI routing instance.

scsirouter reserveproxy

Enable the SCSI reserve/release commands for the specified SCSI routing instance and specify whether these commands are forwarded to the storage device.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

setup scsi

Run the wizard to configure a SCSI routing instance.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter primary

To assign the storage router as the preferred storage router for the named SCSI routing instance, use the scsirouter primary command.

scsirouter name primary {sysname | none}

Syntax Description

name

The name of this SCSI routing instance.

primary sysname

The system name of the preferred storage router.

primary none

Indicate no preferred storage router for this SCSI routing instance.


Defaults

The default primary attribute is none.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set scsirouter primary command.


Usage Guidelines

At any given time, a SCSI routing instance can run on only one storage router in a cluster. If a SCSI routing instance has the primary attribute set, the specified storage router (upon system restart) will take over running that instance. Use the scsirouter primary command if you always want the specified SCSI routing instance to run on a specific storage router in a cluster whenever that storage router is available.

If the primary attribute is not set (the default condition), the SCSI routing instance continues running on the storage router where it was started until it is explicitly stopped (via a no scsirouter enable command), it automatically fails over to another storage router in the cluster because an interface is unavailable or a system failure occurs, or an explicit failover scsirouter command is issued.


Note Setting the primary attribute does not change the existing cluster state and does not immediately change the location of a running SCSI routing instance.


For additional information about HA, cluster configuration, and managing SCSI routing instances in a cluster environment, see "Configuring a Storage Router Cluster," and "Maintaining and Managing the Storage Router."

Examples

The following command designates the storage router LabRouter1 as the storage router on which the SCSI routing instance named foo will always, under normal conditions, run.

[SN5420A]# scsirouter foo primary LabRouter1

The following example resets the primary attribute for the SCSI routing instance named foo2. The instance named foo2 will continue to run on the storage router where it was started until it is explicitly stopped, it automatically fails over, or an explicit failover scsirouter command is issued.

[SN5420A]# scsirouter foo2 primary none

Related Commands

Command
Description

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter failover

Add a storage router to the HA failover list for the specified SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

setup scsi

Run the wizard to configure a SCSI routing instance.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter reserveproxy

To configure the SCSI routing instance to use SCSI reserve/release commands and to specify whether these commands are forwarded to the storage target, use the scsirouter reserveproxy command.

scsirouter name reserveproxy {enable passthru {yes | no} | disable}

Syntax Description

name

The name of the SCSI routing instance.

enable passthru yes

Configure the SCSI routing instance to use SCSI reserve and release commands and enable forwarding of these commands to storage devices.

enable passthru no

Configure the SCSI routing instance to use SCSI reserve and release commands but disable forwarding of these commands to storage devices.

disable

Disable the reserve proxy feature for the named SCSI routing instance.


Defaults

Reserve-proxy passthru is disabled.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set scsirouter reserveproxy command.


Usage Guidelines

The SCSI reserve/release command allows an initiator to reserve the storage device for its own use. Attempts to access the storage device from other initiators are rejected until the first initiator releases the storage device. If this feature is enabled using the scsirouter reserveproxy command, the storage router keeps track of the reserved status of target LUNs and returns the appropriate SCSI command status to other initiators that issue SCSI commands to that target LUN.


Note This functionality does not apply to operating systems (such as Windows NT) which do not utilize the SCSI Reserve command.


Examples

The following example configures the SCSI routing instance foo2 to use SCSI reserve and release commands and enables forwarding of these commands to storage devices:

[SN5420A]# scsirouter foo2 reserveproxy enable passthru yes

Related Commands

Command
Description

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter failover

Add a storage router to the HA failover list for the specified SCSI routing instance.

scsirouter lun reset

Configure the named SCSI routing instance to send a "LUN reset" command when opening all targets.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

setup scsi

Run the wizard to configure a SCSI routing instance.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter serverif

To assign a Gigabit Ethernet interface and IP address to the named SCSI routing instance, use the scsirouter serverif command. The specified interface allows IP hosts and FC server instances access to storage devices.

scsirouter name serverif ge? {A.B.C.D/bits | A.B.C.D/1.2.3.4}

scsirouter name serverif ge? vlan vid {A.B.C.D/bits | A.B.C.D/1.2.3.4}

Syntax Description

name

Name of the SCSI routing instance to which you are adding the Gigabit Ethernet interface.

serverif ge?

The name of the interface. When you type the scsirouter serverif command, followed by ?, the CLI lists the interfaces available. You cannot specify a nonexistent interface.

A.B.C.D/bits

The IP address of the named interface. If the keyword vlan is used, the IP address is part of the specified VLAN. A.B.C.D is the dotted quad notation of the IP address. The /bits specifies the subnet mask in CIDR style.

A.B.C.D/1.2.3.4

The IP address of the named interface. If the keyword vlan is used, the IP address is part of the specified VLAN. A.B.C.D is the dotted quad notation of the IP address. 1.2.3.4 is the dotted quad notation of the subnet mask.

vlan vid

The keyword and the VLAN identifier.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set scsirouter serverif command.


Usage Guidelines

The specified interface IP address is configured on IP hosts and FC server instances requiring IP access to storage through the SN 5420 Storage Router.

Each SCSI routing instance requires three active elements:

The deviceif element specifies the interface available for the storage devices or other devices on a Fibre Channel network. The instance becomes active when this interface is added.

The serverif element assigns an interface and IP address for use by the IP hosts and FC server instances requiring IP access to storage resources.

The target element is a complex item that specifies the mapping between LUNs on the storage devices and the host systems.

The scsirouter serverif vlan command is used to associate a VLAN with a SCSI routing instance. All traffic using the specified Gigabit Ethernet interface will be considered as part of the VLAN; all IP hosts accessing storage through the storage router using the specified Gigabit Ethernet interface IP address must connect as part of the specified VLAN.

When the SCSI routing instance is started, a logical interface (for example, ge2VLAN100) is created, which incorporates the physical interface and the VID. This logical interface can be displayed via the show interface command and can be used when adding static routes to the system.

Examples

The following command adds the Gigabit Ethernet interface ge2, with the IP address 10.1.10.255/24, to the SCSI routing instance named foo2.

[SN5420A]# scsirouter foo2 serverif ge2 10.1.10.255/24

The following command adds the Gigabit Ethernet interface ge2 and VLAN ID 45, with IP address 10.1.30.255/24, to the SCSI routing instance fooA:

[SN5420A]# scsirouter fooA serverif ge2 vlan 45 10.1.30.255/24

Related Commands

Command
Description

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

setup scsi

Run the wizard to configure a SCSI routing instance.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter target accesslist

To associate the named access list with the specified target, use the scsirouter target accesslist command.

scsirouter name target {name | all} accesslist {name | all | none}

Syntax Description

name

The name of the SCSI routing instance to which this target belongs.

target name

The name of the storage target to associate with this access list. The target must already exist.

target all

Associate all targets with the named access list.

accesslist name

The name of the access list to associate with this storage target.

accesslist none

Prevent any new connections or logins to this target from any IP hosts or FC server instances. This is effectively "no access."

accesslist all

Allow connections and logins for the specified target from all IP hosts and FC server instances. This is effectively "open access."


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set scsirouter target accesslist command.


Usage Guidelines

An access list specifies the IP addresses of IP hosts and FC server instances allowed to access the associated storage target through the storage router. Access lists are associated with specific storage targets. Use the target all form of this command to create an association between the specified access list and all targets.

Use the reserved access list name none to remove any access list associations for the specified target. This effectively prevents access to this storage target from any IP host or FC server instance.

Use the reserved access list name all to allow access to this storage target from any IP host or FC server instance.This is effectively "open access."

Existing connections and logins are not affected by an access list change. However, if there are existing connections, the storage router issues a warning message with that information in response to this command.


Note When making changes to SCSI routing instances (such as adding or deleting targets or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of IP hosts using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers and readme and example configuration files from Cisco.com.


Examples

The following example creates an association between the storage target webserver4 (accessed via SCSI routing instance foo) and the access list webserver2.

[SN5420A]# scsirouter foo target webserver4 accesslist webserver2

The following example provides all IP hosts and FC server instances open access to all targets accessed via SCSI routing instance LabA:

[SN5420A]# scsirouter LabA target all accesslist all

Related CommandsThe

Command
Description

accesslist

Create an access list entity.

accesslist A.B.C.D/bits

Add IP addresses to an access list.

delete accesslist

Delete a specific access list entry or an entire access list.

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save accesslist

Save configuration data for the named access list or all access lists.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter primary

Identify a storage router as the preferred storage router to run the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

setup scsi

Run the wizard to configure a SCSI routing instance.

show accesslist

Display the contents of the named access list or all access lists.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter target description

To add a description to the named target, use the scsirouter target description command.

scsirouter name target name description "user text"

Syntax Description

name

The name of the SCSI routing instance to which this target belongs.

target name

The name of the storage target.

description "user text"

User-defined identification information associated with this storage target. If the description contains spaces, enclose the string in quotes. Enter a maximum of 64 characters.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set scsirouter target description command.


Usage Guidelines

Target description information is an optional attribute of a SCSI routing instance. Use the show scsirouter command to display target description information.

Examples

The following example adds a description to the storage target webserver4, accessed through the SCSI routing instance foo:

[SN5420A]# scsirouter foo target webserver4 description "Web databases"

Related CommandsThe

Command
Description

accesslist

Create an access list entity.

accesslist A.B.C.D/bits

Add IP addresses to an access list.

delete accesslist

Delete a specific access list entry or an entire access list.

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save accesslist

Save configuration data for the named access list or all access lists.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter primary

Identify a storage router as the preferred storage router to run the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

scsirouter target accesslist

Associate an access list with a specific SCSI routing instance target or all targets.

setup scsi

Run the wizard to configure a SCSI routing instance.

show accesslist

Display the contents of the named access list or all access lists.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter target {enabled | disabled}

To allow or disallow connections and logins for the named target, use the scsirouter target command.

scsirouter name target {name | all} {enabled | disabled}

Syntax Description

name

The name of the SCSI routing instance to which this target belongs.

target name

The name of the storage target.

target all

Allow connections for all targets of this SCSI routing instance to be enabled or disabled.

enabled

Allow connections and logins for the named target or for all targets of the specified SCSI routing instance.

disabled

Prevent new connections and logins for the named target or for all targets of the specified SCSI routing instance.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the set scsirouter target enable command.


Usage Guidelines

When you add a target to a SCSI routing instance, it is by default enabled. However, no access list is associated with the target, thus effectively preventing any access to the storage target from any IP hosts or FC server instances. When you associate an access list with a target, the specified connections and logins are allowed. Use the scsirouter target command enabled and disabled keywords to control access without changing the target access list association.

Existing connections and logins are not affected by the disabled keyword, but future connections and logins are not allowed. If existing IP hosts and FC server instances are connected, the storage router issues a warning message with that information in response to this command.

Use the reserved target name all to enable or disable connections for all targets of this SCSI routing instance.


Note When making changes to SCSI routing instances (such as adding or deleting targets or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of IP hosts using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers and readme and example configuration files from Cisco.com.


Examples

The following example enables connections for all targets of the SCSI routing instance scsiA.

[SN5420A]# scsirouter scsiA target all enabled

Related CommandsThe

Command
Description

accesslist

Create an access list entity.

accesslist A.B.C.D/bits

Add IP addresses to an access list.

delete accesslist

Delete a specific access list entry or an entire access list.

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save accesslist

Save configuration data for the named access list or all access lists.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter primary

Identify a storage router as the preferred storage router to run the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

scsirouter target accesslist

Associate an access list with a specific SCSI routing instance target or all targets.

setup scsi

Run the wizard to configure a SCSI routing instance.

show accesslist

Display the contents of the named access list or all access lists.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter target {loopid | serial | lunwwn | wwpn} #?

To use an index method of mapping a logical target or a logical target and LUN combination to storage, use the scsirouter target {loopid | serial | lunwwn | wwpn} #? command. This command creates an indexed list of storage resources, assigning a unique index number to each LUN available. Specify the storage resources to map by using the appropriate index numbers.

scsirouter name target name [lun nn] {loopid | wwpn} #?

scsirouter name target name lun nn {serial | lunwwn} #?

scsirouter name target name [lun nn] {loopid | wwpn} #nn [wwpn #nn]

scsirouter name target name lun nn {serial | lunwwn} #nn

Syntax Description

name

Name of the SCSI routing instance to which you are adding the storage target.

target name

A user-specified name of the logical target. Enter a maximum of 31 characters or a valid world-wide unique identifier (WWUI). There is a maximum of 100 targets per storage router or storage router cluster.

lun nn

The LUN number associated with the logical target. The LUN number is optional if mapping to a loop ID or world-wide port number (WWPN) address type. The LUN number is required if mapping to a serial number or LUN world-wide name (LUNWWN) address type.

#?

Request an indexed list of storage resources available on the Fibre Channel network.

loopid

Use the loop ID address type for the named storage resources.

serial

Use the serial number for the named storage resource.

wwpn

Use the world-wide port number (WWPN) address type for the named storage resource. You can specify a primary and optional secondary WWPN.

lunwwn

Use the LUN world-wide name (LUNWWN) address type for the named storage resource.

#nn

The index number from the displayed list. The storage resource listed after the number specified is the physical storage address to which the logical target or logical target and LUN combination is to be mapped.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the add scsirouter target {loopid | wwpn | wwnn} command. The serial keyword was added, allowing mapping to a physical storage resource serial number.


Usage Guidelines

The  scsirouter target {loopid | serial | lunwwn | wwpn} #? command can be used for target-only or target-and-LUN mapping.

Part of the information included in the indexed list is the address type of each storage resource. The address type indicates what type of physical addressing can be used to access the storage resource: loop ID, serial number, world-wide port number, or LUN world-wide name. If the list shows more than one address type for a storage resource, specify the address type you prefer for mapping to that storage resource.

To display the indexed list of storage resources, use the number sign (#) character followed by a question mark (?). That action will cause a list of devices discovered on the Fibre Channel network to display as a numbered (indexed) set of lines. The command is displayed at the prompt below the list to the point of the # keyword. Complete the command by entering the appropriate index number.

When a target is added, it is by default enabled. However, it is not associated with any access list ("accesslist none"), effectively disabling access to the target from any IP hosts or FC server instances. Use the scsirouter target {enabled | disabled} command to enable access to this storage target for selected IP hosts and FC server instances.

See "Configuring SCSI Routing," for details on configuring SCSI routing on the SN 5420 Storage Router.

To restore a previously configured target, use the complete world-wide unique identifier (shown as the WWUI in the show scsirouter display) as the target name. The WWUI is a UTF-8 character string based on iSCSI functional requirements and is generated when a target is initially created.


Note When making changes to SCSI routing instances (such as adding or deleting targets or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of IP hosts using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers and readme and example configuration files from Cisco.com.


Examples

The following example displays an indexed list of storage resources available to SCSI routing instance Lab1 and maps the logical target webserver8 to the loop ID storage address represented by index number 5.

[SN5420A]# scsirouter Lab1 target webserver8 loopid #?

id         lunwwn            wwpn     loopid lun  vendor    product
         serial number
  1: 2000002037c59d0c 2100002037c59d0c   2   0 SEAGATE  ST318451FC      
     3CC05SM000007116DYEB
  2: 2000002037c59d31 2100002037c59d31   3   0 SEAGATE  ST318451FC      
     3CC05V1V00007116DHCE
  3: 2000002037c59e52 2100002037c59e52   4   0 SEAGATE  ST318451FC      
     3CC05T3N00007116DLWQ
  4: 2000002037c59d2b 2100002037c59d2b   5   0 SEAGATE  ST318451FC      
     3CC05TCN00007116DUJY
  5: 2000002037c59e1b 2100002037c59e1b   6   0 SEAGATE  ST318451FC      
     3CC05VBB00007116DH23
  6: 2000002037c59d20 2100002037c59d20   7   0 SEAGATE  ST318451FC      
     3CC05VER00007116DM0G
  7: 2000002037c59cd9 2100002037c59cd9   8   0 SEAGATE  ST318451FC      
     3CC05CC300007116DU7D
  8: 2000002037a78f13 2100002037a78f13   9   0 SEAGATE  ST318451FC      
     3CC038D500007110JRU4

*[SN5420A]# scsirouter Lab1 target webserver8 loopid #5

Related Commands

Command
Description

accesslist

Create an access list entity.

accesslist A.B.C.D/bits

Add IP addresses to an access list.

delete accesslist

Delete a specific access list entry or an entire access list.

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save accesslist

Save configuration data for the named access list or all access lists.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter primary

Identify a storage router as the preferred storage router to run the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

scsirouter target accesslist

Associate an access list with a specific SCSI routing instance target or all targets.

setup scsi

Run the wizard to configure a SCSI routing instance.

show accesslist

Display the contents of the named access list or all access lists.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter target loopid

To map a logical target to a loop ID storage address using a target-only method of mapping, use the scsirouter target loopid command.

scsirouter name target name loopid nnn

Syntax Description

name

Name of the SCSI routing instance to which you are adding the storage target.

target name

A user-specified name of the logical target. Enter a maximum of 31 characters or a valid world-wide unique identifier (WWUI). There is a maximum of 100 targets per storage router or storage router cluster.

loopid nnn

A loop ID number, which is an integer between 0 and 125.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the add scsirouter target loopid command.


Usage Guidelines

The scsirouter target loopid command requires only a logical target name to be mapped to a physical target address—no LUNs are specified. However, all LUNs that are part of the physical target address are discovered and made apparent as LUNs belonging to the logical target.

When a target is added, it is by default enabled. However, it is not associated with any access list ("accesslist none"), effectively disabling access to the target from any IP hosts or FC server instances. Use the scsirouter target {enabled | disabled} command to enable access to this storage target for selected IP hosts and FC server instances.

See "Configuring SCSI Routing," for details on configuring SCSI routing instances on the SN 5420 Storage Router.

To restore a previously configured target, use the complete world-wide unique identifier (shown as the WWUI in the show scsirouter display) as the target name. The WWUI is a UTF-8 character string based on iSCSI functional requirements and is generated when a target is initially created.


Note When making changes to SCSI routing instances (such as adding or deleting targets or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of IP hosts using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers and readme and example configuration files from Cisco.com.


Examples

The following example maps the logical target for the SCSI routing instance scsiB. The logical target webserver4 is mapped to the physical target loop ID 53. All LUNS that are part of the physical target address are made available to the logical target.

[SN5420A]# scsirouter scsiB target webserver4 loopid 53

Related Commands

Command
Description

accesslist

Create an access list entity.

accesslist A.B.C.D/bits

Add IP addresses to an access list.

delete accesslist

Delete a specific access list entry or an entire access list.

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save accesslist

Save configuration data for the named access list or all access lists.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter primary

Identify a storage router as the preferred storage router to run the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

scsirouter target accesslist

Associate an access list with a specific SCSI routing instance target or all targets.

setup scsi

Run the wizard to configure a SCSI routing instance.

show accesslist

Display the contents of the named access list or all access lists.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter target lun loopid lun

To map a logical target and LUN combination to a storage loop ID and LUN, use the scsirouter target lun loopid lun command. The scsirouter target lun loopid lun command is a target-and-LUN mapping method of mapping a logical target and LUN combination to a physical loop ID and LUN combination in storage.

scsirouter name target name lun nn loopid nnn lun nn

Syntax Description

name

Name of the SCSI routing instance to which you are adding the storage target.

target name

A user-specified name of the logical target. Enter a maximum of 31 characters or a valid world-wide unique identifier (WWUI). There is a maximum of 100 targets per storage router or storage router cluster.

lun nn

The LUN number associated with the target (the iSCSI LUN). iSCSI LUNs are integers between 0 and 255. The second instance is the LUN number associated with the loopid (physical device LUN). Physical LUNs may be any physical device number, for example, 0x51d1 or 123.

loopid nnn

A loop ID number, which is an integer between 0 and 125.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the add scsirouter target lun loopid lun command.


Usage Guidelines

The scsirouter target lun loopid lun command requires both a logical target and LUN combination and a physical loop ID and LUN combination.

When a target is added, it is by default enabled. However, it is not associated with any access list ("accesslist none"), effectively disabling access to the target from any IP hosts or FC server instances. Use the scsirouter target {enabled | disabled} command to enable access to this storage target for selected IP hosts and FC server instances.

See "Configuring SCSI Routing," for details on configuring SCSI routing instances on the SN 5420 Storage Router.

To restore a previously configured target, use the complete world-wide unique identifier (shown as the WWUI in the show scsirouter display) as the target name. The WWUI is a UTF-8 character string based on iSCSI functional requirements and is generated when a target is initially created.


Note When making changes to SCSI routing instances (such as adding or deleting targets or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of IP hosts using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers and readme and example configuration files from Cisco.com.


Examples

The following example maps the logical target and LUN combination for SCSI routing instance scsiC. The logical target and LUN combination, webserver3 LUN 3, is mapped to loop ID 1, LUN 3.

[SN5420A]# scsirouter scsiC target webserver3 lun 3 loopid 1 lun 3

Related Commands

Command
Description

accesslist

Create an access list entity.

accesslist A.B.C.D/bits

Add IP addresses to an access list.

delete accesslist

Delete a specific access list entry or an entire access list.

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save accesslist

Save configuration data for the named access list or all access lists.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter primary

Identify a storage router as the preferred storage router to run the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

scsirouter target accesslist

Associate an access list with a specific SCSI routing instance target or all targets.

setup scsi

Run the wizard to configure a SCSI routing instance.

show accesslist

Display the contents of the named access list or all access lists.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter target lun lunwwn

To map a logical target and LUN combination to a LUN world-wide name (LUNWWN) storage address, use the scsirouter target lun lunwwn command. The scsirouter target lun lunwwn command is a target-and-LUN mapping method of mapping a logical target to storage.

scsirouter name target name lun nn lunwwn xx:xx:xx:xx:xx:xx:xx:xx

Syntax Description

name

Name of the SCSI routing instance to which you are adding the storage target.

target name

A user-specified name of the logical target. Enter a maximum of 31 characters or a valid world-wide unique identifier (WWUI). There is a maximum of 100 targets per storage router or storage router cluster.

lun nn

The LUN number associated with the logical target. LUNs are integers between 0 and 255.

lunwwn xx:xx:xx:xx:xx:xx:xx:xx

The physical LUN world-wide name address.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the add scsirouter target lun wwnn command.


Usage Guidelines

The scsirouter target lun lunwwn command specifies a logical target name and LUN number combination to be mapped to a physical LUN world-wide name in storage.


Tips LUNWWN address notation is represented by 16 hex digits, usually formatted as eight pairs with each pair separated by a colon, xx:xx:xx:xx:xx:xx:xx:xx. When entering LUNWWN addresses, colons may be placed anywhere in the address notation, as long as they do not leave one character without a partner character. The entry should be zero-filled from the most significant (the left-most) character position.

The following examples are correct:

0000:0000:1234:5678

0A0F2860:02111750

The following examples are incorrect:

1:234:567:8:91:23:FF:6

12:34:56


When a target is added, it is by default enabled. However, it is not associated with any access list ("accesslist none"), effectively disabling access to the target from any IP hosts or FC server instances. Use the scsirouter target {enabled | disabled} command to enable access to this storage target for selected IP hosts and FC server instances.

See "Configuring SCSI Routing," for details on configuring SCSI routing instances on the SN 5420 Storage Router.

To restore a previously configured target, use the complete world-wide unique identifier (shown as the WWUI in the show scsirouter display) as the target name. The WWUI is a UTF-8 character string based on iSCSI functional requirements and is generated when a target is initially created.


Note When making changes to SCSI routing instances (such as adding or deleting targets or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of IP hosts using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers and readme and example configuration files from Cisco.com.


Examples

The following example maps a logical target and LUN combination for SCSI router instance scsiE. The logical target and LUN combination, webserver5 LUN 5, is mapped to the physical LUNWWN 22:00:00:20:37:19:12:9d.

[SN5420A]# scsirouter scsiE target webserver5 lun 5 lunwwn 22:00:00:20:37:19:12:9d

Related Commands

Command
Description

accesslist

Create an access list entity.

accesslist A.B.C.D/bits

Add IP addresses to an access list.

delete accesslist

Delete a specific access list entry or an entire access list.

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save accesslist

Save configuration data for the named access list or all access lists.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter primary

Identify a storage router as the preferred storage router to run the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

scsirouter target accesslist

Associate an access list with a specific SCSI routing instance target or all targets.

setup scsi

Run the wizard to configure a SCSI routing instance.

show accesslist

Display the contents of the named access list or all access lists.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter target lun serial

To map a logical target and LUN combination to the serial number of the physical LUN, use the scsirouter target lun serial command. The scsirouter target lun serial command is a target-and-LUN mapping method of mapping a logical target and LUN combination to a physical storage resource by the LUN serial number.

scsirouter name target name lun nn serial serialnumber

Syntax Description

name

Name of the SCSI routing instance to which you are adding the storage target.

target name

A user-specified name of the logical target. Enter a maximum of 31 characters or a valid world-wide unique identifier (WWUI). There is a maximum of 100 targets per storage router or storage router cluster.

lun nn

The LUN number associated with the target (the iSCSI LUN). iSCSI LUNs are integers between 0 and 255.

serial serialnumber

The serial number of the physical LUN.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced.


Usage Guidelines

The scsirouter target lun serial command requires both a logical target and LUN combination and the serial number of the physical LUN.

When a target is added, it is by default enabled. However, it is not associated with any access list ("accesslist none"), effectively disabling access to the target from any IP hosts or FC server instances. Use the scsirouter target {enabled | disabled} command to enable access to this storage target for selected IP hosts and FC server instances.

See "Configuring SCSI Routing," for details on configuring SCSI routing instances on the SN 5420 Storage Router.

To restore a previously configured target, use the complete world-wide unique identifier (shown as the WWUI in the show scsirouter display) as the target name. The WWUI is a UTF-8 character string based on iSCSI functional requirements and is generated when a target is initially created.


Note When making changes to SCSI routing instances (such as adding or deleting targets or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of IP hosts using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers and readme and example configuration files from Cisco.com.


Examples

The following example maps the logical target and LUN combination for SCSI routing instance scsiD. The logical target and LUN combination, webserver9 LUN 1, is mapped to the physical LUN with a serial number of ST318451FC3CC05T3N00007116DLWQ.

[SN5420A]# scsirouter scsiD target webserver9 lun 1 serial ST318451FC3CC05T3N00007116DLWQ

Related Commands

Command
Description

accesslist

Create an access list entity.

accesslist A.B.C.D/bits

Add IP addresses to an access list.

delete accesslist

Delete a specific access list entry or an entire access list.

delete scsirouter

Delete the named SCSI routing instance or the specified element of the SCSI routing instance.

restore accesslist

Restore the named access list or all access lists from the named configuration file.

restore scsirouter

Restore the named SCSI routing instance from the named configuration file.

save accesslist

Save configuration data for the named access list or all access lists.

save scsirouter

Save configuration information for the named SCSI routing instance.

scsirouter

Create a SCSI routing instance.

scsirouter deviceif

Assign a Fibre Channel interface to the SCSI routing instance.

scsirouter enable

Stop or start the named SCSI routing instance.

scsirouter primary

Identify a storage router as the preferred storage router to run the named SCSI routing instance.

scsirouter serverif

Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance.

scsirouter target accesslist

Associate an access list with a specific SCSI routing instance target or all targets.

setup scsi

Run the wizard to configure a SCSI routing instance.

show accesslist

Display the contents of the named access list or all access lists.

show scsirouter

Display configuration and operational information for the named SCSI routing instance.


scsirouter target lun wwpn lun

To map a logical target and LUN combination to a primary (and optional secondary) storage address where each storage address is specified by world-wide port name (WWPN) and LUN, use the scsirouter target lun wwpn lun command. The scsirouter target lun wwpn lun command is a target-and-LUN mapping method of mapping a logical target to storage.

scsirouter name target name lun nn wwpn xx:xx:xx:xx:xx:xx:xx:xx lun nn
[wwpn xx:xx:xx:xx:xx:xx:xx:xx lun nn]

Syntax Description

name

Name of the SCSI routing instance to which you are adding the storage target.

target name

A user-specified name of the logical target. Enter a maximum of 31 characters or a valid world-wide unique identifier (WWUI). There is a maximum of 100 targets per storage router or storage router cluster.

lun nn

The first instance is the LUN number associated with the target (the iSCSI LUN). iSCSI LUNs are integers between 0 and 255. The second instance is the LUN number associated with the primary WWPN (physical device LUN). Physical LUNs may be any physical device number, for example 0x51d1 or 123.

wwpn xx:xx:xx:xx:xx:xx:xx:xx

Specifies a WWPN for the primary storage address.

wwpn xx:xx:xx:xx:xx:xx:xx:xx

(Optional) Specifies a WWPN for the secondary storage address, used as an alternate for mapping if the primary is not available.

lun nn

(Optional) Specifies the LUN associated with the optional secondary WWPN. Physical LUNs may be any physical device number, for example 0x51d1 or 123.


Defaults

None.

Command Modes

Administrator.

Command History

Release
Modification

2.1.1

This command was introduced, replacing the add scsirouter target lun wwpn lun command.


Usage Guidelines

The scsirouter target lun wwpn lun command specifies a logical target name and LUN number combination to be mapped to a physical WWPN and LUN combination in storage.

The secondary WWPN and LUN combination is optional. The secondary combination is mapped to the logical target name and LUN combination as an alternate, if the primary WWPN and LUN combination is not available.

When a target is added, it is by default enabled. However, it is not associated with any access list ("accesslist none"), effectively disabling access to the target from any IP hosts or FC server instances. Use the scsirouter target {enabled | disabled} command to enable access to this storage target for selected IP hosts and FC server instances.

See "Configuring SCSI Routing," for details on configuring SCSI routing instances on the SN 5420 Storage Router.

To restore a previously configured target, use the complete world-wide unique identifier (shown as the WWUI in the show scsirouter display) as the target name. The WWUI is a UTF-8 character string based on iSCSI functional requirements and is generated when a target is in