手册页部分 1M: 系统管理命令

退出打印视图

更新时间: 2014 年 7 月
 
 

luxadm(1M)

名称

luxadm - 管理 Sun Fire 880 存储子系统和 FC_AL 设备

用法概要

luxadm [options]... subcommand [options]... enclosure 
     [,dev] | pathname...

描述

luxadm 程序是用于管理 SENA、Sun Fire 880 内部存储子系统以及单个光纤通道仲裁环路 (Fiber Channel Arbitrated Loop, FC_AL) 设备的管理命令。luxadm 可执行各种控制和查询任务,具体取决于使用的命令行参数和选项。

命令行必须包含子命令。命令行还可以包含选项,通常至少包含一个附件名称或路径名以及取决于子命令的其他参数。您仅需要指定唯一标识子命令所需的那么多个字符。

通过输入路径名指定与子命令交互的设备。对于 SENA 子系统,可以改为指定磁盘设备或附件服务控制器,方法为输入该设备的全球名称 (World Wide Name, WWN) 或者该设备的端口。还可以通过输入 SENA 附件的名称以及该附件中特定设备的可选标识符来指定设备。可以通过输入设备的 WWN 或设备的端口来指定单个 FC_AL 设备。

路径名

通过完整物理路径名或完整逻辑路径名来指定设备或控制器。

对于 SENA,设备的典型物理路径名是:


/devices/sbus@1f,0/SUNW,socal@1,0/sf@0,0/ssd@w2200002037000f96,
         0:a,raw

对于系统上的所有 SENA IB(Interface Board,接口板)和 Sun Fire 880 SES 设备控制器,物理路径的逻辑链接存放在目录 /dev/es 中。以下是逻辑链接的示例 /dev/es/ses0

可以使用 WWN 替代路径名来选择 FC_AL 设备、SENA 子系统 IB 或者 Sun Fire 880 内部存储子系统。WWN 是唯一的 16 个十六进制数字值,指定用于访问设备的端口或者设备自身。典型 WWN 值为:

2200002037000f96

有关 WWN 格式的更多信息,请参见“附注”部分。

对于 Sun Fire 880 内部存储子系统中的磁盘,典型物理路径名为:


/devices/pci@8,600000/SUNW,qlc@2/fp@0,0/ssd@w2100002037a6303c,0:a

典型逻辑路径名为:


/dev/rdsk/c2t8d0s2

对于单个 FC_AL 设备,典型物理路径名为:


/devices/sbus@3.0/SUNW,socal@d,10000/sf@0,0/ssd@w2200002037049fc3,0:a,raw

典型逻辑路径名为:


/dev/rdsk/c1t0d0s2

附件

对于 SENA,可以通过其附件名称和插槽名称标识设备:

box_name[,fslot_number]
box_name[,rslot_number]

box_name 是 SENA 附件的名称,由 enclosure_name 子命令指定。如果使用时不带可选的 slot_number 参数,box_name 标识 SENA 子系统 IB。

fr 指定是 SENA 附件中前面还是后面的插槽。

slot_number 指定 SENA 附件中设备的插槽编号,0-60-10

对于 Sun Fire 880 内部存储子系统,还可以通过设备的附件名称和插槽名称标识该设备。但是,仅有一组磁盘:


box_name[,sslot_number]

box_name 是 Sun Fire 880 附件的名称,由 enclosure_name 子命令指定。如果使用时不带可选的 slot_number 参数,box_name 标识 Sun Fire 880 内部存储子系统附件服务设备。使用 s 指定 Sun Fire 880 内部存储子系统中的磁盘插槽编号,0 - 11

有关磁盘和子系统的逻辑名称的其他信息,请参见 disks(1M)devlinks(1M)

选项

所有子命令都支持以下选项:

–e

专家模式。建议初学用户不要使用此选项。

–v

详细模式。

特定于某个子命令的选项在“用法”部分中随子命令一起进行介绍。

操作数

支持下列操作数:

enclosure

SENA 的 box_name 或者 Sun Fire 880 内部存储子系统。

fibre_channel_HBA_port

主机控制器端口的路径。典型路径为:


 /devices/pci@8,600000/pci@1/SUNW,qlc@4/fp@0,0:devctl
pathname

SENA IB、Sun Fire 880 内部存储子系统或磁盘设备的逻辑或物理路径。pathname 还可以是 SENA IB、SENA 磁盘或单个 FC_AL 设备的 WWN。

