[an error occurred while processing this directive]

Support

Chapter 4 Configuring SCSI Routing

 Feedback

Table Of Contents

Configuring SCSI Routing

Prerequisite Tasks

Configuration Tasks

Creating an Access List

Creating SCSI Routing Services

Configuring a Server Interface

Configuring a Device Interface

Configuring iSCSI Targets

Configuring Access

Verifying and Saving Configuration


Configuring SCSI Routing


This chapter explains how to configure SCSI routing on your storage router and contains the following sections:

Prerequisite Tasks

Configuration Tasks

Creating an Access List

Creating SCSI Routing Services

Configuring a Server Interface

Configuring a Device Interface

Configuring iSCSI Targets

Configuring Access

Verifying and Saving Configuration

To change configuration settings, use either the web-based GUI or a combination of add, delete and set CLI commands.

Prerequisite Tasks

Before configuring SCSI routing, make sure you have configured all system parameters as described in "First-Time Configuration" or "Configuring System Parameters".


Note If you ran the complete SN 5420 configuration wizard (the CLI setup command with no keywords) or the SCSI configuration portion of the SN 5420 configuration wizard (the CLI setup scsi command), you do not need to perform the configuration tasks in this chapter. However, you will need to configure access, and you may want to create access lists. You may also want to rename iSCSI targets created from the configuration wizard.


Configuration Tasks

To configure SCSI routing on your storage router, perform the following steps:


Step 1 (Optional) Create an access list defining which servers can access iSCSI targets configured in an instance of SCSI routing services. Creating an access list is necessary if you want to specify access to iSCSI targets on a per-server basis. Creating an access list is not necessary if you want to specify that all servers have access to the iSCSI targets configured in an instance of SCSI routing services.

Step 2 Create an instance of SCSI routing services. Once an instance of SCSI routing services is created, you will configure it with parameters for a server interface, a device interface, iSCSI targets, and server access.

Step 3 Configure the server interface.

Step 4 Configure the device interface.

Step 5 Configure iSCSI targets.

Step 6 Configure access. This determines which servers can access the iSCSI targets configured in the SCSI routing services.

Step 7 Verify and save configuration.


Note Although this is shown as the last step, you can also verify and save the configuration at any point while performing the configuration tasks. You must save the configuration for it to be retained in the storage router when it is rebooted.




Caution When making changes to SCSI routing services (such as adding or deleting targets, or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of servers 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, readme and example configuration files from Cisco.com.)

Figure 4-1 illustrates SCSI routing configuration elements and Figure 4-2 illustrates the example configuration used in this chapter.

Figure 4-1 SCSI Routing Configuration Elements

Figure 4-2 SCSI Routing Parameters Example Configuration

Creating an Access List

Creating an access list consists of creating a list of server IP addresses that will have permission to access storage devices via iSCSI target names. Use the following table to create an access list.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

create accesslist aegis

Create an access list; for example, create an access list named aegis.

Step 3 

add accesslist aegis 10.2.0.23/32, 10.3.0.36/32, 10.4.0.49/32

Add IP addresses to the access list. For example, add the following IP addresses to the access list named aegis: 10.2.0.23, 10.3.0.36, and 10.4.0.49. Set the network mask for each IP address to 255.255.255.255 to limit the access to each IP address.


Note In a cluster environment, all access list must be created and maintained on the first storage router to join the cluster. If you issue create accesslist or add accesslist commands 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 SN 5420."


Creating SCSI Routing Services

Creating SCSI routing services consists of creating and naming a base set of SCSI routing services. Use the following table to create SCSI routing services.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

create scsirouter zeus

Create a SCSI routing service instance named zeus.

Note You can define up to four instances on a single SN 5420 or across a cluster. For additional details about configuring SN 5420 clusters for high availability, see "Configuring a Storage Router Cluster."

Configuring a Server Interface

Configuring a server interface consists of identifying which SCSI routing service instances to add to the server interface, identifying the server interface name, and assigning an IP address to the server interface. Use the following table to configure a server interface for an instance of SCSI routing services.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

add scsirouter zeus serverif ge2 10.1.0.45/24

