企业官网建设流程全解析

简介：EMC DS300B光纤交换机维护手册是一份面向存储运维人员与系统管理员的实用技术文档，重点解决光纤交换机日常巡检、启停操作与异常定位等高频问题。手册以实际项目为背景，详细覆盖设备概况、连接拓扑（含与EMC VNX5300存储及数据库、应用服务器HBA卡交叉连接方式）、开机与关机步骤、通过IE登录检查端口别名与zone配置、状态灯颜色判读、供电中断或光纤接口松动等故障诊断，以及调用powermt display dev=all查看多链路alive状态的排错思路，并配有命令输出示例，便于对照判断链路健康度。其中针对单路供电下双机冗余切换的注意事项提醒，能有效帮助运维者规避误操作导致的数据风险。资源为1个doc格式文档，压缩包大小361KB，内容高度精炼，适合数据中心、金融或企业IT机房场景下作为运维手册模板与故障速查清单。目前已有2055人学习下载，对存储网络初学者和一线运维工程师均具实用参考价值。

1. 认识 DS300B 光纤交换机：为什么链路抖动时它总是最后才被想起

EMC DS300B 光纤交换机是存储链路里最容易被忽视的一环。凌晨两点数据库告警，主机多路径日志全是 path down/up，阵列工程师说阵列没事，主机工程师说主机没报错，最后回机柜一看，DS300B 上某只 SFP 的收光功率已经滑到灵敏度边缘。DS300B 是 EMC 时代 Connectrix 系列里的 8Gb 光纤交换机，实质是 Brocade 300 的 OEM 版本，跑的是 FOS，所有 FC 链路都从它身上过，却总在故障排查里被最后想起。这篇笔记面向存储和机房运维，把 DS300B 日常怎么巡检、配置怎么备份、固件怎么升级、Zone 和光模块有哪些坑，以及怎么把日志变成故障时间线讲清楚。新手能跟着跑一遍，熟手可以直接拿走巡检清单。

2. 从面板到命令行：摸清 DS300B 的硬件与三种登录方式

先别急着敲命令，认识设备得从面板开始。DS300B 是 1U 高度，前面板排满 24 个 FC 光口，左侧有 RJ45 样式的管理口和 console 口。很多人第一次接手会把管理口当成上联口去插网线，或者试图把电口模块塞进 FC 光口里，这些都是后面翻车的起点。把硬件看明白，登录方式和后续维护才有意义。

2.1 面板布局：24 个 FC 端口、MGMT 口与 console 口

FC 物理口是 SFP+ 封装，插入 LC 接口的光模块，不是网线。光模块安装到位会有清脆的卡扣声，没卡到位交换机上电后就显示 No_Module，拔出来重插大概率能解决。console 口虽然是 RJ45 外观，但它不是以太网口，需要 rollover 翻转线接到笔记本的串口或 console 服务器，普通网线插上去要么没反应，要么满屏乱码。

登录方式三种：串口、SSH、Web Tools。SSH 和 Web 走 MGMT 口，串口走 console 口。我一般建议任何变更操作都从 SSH 或串口进 CLI，Web Tools 用来看状态可以，做批量变更效率太低。下面的配置过程全部以 CLI 为准。

2.2 串口登录与初始 IP：9600 波特率与 ipaddrset

第一次上手，建议先走串口。用 USB 转串口线连接 console 口，PuTTY 或 SecureCRT 新建会话，波特率 9600，数据位 8，停止位 1，无校验，无流控。如果屏幕上直接出现乱码或完全没反应，把波特率轮流切到 19200 和 115200 再试。我不止一次遇到上一任维护者把串口速率改掉的情况，这不是玄学，是交接记录缺失。

login: admin password: admin

默认账号密码常见是 admin/admin，如果是经过 EMC 原厂部署的设备，以设备标签或交付文档为准。登录成功后先看基本状态：

switchshow ipaddrshow

switchshow 输出里能看到交换机名称、运行状态、端口列表；ipaddrshow 查看管理口的 IP 配置，包括当前是 DHCP 还是静态地址。给管理口配静态 IP 用 ipaddrset：

