Guest

Cisco MDS 9000 SAN-OS Software

Cisco MDS 9000 Family Release Notes for Cisco MDS SAN-OS Release 2.1(2b)

Table Of Contents

Cisco MDS 9000 Family Release Notes
for Cisco MDS SAN-OS Release 2.1(2b)

Contents

Introduction

System Requirements

Components Supported

Determining the Software Version

Image Upgrade

Performing a Disruptive Upgrade on a Single Supervisor MDS Family Switch

New Features in Cisco MDS SAN-OS Release 2.1(2b)

Limitations and Restrictions

VSFN Compatibility

IVR

NASB

14/2-Port Multiprotocol Services Module

iSCSI Proxy Initiators

Caveats

Resolved Caveats

Open Caveats

Related Documentation

Obtaining Documentation

Cisco.com

Product Documentation DVD

Ordering Documentation

Documentation Feedback

Cisco Product Security Overview

Reporting Security Problems in Cisco Products

Obtaining Documentation

Cisco.com

Product Documentation DVD

Ordering Documentation

Documentation Feedback

Cisco Product Security Overview

Reporting Security Problems in Cisco Products

Obtaining Technical Assistance

Cisco Technical Support & Documentation Website

Submitting a Service Request

Definitions of Service Request Severity

Obtaining Additional Publications and Information


Cisco MDS 9000 Family Release Notes
for Cisco MDS SAN-OS Release 2.1(2b)


Release Date: September 28, 2005

Text Part Number: OL-7411-04 S0

This document describes the caveats and limitations for switches in the Cisco MDS 9000 Family. Use this document in conjunction with documents listed in the "Related Documentation" section.


Note Release notes are sometimes updated with new information on restrictions and caveats. Refer to the following website for the most recent version of the Cisco MDS 9000 Family Release Notes: http://www.cisco.com/en/US/products/hw/ps4159/ps4358/prod_release_notes_list.html


Table 1 shows the on-line change history for this document.

Table 1 Online History Change

Revision
Date
Description

A0

09/28/2005

Created release notes

B0

09/30/2005

Added NASB information to the Limitations and Restrictions section.

C0

11/03/2005

Added DDTS CSCeh69186

D0

11/17/2005

Added DDTS CSCsc53604

E0

12/07/2005

Added DDTS CSCsc31424, CSCsc46451, and CSCsc28722

F0

12/13/2005

Added DDTS CSCsc72994

G0

12/30/2005

Added DDTS CSCei91968

H0

2/17/2006

Added DDTS CSCeh51924, CSCsb90192, CSCsc16506, CSCsc23435, CSCsc24966, CSCsc57865, CSCsc68084, CSCsc97070, and CSCsc98796

Added limitation for iSCSI proxy initiators

I0

5/26/2006

Added DDTS CSCeg12962, CSCeg33121, CSCeg84871, CSCeh30951, CSCeh70232, CSCei02126, CSCei36082, CSCei55208, CSCei79457, CSCsc46451, CSCsc75056, CSCsd47064, CSCsd79954, CSCeg53114, CSCei57342, CSCei58652, CSCei71686, CSCei86399, CSCei91676, CSCej08751, CSCsb89732, CSCsc09732, CSCsc20106, CSCsc33788, CSCsc40012, CSCsc48919, CSCsc60283, CSCsc93936, CSCsd07246, CSCsd12831, CSCsd29338, CSCsd30165, CSCsd34882, CSCsd53429, CSCsd58774, CSCsd60578, CSCsd71701, CSCsd72822, CSCsd73494, CSCsd76429, CSCsd81725, CSCsd82449, CSCsd89872, and CSCsd94718

J0

06/06/2006

Removed DDTS CSCed16845

K0

08/07/2006

Removed DDTS CSCeg33121, CSCeg12962, CSCeg84871, CSCeg90336, CSCeh04183, CSCeh30951, CSCeh52973, CSCeh70232, CSCeh93109, CSCei10774, CSCei36082, CSCei55208, CSCei55341, CSCec31365, CSCeg12383, CSCeg53114, CSCeg55238, CSCeh34828, CSCei48889, CSCei83322, CSCei91676, CSCej08751, CSCin92870, CSCin95789, CSCsd71701.

Added DDTS CSCse84811

L0

08/18/2006

Added DDTS CSCse89151

M0

09/05/2006

Added DDTS CSCsd78967 and CSCse88606.

N0

09/13/2006

Added DDTS CSCsf21970

O0

11/08/2006

Added DDTS CSCin95789, CSCsd81137, CSCse70275, CSCse71420, CSCsf96043, CSCsg12020, and CSCsg15392.

P0

02/23/2007

Added DDTS CSCse99087, CSCsg03171, CSCsg62359, and CSCsh27840.

Q0

03/26/2007

Added DDTS CSCsd41578 and added a Workaround for DDTS CSCsd58774.

R0

04/04/2007

Added the section "Performing a Disruptive Upgrade on a Single Supervisor MDS Family Switch".

S0

08/24/2007

Added DDTS CSCsd83775.


Contents

This document includes the following sections:

Introduction

System Requirements

Image Upgrade

New Features in Cisco MDS SAN-OS Release 2.1(2b)

Limitations and Restrictions

Caveats

Related Documentation

Obtaining Documentation

Documentation Feedback

Cisco Product Security Overview

Obtaining Technical Assistance

Obtaining Additional Publications and Information

Introduction