Add server interface to SCSI routing services name zeus. Specify an IP address that servers will use to access the SCSI routing services, zeus. In addition, set the IP netmask to 255.255.255.0.

Configuring a Device Interface

Configuring a device interface consists of specifying which SCSI routing service instances to add to the device interface and the device interface name and topology. Use the following table to configure a device interface for an instance of SCSI routing services.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

add scsirouter zeus deviceif fc1

Add device interface to SCSI routing services named zeus. This will be the interface in the storage router that the SCSI routing services will use to access physical storage devices.

Step 3 

set interface fc1 topology loop

or

set interface fc1 topology ptp

Set the device interface topology. The device interface is configured to attempt link activation in a point-to-point topology, by default. If point-to-point is not successful, a loop topology is assumed.

If the storage devices are all connected to a hub with the intention of running in an arbitrated loop, change the device interface topology to loop, as shown in the first example.

If the storage devices are all connected in a point-to-point topology, change the device interface topology to ptp, as shown in the second example.

Step 4 

save all

Save your configuration before rebooting the storage router.

Step 5 

reboot

Reboot the storage router. A reboot is necessary to make the new interface topology selection effective.

Once the device interface is added, the SCSI routing service instance becomes active.

Configuring iSCSI Targets

Configuring iSCSI targets consists of specifying the SCSI routing services to which the iSCSI target is to be added, specifying an iSCSI target, and mapping the iSCSI target to a physical storage device. When adding an iSCSI target, you can specify the physical storage device either by physical storage address or by an index number assigned to the device.


Note When a new iSCSI target is configured, servers do not have access to it. You need to configure access to newly created iSCSI targets according to the section"Configuring Access" later in this chapter.


Use the tables that follow according to mapping type and storage addressing type:

Target-and-LUN Mapping using LoopID Addressing

Target-and-LUN Mapping using WWPN Addressing

Target-and-LUN Mapping using WWNN Addressing

Target-only mapping using LoopID addressing

Target-only mapping using WWPN addressing

Target-and-LUN Mapping using LoopID Addressing

Use this table to map iSCSI targets to storage devices by physical storage address.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

add scsirouter zeus target chimaera_email lun 23 loopid 15 lun 0

Specify SCSI routing services named zeus. Specify iSCSI target and LUN as chimaera_email, LUN 23, and map it to a physical address LoopID 15, LUN 0.

Use this table to map iSCSI targets to storage devices by index numbers.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

add scsirouter zeus target chimaera_email lun 23 loopid ?

Specify SCSI routing services named zeus. Specify iSCSI target as chimaera_email, LUN 23, and prompt for an indexed list of storage addresses available.

Step 3 

add scsirouter zeus target chimaera_email lun 23 loopid #5

Choose a physical address designated by index number 5 (Example 4-1) to map iSCSI target and LUN combination, chimaera_email, LUN 23 to physical address LoopID 15, LUN 0.

Example 4-1 Indexed List of Storage Devices

           wwnn            wwpn     loopid lun  vendor    product
         serial number
  1: 20000020371912d5 22000020371912d5   8   0 SEAGATE  ST39103FC       
     LS099969000019511C2H
  2: 20000020371912da 22000020371912da   9   0 SEAGATE  ST39103FC       
     LS097776000019511C3B
  3: 200000203719129d 220000203719129d  10   0 SEAGATE  ST39103FC       
     LS101990000019411NGQ
  4: 2000002037191505 2200002037191505  12   0 SEAGATE  ST39103FC       
     LS092288000019512N3V
  5: 20000020371912b2 22000020371912b2  15   0 SEAGATE  ST39103FC       
     LS099843000019430RC7

Target-and-LUN Mapping using WWPN Addressing

Use this table to map iSCSI targets to storage devices by physical storage address.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

add scsirouter zeus target chimaera_apps lun 24 wwpn 22:00:00:20:37:19:15:05 lun 0

Specify SCSI routing services named zeus. Specify iSCSI target as chimaera_apps, LUN 24, and map it to a physical address WWPN 22:00:00:20:37:19:15:05 LUN 0.

Use this table to map iSCSI targets to storage devices by index numbers.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

add scsirouter zeus target chimaera_apps lun 31 wwpn ?