ipaddrset Ethernet IP Address [10.1.1.1]: 192.168.1.10 Ethernet Subnetmask [255.255.255.0]: 255.255.255.0 Gateway [192.168.1.1]: 192.168.1.1

参数说明：交互式会依次询问管理 IP、子网掩码、网关。配置完成后立即生效，不需要重启交换机。改完用 ipaddrshow 确认。因为管理口和 FC 转发面分离，这个操作在业务时间做也没有影响，但如果交换机里已有 Zone 配置，改动 IP 前最好先备份配置（第 4 章会细讲）。

2.3 SSH 与 Web Tools 登录：管理通道打不开时的判断顺序

串口确认能进之后，建议立即把 SSH 调通，后续远程维护更方便。SSH 登录命令：

ssh admin@192.168.1.10

SSH 连不上时，按顺序查三件事：一是管理口网线是否插在 MGMT 口而不是 FC 光口附近那个看似相同的 RJ45；二是笔记本和交换机管理 IP 是否在同一网段；三是交换机上有没有启用 SSH 服务，某些出厂配置里 SSH 是关闭的，需要先用串口执行 sshutil 相关命令启用。用 ping 和 curl 做基础探测：

ping -c 3 192.168.1.10 curl -I http://192.168.1.10

curl 返回 HTTP 200 只能说明 Web 服务在跑，不代表 Web Tools 一定能开。较老的 FOS 版本里 Web Tools 对 Java 插件版本挑剔，浏览器太新反而打不开。建议参考当前固件版本对应的 EMC 支持矩阵选浏览器，或者干脆用 SSH 做所有操作。能进命令行就不要依赖 Web 做变更，CLI 所见即所得，出问题也好回溯。

2.4 新接手设备时的四件套检查

新接手的 DS300B，先执行四组命令建立“身份基线”，我习惯叫它四件套：

version firmwareshow licenseshow switchshow

version 看 FOS 版本号，EMC 定制版固件会带 EMC 标识；firmwareshow 查看当前激活镜像和备用镜像；licenseshow 看授权，尤其是端口授权——这台交换机物理上有 24 个光口，但出厂可能只激活了其中一部分，扩展端口必须加 license；switchshow 看端口状态和交换机 WWN。把这几条输出存成文本，后续备份文件命名和故障对比都用得上。

3. 日常巡检：用 switchshow、porterrshow、opticshow 建立设备基线

很多人以为 FC 交换机不用管，直到链路抖动才发现什么日志都没有。我的习惯是给每台交换机建一份基线：端口状态、错误计数、光模块收发功率，每季度更新一次。有了基线，故障发生时才能判断“现在的异常是不是原来就有”。巡检命令全部是只读的，不影响业务，白天做完全没问题。

3.1 switchshow 输出解读：Online、E_Port、F_Port 分别什么含义

switchshow 是最常用的状态命令，输出类似这样：

switchshow SwitchName: DS300B-sw01 switchState: Online switchRole: Principal Port 0: 1 Online F-Port 8G 10:00:00:xx:xx:xx:xx:xx Port 1: 2 Online F-Port 8G 10:00:00:xx:xx:xx:xx:xx Port 2: -- No_Module Port 3: 4 Online E-Port 8G 10:00:00:xx:xx:xx:xx:xx

字段含义：Port 是物理端口号，Online 表示端口已启用且链路正常，Offline 表示端口被 disable，No_Module 表示这个槽位没有插光模块，No_Card 表示端口板卡异常（DS300B 是固定端口机型，出现 No_Card 就要考虑硬件故障了）。F-Port 是接服务器 HBA 或存储前端的端口，E-Port 是交换机级联端口。速率显示 8G 就正常，如果看到 4G 或 2G，说明对端设备速率不匹配或光模块速率不对。

巡检时重点看有没有端口从 Online 变成 Offline，或者 Online 状态但速率不对。端口反复 Online/Offline 通常物理层有问题，结合后面的错误计数一起判断。

3.2 porterrshow 端口错误表：CRC、ENC_OUT、TX_TIMEOUT 怎么读

porterrshow 是端口错误统计表，链路级错误都会累计在这里：

porterrshow Port | CRC Err | ENC Out | TX Timeout | Link Reset 0 | 0 | 0 | 0 | 0 1 | 230 | 0 | 12 | 3 2 | 0 | 0 | 0 | 0