The Cisco MDS 9000 Family of multilayer directors and fabric switches offers intelligent fabric-switching services that realize maximum performance while ensuring high reliability levels. These switches combine robust and flexible hardware architecture with multiple layers of network and storage management intelligence. This powerful combination enables highly available, scalable storage networks that provide advanced security and unified management features.

The Cisco MDS 9000 Family provides intelligent networking features such as multiprotocol and multitransport integration, virtual SANs (VSANs), advanced security, sophisticated debug analysis tools, and unified SAN management.

System Requirements

This section describes the system requirements for Cisco MDS SAN-OS Release 2.1(2b) and includes the following topics:

Components Supported

Determining the Software Version

Components Supported

Table 2 lists the software and hardware components supported by the Cisco MDS 9000 Family.


Note To use the Cisco Storage Services Enabler package, Cisco MDS SAN-OS Release 1.3(5) or later must be installed on the MDS switch.


Table 2 Cisco MDS 9000 Family Supported Software and Hardware Components  

Component
Part Number
Description
Applicable Product

Software

M95S1K9-2.1.2B

MDS 9500 Supervisor/Fabric-I, SAN-OS software.

MDS 9500 Series only

M92S1K9-2.1.2B

MDS 9216 Supervisor/Fabric-I, SAN-OS software.

MDS 9200 Series only

M91S1K9-2.1.2B

MDS 9100 Supervisor/Fabric-I, SAN-OS software.

MDS 9100 Series only

License

M9500ENT1K9

Enterprise package.

MDS 9500 Series

M9200ENT1K9

Enterprise package.

MDS 9200 Series

M9100ENT1K9

Enterprise package.

MDS 9100 Series

M9500FIC1K9

Mainframe package.

MDS 9500 Series

M9200FIC1K9

Mainframe package.

MDS 9200 Series

M9100FIC1K9

Mainframe package.

MDS 9100 Series

M9500FMS1K9

Fabric Manager Server package.

MDS 9500 Series

M9200FMS1K9

Fabric Manager Server package.

MDS 9200 Series

M9100FMS1K9

Fabric Manager Server package.

MDS 9100 Series

M9500EXT1K9

SAN Extension over IP package for IPS-8 module.

MDS 9500 Series

M9200EXT1K9

SAN Extension over IP package for IPS-8 module.

MDS 9200 Series

M9500EXT14K9

SAN Extension over IP package for IPS-4 module.

MDS 9500 Series

M9200EXT14K9

SAN Extension over IP package for IPS-4 module.

MDS 9200 Series

M9500EXT12K9

SAN Extension over IP package for MPS 14+2 module.

MDS 9500 Series

M9200EXT12K9

SAN Extension over IP package for MPS 14+2 module.

MDS 9200 Series

M9500SSE1K9

Storage Services Enabler package.

MDS 9500 Series with ASM or SSM

M9200SSE1K9

Storage Services Enabler package.

MDS 9200 Series with ASM or SSM

Chassis

DS-C9509

MDS 9509 director, base configuration (9-slot modular chassis includes 7 slots for switching modules and 2 slots for supervisor modules—SFPs1 sold separately).

MDS 9509 only

DS-C9506

MDS 9506 director (6-slot modular chassis includes 4 slots for switching modules and 2 slots for supervisor modules—SFPs sold separately).

MDS 9506 only

DS-C9216-K9

MDS 9216 16-port semi-modular fabric switch (includes 16 1-Gbps/2-Gbps Fibre Channel ports, power supply, and expansion slot—SFPs sold separately).

MDS 9216 only

DS-C9216A-K9

MDS 9216A 16-port semi-modular fabric switch (includes 16 1-Gbps/2-Gbps Fibre Channel ports, power supply, and expansion slot—SFPs sold separately).

MDS 9216A only

DS-C9216i-K9

MDS 9216i 16-port semi-modular fabric switch (includes 14 1-Gbps/2-Gbps Fibre Channel ports, 2 Gigabit Ethernet ports, power supply, and expansion slot—SFPs sold separately).

MDS 9216i only

DS-C9120-K9

MDS 9120 fixed configuration, non-modular, fabric switch (includes 4 full rate ports and 16 host-optimized ports).

MDS 9120 only

DS-C9140-K9

MDS 9140 fixed configuration (non-modular) fabric switch (includes 8 full rate ports and 32 host-optimized ports).

MDS 9140 only

Supervisor modules

DS-X9530-SF1-K9

MDS 9500 Supervisor/Fabric-I, module.

MDS 9500 Series only

Switching modules

DS-X9016

MDS 9000 16-port 1-Gbps/2-Gbps Fibre Channel module (SFPs sold separately).

MDS 9500 Series and 9200 Series

DS-X9032

MDS 9000 32-port 1-Gbps/2-Gbps Fibre Channel module (SFPs sold separately).

Services modules

DS-X9308-SMIP

8-port Gigabit Ethernet IP Storage Services module.

DS-X9304-SMIP

4-port Gigabit Ethernet IP Storage Services module.

DS-X9032-SMV

32-port Fibre Channel Advanced Services Module (ASM).

DS-X9032-SSM

MDS 9000 32-port 1-Gbps/2-Gbps Fibre Channel Storage Services Module (SSM).

DS-X9560-SMC

Caching Services Module (CSM).

DS-X9302-14K9

14-port Fibre Channel/2-port Gigabit Ethernet Multiprotocol Services (MPS-14/2) module.