Specify SCSI routing services named zeus. Specify iSCSI target as chimaera_apps, LUN 31, and prompt for an indexed list of storage addresses available.

Step 3 

add scsirouter zeus target chimaera_apps lun 31 wwpn #4

Choose a physical address designated by index number 4 (Example 4-1) to map iSCSI target and LUN combination, chimaera_apps, LUN 31 to physical address WWPN 22:00:00:20:37:19:15:05, LUN 0.

Target-and-LUN Mapping using WWNN Addressing

Use this table to map iSCSI targets to storage devices by physical storage address.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

add scsirouter zeus target chimaera_eng lun 17 wwnn 22:00:00:20:37:19:12:9d

Specify SCSI routing services named zeus. Specify iSCSI target as chimaera_eng, LUN 17, and map it to a physical address WWNN 22:00:00:20:37:19:12:9d.

Use this table to map iSCSI targets to storage devices by index numbers.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

add scsirouter zeus target chimaera_eng lun 17 wwnn ?

Specify SCSI routing services named zeus. Specify iSCSI target as chimaera_eng, LUN 17, and prompt for an indexed list of storage addresses available.

Step 3 

add scsirouter zeus target chimaera_eng lun 17 wwnn #3

Choose a physical address designated by index number 3 (Example 4-1) to map iSCSI target and LUN combination, chimaera_eng, LUN 17 to physical address WWNN 22:00:00:20:37:19:12:9d

Target-only mapping using LoopID addressing

Use this table to map iSCSI targets to storage devices by physical storage address.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

add scsirouter zeus target pegasus_dbase loopid 8

Specify SCSI routing services named zeus. Specify iSCSI target as pegasus_dbase and map it to a physical address LoopID 8 and any LUNs available as part of that LoopID.

Use this table to map iSCSI targets to storage devices by index numbers.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

add scsirouter zeus target pegasus_dbase loopid ?

Specify SCSI routing services named zeus. Specify iSCSI target as pegasus_dbase and prompt for an indexed list of storage addresses available.

Step 3 

add scsirouter zeus target pegasus_dbase loopid #1

Choose a physical address designated by index number 1 (Example 4-1) to map iSCSI target, pegasus_dbase, to physical address LoopID 8, LUN 0.

Target-only mapping using WWPN addressing

Use this table to map iSCSI targets to storage devices by physical storage address.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

add scsirouter zeus target pegasus_email wwpn 22:00:00:20:37:19:12:da

Specify SCSI routing services named zeus. Specify iSCSI target as pegasus_email and map it to a physical address WWPN 22:00:00:20:37:19:12:da and any LUNs available as part of that WWPN.

Use this table to map iSCSI targets to storage devices by index numbers.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

add scsirouter zeus target pegasus_email wwpn ?

Specify SCSI routing services named zeus. Specify iSCSI target as pegasus_email and prompt for an indexed list of storage addresses available.

Step 3 

add scsirouter zeus target pegasus_email wwpn #2

Choose a physical address designated by index number 2 (Example 4-1) to map iSCSI target pegasus_email to physical address WWPN 22:00:00:20:37:19:12:da.

Configuring Access

Configuring access consists of specifying which iSCSI targets can be accessed by servers. When configuring access, you can specify one iSCSI target at a time or all iSCSI targets. Similarly, you can specify one access list at time or all servers using an instance of SCSI routing services. In addition, you can deny access to iSCSI targets one at a time or all at once.


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 a create accesslist or add 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 SN 5420."


Use the tables that follow according to the type of access:

Access an iSCSI target by servers identified in an access list

Access an iSCSI target by all servers

Access all iSCSI targets by servers identified in an access list

Access all iSCSI targets by all servers

Access denied to one iSCSI target

Access denied to all iSCSI targets

Access an iSCSI target by servers identified in an access list

Use this table to specify one iSCSI target at a time to be accessible by servers listed in an access list.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

set scsirouter zeus target chimaera_email accesslist aegis

Specify that the iSCSI target named chimaera_email (configured as part of the zeus SCSI routing services) can be accessed by servers listed in the access list named aegis using the SCSI routing services named zeus.

Access an iSCSI target by all servers

Use this table to specify one iSCSI target at a time to be accessible by all servers.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