用法

子命令

display enclosure[,dev] . . . | pathname . . .
display –p pathname . . .
display –r enclosure[,dev] . . . | pathname . . .
display –v enclosure [,dev] . . . | pathname . . .

显示附件或设备特定的数据。

子系统数据包含附件环境信息以及所有子系统设备(包括磁盘)的状态。

磁盘数据包含查询、容量和配置信息。

–p

显示 pathname 指定的设备或子系统的性能信息。此选项仅适用于累积性能信息的子系统。

–r

显示由路径名指定的 FC_AL 设备的错误信息,如果路径为 SENA,则显示环路上所有设备的错误信息。–r 选项仅适用于 SENA 子系统和单个 FC_AL 设备。

–v

在详细模式下显示,包括模式意义数据。

download [ –s ] [ –f filename_path ] enclosure. . .

下载指向由附件或路径名指定的 SENA 子系统接口板单元或 Sun Fire 880 内部存储子系统的 prom 映像。

SENA 的下载完成时,将重置 SENA 并且执行下载的代码。如果未指定文件名,将使用缺省 prom 映像。SENA 的缺省 prom 映像位于目录 usr/lib/locale/C/LC_MESSAGES 中,名称为 ibfirmware

Sun Fire 880 内部存储子系统的下载完成时,子系统将重置并且下载的代码开始执行。Sun Fire 880 内部存储子系统的缺省固件映像位于:/usr/platform/SUNW,Sun-Fire-880/lib/images/int_fcbpl_fw

–s

保存。–s 选项用于将下载的固件保存在 FEPROM 中。如果未指定 –s,在关开机循环后将不保存下载的固件。

–s 选项不适用于 Sun Fire 880 内部存储子系统,因为该系统始终在闪存中存储下载的固件。

使用 –s 选项时,download 子命令修改子系统上的 FEPROM 并且应谨慎使用

enclosure_name new_name enclosure | pathname

更改由附件或路径名指定的附件的附件名称。新名称 (new_name) 必须等于或少于 16 个字符。仅接受字母或数字字符。此子命令仅适用于 SENA 和 Sun Fire 880 内部存储子系统。

failover primary | secondary pathname

选择访问给定逻辑卷的 Sun Storage T3 存储阵列合作伙伴组控制器。如果指定了 primary,将通过主控制器访问逻辑卷。如果指定了 secondary,将通过由 pathname 指定的辅助控制器访问逻辑卷。

fcal_s_download [ –f fcode-file ]

将文件 fcode-file 中包含的 fcode 下载到所有 FC100/S Sbus 卡中。此命令是交互式的,在下载 fcode 之前需要用户确认。

在单用户模式下使用 fcal_s_download。存在通过某个主机适配器进行的 I/O 活动时,使用 fcal_s_download 更新该适配器会导致该适配器重置。只有在系统重新引导后,才会执行或显示新更新的 FCode。

–f fcode-file

如果调用时不带 –f 选项,将输出每个 FC100/S Sbus 卡中 fcode 的当前版本。

fcode_download –p
fcode_download –d dir-name

查找已安装的 FC/S、FC100/S、FC100/P 或 FC100/2P 主机总线适配器卡,并将 dir-name 中的 FCode 文件下载到适当的卡。该命令确定每种文件类型的正确卡,并且是交互式的。将 FCode 下载到每个设备之前需要用户确认。

请仅在单用户模式下使用 fcode_download 装入 FCode。存在通过某个主机适配器进行的 I/O 活动时,使用 fcode_download 更新该适配器会导致该适配器重置。只有在系统重新引导后,才会执行或显示新更新的 FCode。

–d dir-name

将目录 dir-name 中包含的 FCode 文件下载到适当的适配器卡。

–p

输出每个卡上装入的 FCode 的当前版本。不执行任何下载。

inquiry enclosure[,dev ] . . .  | pathname . . .

显示由附件或路径名指定的所选设备的查询信息。

insert_device [ enclosure,dev . . . ]