四个字段最常用：CRC Err 表示接收帧的 CRC 校验错误，持续增长说明链路误码，常见原因是光模块收光功率太低、光纤头脏、光纤长度超标；ENC Out 是编码错误，由光模块或物理链路引起；TX Timeout 是发送超时，端口没在预期时间内拿到对端信用值，线缆过长或对端异常都会导致；Link Reset 是链路复位计数，每次链路断开再恢复都会加一，频繁增加说明物理连接不稳定。

判断错误的经验不是看绝对值，而是看增长率。交换机运行三年，几百个 CRC 可能只是灰尘积累，但如果上周巡检记下 1200，这周变 1500，那就是持续增长，必须查链路。这个“增量对比”是整个巡检的核心逻辑，基线数据就是为了这一刻。

3.3 opticshow 查看收发功率：光模块也有“亚健康”状态

光模块功率是排查链路问题时最直接的物理证据：

opticshow Port 12: Temperature: 45 C Tx Power: -3.2 dBm Rx Power: -14.5 dBm

Tx Power 是发光功率，偏低说明模块发光单元衰老；Rx Power 是收光功率，最关键。不同模块的接收灵敏度不一样，通常在 -17 到 -20 dBm 范围。如果收光功率接近灵敏度，故障模式就是“平时正常，机房温度一高或光纤一弯，链路直接 reset”。经验做法是收光功率低于模块标称灵敏度 3 dB 以内就列为观察对象，达到灵敏度边缘直接换模块。

还要注意，有些第三方兼容模块在 opticshow 里读不到功率，显示 Unknown。这种时候光模块就成了黑匣子，只能靠错误计数和替换法判断，建议备一两个原厂模块用于交叉验证。

3.4 巡检频率与阈值建议：把这些命令排进日历

每次巡检输出保存成文本，文件名带日期，比如 ds300b-sw01_porterr_20240601.txt。三个月后再翻出来对比，你会感谢当时的自己。这套巡检清单对单台设备适用，对几十台设备的环境，优先把命令封装成脚本批量采集，最后一章会讲脚本化归档的做法。

4. 配置备份与固件升级：给交换机留一份后悔药

FC 交换机配置看起来简单，一个 Zone 文件才几十 KB，丢了好像也能重新敲。但真到设备冒烟那一刻，如果手里没有一份配置备份，所有 Alias、Zone、CFG 都得靠回忆恢复。生产环境里这种事不值得赌。配置备份就是给交换机留的后悔药，平时花两分钟做一次，故障时能省下半天。

4.1 configupload 备份：把配置从交换机搬到 FTP/SCP

configupload 是把当前生效配置导出成文本文件，传到 FTP 或 SCP 服务器。交互式操作：

configupload Protocol (FTP or SCP or USB): scp Server Name or IP Address: 192.168.1.20 User Name: backup Password: ****** Remote File Name: ds300b-sw01_config_20240601.cfg

参数说明：协议选 SCP 比 FTP 安全，传输加密；服务器地址要和交换机管理口网络可达；文件名建议带设备名和日期，否则多台设备的备份很容易混。备份完成后在服务器上执行 head 或 cat 看一眼文件内容，确认不是空文件或损坏文件。配置文件是文本格式，里面能直接看到交换机名称、WWN、Zone 定义。

非交互式写法适合放进脚本：

configupload -p scp -h 192.168.1.20 -u backup -pw 'P@ssword' -f ds300b-sw01_config_20240601.cfg

参数说明：-p 指定协议，-h 服务器地址，-u 用户名，-pw 密码，-f 远程文件名。但 -pw 会出现在 shell 历史里，自动化执行时建议用交互式或把密码放到受保护的脚本配置里。configdownload 是反向操作，把备份文件灌回交换机，但注意只导入到同一台设备，否则就是第 5 章那个坑。

4.2 firmwaredownload 升级步骤：从备份到 switchdisable 的完整流程

固件升级前先做检查，按下面清单过一遍：

升级命令流程：

