Storage Admin Hub
Cisco MDS SAN · Detailed procedure

Cisco MDS basics: installation, initial setup, VSANs and FC host ports

Prepare an MDS switch, identify its hardware and management plane, create a lab VSAN, attach an FC host and verify real device logins.

Scope

Cisco MDS 9000 · NX-OS 9.x · native FC ports · isolated new-port examples; Nexus Ethernet and FCoE/vFC need their own procedures

Scenario

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

  1. 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.
  2. Check module state, fans, power and environmental conditions. For a director, include supervisor redundancy and every relevant fabric/line-card module.
  3. 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.
MDS EXEC · read-only discovery
show version
show inventory
show module
show environment
show interface brief
Acceptance check

The 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.

  1. Confirm rack support, depth, clearances and the cold/hot aisle direction. Verify all fitted airflow components match the selected airflow design.
  2. 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.
  3. Label host, target and planned ISL ports by physical fabric. Confirm SFP compatibility, fiber type/reach, connector condition and routing.
  4. 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.
Acceptance check

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.

Initial setup worksheet
InputFictional lab value or decision
Hostnamemds-a
Management address192.0.2.31/24
Management gateway192.0.2.1, where the selected management network requires it
Administrator authenticationUnique approved credential; do not copy a shared password into notes
Management transportSSH through the authorized management network
Time, logs and monitoringApproved NTP, syslog and SNMPv3/telemetry endpoints
Default-zone and zoning modeUse the reviewed isolation policy; record actual basic/enhanced mode
  1. Complete the initial console prompts and record the resulting configuration securely. Use the correct management routing/context for the platform.
  2. Open a second authorized SSH session and confirm identity and reachability before releasing the console session.
  3. 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.
Acceptance check

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.

  1. 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.
  2. 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.
  3. Record actual zoning mode. Basic and enhanced zoning use different activation/commit behavior; the zoning guide branches explicitly.
MDS EXEC · read-only; an absent lab VSAN is expected before creation
show vsan
show vsan membership
show zone status vsan 10
show zoneset active vsan 10
show running-config
Acceptance check

No existing service or fabric context will be accidentally reused or displaced.

05Create the example VSAN and assign unused host/target ports

  1. Create the approved VSAN name/number under vsan database. Place the designated host and target ports in that same intended context.
  2. Inspect membership after leaving configuration mode. Match every interface to the cabling worksheet.
  3. 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.
MDS configuration · changes membership of the three named unused lab ports
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 membership
Acceptance check

The 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.

  1. Inspect administrative and operational state, negotiated speed and the reason for any down state.
  2. If the link remains down, verify peer power/HBA state, correct fiber, SFP support and port entitlement before proceeding to zoning.
  3. Preserve intentionally shut or reserved interfaces. A blanket no shutdown across a switch is not part of host commissioning.
MDS configuration · endpoint ports only; not an ISL or NPV uplink template
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/6
Acceptance check

Each named endpoint link is online in the expected FC role at a supported speed.

07Verify FLOGI and the fabric name server

Login acceptance decisions
ObservationInterpretation
Port online, expected HBA absentInvestigate endpoint/login/policy; zoning alone is not the next fix
HBA present in VSAN 10, target only in VSAN 20Wrong context or intentional routing design; ordinary same-VSAN zoning cannot bridge it
Both identities presentContinue to effective zoning, target session and storage presentation checks
  1. Confirm the local HBA login maps fc1/1 to the expected port WWN, VSAN and FCID. Compare it with the host adapter inventory.
  2. 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.
  3. 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.
MDS EXEC · read-only endpoint registration
show flogi database interface fc1/1
show flogi database vsan 10
show fcns database vsan 10
show fcns database detail
Acceptance check

The observed initiator and target identities are the intended ones in the correct fabric context.

08Check optics and errors without erasing the baseline

  1. Record counters and time, then collect again during a representative interval. Old lifetime counts alone cannot show that a fault is still active.
  2. 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.
  3. Keep evidence before any counter reset or component replacement. Confirm scope and alternate path health before an approved cable/SFP change.
MDS EXEC · read-only link evidence; fields vary by platform
show interface fc1/1 counters detailed
show interface fc1/1 transceiver details
show logging logfile
Acceptance check

The 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.

MDS EXEC · persists approved configuration and exports to an authorized SCP receiver
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 database
Acceptance check

The 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.

MDS basics completion record
CheckExpected evidence
Switch healthExpected modules, power/fans and no unexplained new fault
ContextCorrect VSAN and exact endpoint membership
LinksExpected F-port role, supported speed and stable counters
IdentityObserved HBA and target LIF WWPNs match inventory
ManagementAuthorized SSH, trusted time/logs and console recovery
Next taskComplete the correct basic/enhanced zoning branch, then target mapping and host acceptance
Acceptance check

The switch is ready for a reviewed zoning change, with enough evidence to diagnose a missing endpoint first.

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.