帮助用户热插入新设备或者新设备链。有关热插拔操作的限制,请参阅“附注”部分。此子命令仅适用于 SENA、Sun Fire 880 内部存储子系统和单个 FC_AL 驱动器。对于 SENA,如果指定了多个附件,可以在多个总线上执行并发热插入。如果该子命令没有参数,可以插入整个附件或单个 FC_AL 驱动器。对于 SENA 或 Sun Fire 880 内部存储子系统,该子命令以交互方式引导用户执行新设备或设备链的热插入步骤。如果输入了磁盘列表,将要求用户验证要插入的设备列表是否正确,此时用户可以选择继续或退出。然后会以交互方式要求用户插入磁盘或附件,然后创建并显示设备的逻辑路径名。

led enclosure,dev . . . | pathname. . .

显示由附件或路径名指定的磁盘的关联 LED 的当前状态。此子命令仅适用于支持此功能的子系统。

led_blink enclosure,dev . . . | pathname . . .

请求子系统开始闪烁由附件或路径名指定的磁盘的关联 LED。此子命令仅适用于支持此功能的子系统。

led_off enclosure,dev . . . | pathname . . .

请求子系统禁用(关闭)由附件或路径名指定的磁盘的关联 LED。在 SENA 子系统上,此项可能会、也可能不会使 LED 关闭或停止闪烁,具体取决于 SENA 子系统的状态。请参阅《SENA Array Installation and Service Manual》(文件号码 802-7573)。此子命令仅适用于支持此功能的子系统。

led_on pathname . . .

请求子系统启用(打开)由路径名指定的磁盘的关联 LED。此子命令仅适用于支持此功能的子系统。

power_off [ –F ] enclosure[,dev] . . . | pathname  . . .

用于 SENA 时,此子命令会使 SENA 子系统进入节能模式。在节能模式下时,SENA 驱动器不可用。用于 SENA 中的驱动器时,将该驱动器设置为驱动器关闭/不对插状态。在驱动器关闭/不对插状态下,驱动器将降低转速(停止)并处于绕过模式。此命令不适用于 Sun Fire 880 内部存储子系统。

–F

强制选项仅适用于 SENA。指示 luxadm 尝试关闭一个或多个设备的电源,即使这些设备正在由该主机使用(因此处于忙碌状态)也是如此。

警告:关闭包含当前正使用数据的设备的电源将导致不可预测的结果。用户应该首先尝试正常关闭设备电源(无 –F),仅当明确知道不进行正常检查的后果时才能采用此选项。

power_on enclosure[,dev] . . 

使 SENA 子系统离开节能模式(在将此子命令用于 SENA 时)。将此子命令用于驱动器时,会将该驱动器设置为正常启动状态。此命令不适用于 Sun Fire 880 内部存储子系统。

probe [ –p ]

查找和显示关于所有连接的 SENA 子系统、Sun Fire 880 内部存储子系统以及单个 FC_AL 设备的信息,包括逻辑路径名、WWNs 和附件名称。如果此子命令发现具有相同附件名称的不同 SENA,它会对用户进行警告。

–p

在显示中包括物理路径名。

qlgc_s_download [ –f fcode-file ]

将文件 fcode-file 中包含的 FCode 下载到所有 FC100/P、FC100/2P PCI 主机适配器卡中。此命令是交互式的,在将 FCode 下载到每个设备之前需要用户确认。请仅在单用户模式下使用 qlgc_s_download。存在通过某个主机适配器进行的 I/O 活动时,使用 qlgc_s_download 更新该适配器会导致该适配器重置。只有在系统重新引导后,才会执行或显示新更新的 FCode。

–f fcode-file

如果调用时不带 –f 选项,将输出每个 FC100/P、FC100/2P PCI 卡中 FCode 的当前版本。

release pathname

释放指定磁盘上的预留空间。路径名应该是磁盘的物理或逻辑路径名。

包括此子命令只是出于历史原因和诊断目的。

remove_device [ –F ] enclosure[,dev] . . . | pathname . . .

帮助用户热移除设备或设备链。此子命令还可用于移除整个附件。此子命令适用于 SENA、Sun Fire 880 内部存储子系统和单个 FC_AL 驱动器。有关热插拔操作的限制,请参阅“附注”部分。对于 SENA、Sun Fire 880 内部存储子系统和单个 FC_AL 设备,该子命令引导用户执行一个或多个设备的热移除操作。在执行过程中,将要求用户验证要移除的设备列表是否正确,此时用户可以选择继续或退出。然后会准备要移除的磁盘或附件并以交互方式要求用户移除磁盘或附件。

