Cisco MDS 9000 · NX-OS 9.x · native FC ports · isolated new-port examples; Nexus Ethernet and FCoE/vFC need their own procedures
mds-a is an isolated lab switch for Fabric A. VSAN 10 is named PROD_A, app01 HBA A uses fc1/1, and two ONTAP FC target links use fc1/5 and fc1/6. The management example is 192.0.2.31/24. This page establishes the switch and endpoint registration; the separate zoning guide completes host-to-target permission. Existing production ports must not be reassigned as if they were unused lab ports.
About the command and output examples
Names, addresses and results are illustrative. Commands have not been executed against a live storage system or SAN switch for this publication. Confirm syntax and compatibility for your release, then rehearse in an approved lab. Existing-data recovery and destructive changes need an environment-specific plan. Read the editorial standards.
01Identify the exact MDS platform and release
- Record the switch model, serial, running NX-OS version and installed modules. Confirm that the command context is an MDS FC switch rather than an Ethernet Nexus example found online.
- Check module state, fans, power and environmental conditions. For a director, include supervisor redundancy and every relevant fabric/line-card module.
- Verify port licensing/entitlements and supported optics for the actual model. A port that is not licensed or supported cannot be fixed by adding a zone. Retain a timestamped baseline before connecting workloads.
show version
show inventory
show module
show environment
show interface briefThe hardware, software, usable ports and initial component health are known and supported.
02Rack, power and cable the new switch
Use the hardware guide for your exact chassis and rack kit. The linked 9148T guide is an example, not a universal lifting, torque, airflow or power procedure. Separate power feeds only provide the intended resilience if their upstream dependencies are also understood.
- Confirm rack support, depth, clearances and the cold/hot aisle direction. Verify all fitted airflow components match the selected airflow design.
- Install the rails, chassis and protective grounding according to the model guide, then connect approved power and console/management access. Inspect boot messages and component status.
- Label host, target and planned ISL ports by physical fabric. Confirm SFP compatibility, fiber type/reach, connector condition and routing.
- Connect only the approved host/target links. Do not connect a new switch into an existing fabric until domain, zoning, software and merge prerequisites are reviewed in the advanced guide.
Physical installation and cable identity agree with the worksheet, with no unexplained component or optical fault.
03Complete management bootstrap through the console
For a new isolated switch, follow the documented NX-OS setup utility. Maintain console access while setting management addressing and credentials. The utility can also ask about fabric and zoning defaults: review each choice rather than accepting an unintended default-zone access policy. Do not rerun initial setup against a live switch as a troubleshooting shortcut.
| Input | Fictional lab value or decision |
|---|---|
| Hostname | mds-a |
| Management address | 192.0.2.31/24 |
| Management gateway | 192.0.2.1, where the selected management network requires it |
| Administrator authentication | Unique approved credential; do not copy a shared password into notes |
| Management transport | SSH through the authorized management network |
| Time, logs and monitoring | Approved NTP, syslog and SNMPv3/telemetry endpoints |
| Default-zone and zoning mode | Use the reviewed isolation policy; record actual basic/enhanced mode |
- Complete the initial console prompts and record the resulting configuration securely. Use the correct management routing/context for the platform.
- Open a second authorized SSH session and confirm identity and reachability before releasing the console session.
- Apply the site’s AAA/RBAC and secure monitoring design, preserving a tested management recovery route. Test permitted and denied access from the intended management sources.
The switch is securely manageable from the approved network, with recoverable console access and trustworthy time/logging.
04Inspect VSAN and zoning state before allocating ports
A VSAN provides a logical fabric context. Its number and name do not create a separate power supply, chassis or host adapter. Each VSAN has its own zoning database. On independently managed A and B physical fabrics, the same numerical VSAN ID can be reused, but the worksheet must still distinguish the physical fabric and active zone-set name.
- Confirm that VSAN 10 is free or already belongs to this intended lab. Check the existing membership of fc1/1, fc1/5 and fc1/6.
- Inspect each selected port’s connected identity and running configuration. Stop if an apparently spare port carries an application, an ISL, an NPV uplink or a port-channel member.
- Record actual zoning mode. Basic and enhanced zoning use different activation/commit behavior; the zoning guide branches explicitly.
show vsan
show vsan membership
show zone status vsan 10
show zoneset active vsan 10
show running-configNo existing service or fabric context will be accidentally reused or displaced.
05Create the example VSAN and assign unused host/target ports
- Create the approved VSAN name/number under vsan database. Place the designated host and target ports in that same intended context.
- Inspect membership after leaving configuration mode. Match every interface to the cabling worksheet.
- If a target was assigned to a different VSAN by mistake, correct only the reviewed port assignment. Broadly moving all storage ports would affect unrelated consumers.
configure terminal
vsan database
vsan 10 name PROD_A
vsan 10 interface fc1/1
vsan 10 interface fc1/5
vsan 10 interface fc1/6
exit
end
show vsan 10
show vsan 10 membershipThe intended host and both target links belong to the correct active VSAN.
06Configure endpoint links as F ports
An HBA or ordinary storage target connects to an F port in this lab. An ISL between switches uses E/TE behavior, while NPV uplinks have their own role. Set supported speed and other hardware-dependent parameters only when the design requires them; a copied forced-speed value can prevent a perfectly valid link from training.
- Inspect administrative and operational state, negotiated speed and the reason for any down state.
- If the link remains down, verify peer power/HBA state, correct fiber, SFP support and port entitlement before proceeding to zoning.
- Preserve intentionally shut or reserved interfaces. A blanket no shutdown across a switch is not part of host commissioning.
configure terminal
interface fc1/1
description app01_HBA_A
switchport mode F
no shutdown
exit
interface fc1/5
description ontap_node1_FC_A
switchport mode F
no shutdown
exit
interface fc1/6
description ontap_node2_FC_A
switchport mode F
no shutdown
end
show interface fc1/1
show interface fc1/5
show interface fc1/6Each named endpoint link is online in the expected FC role at a supported speed.
07Verify FLOGI and the fabric name server
| Observation | Interpretation |
|---|---|
| Port online, expected HBA absent | Investigate endpoint/login/policy; zoning alone is not the next fix |
| HBA present in VSAN 10, target only in VSAN 20 | Wrong context or intentional routing design; ordinary same-VSAN zoning cannot bridge it |
| Both identities present | Continue to effective zoning, target session and storage presentation checks |
- Confirm the local HBA login maps fc1/1 to the expected port WWN, VSAN and FCID. Compare it with the host adapter inventory.
- Find the ONTAP target LIF WWPNs in the appropriate fabric directory and correlate them with the intended physical uplinks. More than one logged-in identity on an uplink can be valid NPIV behavior.
- Distinguish a local FLOGI from a remote FCNS registration. In a multi-switch fabric, a target can be known through an ISL without being locally attached to this switch.
show flogi database interface fc1/1
show flogi database vsan 10
show fcns database vsan 10
show fcns database detailThe observed initiator and target identities are the intended ones in the correct fabric context.
08Check optics and errors without erasing the baseline
- Record counters and time, then collect again during a representative interval. Old lifetime counts alone cannot show that a fault is still active.
- Compare transceiver readings with that optic’s diagnostic thresholds and supported reach. Investigate a rising CRC/invalid-word or signal-loss condition with the cable, peer and both transceivers.
- Keep evidence before any counter reset or component replacement. Confirm scope and alternate path health before an approved cable/SFP change.
show interface fc1/1 counters detailed
show interface fc1/1 transceiver details
show logging logfileThe new link is stable under relevant traffic, and any counter increase has a documented interpretation.
09Save and export configuration with operational context
Use unique per-switch filenames and an approved reachable receiver. Authenticate through the interactive prompt; credentials do not belong in copied commands. Confirm that the remote files actually exist and are protected. Retain active/full zoning, aliases, port membership and login evidence with the configuration. A support bundle and a restorable configuration serve different purposes.
copy running-config startup-config
copy running-config scp://backupuser@192.0.2.80/backups/mds-a-running.cfg
copy startup-config scp://backupuser@192.0.2.80/backups/mds-a-startup.cfg
show zoneset active vsan 10
show zoneset vsan 10
show device-alias databaseThe approved running state is retained locally and the off-switch backup can be located by the recovery owner.
10Finish commissioning with explicit postchecks
This page ends at a correctly installed and identified switch with logged-in endpoints. Do not declare a mapped application healthy from a FLOGI listing. The zoning procedure adds connectivity permission; host and target checks then establish the intended LUN and service.
| Check | Expected evidence |
|---|---|
| Switch health | Expected modules, power/fans and no unexplained new fault |
| Context | Correct VSAN and exact endpoint membership |
| Links | Expected F-port role, supported speed and stable counters |
| Identity | Observed HBA and target LIF WWPNs match inventory |
| Management | Authorized SSH, trusted time/logs and console recovery |
| Next task | Complete the correct basic/enhanced zoning branch, then target mapping and host acceptance |
The switch is ready for a reviewed zoning change, with enough evidence to diagnose a missing endpoint first.
Use the section links to revisit a step, or follow a related guide below.
Official references and further reading
Choose the matching release in the vendor documentation before using a command or design. References open on the publisher’s website; linked material remains with its publisher.
- Cisco MDS 9.x: managing system hardware
- Cisco MDS 9.x: initial setup utility
- Cisco MDS 9.x: interface configuration
- Cisco MDS 9.x: VSAN configuration
- Cisco MDS 9.x: FLOGI, FCNS and RSCN databases
- Cisco MDS 9.x: FC interfaces, counters and optics
- Cisco MDS 9.x: configuration files
- Cisco MDS 9148T: hardware installation example