set scsirouter zeus target chimaera_apps accesslist all

Specify that the iSCSI target named chimaera_apps (configured as part of the zeus SCSI routing services) can be accessed by all servers using the SCSI routing services named zeus.

Access all iSCSI targets by servers identified in an access list

Use this table to specify all iSCSI targets to be accessible by servers listed in an access list.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

set scsirouter zeus target all accesslist aegis

Specify that all iSCSI targets (configured as part of the zeus SCSI routing services) can be accessed by servers listed in the access list named aegis using the SCSI routing services named zeus.

Access all iSCSI targets by all servers

Use this table to specify all iSCSI targets to be accessible by all servers.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

set scsirouter zeus target all accesslist all

Specify that all iSCSI targets (configured as part of the zeus SCSI routing services) can be accessed by all servers using the SCSI routing services named zeus.

Access denied to one iSCSI target

Use this table to deny server access to one iSCSI target at a time.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

set scsirouter zeus target chimaera_apps accesslist none

Specify that no server can access the target named chimaera_apps (configured as part of the zeus SCSI routing services) using the SCSI routing services named zeus.

Access denied to all iSCSI targets

Use this table to deny server access to all iSCSI targets at once.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

set scsirouter zeus target all accesslist none

Specify that no server can access any iSCSI target (configured as part of the zeus SCSI routing services) using the SCSI routing services named zeus.

Verifying and Saving Configuration

Verify the access list configuration and the SCSI routing services configuration using the tables that follow. Then save the configuration using a save all CLI command. You must save the configuration for it to be retained in the storage router when it is rebooted. Once you have saved the configuration, you can verify that the configuration to be used when the storage router is rebooted matches the currently running configuration.

Use this table to verify access list configuration.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

show accesslist

Use this command to verify that an access list exists (Example 4-2).

Step 3 

show accesslist aegis

Use this command to verify the IP addresses in an access list (Example 4-3).

Example 4-2 Verifying Existence of An Access List

[SN5420-MG1]# show accesslist
aegis
hris-mgmt

Example 4-3 Verifying IP Addresses in an Access List Named aegis

[SN5420-MG1]# show accesslist aegis
accesslist aegis 10.2.0.23/32
accesslist aegis 10.3.0.36/32
accesslist aegis 10.4.0.49/32

Use this table to verify the configuration of SCSI routing services

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

show scsirouter zeus

Using this command will show all the parameters configured for the named instance of SCSI routing services. (Example 4-4).

Example 4-4 Verifying Configuration for SCSI Routing Service Named Zeus

[SN5420-MG1]# show scsirouter zeus
zeus description "(not set)"
zeus primary "none"
zeus serverif ge2 10.1.0.45/24
zeus deviceif fc1 
zeus target chimaera_email description "(not set)"
zeus target chimaera_email enabled "TRUE" 
zeus target chimaera_email accesslist "aegis" 
zeus target chimaera_email lun 23 loopid "15" lun "0" 
zeus target chimaera_apps description "(not set)"
zeus target chimaera_apps enabled "TRUE" 
zeus target chimaera_apps accesslist "none" 
zeus target chimaera_apps lun 24 wwpn "22:00:00:20:37:19:15:05" lun "0" 
zeus target chimaera_eng description "(not set)"
zeus target chimaera_eng enabled "TRUE" 
zeus target chimaera_eng accesslist "aegis" 
zeus target chimaera_eng lun 17 wwnn "22:00:00:20:37:19:12:9d" 
zeus target pegasus_dbase description "(not set)"
zeus target pegasus_dbase enabled "TRUE" 
zeus target pegasus_dbase accesslist "hris-mgmt" 
zeus target pegasus_dbase loopid "8" 
zeus target pegasus_email description "(not set)"
zeus target pegasus_email enabled "TRUE" 
zeus target pegasus_email accesslist "all" 
zeus target pegasus_email wwpn "22:00:00:20:37:19:12:da"

Use this table to save your current system configuration, including all access lists and SCSI routing services.

 
Command
Description

Step 1 

enable

Enter Administrator mode.

Step 2 

save all

Save the current running system configuration, including all access lists and SCSI routing services.


[an error occurred while processing this directive]