LC-type fiber-optic SFP

DS-SFP-FC-2G-SW

2-Gbps/1-Gbps Fibre Channel — short wavelength SFP.

MDS 9000 Family

DS-SFP-FC-2G-LW

2-Gbps/1-Gbps Fibre Channel — long wavelength SFP.

DS-SFP-FCGE-SW

1-Gbps Ethernet and 1-Gbps/2-Gbps Fibre Channel—short wavelength SFP.

DS-SFP-FCGE-LW

1-Gbps Ethernet and 1-Gbps/2-Gbps Fibre Channel — long wavelength SFP.

DS-SFP-GE-T

1-Gbps Ethernet SFP

CWDM2

CWDM-SFP-xxxx-2G

Gigabit Ethernet and 1-Gbps/2-Gbps Fibre Channel SFP LC interface xxxx nm, where xxxx = 1470, 1490, 1510, 1530, 1550, 1570, 1590, or 1610 nm.

MDS 9000 Family

CWDM-MUX-4

Add/drop multiplexer for four CWDM wavelengths.

CWDM-MUX-8

Add/drop multiplexer for eight CWDM wavelengths.

CWDM-CHASSIS-2

Two slot chassis for CWDM add/drop multiplexer(s).

Power supplies

DS-CAC-300W

300-W3 AC power supply.

MDS 9100 Series only

DS-CAC-845W

845-W AC power supply.

MDS 9200 Series only

DS-CAC-2500W

2500-W AC power supply.

MDS 9509 only

DS-CDC-2500W

2500-W DC power supply.

DS-CAC-4000W-US

4000-W AC power supply for US (cable attached).

DS-CAC-4000W-INT

4000-W AC power supply international (cable attached).

DS-CAC-1900W

1900-W AC power supply.

MDS 9506 only

DS-CDC-1900W

1900-W DC power supply.

CompactFlash

MEM-MDS-FLD512M

MDS 9500 supervisor CompactFlash disk, 512MB.

MDS 9500 Series only

Port analyzer adapter

DS-PAA-2

A standalone Fibre Channel-to-Ethernet adapter that allows for simple, transparent analysis of Fibre Channel traffic in a switched fabric.

MDS 9000 Family

CD-ROM

M90FM-CD-212=

MDS 9000 Management Software and Documentation CD-ROM, spare

MDS 9000 Family

1 SFP = small form-factor pluggable

2 CWDM = coarse wavelength division multiplexing

3 W = Watt


Determining the Software Version


Note We strongly recommend that you use the latest available software release supported by your vendor for all Cisco MDS 9000 Family products.


To determine the version of the Cisco MDS SAN-OS software currently running on a Cisco MDS 9000 Family switch using the CLI, log into the switch and enter the show version EXEC command.

To determine the version of the Cisco MDS SAN-OS software currently running on a Cisco MDS 9000 Family switch using the Fabric Manager, view the Switches tab in the Information pane, locate the switch using the IP address, logical name, or WWN, and check its version in the Release column.

Image Upgrade

The Cisco MDS SAN-OS software is designed for mission-critical high availability environments. To realize the benefits of nondisruptive upgrades on the Cisco MDS 9500 Directors, we highly recommend that you install dual supervisor modules.

You can nondisruptively upgrade to Cisco MDS SAN-OS Release 2.1(2b) from any SAN-OS software release beginning with Release 1.3(x). If you are running an older version of the SAN-OS, upgrade to Release 1.3(x) and then Release 2.1(2b).

When downgrading from Cisco MDS SAN-OS Release 2.1(2b) to Release 1.3(x), you might need to disable new features in Release 2.1(2b) for a nondisruptive downgrade. Issuing the install all command from the CLI, or using Fabric Manager to perform the downgrade enables the compatibility check. The check indicates that the downgrade is disruptive and the reason is "current running-config is not supported by new image."

Compatibility check is done:
Module  bootable          Impact  Install-type  Reason
------  --------  --------------  ------------  ------
      2       yes      disruptive         reset  Current running-config is not 
supported by new image
      3       yes      disruptive         reset  Current running-config is not 
supported by new image
      5       yes      disruptive         reset  Current running-config is not 
supported by new image
      6       yes      disruptive         reset  Current running-config is not 
supported by new image

At a minimum, you need to disable the default device alias distribution feature using the no device-alias distribute command in global configuration mode. The show incompatibility system bootflash:1.3(x)_filename command determines which additional features need to be disabled.


Note Refer to the "Determining Software Compatibility" section of the Cisco MDS 9000 Family Configuration Guide for more details.


Performing a Disruptive Upgrade on a Single Supervisor MDS Family Switch

Cisco MDS SAN-OS software upgrades are disruptive on the following single supervisor Cisco MDS Family switches:

MDS 9120 switch

MDS 9140 switch

MDS 9216i switch

If you are performing an upgrade on one of those switches, you should follow the nondisruptive upgrade path listed in this section, even though the upgrade is disruptive. Following the nondisruptive upgrade path ensures that the binary startup configuration remains intact.

If you do not follow the upgrade path, the binary startup configuration is deleted because it is not compatible with the new image, and the ASCII startup configuration file is applied when the switch comes up with the new upgraded image. When the ASCII startup configuration file is applied, there may be errors. Because of this, we recommend that you follow the nondisruptive upgrade path.

New Features in Cisco MDS SAN-OS Release 2.1(2b)

