简介：博科光纤交换机操作手册是一份针对博科光纤交换机配置与运维的技术资料，适合网络工程师、存储管理员及数据中心运维人员快速熟悉设备管理。手册以条目化方式梳理了交换机的基本概念、三种交互方式（串口/以太网口/光纤口）以及缺省串口参数和IP访问设置，并详细说明了命令行与图形界面两种管理路径，涵盖Telnet、HyperTerm、Brocade Fabric Manager、Web Tool等常用工具的使用场景。针对日常运维，手册还列出了ipAddrSet、ipAddrShow、configure、portcfg等关键命令的操作方法，介绍了四种用户账号（admin、user、root、factory）的权限划分、密码修改注意事项、Fabric参数调整、License激活、SNMP配置以及配置上传下载等实用知识点，同时给出FOS不同版本并发登录限制等细节，便于读者避开常见坑点。整个资源仅包含1个docx文件，大小26KB，结构紧凑、检索方便，适合作为博科交换机操作的随查手册。目前已有800余人学习，对于希望系统掌握博科交换机管理要点的初中级运维人员，是一份省时高效的参考材料。

1. 博科光纤交换机：别让操作手册躺在硬盘里吃灰

做存储运维的人迟早会碰到博科光纤交换机，尤其是 SilkWorm 系列和后来的 3000、12000、24000 这些型号。第一次接触这设备的人普遍有个错觉：以为它跟 Cisco 交换机一样，插上网线就能用 Web 页面管理。真到现场才发现，默认 IP 是 10.77.77.77，用户名 admin 密码 password，串口线还得自己找 DB9 母对母头——而机房里的老服务器往往根本没有串口。这份手册最值钱的地方不在于罗列命令，而是把登录方式、用户体系、Zoning 配置和状态解读串成了一条完整的运维链路。本文会把手册里最有实操价值的部分拆开讲：登录和 IP 改造、用户与安全基线、状态巡检、Zoning 落地方案，以及配置存档和恢复的坑。适合刚接手博科 SAN 环境的新人照着做，也适合老手对照检查自己的配置习惯。

2. 登录和 IP 配置：串口是第一道门，ipAddrSet 是改造的起点

2.1 三种登录方式怎么选：串口、以太网口、光纤口

手册里明确写了博科交换机的三种交互方式：串口、以太网口、光纤口。实际运维中，90% 的初始配置都是从串口开始的。原因很简单：新交换机默认 IP 可能与现网冲突，或者你根本不知道它被改成什么了，只有串口是无条件可用的。

串口参数是固定的：9600 波特率、8 数据位、无校验、1 停止位、无流控。Windows 上用超级终端或 SecureCRT 新建连接时选择 Serial，速率选 9600 即可。UNIX 环境下手册给出的命令是tip /dev/ttyb -9600，这是老式 Sun 工作站的写法，现在 Linux 主机一般用minicom -s配置串口参数后连接，或者直接用screen /dev/ttyUSB0 9600。

接线时注意：博科交换机串口是 RJ-45 形状的，需要用 Console 线转成 DB9 母头，再接到电脑。如果要连笔记本，还得备一个 USB 转串口线，建议用基于 FTDI 芯片的，CH340 在某些老交换机上会出现乱码。

登录后默认提示符类似sw2:admin>，说明当前用户是 admin。如果显示sw2:user>就说明是普通用户权限。判断当前是哪个用户这一点很重要，因为后续所有配置命令都需要 admin 权限。

2.2 用 ipAddrSet 改造管理 IP：完整交互过程与参数说明

拿到一台新交换机，第一步永远是查看当前 IP，再决定是否修改。ipAddrShow显示的字段包括：

sw2:admin> ipAddrShow Ethernet IP Address: 10.77.77.77 Ethernet Subnetmask: 255.255.255.0 Fibre Channel IP Address: none Fibre Channel Subnetmask: none Gateway Address: 0.0.0.0

这里最关键的是区分 Ethernet IP 和 Fibre Channel IP。前者是管理网口用的，后者是 FC 网络承载 IP 流量用的，日常管理只需要关注 Ethernet 和 Gateway 两项。

修改 IP 用ipAddrSet，交互过程如下：

sw2:admin> ipAddrSet Ethernet IP Address [10.77.77.77]: 192.168.66.107 Ethernet Subnetmask [0.0.0.0]: 255.255.255.0 Fibre Channel IP Address [none]: Fibre Channel Subnetmask [none]: Gateway Address [172.17.1.1]: Set IP address now? [y = set now, n = next reboot]: y