supportshow configupload -p scp -h 192.168.1.20 -u backup -pw 'P@ssword' -f ds300b-sw01_preupgrade_20240601.cfg switchdisable firmwaredownload -s ftp -h 192.168.1.20 -u ftpuser -pw 'xxxx' -f /firmware/v7.x.x_DS300B.tgz

switchdisable 的作用是停止交换机上的数据转发，避免升级重启过程中业务 IO 撞上链路中断。如果是双活或多路径环境，业务流量会自动切到另一条路径，但仍然要按变更流程走。firmwaredownload 会先校验固件包，再写入备用镜像分区，最后切到新版本并重启。传完固件后不要关闭终端窗口，等它自动重启完成。

重启完成后执行：

switchenable version switchshow

确认新固件版本生效、端口状态恢复 Online。switchenable 把交换机重新置于可转发状态。升级后建议观察一个业务低峰时段，再次执行 porterrshow，如果新增大量 CRC 或 Link Reset，优先查光模块和链路物理状态。

提示：firmwaredownload 过程中不要断开串口或 SSH 连接，也不要对交换机断电；升级失败优先保留现场，不要反复重刷。

4.3 升级失败怎么办：FOS 双镜像机制与回退思路

FOS 采用主备双镜像分区设计，升级流程是先写备用分区，再切换激活。如果激活失败，原镜像通常还在设备里，不会立刻变砖。设备起不来时，用串口观察启动输出，在启动菜单选旧镜像就能回到升级前版本。设备能进命令行时，用 firmwareshow 查看当前镜像和备份镜像，再用 FOS 自带镜像回退命令切回旧分区。

如果升级后端口全部显示 No_Module，先别急着回退，试试逐个端口做 portdisable 再 portenable，或者重插光模块，很多时候是升级重启导致光模块没被重新枚举。回退操作完成后，第一件事不是看版本号，而是执行 switchshow 和 cfgshow 确认端口和 Zone 都正常，然后立刻 configupload 一次，把回退后的状态留档。升级失败处理的核心是“先保现场，再回退”，串口日志和 supportshow 输出是判断原因的唯一依据。

5. 避坑指南：Zone、端口告警与光模块的五个现场

这一章的坑，是我和同行一起踩出来的，不是从理论推的。每个现象按“现象、原因、解决”写清楚，建议对照排查。

5.1 现象：Zone 配置完成后主机侧看不到盘

Zone 创建后没有生效，或者生效了主机没有发起重新扫描，是最常见的两个原因。很多人只执行了 zonecreate，没有 cfgenable，配置停留在草稿状态。

cfgshow cfgenable "prod_cfg" cfgsave cfgactvshow

流程说明：cfgshow 查看当前 defined 配置和 effective 配置；cfgenable 激活指定配置；cfgsave 把激活结果保存到持久化配置里；cfgactvshow 验证当前生效的是哪个配置。主机侧还要在 FC HBA 上重新扫描一次，操作系统不会自动发现新 LUN。另外检查端口状态，如果主机端口没 Online，Zone 再正确也白搭。

5.2 现象：固件升级后所有端口上报 No_Module

升级完成后 switchshow 里一片 No_Module，光模块看起来像集体阵亡。一部分情况是升级过程中交换机多次重启，光模块供电时序异常导致没被枚举；另一部分是升级前有人拔过光模块清洁，插回时没卡到位。真正一批硬件同时损坏的概率不高，但确实存在。

解决方式：对问题端口执行 portdisable 再 portenable，或者把光模块拔出来重插一次，多数能恢复。

portdisable 12 portenable 12

上面的命令用端口号 12 做示例，执行后配合 switchshow 确认。如果重插仍无效，把光模块换到相邻正常端口做交叉验证——跟着端口走就是端口硬件问题，跟着模块走就是光模块问题。升级前拍照记录光模块所在槽位，能省掉后面找对应关系的麻烦。

5.3 现象：光模块明明没有报警，链路却反复 Link Reset

交换机没有 CRC 飙升，但 Link Reset 计数每月涨几十次，业务端频繁看到多路径切换。原因常常是光模块收光功率处于临界区，低于交换机报警门限但高于误码门限，温度波动或光纤轻微弯曲就触发链路复位。这类故障表面最会骗人，模块指示灯正常，日志也看不到 CRC。