The new features for this release are the same as those listed in the Cisco MDS 9000 Family Release Notes for Cisco MDS SAN-OS Release 2.1(2).

Limitations and Restrictions

This section lists the limitations and restrictions for this release.

VSFN Compatibility

For the latest VSFN compatibility information, refer to the Cisco MDS SAN-OS Release Compatibility Matrix for VERITAS Storage Foundation for Networks Software.

IVR

All IVR enabled switches in a network must be either in NAT or non-NAT mode. Mixing the two modes is not supported. Ensure that a switch with IVR-NAT mode enabled never coexists in the network with another switch where IVR is enabled without NAT mode enabled.

While migrating from IVR non-NAT mode to NAT mode in Cisco MDS SAN-OS Release 2.1(1b), deactivate the IVR zoneset, disable IVR on all of the IVR enabled switches, then reenable IVR. Finally, enable NAT mode and then the IVR configurations. Note that migration between the non-NAT and NAT modes is disruptive to IVR traffic and the FCIDs of the IVR devices change in the exported VSANs.

While upgrading the SAN-OS images on IVR enabled switches, upgrade all of the IVR enabled switches to the new SAN-OS version before making any topology or configuration changes.

CFS distribution for IVR should be disabled on all IVR enabled switches before upgrading from Cisco MDS SAN-OS Release 2.0(x) to Releases 2.1(1b) or 2.1(2b). After upgrading all of the IVR-enabled switches to Cisco MDS SAN-OS Release 2.1(1b) or Release 2.1(2b), CFS distribution for IVR can be reenabled.

NASB

The NASB feature requires that the backup application load the tape drive with a compatible tape cartridge prior to configuring NASB in the backup VSAN.

14/2-Port Multiprotocol Services Module

The MPS-14/2 module does not support a MTU size greater than 8000 bytes. An attempt to set the MTU size greater than 8000 bytes will result in an error. Reset the MTU size value between 576 to 8000 bytes and issue the no shutdown command on the port for normal operation.

iSCSI Proxy Initiators

No more than 250 iSCSI proxy initiator sessions can be active on an IPS port.

Caveats

This section lists the open and resolved caveats for this release. Use Table 3 to determine the status of a particular caveat. In the table, "O" indicates an open caveat and "R" indicates a resolved caveat.

Table 3 Open Caveats and Resolved Caveats Reference 

DDTS Number
Software Release (Open or Resolved)
2.1(2)
2.1(2b)

Severity 1

CSCsd29338

O

O

Severity 2

CSCeh73149

O

O

CSCeh92604

O

O

CSCei02126

O

O

CSCei18449

O

R

CSCei18830

O

O

CSCei19822

O

O

CSCei40874

O

O

CSCei50818

O

R

CSCei53783

O

O

CSCei62511

O

R

CSCei73996

O

R

CSCei81840

O

R

CSCei82417

O

R

CSCei88345

O

R

CSCsc16506

 

O

CSCsc46451

 

O

CSCsc75056

 

O

CSCsd41578

 

O

CSCsd47064

 

O

CSCsd78967

O

O

CSCsd79954

 

O

CSCse89151

 

O

CSCsh27840

O

O

Severity 3

CSCef56229

O

O

CSCeg27584

O

O

CSCeg37598

O

O

CSCeh33548

O

O

CSCeh41099

O

O

CSCeh51924

 

O

CSCeh69186

O

R

CSCeh75500

 

O

CSCeh88814

O

O

CSCei32317

O

O

CSCei57342

O

O

CSCei58652

O

O

CSCei67982

O

R

CSCei71686

O

O

CSCei76309

 

R

CSCei77038

O

R

CSCei78778

O

R

CSCei79457

O

R

CSCei86399

O

O

CSCei91968

O

O

CSCin95686

 

O

CSCin95789

O

O

CSCsb89732

O

O

CSCsb90192

 

O

CSCsc09732

O

O

CSCsc20106

 

O

CSCsc23435

O

O

CSCsc24966

 

O

CSCsc28722

O

O

CSCsc31424

O

O

CSCsc33788

O

O

CSCsc40012

O

O

CSCsc48919

O

O

CSCsc53604

 

O

CSCsc57865

O

O

CSCsc60283

O

O

CSCsc68084

 

O

CSCsc72994

 

O

CSCsc93936

O

O

CSCsc97070

 

O

CSCsc98796

 

O

CSCsd07246

O`

O`

CSCsd12831

 

O

CSCsd30165

O

O

CSCsd34882

O

O

CSCsd53429

 

O

CSCsd58774

 

O

CSCsd60578

 

O

CSCsd72822

O

O

CSCsd73494

 

O

CSCsd76429

O

O

CSCsd81137

 

O

CSCsd81725

 

O

CSCsd82449

 

O

CSCsd83775

O

O

CSCsd89872

 

O

CSCsd94718

O

O

CSCse70275

O

O

CSCse71420

 

O

CSCse84811

O

O

CSCse88606

O

O

CSCse99087

O

O

CSCsf21970

O

O

CSCsf96043

 

O

CSCsg03171

O

O

CSCsg12020

 

O

CSCsg15392

O

O

CSCsg62359

 

O


Resolved Caveats

CSCei18449

Symptom: When upgrading from Cisco MDS SAN-OS Releases 2.1(1x) to 2.1(2x), in some circumstances, the SSM or ASM modules might not boot properly after the install all command is issued.

Workaround: Manually reload the SSM or ASM module.

CSCei50818