最后一步问的是立即生效还是重启后生效。我一般选 y 立即生效，但前提是你通过串口连的，改完 IP 不会断掉当前会话。如果你正用 Telnet 连在交换机上改 IP，选 y 会立刻断开，这个细节经常有人翻车。

此外，ifmodeshow可以查看管理口的工作模式，ifmodeset可以改。比如某些型号默认是自动协商，接老交换机时可能需要强制成 100M 全双工，否则会出现能 ping 通但 SSH 卡顿的现象。

2.3 2000/3000 系列 Telnet 限制与 SSH 的注意事项

手册里提到一个容易忽略的限制：2000 和 3000 系列同一时刻只支持一个 Telnet 进程。这在多人协作排障时非常容易撞车——你 Telnet 登着，同事也 Telnet 进来，后登录的人会直接把前面的人踢掉。

Fabric OS v4.1 开始支持 SSH v2，这是更安全的选择。但注意，如果交换机启用了 Brocade Secure Fabric OS，CLI 接口只能用 Brocade Secure Telnet 或 SSH，普通 Telnet 会被拒绝。碰到这种情况，先确认交换机是不是跑了 Secure 版本，别在 Telnet 上死磕。

另外，FOS 4.x 允许两个用户同时登录，但配置类操作（比如 Zoning 修改）同一时刻只能一个用户做。这算是半开半闭的机制，从实践角度看，做变更前先确认有没有其他会话，用sessionshow查看当前登录会话是一个好习惯。

3. 用户体系与安全基线：四个账号的边界，别碰 root 和 factory

3.1 用户角色边界：admin、user、root、factory 各能干什么

博科交换机的用户体系比普通网络设备复杂一些，默认有四个账号：admin、user、root、factory。它们的边界如下：

admin 和 user 的差异可以通过一个场景说清楚：switchShow两个用户都能执行，但configure、zoneCreate、cfgEnable只有 admin 能跑。user 账号在手册里的定位是"查看交换机状态"，实际环境中可以把它分配给监控脚本或值班人员。

第一次登录时交换机会要求修改四个账号的密码。手册明确建议：修改 admin 和 user 的密码，不要动 root 和 factory。原因很实际——root 密码如果忘了，恢复流程非常麻烦，甚至可能需要联系厂商重置；factory 密码改了之后，后续如果要做返厂检测或固件恢复，会遇到认证对不上的问题。

3.2 密码修改与登录安全配置

修改密码的命令是passwd，以 admin 身份执行后：

sw2:admin> passwd Changing password for admin Enter old password: Enter new password: Re-type new password:

它会依次列出用户，可以逐个修改。实际操作中，我通常只改 admin 和 user，root 和 factory 直接跳过。这里有一个建议：新密码不要包含交换机的型号名和日期，比如Brocade3000_202401这种，字典枚举的时候真的会中招。

Telnet Timeout 的设置也值得注意。默认情况下 FOS v4.x 是 10 分钟，v3.x 是 0（永不断开）。生产环境我建议设置成 5 分钟，避免有人挂着 Telnet 会话不关，占用会话名额，还留下未锁屏的终端。设置命令是timeout，可以在 configure 菜单里改，也可以通过命令行直接设置。

3.3 SNMP 配置：热搜里都在问的监控接入方法

博科交换机支持 SNMP 协议，通过 MIB 可以读取和配置公共设置。很多监控系统（Zabbix、Prometheus + snmp_exporter）接入 SAN 交换机都会用到。

配置 SNMP 的基本步骤是先确认交换机 IP 可达，然后设置 community 字符串。在 FOS 里常用的命令是snmpconfig，进入交互式配置界面：

sw2:admin> snmpconfig System Contact: System Location: Rack 3, Row A SNMP community string read: public SNMP community string write: private SNMP Trap receiver 1 IP: 10.0.0.50 SNMP Trap receiver 1 enabled: true

注意一点：不同 FOS 版本的 snmpconfig 交互项略有差异，如果只是读监控，只需要配置 read community 就够了。write community 在生产环境尽量不配，避免有人通过 SNMP 写操作修改交换机配置。

还有syslogdipadd命令，可以配置最多 6 个 syslog 服务器地址。这个建议和 SNMP 配合使用，交换机日志实时传到日志平台，SNMP 负责性能指标采集，两个通道互补。

4. 交换机状态巡检：switchShow 和 fabricShow 里的门道

4.1 switchShow 输出解读：端口状态与故障定位

switchShow是博科交换机最常用的状态查看命令，输出信息量很大。新人在初期很难快速定位问题，核心原因是字段太多，不知道先看哪个。手册里对输出字段解释得算是比较清楚的，这里挑几个关键字段讲。