解决方式：用 opticshow 记录 Rx Power 并与模块灵敏度对比，收光功率接近灵敏度就直接换模块；清洁光纤两端和 SFP 接口，脏污是误码的老来源；检查光纤跳线弯曲半径，长期打弯会让内部受力不均，表现为时通时断。长距离链路必须用对应距离等级的光模块，短距模块硬上长距光纤迟早翻车。

5.4 现象：configdownload 把另一台设备的配置灌了进来

从共享目录拿了一份“最新备份”往设备里恢复，结果 Zone 全部不是本机的，链路启用后直接乱套。原因是备份文件没有和设备一一对应，或者多台设备的备份都叫 switch.cfg。配置文件里包含交换机名称和 WWN，导入前必须核对。

处理办法：

head -20 ds300b-sw01_config_20240601.cfg grep -i wwn ds300b-sw01_config_20240601.cfg

用 head 看文件开头字段，用 grep 提取 WWN，和 switchshow 输出的本机 WWN 对比，不一致就拒绝导入。我在备份命令里约定文件命名必须带设备名，比如 ds300b-sw01_config_日期.cfg。configdownload 前先 switchdisable，导入后先检查 cfgshow 再 switchenable，不给错误配置影响生产的机会。

5.5 现象：串口连不上、Web 打不开

新接手设备，串口按默认配置敲回车没反应，浏览器访问 HTTP 也是 service unavailable。串口问题八成是波特率不对，或者 console 线用了普通网线而非翻转线。Web 打不开先确认管理口 IP 和笔记本在同一网段，然后确认固件版本是否启用了 Web Tools，最后才考虑浏览器兼容性。

排查顺序：

ipaddrshow ping -c 3 192.168.1.10 curl -I http://192.168.1.10

ipaddrshow 确认管理 IP 和子网掩码；ping 确认链路通；curl 确认 Web 服务在跑。串口会话里把波特率在 9600、19200、115200 之间轮流切，多数能解决。老固件的 Web Tools 依赖 Java 插件版本，参考 EMC 支持矩阵选浏览器，或者直接放弃 Web，用 SSH 完成所有操作。

6. 进阶：把日志与 supportshow 归档变成故障时间线

很多 FC 故障不是瞬时发生，而是累积了几个月的小问题。单看一次巡检结果，错误计数可能都不高，但把时间线拉长，就能看到问题的演变轨迹。我的做法是为每台交换机建立 supportshow 归档目录，每季度存一份，故障时先翻时间线再动手。

操作步骤：在跳板机建目录，比如 ~/support/DS300B/设备名/日期/；每季度 SSH 登录交换机执行 supportshow 保存为文本，再单独存 cfgshow、porterrshow、opticshow 的输出；故障时先看最近几份快照，文件里有硬件温度、电压、固件版本、错误日志摘要，配合 errdump 的时间戳就能定位到首次异常时间点。

归档脚本可以这样写：

#!/bin/bash SW=192.168.1.10 TODAY=$(date +%Y%m%d) OUT=~/support/DS300B/$SW/$TODAY mkdir -p "$OUT" ssh admin@$SW "supportshow" > "$OUT/support.txt" ssh admin@$SW "porterrshow" > "$OUT/porterr.txt" ssh admin@$SW "opticshow" > "$OUT/optic.txt" echo "[OK] 归档完成：$OUT"

参数说明：SSH 建议配好密钥免密登录，否则脚本会在终端里等密码；supportshow 输出较长，重定向到文件时耐心等几秒再确认文件大小；归档放在业务低峰执行，避免和其他备份任务抢带宽。

有个细节容易被忽略：交换机上的时钟如果没有和 NTP 同步，两台级联设备日志时间可能差出几十分钟。巡检时用 clock show 检查时间，不一致立刻配 NTP；配不了的设备，至少在归档文件名里带日期，保证每份快照都能对上明确时间点。

说一个我自己的教训：有次巡检发现某端口 CRC 比三个月前涨了 200，想着下周再处理，结果周四晚上链路就断了，多路径切换导致业务闪断。现在只要错误计数出现跨周期增长，我直接换光模块，几十块钱的成本比半夜爬起来处理强得多。希望帮到你。

本文还有配套的精品资源，点击获取