Symptom: iSCSI hosts are unable to log in to the target storage arrays because of name server issues on the IPS blade.

Workaround: None.

CSCei62511

Symptom: If the Cisco MDS 9020 switch has a large number of zones defined, the Fabric Manager will not display them because of buffering requirements.

Workaround: None.

CSCei73996

Symptoms: Under certain circumstances, Fabric Manager shows cached zone members.

Workaround: None.

CSCei79457

Symptom: The port manager process fails because of a NULL pointer access causing a system switchover during a long testing cycle.

Workaround: None.

CSCei81840

Symptom: Even though FCIP IVR capability on a Cisco MDS 9216i switch is bundled with hardware at no extra charge, a switch running Cisco MDS SAN-OS Release 2.1(1a) or later might disable FCIP IVR functionality after the 120 days of enabling the feature. As a result, the Cisco MDS 9216i switch will stop routing traffic, such as IVR functionality, over the FCIP links. There are no issues if FCIP functionality is not enabled on the Cisco MDS 9216i switch.

Workaround: Contact your OSM and/or Cisco TAC to obtain and install SAN-OS version 2.1.2b. If you are unable to upgrade to SAN-OS 2.1.2b at this time, then work with your OSM's service organization to obtain and install a software fix.

CSCei82417

Symptom: When multiple roles are configured on the switch, the SNMP process may consume more memory if the user logs in using the GUI with some VSAN restrictions.

Workaround: Use the network-admin role only, the CLI only, or two well defined roles, network-admin and network-operator.

CSCei88345

Symptom: An Inter-Switch Link (ISL) flap resulting in fabric segmentation or a merge during or after an upgrade from Cisco MDS SAN-OS Release 2.0(x) to a later image where IVR is running might be disruptive. Some possible scenarios include:

FCIP connection flapping during the upgrade process resulting in fabric segmentation or merge.

ISL flap results in fabric segmentation or merge because of hardware issues or a software bug.

ISL port becomes part of PCP results in fabric segmentation or merge because of a port flap.

If this problem occurs, syslogs indicate RDI failure and the flapped lSL could remain in a down state because of a domain overlap. This is caused by conflicts between the allowed domains list and the virtual domain requested through RDI.

Workaround: There are four distinct scenarios for which the workarounds are provided.

1. If you are running Cisco MDS SAN-OS Releases 1.3(X) or 2.0(X) with IVR enabled, we recommend upgrading to Release 2.0(2b). Please contact your OSM for 2.1(2b) availability.

2. If you have already upgraded some or all of your Cisco MDS SAN-OS switches from Cisco MDS SAN-OS Release 1.3(X) or 2.0(x) to Release SAN-OS 2.1(1a), 2.1(1b), or 2.1(2a), a scheduled downtime is required to perform the following steps:

a. Configure static domains for all switches in all VSANs where IVR is enabled. Configure the static domain the same as the running domain so that there is no change in domain IDs. Make sure that all domains are unique across all of the IVR VSANs. We recommend this step as a best practice for IVR-non-NAT mode.

Issue the fcdomain domain {id} static vsan {vsan id} command to configure the static domains.


Note Complete Step 2a for all switches before moving to Step 2b.


b. b. Issue the no ivr virtual-fcdomain-add vsan-ranges 1-4093 command to disable RDI mode on all IVR enabled switches. This can cause traffic disruption.


Note Complete Step 2b for all IVR enabled switches before moving to Step 2c.


c. Check the syslogs for any ISL that was brought down.

Example Syslog Error Messages 
2005 Aug 31 21:52:04 switch %FCDOMAIN-2-EPORT_ISOLATED: %$VSAN 2005%$ Isolation of 
interface port-channel 52 (reason: unknown failure) 
2005 Aug 31 21:52:04 switch %FCDOMAIN-2-EPORT_ISOLATED: %$VSAN 2005%$ Isolation of 
interface port-channel 51 (reason: domain ID assigment failure)

d. Identify any switches isolated and issue the following commands for the affected switches:

switch(config)# vsan database
switch(config-vsan-db)# vsan {vsan ID} suspend
switch(config-vsan-db)# no vsan {vsan ID} suspend

e. e. Issue the ivr refresh command to perform an IVR refresh on all the IVR enabled switches.

f. f. Issue the copy running startup command to save the RDI mode in the startup configuration on all of the switches.

3. If you have already upgraded some or all of the switches from Cisco MDS SAN-OS Release 1.3(X) or 2.0(x) to Releases 2.1(1a), 2.1(1b), or 2.1(2a), with Interop-mode 2 or 3 enabled, issue the ivr refresh command to perform the IVR refresh on all the IVR enabled switches.

4. If you are adding new switches running Cisco MDS SAN-OS Releases SAN-OS 2.1 (1a), 2.1(1b), or 2.1 (2a) to your existing network running Releases 1.3(X) or 2.0 (X), disable RDI mode on your new switches before adding them to the existing network. Issue the no ivr virtual-fcdomain-add vsan-ranges 1-4093 command to disable RDI mode.


Note RDI mode should not be disabled for VSANs running in Interop-mode 2 or Interop-mode 3.


CSCeh69186

Symptom: Fabric Manager might display a duplicate SAN.

Workaround: Uninstall the current Cisco SAN-OS release, and then install Cisco SAN-OS Release 2.1(2b) to remove the invalid data completely. Or upgrade to Cisco SAN-OS Release 2.1(2b), and then open a fabric without reloading from the database.