switchName: SW2K switchType: 16.2 switchState: Online switchMode: Native switchRole: Subordinate switchDomain: 1 switchId: fffc01 switchWwn: 10:00:00:60:69:50:16:d5 switchBeacon: OFF

第一行看 switchName，确认自己操作的交换机没有串线。switchType 后的数字对应型号，手册里给了对照表：1 对应 SilkWorm 1000，2 对应 2800，3 对应 2400，4 对应 20x0，5 对应 22x0，9 对应 3800，16 对应 3200，10 对应 12000，12 对应 3900，21 对应 24000，26 对应 3250，27 对应 3850。这套编号现在已经不怎么用了，但老环境里对照型号查 GBIC 类型还是能派上用场。

switchState 是核心状态，只有 Online 才是正常状态。Offline 可能是配置问题，Testing 是在自检，Faulty 说明交换机硬件出问题了。看到 Faulty 先别慌，用errDump或supportshow收集日志，再判断是主板、电源还是光模块故障。

端口区域的信息格式类似：

Port PortType PortState PortSpeed LongDistance Comment 0 sw Online 2G L0 1 lw Online 1G L0 2 sw Laser_Flt N2 L0

端口状态这一行，最需要关注的是Laser_Flt和Port_Flt。Laser_Flt 说明 GBIC 模块收到了激光错误，通常就是光模块故障或光纤链路问题。处理办法：先把光纤拔下来清洁一下，不行就换模块试。Port_Flt 说明端口被标记为故障，可能是链路抖动导致的，也可能是设备侧故障引起。

端口速度那一列有个容易误解的地方：N2表示带宽协商为 2G，AN表示自动协商。如果你的端口速度显示 AN，但实际传输速率明显低于预期，查看一下对端设备的端口配置是否也开了自动协商，不对称的协商可能导致速率降级。

4.2 fabricShow 主交换机选举与 Domain ID 分配

fabricShow查看的是整个 Fabric 的拓扑信息，输出类似：

Switch ID Worldwide Name Enet IP Addr FC IP Addr Name 1 10:00:00:60:69:50:16:d5 192.168.66.107 Switch1 2 10:00:00:05:1e:8f:12:3a 192.168.66.108 Switch2

第一列就是 Domain ID，范围 1 到 239。第三列的 Enet IP Addr 是这个交换机容易被忽略的 IP 来源。Fabric 中有一个概念叫 Principal Switch（主交换机），负责在 Fabric 初始化时为每台交换机分配 8 位 Domain ID。主交换机的选举规则是 WWN 最小的交换机当选——注意这里的 WWN 是全 Fabric 范围内比较，不是只看本机的。

实际运维中的一个典型场景：新交换机加入现有 Fabric，如果它的 WWN 较小，它会等待现有主交换机退出后才发起选举。所以别指望新设备一接入就能成为主交换机，这是正常的。但如果主交换机故障了，Fabric 会自动选举新的主交换机——这个过程可能导致 Domain ID 重新分配，如果配置里硬编码了 Domain ID 的设备可能因此异常。记住一句话：不要依赖主交换机的身份做任何配置，它是自动选举出来的，不是手工指定的。

4.3 nsShow 和 nsAllShow：Name Server 信息怎么看

nsShow查看本交换机登记的 Name Server 信息，核心是确认设备有没有成功登录到 Fabric：

sw2k:admin> nsShow Type: N Pid: 011200 COS: 2,3 PortName: 21:00:00:24:ff:37:9a:01 NodeName: 20:00:00:24:ff:37:9a:01 TTL: na FC4s: SCSI-FCP Fabric Port Name: 10:00:00:60:69:50:16:d5

Type 字段的 N 表示 N_Port，即主机 HBA 或存储端口；NL 表示 NL_Port（环路设备），在直连 Fabric 环境里基本不会看到 NL。Pid 是十六进制的端口地址，前两位是 Domain ID，后四位是端口号。看到 Pid 就能直接判断设备连在哪个交换机的哪个端口上。

nsAllShow显示全 Fabric 所有设备的 PID，可以加参数过滤。比如nsAllShow 8只显示 FCP 端口，nsAllShow 5只显示 FC-IP 端口。排障时这个命令很有用：当你怀疑某个 LUN 映射有问题，先用 nsAllShow 确认主机和存储的端口都登录到了 Fabric，再往下查 Zone 和 LUN 映射。

5. Zoning 配置实操：从命名规划到生效的完整链路

5.1 Software Zone 与 Hardware Zone 的本质差异