对于多重托管的磁盘,执行的步骤为:

  • 在第一个主机上发出 luxadm remove_device 命令。当提示继续时,请等待。

  • 在辅助主机上发出 luxadm remove_device 命令。当提示继续时,请等待。

  • 在第一个主机上继续执行 remove_device 命令。提示移除设备时执行该操作。

  • 在其他主机上完成 luxadm remove_device 命令。

–F

指示 luxadm 尝试热插拔一个或多个设备,即使这些设备正在由该主机使用(因此处于忙碌保留状态)也强制执行热插拔操作。

警告:移除包含当前正使用的数据的设备将导致不可预测的结果。用户应该首先尝试正常热插拔(无 –F),仅当明确知道不进行正常热插拔检查的后果时才能采用此选项。

reserve pathname

保留指定磁盘,使其供发出命令的主机专用。使用的路径名应该是磁盘的物理或逻辑路径名。

包括此子命令只是出于历史原因和诊断目的。

set_boot_dev [ –y ] pathname

将系统 PROM 中的 boot-device 变量设置为 pathname 指定的物理设备名称,其可以是块特殊设备或者挂载引导文件系统的目录的路径名。该命令通常以交互方式运行,要求对在 PROM 中设置缺省 boot-device 进行确认。可以使用 –y 选项以非交互方式运行该命令,在这种情况下不要求或不需要确认。

start pathname

加快 SENA 中指定磁盘的转速。

stop pathname...

降低 SENA 中指定磁盘的转速。

SENA、Sun Fire 880 内部存储子系统以及单个 FC_AL 驱动器专家模式子命令

以下子命令仅供专家使用,仅适用于 SENA、Sun Fire 880 内部存储子系统和光纤通道环路。这些子命令应该仅由熟悉 SENA 子系统和光纤通道环路的用户使用。

如果为针对总线运行的专家子命令指定磁盘,该子命令会对指定磁盘所连接到的总线运行。

–e bypass [–ab] enclosure,dev
–e bypass –f enclosure

请求附件服务控制器将指定端口和设备的 LRC(Loop Redundancy Circuit,环路冗余线路)设置为绕过状态。

该子命令支持以下选项:

–a

绕过指定设备的端口 a

–b

绕过指定设备的端口 b

–e dump_map fibre_channel_HBA_port

显示指定光纤通道端口上的目标设备或主机总线适配器的 WWN 数据。如果指定端口上没有目标设备,则返回错误。

–e enable [–ab] enclosure,dev
–e enable –f enclosure

请求附件服务控制器将指定端口和设备的 LRC(Loop Redundancy Circuit,环路冗余线路)设置为启用状态。

该子命令支持以下选项:

–a

启用指定设备的端口 a

–b

启用指定设备的端口 b

–e forcelip enclosure[,dev]  . . . | pathname . . .

使用环路初始化基元 (Loop Initialization Primitive, LIP) 序列强制链路重新初始化。附件或路径名可以指定环路上的任何设备。使用路径名指定多重环路配置的特定路径。

这是仅限专家使用的命令,使用时应谨慎。该命令将重置环路上的所有端口。

–e rdls enclosure[,dev]  . . . | pathname . . .

对于包含由附件或路径名指定的设备的环路,读取并显示该环路上所有可用设备的链路错误状态信息。

其他专家模式子命令

有关这些子命令的限制,请参见“附注”部分。这些子命令应该仅由熟悉其所管理的系统的用户使用。

这些命令不适用于 Sun Fire 880 内部存储子系统。

–e bus_getstate pathname

获取并显示指定总线的状态。

–e bus_quiesce pathname

停止指定总线。

–e bus_reset pathname

仅重置指定总线。

–e bus_resetall pathname

重置指定总线和所有设备。

–e bus_unquiesce pathname

将指定总线停止。

–e dev_getstate pathname

获取并显示指定设备的状态。

–e dev_reset pathname

重置指定设备。

–e offline pathname

将指定设备脱机。

–e online pathname

将指定设备联机。

示例

示例 1 显示系统上的 SENA 和单个 FC_AL 设备

以下示例查找并显示系统上的所有 SENA 和单个 FC_AL 设备:


example% luxadm probe

示例 2 显示 SENA 或 Sun Fire 880 内部存储子系统

以下示例显示 SENA 或 Sun Fire 880 内部存储子系统:

example% luxadm display /dev/es/ses0
示例 3 显示两个子系统