CSCei67982

Symptoms: During an upgrade of a Cisco MDS 9000 Family switch with two or more MPS 14/2 modules, FCIP tunnels on multiple MPS 14/2 modules can be down at the same time. If a PortChannel with two FCIP tunnels on different 14+2 modules is used for redundancy, this redundancy can be lost. If IVR is running over these FCIP tunnels, IVR can lose remote devices as a result of loss of access over the FCIP-based PortChannel.

Workaround: Place other hitless upgradeable modules between the 14+2 modules to allow for more time between module upgrades and give the FCIP tunnels more time to stabilize.

CSCei76309

Symptoms: Using the Software Install Wizard to install a mix of FabricWare and SANOS software will not work. Once you select SANOS (even if you unselect later), it removes the Fabricware ability.

Workaround: None.

CSCei77038

Symptoms: If you use Device Manager to configure the radius server, the Cisco MDS 9020 switch does not send an authorization request to the server. When configured from the CLI, it works fine.

Workaround: None.

CSCei78778

Symptom: If you restrict the user from changing interface parameters, the user might be able to change it in the running configuration using Device Manager until the changes are saved in the startup configuration.

Workaround: The SAN switch administrator can login in to Device Manager as a restricted user, change the switch port mode, then revert back to the previous mode, then exit Device Manager. This prompts the user to save the configuration to startup configuration, but it will fail or work based on the user roles. After this procedure, a restricted user may not be able to change the switchport mode.

CSCei79457

Symptom: During a long testing cycle involving various tests, the port manager process failed due to a NULL pointer access causing a system switchover.

Workaround: None

Open Caveats

CSCsd29338

Symptom: The port manager might crash and a switchover might occur when FICON is configured and the MDS switch is interoperating with a CNT device. This occurs when a port is UP, a link failure happens, and the remote node ID (RNID) retry timer is activated.

Workaround: None.

CSCeh73149

Symptom: The VSAN suspend/resume operation facilitates network level reconfiguration and is not often used. In Cisco MDS SAN-OS Release 2.1(2), the command should not be used on a SANTap related VSAN.

Workaround: If VSAN suspend/resume must be used, first unprovision SANTap prior to using VSAN suspend/resume.

CSCeh92604

Symptom: Enabling IVR-NAT on the same switch where write acceleration is enabled over a PortChannel of multiple FCIP links might result in frames from the source to the destination not transferring.

Workaround: Do not have all of the following on the same switch:

IVR-NAT enabled

PortChannel of multiple FCIP links that can potentially carry IVR-NAT traffic

FCIP write acceleration enabled

However, any two of the above three configurations are supported on the same switch.


Note IVR in non-NAT mode can be configured with FCIP PortChannels and FCIP write acceleration on the same switch.


CSCei02126

Symptom: If snmpTargetAddrName and snmpTargetParamsName are set to NULL in the SNMP host/target creation, then the SNMP process crashes and may cause a switchover to the standby supervisor module.

Workaround: When using third party tools or any other SNMP tool, set snmpTargetAddrName and snmpTargetParamsName to non-NULL values.

CSCei18830

Symptom: Removing zones from an active zone set may generate a system message that the zone activation has failed because of an Accept Change Authorization (ACA) failure.

Workaround: None required. The IVR retries the activation and eventually the zone set activation succeeds.

CSCei19822

Symptom: An active IVR zone set on the local switch is not propagated when the commit session contains any other configuration changes.

Workaround: For Release 2.1(2), perform an implicit commit without any changes. In the case of a merge failure and the IVR zone set is not active on remote switches but is active on a local switch, issue an implicit commit from the local switch to propagate the active zone set to the remote switches.

For releases prior to 2.1(2), the workaround is different. Add either a dummy member to an existing zone or add a dummy zone with dummy members to the currently active IVR zone set, and then reactivate the IVR zone set. Then issue the commit command, which will propagate the active zone set to other switches.

CSCei40874

Symptom: If port 9001 is in use by another process, the database update for the previous release tables and data may hang.

Workaround: Edit the server.properties file in the bin directory and use another port. Alternatively, remove the process that opened port 9001.

CSCei53783

Symptom: An iSCSI host cannot log in to one IPS port after many supervisor module switchovers.

Workaround: None.

CSCsc16506

Symptom: The following syslog message is displayed:

Transmit Flow Control is seen for too long

followed by link flap of the affected port. This applies only in E port mode and TE port mode of operation on Storage Services Modules (SSM) (DS-X9032-SSM) interfaces and occurs only when class-F packets are dropped due to a timeout condition. Typically, the packet timeout happens when there is serious congestion in the network, forcing the packets to stay in the switch for more than the timeout period.

Workaround: Avoid configuring in E port mode or TE port mode on the Fibre Channel interfaces.

CSCsc46451

Symptom: CFS distribution may become inconsistent when a link flaps. One switch in the CFS distribution list may detect that a CFS peer has dropped from the fabric while the other CFS peers do not detect this. Subsequent CFS distributions result in incorrect updates to CFS peers.

Workaround: Use a switch where all other switches are reachable through CFS for IVR applications and follow these steps:

a. Issue the show ivr vsan-topology command and make sure that the switch auto topology is showing correct information.

b. Issue the ivr copy auto user command in EXEC mode to copy the current active topology to the user-configured topology.


Note The ivr copy auto user command should lock the database on all the remaining 10 IVR enabled switches.