Zoning 是博科交换机上用得最多的功能，也是手册里篇幅最大的部分。核心概念有两个：Software Zone 和 Hardware Zone。

Software Zone 完全基于 Name Server 实现。主机登录 Fabric 时向 Name Server 注册并查询设备列表，Name Server 只返回它所属 Zone 内的设备，其他设备对主机不可见。这种方式的优点是实现简单，缺点是它依赖主机"自觉"——如果主机是坏公民，跳过 Name Server 直接扫描地址，照样能访问到 Zone 外的设备。没有严格的安全性。

Hardware Zone 则是在 ASIC 层面做真正的数据包过滤，无论主机是否愿意遵守规则，数据层面就被隔开了。Brocade 的 Zoning 功能在硬件层面实现，无论 Software Zone 还是 Hardware Zone 都不会影响转发性能。

判别标准是成员类型：Zone 同时包含 WWN 和 Domain,Port 成员时是 Software Zone；只有 WWN 或只有 Domain,Port 时是 Hardware Zone。这个判断逻辑由交换机自动完成。换句话说，避免 Software Zone 的唯一办法是：创建 Zone 时成员类型保持一致，不要混用。

5.2 Alias、Zone、Configuration 三层结构与创建顺序

Zoning 涉及三个对象：Alias、Zone、Configuration。

Alias 是把设备 WWN 或 Domain,Port 声明为更好记的别名。比如给主机 HBA 起名HostA_HBA1，给存储端口起名StorageA_Port1。好处是后续换设备时只需要改 Alias 定义，不用改 Zone 配置。

Zone 是一组可以互相访问的设备集合，成员只能是 Alias、WWN 或 Domain,Port。Zone 内设备可以互访，但不能访问 Zone 外的设备。一个 WWN 被放进 Zone 后，它的所有端口都会包含在内——这个特性在设计 Zone 时要注意，如果只想放某个 HBA 的其中一个端口，没办法通过 WWN 精确控制，只能改用 Domain,Port。

Configuration 是一组 Zone 的集合。多个 Zone 同时生效必须放在同一个 Configuration 里。交换机上可以有多个 Configuration 并存，但只有一个能成为 Active Configuration。

配置 Zoning 的标准顺序是：

# 1. 创建 Alias aliCreate "HostA_HBA1", "10:00:00:00:c9:2b:41:5e" aliCreate "StorageA_Port1", "20:00:00:24:ff:37:9a:01" # 2. 创建 Zone，用 Alias 作为成员 zoneCreate "Zone_A", "HostA_HBA1;StorageA_Port1" # 3. 创建 Configuration cfgCreate "Cfg_Prod", "Zone_A;Zone_B" # 4. 激活并保存 cfgEnable "Cfg_Prod" cfgSave

注意最后两步的配合：cfgEnable让配置立即生效，但此时配置还只在内存里；cfgSave把配置写入 Flash，交换机重启后才不会丢。只做 cfgEnable 不做 cfgSave，重启后配置回滚，这是最常见的翻车场景之一。

5.3 修改 Zone 成员的正确姿势

生产环境中给一个 Zone 增加成员是高频操作。手册里给了命令行方式：

aliAdd "mkt", "s3wwn" zoneAdd "ZoneMkt", "s3wwn" cfgEnable "cfgEngMkt" cfgSave

这里的重点是：改完 Zone 后必须重新执行cfgEnable让变更生效，然后cfgSave持久化。很多人改完 zoneAdd 就以为保存了，结果过两天发现配置丢了。

另一种常见做法是用zoneEdit或aliEdit进入交互式编辑器修改。交互式的好处是能看到当前配置的完整内容，不容易出错；坏处是操作步骤多，一次性修改多个成员时容易漏掉。命令行方式适合单个变更，交互式方式适合批量调整。

重新激活配置时，如果之前配置里有多个 Zone，cfgEnable 后所有 Zone 会同时生效，不会只生效你改的那一个。这个机制符合预期，但如果有人之前手动修改了某个 Zone 并忘记保存，这次 cfgEnable 可能会连带生效。

5.4 避坑：Zoning 配置的 5 个常见问题

问题 1：配置完成后发现不生效现象：cfgEnable 执行成功，但两台设备还是不通。原因大概率是 cfgSave 没执行，或者当前激活的 Configuration 不是你以为的那个。解决：cfgShow查看当前激活的配置，确认后重新执行 cfgEnable 和 cfgSave。

问题 2：Zone 里混用了 WWN 和 Domain,Port现象：交换机自动把 Zone 判定为 Software Zone，安全性没有达到预期。原因：创建 Zone 时成员类型不统一。解决：用zoneShow "ZoneName"查看 Zone 成员，如果发现混用，重建 Zone，保持成员类型一致。