以下示例使用附件名称显示两个子系统:

example% luxadm display BOB system1
示例 4 显示关于第一个磁盘的信息

以下示例显示名为 BOB 的附件前面第一个磁盘的信息。使用 f 指定前面的磁盘。使用 r 指定后面的磁盘。


example% luxadm display BOB,f0

示例 5 显示关于 Sun Fire 880 内部存储子系统的信息

Sun Fire 880 内部存储子系统仅具有一组磁盘。在这种情况下,使用 s 指定插槽:


example% luxadm display BOB,s0 

示例 6 显示关于 SENA 磁盘、附件或单个 FC_AL 驱动器的信息

以下示例显示关于 SENA 磁盘、附件或端口 WWN 为 2200002037001246 的单个 FC_AL 驱动器的信息:


example% luxadm display 2200002037001246

示例 7 使用唯一字符发出子命令

以下示例仅使用了唯一标识子命令所需的那么多个字符:


example% luxadm disp BOB

示例 8 显示错误信息

以下示例显示关于附件 BOB 所在的环路的错误信息:


example% luxadm display –r BOB

示例 9 将新固件下载到接口板

以下示例将新固件下载到名为 BOB 的附件中的接口板中(使用文件的缺省路径进行下载):


example% luxadm download –s BOB

示例 10 显示来自 SCSI 查询命令的信息

以下示例显示 SCSI 查询命令从系统上所有单个磁盘获取的信息,仅使用唯一标识查询子命令所需的那么多个字符:


example% luxadm inq /dev/rdsk/c?t?d?s2

示例 11 热插拔

以下示例将新驱动器热插入名为 BOB 的附件前面的第一个插槽中:


example% luxadm insert_device BOB,f0

以下示例将新驱动器热插入名为 SF880-1 的 Sun Fire 880 内部存储子系统中的第一个插槽中:


example% luxadm insert_device SF880-1,s0

示例 12 运行专家子命令

以下示例运行专家子命令。该子命令在附件 BOB 所在的环路上强制环路初始化:

example% luxadm –e forcelip BOB
示例 13 使用专家模式热插拔子命令

下面是使用专家模式热插拔子命令来热移除磁盘的示例。有关热插拔的限制,请参见“附注”部分

第一个步骤保留 SCSI 设备,使其无法从它的第二个 SCSI 总线访问:

example# luxadm reserve /dev/rdsk/c1t8d0s2
示例 14 将要移除的磁盘脱机

后面两个步骤将要移除的磁盘脱机,然后停止总线:

example# luxadm –e offline /dev/rdsk/c1t8d0s2
example# luxadm -e bus_quiesce /dev/rdsk/c1t8d0s2
示例 15 将总线停止

然后,用户移除磁盘并继续执行以下操作:将总线停止、将磁盘重新联机,然后将其取消保留:

example# luxadm –e bus_unquiesce /dev/rdsk/c1t8d0s2
example# luxadm –e online /dev/rdsk/c1t8d0s2
example# luxadm release /dev/rdsk/c1t8d0s2

环境变量

有关影响 luxadm 执行的 LANG 环境变量的说明,请参见 environ(5)

退出状态

将返回以下退出值:

0

成功完成。

−1

出现错误。

文件

  • usr/lib/firmware/fc_s/fc_s_fcode

  • usr/lib/locale/C/LC_MESSAGES/ibfirmware

属性

有关下列属性的说明,请参见 attributes(5)

usr/sbin

属性类型
属性值
可用性
system/storage/fc-utilities

另请参见

devlinks(1M)disks(1M)attributes(5)environ(5)ses(7D)

在 Oracle Solaris 11.2 中管理 SAN 设备和多路径

Oracle Solaris Cluster 3.3 with Fibre Channel JBOD Storage Device Manual

附注

请参见 R.Snively 编著的《Tutorial for SCSI use of IEEE Company_ID》,了解关于 IEEE 扩展 WWN 的其他信息。当前,仅某些设备驱动程序支持热插拔。如果在不支持热插拔的磁盘或总线上尝试热插拔,将显示以下形式的错误消息:

luxadm: can't acquire "PATHNAME": No such file or directory

……

请务必谨慎,不要停止包含根文件系统或 /usr 文件系统或者任何交换数据的总线。如果停止此类总线,会导致死锁,从而需要重新引导系统。