c. Issue the ivr vsan-topology activate command to activate the copied user configured topology.

d. Type ivr commit to push the changes to all the remaining 10 IVR enabled switches.

After Step d, all the IVR enabled switches should have active user-configured topology with the same entries.

Using the switch where the problem exists with the auto topology output, follow these remaining steps:

e. Issue the no ivr distribute command to isolate the switch from any remaining CFS clouds with IVR. Use the show cfs merge status na ivr command on all remaining switches to ensure that the current switch is removed and the output contains just the local switch.

f. Issue the ivr distribute command to retrigger the CFS merge. After stabilization time, use the show cfs merge status na ivr command on each of the switches to verify the correct number of switches are shown.

Finally, reenable auto topology by issuing the ivr vsan-topo auto command, followed by the ivr commit command. After stabilization time (around 2 to 3 minutes), you should see that auto topology is consistent on all switches.

CSCsc75056

Symptom: Installing an invalid license file may cause an MDS switch to reload.

Workaround: None.

CSCsd41578

Symptom: When a port continuously flaps, the Fibre Channel process may crash and cause a supervisor switchover.

Workaround: Use a different port or check the host bus adapter (HBA) port.

CSCsd47064

Symptom: The Forwarding Information Base (FIB) process may fail if an IVR zone set push from the Fabric Manager fails because of an SNMP timeout and various switches send conflicting active IVR zone sets.

Workaround: There are two ways to address the problem:

Examine the output of the show interface mgmt 0 command to see if there is a duplex mismatch that may cause an SNMP timeout.

Use the ivr distribute command to enable Cisco Fabric Services (CFS) distribution for IVR zone or zone sets and the topology through Inter-Switch Links (ISLs).

CSCsd78967

Symptom: If you remove a port from a port channel or shutdown a member port of a port-channel, the ConnUnitPortStatus/State trap is not sent.

Workaround: None.

CSCsd79954

Symptom: A VSAN that is connected to a McDATA switch with interop mode 1 participates in IVR. The VSAN has devices that are zoned for IVR with a device with domain IDs not within the 97 to 127 range. A loss of connectivity between the hosts and storage devices that are zoned for IVR and the devices in a normal zone might occur.

Workaround: None.

CSCse89151

Symptom: If you have more than 800 zones in an active zoneset for a single VSAN, your MDS 9000 switch might reload if you move from basic zoning to enhanced zoning and then read the active zoneset information.

Workaround: Lower the number of zones in an active zoneset for a single VSAN to less than 800.

CSCsh27840

Symptom: While using an FCIP link for remote SPAN, it is possible that the FCIP link may flap.

Workaround: Do not use FCIP links for Remote SPAN.

CSCef56229

Symptom: If an iSCSI initiator is configured differently on multiple switches, iSNS might report more targets to the initiator than the initiator can access. An iSCSI initiator would get a target error if it attempts to establish a connection.

Workaround: None.

CSCeg27584

Symptom: Creating a role that has VSAN policy as "deny" requires an Enterprise License on the switch. If such a role is created on a switch that does not have the license, the switch exhibits different behavior when distribution is turned on versus when distribution is turned off.

If distribution is turned off, creation of the role is rejected.

if distribution is turned on, creation of the role succeeds but the VSAN policy continues to be "permit."

Workaround: None.

CSCeg37598

Symptom: The iSNS server might crash when iSCSI is disabled and iSNS is enabled using Fabric Manager.

Workaround: None.

CSCeh33548

Symptom: Tape devices can only be accessed over an FCIP tunnel in a PortChannel with write acceleration enabled if SID/DID based load-balancing is used in the VSANs.

Workaround: Disable write acceleration or enable SID/DID based load-balancing in the VSANs if you have tape device traffic going over an FCIP tunnel in a PortChannel.

CSCeh41099

Symptom: Protocol and port numbers, if specified in an IP ACL assigned to an IPSec profile (crypto map), will be ignored. In an interop between Microsoft's iSCSI initiator with IPSec encryption with Cisco MDS 9000 Series switches, if IPSec is configured in the Microsoft iSCSI initiator (also the IPSec/IKE initiator), the host IPSec implementation sends the following IPSec policy:

source IP - Host IP, dest IP - MDS IP,
source port - any, dest port - 3260 (iSCSI), protocol - 6 (TCP).

Upon receiving this policy, the protocol and port numbers are ignored and only the IP addresses for the IPSec policy are used. Thus, although iSCSI traffic is encrypted, non-iSCSI traffic (such as ICMP ping) sent by the Microsoft host in clear text will be dropped in the MDS port.

Workaround: None.

CSCeh51924

Symptom: SNMP service might stop and restart because of a corrupted snmpTargetParamsEntry in the snmpTargetParamsTable. This corrupted entry is created when there is a null string in object snmpTargetParamsName as its index.

Workaround: Enter a name in the snmpTargetParamsName with at least one character when creating an snmpTargetParamsEntry.

CSCeh75500

Symptom: A device that interfaces with SANTap may request SANTap to create a session for an ITL that was previously requested, and ITL checking is not robust.

Workaround: Have the device validate the ITL and ensure that it does not send a request for a duplicate ITL.

CSCeh88814

Symptom: When SANTap is unprovisioned, the control virtual target (CVT) object is not getting cleaned up on the supervisor module.

Workaround: To ensure that cleanup occurs, the administrator should first issue the no santap module slot-number appl-vsan vsan-id command to clean up the CVT, and then unprovision SANTap.