问题 3：使用 WWN 划分 Zone 但设备不上线现象：某个主机 HBA 加入了 Zone，但始终无法访问存储。原因：该设备连接的交换机可能不在 BLOOM ASIC 芯片上——手册里特别提到，以 WWN 划分 Zone 时，要保证所有设备连接到 BLOOM ASIC 的交换机上。解决：确认交换机的 ASIC 型号，更换端口或者改用 Domain,Port 方式划分。

问题 4：RSCN 风暴现象：Fabric 中有设备频繁上下线时，所有交换机都收到大量 RSCN 通知，影响业务稳定性。原因：没有启 Zone，RSCN 广播到所有设备。解决：实施 Zoning 后，RSCN 只会发送到状态变更设备所在的 Zone 内，大幅减少无效通知。

问题 5：删除了一个 Zone 但数据库还在报残留现象：cfgRemove 删掉 Zone 后，某配置里还引用着这个 Zone 名称。原因：Configuration 中的成员关系没有同步清理。解决：用cfgShow查看 Configuration 引用的 Zone 列表，逐个确认并移除。

5.5 一个 Zone 一个主机的设计原则

设计 Zone 时有一条最基本的原则：每个 Zone 中只有一台主机（Initiator）。这样做有几个实际好处：结构清晰，不容易出错；防止不同主机争夺对磁盘控制权；变更时影响面最小。

比如一个环境有 3 台主机、2 台存储，合理的划分方式是：

存储端口可以被多个 Zone 引用，这是合法且常见的做法——存储是多主机共享的，但每台主机有自己独立的 Zone。这样某一台主机上下线不会影响到其他主机的访问。

6. 配置存档、恢复与时间同步：给你留一手后悔药

6.1 configureupload 和 configuredownload：配置备份的标准做法

博科交换机的配置备份用configureupload和configuredownload。配置可以上传到 FTP 或本地，常见做法是传到 FTP 服务器。

sw2:admin> configureupload Upload to (A)ll, (C)onfig, (S)ecurity or (Z)oning? [A]: A Protocol (FTP or SCP) [FTP]: FTP Server IP: 192.168.1.100 User: ftpuser Password: ***** Remote Directory: /backup/brocade Remote File: switch1_config_20240115.txt

每次做重大变更前执行一次 configureupload，把配置备份到 FTP。恢复配置用 configuredownload，操作流程类似，只是方向反过来。

恢复配置时有一个细节：Zoning 配置默认是随配置一起恢复的，但如果原配置中 cfgEnable 激活的 Configuration 在新环境中不存在对应设备，恢复后 Zoning 可能处于未激活状态。恢复后应该立即用cfgShow确认，必要时重新 cfgEnable。

6.2 时间同步与 NTP：日志审计的基础

交换机时间不同步的后果，等你翻日志查故障的时候就知道了：事件时间对不上，根本无法判断先后顺序。

sw2:admin> date Wed Jan 15 14:32:08 2025

手工设置时间用date命令，格式是MMDDHHMmYY：

sw2:admin> date "011514322025"

但手工设置只是临时方案，Fabric OS v2.6.1/3.1/4.1 开始支持 NTP 时间同步。指定 NTP 服务器的命令是：

sw2:admin> tsClockServer "137.92.140.80"

如果公司内网有 NTP 服务器，建议直接指向内网地址。设置后可以通过tsTimeZone设置时区，默认是 Pacific time，国内环境记得改成 Asia/Shanghai，否则日志时间会有 8 小时偏差。

6.3 Firmware 升级前后必须做的事

升级固件是风险最高的操作之一，这份手册提到了 License Key 的概念——License 已经加载到固件中，但要用 License Key 激活。升级前，先licenseShow确认现有 License 还在；升级后，除了功能验证，还要确认 License 没有丢失。

升级前另一个必做项是备份当前配置。有些人觉得配置简单，重启后手工敲回来就行，但 Zoning 配置动辄几十条 Alias，手工恢复太容易出错了。

最后说一个我自己的习惯：每次升级固件前，我都会先在测试交换机上跑一遍完整的升级流程，确认目标 FOS 版本与当前配置兼容，再动生产环境。有一次我在生产环境直接升了一个大版本，结果 Zoning 结构变了，存储多路径软件把链路状态搞乱了，业务断了半小时。从那以后，我每次做任何配置变更前都强制走一遍 configureupload，并在变更后用 cfgShow 和 switchShow 做前后对比。配置备份这个习惯，希望帮到你。

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