本附录说明如何使用 Sun Fire Link FM 命令行界面 (CLI) 配置和管理 Sun Fire Link 群集。此处描述的任务包括：
- 创建互联体
- 启动互联体
- 配置互联体
- 监视配置状态
- 搜索链接
- 删除互联体
这些任务要用到以下 CLI 命令：
- listfabrics(1m)
- createfabric(1m)
- startfabric(1m)
- stopfabric(1m)
- killfabrics(1m)
- deletefabric(1m)
- wcfmconf(1m)
- wcfmstat(1m)
- wcfmver(1m)
6 条互联体 命令均在同一手册页 (fabric) 中说明。而 wcfmconf、wcfmstat 和 wcfmver 有单独的手册页。
使用 wcfmconf 配置 Sun Fire Link 群集需要为每个互联体创建一个基于 XML 的配置文件。有关指导，请参见附录 B。
|
注意 - 所有 文本项，包括但不仅限于互联体、域和分区名，均只能使用 ASCII 字符。此限制适用于所有提供给 Sun Management Center GUI 的文本以及编辑基于 XML 的配置文件时输入的文本。
|
本附录中所述的这些命令均包含一个 -h 命令行选项，该选项显示命令的用法信息。它们还拥有为内部使用而开发的选项。这些选项并未在此处进行叙述，因为它们对管理 Sun Fire Link 群集并无任何裨益。
创建新互联体
使用 createfabric 命令可初始化一个新的互联体。此命令建立互联体名称，并创建目录以存放互联体的配置文件和消息日志。
互联体创建后，处于未配置的初始状态。也就是说，它并未与配置文件相关联。这种配置文件定义作为互联体成员的一组节点以及可选的交换机。请参见附录 B 以查看关于互联体配置文件的说明，以及如何创建和编辑配置文件的指导。
此命令的语法如下：
- -h - 显示 createfabric 的用法（可选）
- 互联体名 - 指定互联体的名称（必需）
|
创建新互联体
|
请键入：
# cd /opt/SUNWwcfm/bin
# ./createfabric 互联体名
|
启动、初始化、复位以及校验互联体
使用 startfabric 命令激活指定互联体的互联体管理器。该互联体必须已存在。此命令的语法如下：
startfabric [ -h ][ -p RMI 端口 ] [ [ -i [ 配置文件 ] ] | [ -r
[ [ 配置文件 ] | [ scname:域, 交换机名, scname:域 ... ]
] ] | [ -v ] ] 互联体名
|
- -h - 显示 startfabric 的用法（可选）
- -p - 指定互联体将要使用的 RMI 端口。缺省值是 1099（可选）
- -i - 在 FM 服务器上初始化互联体的配置数据，并启动互联体的守护程序实例。（可选）
- -r - 在群集中所有节点和交换机上或特定节点和/或交换机将配置数据复位到指定状态，并启动互联体的守护程序实例。（可选）
- -v - 验证所有节点和交换机上互联体的状态。（可选）
- 互联体名 - 指定互联体的名称（必需）
通过这些选项，您可以使用 startfabric 命令来初始化、复位以及验证互联体。
初始化选项可用于删除所有与所指的互联体建立了关联的数据，并以如下状态启动互联体：
- 初始化为无配置状态 - 若未指定配置文件，则互联体不与任何节点或交换机相关联。
- 初始化全新配置状态 - 若指定了配置文件，则该文件定义互联体的配置。
复位选项可用于将群集节点和交换机上的互联体配置数据复位，有以下选择：
- 将所有节点和交换机复位到当前配置 - 如果未指定节点或交换机，且未指定配置文件，则所有节点和交换机的本地配置数据都将更新，与互联体的当前配置文件相匹配。
- 将特定节点和/或交换机复位到当前配置 - 如果指定了一个或多个节点或交换机，则指定的节点和/或交换机的本地配置数据将更新，与互联体的当前配置文件相匹配。
- 复位到新配置 - 如果指定了配置文件，则所有节点和/或交换机的本地配置数据都将更新，与指定的配置文件相匹配。
-r 选项的主要目的是为了提供一种方法，当发生某些事件导致节点和交换机上的本地配置状态与已建立的状态不一致时，可以直接在节点和交换机上恢复配置数据。在这种情况下，不带配置文件 自变量使用 -r 选项。
|
注意 - 使用 -r 配置文件 的效果与使用 -i 配置文件 相同。
|
借助验证选项，可验证所有互联体成员节点和交换机上现有互联体的状态。从验证选项得来的信息可用于找出含有与当前互联体状态不一致的配置状态的那些互联体成员。根据这一信息，便可有选择地对这些节点和/或交换机进行复位，而无需复位互联体的所有成员。
|
启动互联体
|
请键入：
# cd /opt/SUNWwcfm/bin
# ./startfabric 互联体名
|
验证和复位互联体
代码示例 A-1 显示所用的验证选项以及得到的结果，从中可以看出交换机 minime 和计算节点 hamlin:A 都具有无效的的 FM 节点 ID。
代码示例 A-1
node1# ./startfabric -v testfab
|
Verifying Fabric...
|
FM Node ID invalid for Fabric Member minime. *** invalid switch
|
FM Node ID verified for Fabric Member vanessa.
|
FM Node ID invalid for Fabric Member hamlin:A. *** invalid node
|
FM Node ID verified for Fabric Member hamlin:B.
|
Validating partition part1:
|
Verified node: hamlin-b
|
Invalid FM Node ID on node: hamlin-a
|
Invalid FM Node ID on switch: minime
|
Verified switch: vanessa
|
Concluded partition verification.
|
Fabric Verification Completed.
|
代码示例 A-2 显示用于复位交换机 minime 和节点 hamlin:A 的复位选项。这一步骤将复位 minime 和 hamlin:A 上的所有配置信息，而不会影响其它节点和交换机。由于未指定配置文件，将使用当前配置。
代码示例 A-2
node1# ./startfabric -r minime hamlin:A testfab
|
Reset Nodes set to: minime hamlin:A
|
Stopping Fabric testfab for Reset/Verify
|
Found FM at [rmi://localhost:1099/testfab]
|
Fabric "testfab" stopped, the FM process may not exit for several seconds
|
Resetting Fabric
|
testfab Bound To Registry
|
配置互联体
使用 wcfmconf 命令来配置互联体并创建一个或多个分区。此过程需要一个完备的 XML 配置文件。请参见附录 B，以获得有关此过程的说明。
|
注意 - 当 XML 配置文件通过 wcfmconf 命令激活时，该文件中指定的互联体名必须完全匹配已创建并启动的互联体名称。
|
此命令的语法如下：
wcfmconf [ -h ] [ -p RMI 端口 ] 配置文件路径
|
- -h - 显示 wcfmconf 的用法（可选）
- -p - 指定互联体将要使用的 RMI 端口。缺省值是 1099（可选）
- 配置文件路径 - 指向 XML 配置文件的绝对或相对路径
|
注意 - 在启动配置进程之前，验证配置文件是否满足特定于站点的配置需求。
|
将配置文件的读/写/执行权限设置为 600。这不是强行规定，这样做只是为了防止文件的内容被意外修改。
|
配置 Sun Fire Link 互联体
|
请键入：
# cd /opt/SUNWwcfm/bin
# ./wcfmconf 配置文件路径
|
如果配置过程顺利完成，您会见到一条消息，提示找到了 Sun Fire Link Manager (FM)。代码示例 A-3 中是一个以互联体 fmdc 为例的输出结果。该输出结尾处的消息指出 FM 已在 localhost:1099/fmdc 找到。该输出不包含任何错误消息。
代码示例 A-3 成功运行 wcfmconf 时的输出
# ./wcfmconf fmdc.xml
|
Config file set to fmdc.xml
|
Found FM at [//localhost:1099/fmdc]
|
Configuration file processed successfully.
|
代码示例 A-4 所示为 wcfmconf 执行不成功时的输出。此输出包含一条消息，它指出尝试读取配置文件时出错。
代码示例 A-4 运行 wcfmconf 不成功时的输出示例
# ./wcfmconf fmdc.xml
|
Config file set to fmdc.xml
|
Found FM at [//localhost:1099/fmdc.xml]
|
Configuration failed
|
Missing Links are:
|
moab::0=fmdc:a:29
|
监视配置状态
在 FM 主机上使用 wcfmstat 命令收集有关互联体成员和状态的信息。wcfmstat 命令还提供指定分区或节点的链接和路由信息。
此命令的语法如下：
wcfmstat [ -h ] [ -r RMI 端口 ] [ -p 分区名 | -n 节点名 ] 互联体名
|
- -h - 显示 wcfmstat 的用法。
- -r - 指定互联体将要使用的 RMI 端口。缺省值是 1099（可选）。
- -p - 指定现有分区的名称（可选）。
- -n - 指定系统控制器名称，其后跟随域 ID，格式为 SC 名：域（可选）。
- 互联体名 - 指定互联体的名称（必需）。
|
以最高级别显示互联体信息
|
请键入：
# cd /opt/SUNWwcfm/bin
# ./wcfmstat 互联体名
代码示例 A-5 显示将互联体名作为自变量时 wcfmstat 的输出内容。在本例中，不存在未分配的节点或交换机。
代码示例 A-5 互联体级别的 wcfmstat 输出
# ./wcfmstat fmdc
|
print_fabric_status
|
Found FM at [rmi://localhost:1099/fmdc]
|
Fabric name is "fmdc"
|
Partition Stripe Level
|
Name Type Topology WCI Link
|
fmdc RSM WCIX_SWITCH 2 2
|
All members of this fabric are assigned to partitions.
|
|
显示特定分区的互联体成员、路由和链接
|
请键入：
# cd /opt/SUNWwcfm/bin
# ./wcfmstat -p 分区名 互联体名
代码示例 A-6 显示当互联体名与分区选项同时指定时 wcfmstat 的输出。
代码示例 A-6 显示特定分区的互联体成员、路由和链接的 wcfmstat 输出
# ./wcfmstat -p part1 fmdc
|
print_partition_status
|
Found FM at [rmi://localhost:1099/fmdc]
|
Partition Name: part1
|
Members:
|
hamlin-a
|
hamlin-b
|
minime-null
|
vanessa-null
|
-----------------------------------------
|
Routes:
|
hamlin:a=hamlin:b
|
hamlin:a:8:1:0=minime::::0=0
|
hamlin:a:8:1:2=vanessa::::0=0
|
hamlin:a:9:1:0=vanessa::::2=0
|
hamlin:a:9:1:2=minime::::2=0
|
hamlin:b:8:1:0=minime::::1=0
|
hamlin:b:8:1:2=vanessa::::1=0
|
hamlin:b:9:1:0=minime::::3=0
|
hamlin:b:9:1:2=vanessa::::3=0
|
-----------------------------------------
|
Links:
|
hamlin:a:8:1:0=minime::::0=0
|
hamlin:a:8:1:2=minime::::0=0
|
hamlin:a:9:1:0=minime::::2=0
|
hamlin:a:9:1:2=minime::::2=0
|
hamlin:b:8:1:0=minime::::1=0
|
hamlin:b:8:1:2=minime::::1=0
|
hamlin:b:9:1:0=minime::::3=0
|
hamlin:b:9:1:2=minime::::3=0
|
|
输出中的 "Routes" 部分列出了每个路由，并在每个路由说明的下面列出了实现该路由的各个链接。路由说明只是由该路由连接的两个域，以等号连接。在代码示例 A-6 中列出的单个路由，连接 hamlin:a 和 hamlin:b。
每个链接说明包含两个端点说明，以等号链接。每个端点说明包含 5 个字段，说明如下：
- SC 或 SSC 名 - 系统的名称（节点或交换机）。
- 域 ID - 对于 Sun Fire 6800 系统，这是 a 到 d 之间的一个字母。对于 Sun Fire 15K/12K 系统，这是 a 到 r 之间的一个字母。对于交换机，此字段为空。
- 机柜 I/O 插槽 - 对于 Sun Fire 6800 系统，这是 8 或 9。对于 Sun Fire 15K/12K 系统，I/O 插槽号的范围是 0 到 17。对于交换机，此字段为空。
- WCI ID - 对于 Sun Fire 6800 系统，WCI ID 值永远是 1。对于 Sun Fire 15K/12K 系统，WCI ID 值等于（插槽号 x 32） + 29。参见图 10-3 以获取 Sun Fire 15K/12K 系统中 WCI ID 值的完整列表。对于交换机，此字段为空。
- 链接（端口）ID - 对于 Sun Fire 6800 和 Sun Fire 15K/12K 系统，此 ID 都是 0 或 2。对于交换机，链接号范围是 0 到 7。
链接说明的最后是状态值，该值可以是以下之一：
输出的 "Links" 部分列出分区中找到的所有链接，而且并不将它们与特定的路由相关联。
验证互联体连接性
使用 wcfmver 命令来验证 XML 配置文件中指定的连接是否与硬件中的实际链接相匹配。可通过两种方式向 wcfmver 提供数据。
- 第一种方式是使用 -c 选项提供互联体配置文件。wcfmver 程序只报告该文件中已列出但搜索进程并未显示的链接，以及所有搜索到但并未列于配置文件中的链接。
- 第二种方式是使用 -n 选项提供互联体节点列表。于是，wcfmver 程序报告对每个指定节点搜索到的所有链接信息。所有指定节点必须位于互联体内。
|
注意 - 使用 -n 选项时，若带有描述节点之间或节点与交换机之间的物理连接的表，将非常有帮助。
|
此命令的语法如下：
wcfmver [ -h ] [ -p RMI 端口 ] {-c 配置文件路径 | -n SC 名：域 交换机
名 ... } 互联体名
|
- -h - 显示 wcfmver 的用法
- -p - 指定互联体将要使用的 RMI 端口。缺省值是 1099（可选）
- -c - 指定含有互联体中全部链接的文件（必需带有此选项或 -n 选项）。请注意，此处指 FM 创建的文件，而不是附录 B 中所述的 XML 配置文件。
- -n - 需要在其上进行链接验证的那些节点的节点列表（必需带有此选项或 -c 选项）
- 互联体名 - 互联体的名称（必需）
|
对于指定节点验证互联体连通性
|
请键入：
# cd /opt/SUNWwcfm/bin
# ./wcfmver -n SC 名:域, 交换机名 互联体名
代码示例 A-7 显示指定两个节点时 wcfmver 的输出。
|
注意 - 请参见显示特定分区的互联体成员、路由和链接以获取对链接说明的解释。
代码示例 A-7 wcfmver 的输出，显示在节点 hamlin-a 与 hamlin-b 所找到的链接通路
# ./wcfmver -n hamlin-sc0:A, hamlin-sc0:b fmdc
| Found FM at [//localhost:1099/testfab]
|
| Starting discovery.
| Estimated wait time = 180 sec.
| ...............
|
| The following links are in the configuration but were not discovered...
|
|
| The following links were discovered but are not in the configuration...
|
| hamlin-sc0:A:6:1:2=unibrow::::2
| hamlin-sc0:A:6:1:0=minime::::0
| hamlin-sc0:A:8:1:2=drevil::::4
| hamlin-sc0:A:8:1:0=vanessa::::0
| hamlin-sc0:B:7:1:2=minime::::1
| hamlin-sc0:B:7:1:0=unibrow::::0
| hamlin-sc0:B:9:1:2=vanessa::::1
| hamlin-sc0:B:9:1:0=drevil::::6
|
|
列出互联体
使用 listfabrics 命令显示所有当前运行互联体的列表。它列出所有联结到指定 RMI 注册表的互联体。
此命令的语法如下：
listfabrics [ -h ] [ -p RMI 端口 ]
|
- -h - 显示 listfabrics 的用法（可选）
- -p - 指定互联体将要使用的 RMI 端口。缺省值是 1099（可选）
|
列出互联体
|
请键入：
# cd /opt/SUNWwcfm/bin
# ./listfabrics
停止互联体
使用 stopfabric 命令来停止指定互联体。此操作从 RMI 注册表取消与 FM 相关联的互联体的联结。
此命令的语法如下：
stopfabric [ -h ] [ -p RMI 端口 ] [ -f ] 互联体名
|
- -h - 显示 stopfabric 的用法（可选）
- -p - 指定互联体将要使用的 RMI 端口。缺省值是 1099（可选）
- -f - 不论其状态如何，均强制指定的互联体停止运行。
- 互联体名 - 互联体的名称（必需）
|
停止互联体
|
请键入：
# cd /opt/SUNWwcfm/bin
# ./stopfabric 互联体名
停止所有互联体
使用 killfabrics 命令来使所有互联体停止运行。它还删除相关联的 FM 守护程序联结的 RMI 注册表。
此命令的语法如下：
其中，-h 显示 killfabrics 的用法。
|
停止所有互联体
|
请键入：
# cd /opt/SUNWwcfm/bin
# ./killfabrics
删除互联体
deletefabric 命令删除与指定互联体相关联的所有互联体信息。
此命令的语法如下：
- -h - 显示 deletefabric 的用法（可选）
- 互联体名 - 互联体的名称（必需）
|
删除互联体
|
请键入：
# cd /opt/SUNWwcfm/bin
# ./deletefabric 互联体名
Sun Fire Link 互联体管理员指南
| 817-0747-11
|
|
Copyright © 2003, Sun Microsystems, Inc. 版权所有。