CSCei32317

Symptom: When configuring a remote SPAN (RSPAN), the Fibre Channel tunnel will not come up if it goes through more than one hop.

Workaround: Configure the Fibre Channel tunnel explicit-path option and list every IP hop between the source and destination.

CSCei57342

Symptom: If a link is isolated because of a fabric-binding database mismatch, a reactivation of the corrected fabric-binding database may not initialize the ports.

Workaround: Use the shut command followed by the no shut command to manually disable and then enable the link.

CSCei58652

Symptom: When a reconfigure fabric (RCF) frame occurs on a VSAN, the ports may be left in a state where the fabric binding is incorrect.

Workaround: None

CSCei71686

Symptom: If iSCSI is enabled before FCIP, then the qos command that is configurable under a FCIP interface is not available as an option. The reverse is true as well. If FCIP is enabled first, then the qos command is not an option for iSCSI interfaces.

Workaround: None.

CSCei86399

Symptom: A TACACS+ key that includes the less than (<) and greater than (>) characters fails when copied to an FTP server, and then copied back to the MDS switch.

Workaround: None.

CSCei91968

Symptom: In a fabric with more than one switch, there is a possibility of CFS or syslog crashing because of a PSS-FULL condition. This happens because of leakage in the PSS records stored by the CFS module.

CFS internal distributions cause a PSS leakage during one of the following:

An application registration/de-registration. (This is at the rate of 1 PSS records or 60 bytes per event.)

-An ISL Link flap. (This is at the rate of 2 PSS records per CFS registered application. For 10 CFS registered applications, a 1000 flaps would cause a leak of about 1M.)

Application and Regular CFS distributions in a stable fabric do not result in PSS leakages.

Workaround: None. A switchover will help in cleaning up these records but the usage of the partition remains same (dev/shm partition). However, CFS will reuse the freed space for further PSS storage.

CSCin95686

Symptom: The RRD graph in the Performance Manager does not refresh on a web client opened in Mozilla or Netscape.

Workaround: Do not use a proxy server or use the browser's Refresh button.

CSCin95789

Symptom: When you configure Cisco Traffic Analyzer to capture traffic on one or more interfaces on a Windows platform, the configuration web page might not show that the interface has been selected for traffic capture even though traffic capture on that interface is enabled.

Workaround: Check the logs to clarify that the correct interface has been selected.

CSCsb89732

Symptom: After an upgrade from SAN-OS Release 1.3(2a) to any release lower than SAN-OS Release 3.0(1), you may see errors like the following in the syslog file:

2005 Sep 15 17:36:55 coral %SYSMGR-3-CFGWRITE_SRVFAILED: Service "fcc" failed to store 
its configuration (error-id 0xFFFFFFFF).
2005 Sep 15 17:36:56 coral %SYSMGR-2-CFGWRITE_ABORTED: Configuration copy aborted.
2005 Sep 15 17:36:59 coral %SYSMGR-3-CFGWRITE_FAILED: Configuration copy failed 
(error-id 0x401E0000).
2005 Sep 15 17:37:43 coral %SYSMGR-3-CFGWRITE_SRVFAILED: Service "fcc" failed to store 
its configuration (error-id 0xFFFFFFFF).
2005 Sep 15 17:37:44 coral %SYSMGR-2-CFGWRITE_ABORTED: Configuration copy aborted.
2005 Sep 15 17:37:47 coral %SYSMGR-3-CFGWRITE_FAILED: Configuration copy failed 
(error-id 0x401E0000).
2005 Sep 15 17:38:31 coral %SYSMGR-3-CFGWRITE_SRVFAILED: Service "fcc" failed to store 
its configuration (error-id 0xFFFFFFFF).
2005 Sep 15 17:38:32 coral %SYSMGR-2-CFGWRITE_ABORTED: Configuration copy aborted.
2005 Sep 15 17:38:35 coral %SYSMGR-3-CFGWRITE_FAILED: Configuration copy failed 
(error-id 0x401E0000).

Workaround: After the upgrade, issue the copy running-config startup-config command before issuing the show startup-config command.

If you have already encountered this issue, perform a stateful switchover, then issue the copy running-config startup-config command.

CSCsb90192

Symptom: The CFS process crashes while processing a discovery response containing null data.

Workaround: None.

CSCsc09732

Symptom: If there is a port software failure at the same time as a configuration change for an FCIP interface, the configuration change can fail and subsequent configuration and show commands will fail for that FCIP interface.

Workaround: None.

CSCsc20106

Symptom: On a Cisco MDS 9020 Fabric Switch, Fabric Manager displays a 4-Gbps Inter-Switch Link (ISL) as a 3-Gbps ISL.

Workaround: None.

CSCsc23435

Symptom: System logs an error due to a xbar-ASIC interface device 6 (overflow). The error results in packet loss and, potentially, the card going into a failure state.

The down-xbar interface ASIC (D-chip) has a mapping of hardware queues to software destination indexes (DIs).This table is initialized by hardware to map all queues to DI 0. The D-chip statically allocates packet buffers for each hardware queue during initialization. These buffers correspond to credits given to the central arbiter for the corresponding DI.

On line cards with FCIP interfaces, the binding of DIs is performed dynamically after initialization. This means that any hardware queues that have not yet been bound to a DI will actually be giving credits to the arbiter for DI 0.

In rare cases, the D-chip may fill up w