Oracle® Solaris Cluster 参考手册

退出打印视图

更新时间: 2014 年 7 月,E51743-01
 
 

scdidadm (1M)

名称

scdidadm - 设备标识符配置和管理实用程序包装

用法概要

/usr/cluster/bin/scdidadm -b combined-did-instance
/usr/cluster/bin/scdidadm -C
/usr/cluster/bin/scdidadm -c
/usr/cluster/bin/scdidadm -F 
     {pathcount | scsi3 | useglobal} instance
/usr/cluster/bin/scdidadm -G
/usr/cluster/bin/scdidadm -G {pathcount | prefer3}
/usr/cluster/bin/scdidadm {-l | -L} [-h] [-o fmt]… [path | 
     instance]
/usr/cluster/bin/scdidadm -R {path | instance | all}
/usr/cluster/bin/scdidadm -r
/usr/cluster/bin/scdidadm -T remote-nodename -e replication-type
/usr/cluster/bin/scdidadm -t 
     source-instance:destination-instance -e replication-type [-g 
     replication-device-group]
/usr/cluster/bin/scdidadm [-u] [-i]
/usr/cluster/bin/scdidadm -v

描述


注 -  Oracle Solaris Cluster 软件包括面向对象的命令集。虽然 Oracle Solaris Cluster 软件仍支持原始的命令集,但是 Oracle Solaris Cluster 过程文档仅使用面向对象的命令集。有关面向对象的命令集的更多信息,请参见 Intro(1CL) 手册页。

scdidadm 实用程序管理设备标识符 (device identifier, DID) 伪设备驱动程序 did

scdidadm 实用程序执行以下主要操作:

  • 创建驱动程序配置文件

  • 修改文件中的条目

  • 将当前配置加载到内核

  • 列出设备条目和 did 驱动程序实例号之间的映射

启动脚本 /etc/init.d/bootcluster 使用 scdidadm 实用程序来初始化 did 驱动程序。您也可以使用 scdidadm 来更新或查询现有设备和相应设备标识符以及 did 驱动程序实例号之间的当前设备映射。

devfsadm(1M) 命令创建文件系统设备入口点。

仅可以在全局区域中使用此命令。

选项

支持以下选项:

–b

将复制的 DID 实例返回到之前为两个独立 DID 实例时的状态。使用此选项可纠正配置错误或准备影响原始 DID 实例的配置更改。

只能从以群集模式引导的节点使用此选项。仅可以在全局区域中使用此选项。

使用 –b 选项前,从使用复制设备的所有设备组中删除复制设备。然后从其 DID 实例被并入组合 DID 实例的节点之一指定此选项。

您需要具有 solaris.cluster.device.modify RBAC 授权才能使用该命令选项。请参见 rbac(5)

–C

删除所有已从当前节点断开的底层设备的 DID 引用。

只能从以群集模式引导的节点使用此选项。仅可以在全局区域中使用此选项。

在已使用 Solaris 设备命令删除对群集节点上不存在设备的引用后指定此选项。

–F 选项不影响已配置的法定设备的隔离协议。

您需要具有 solaris.cluster.device.modify RBAC 授权才能使用该命令选项。请参见 rbac(5)

–c

对设备的内核表示和物理设备执行一致性检查。

仅可以在全局区域中使用此选项。

一致性检查失败时,会显示错误消息。该过程会继续,直到已检查完所有设备为止。

您需要具有 solaris.cluster.device.read RBAC 授权才能使用该命令选项。请参见 rbac(5)

–e type

指定复制类型。指定 SRDF 复制类型时,此选项只能与 –t 选项一起使用。

–F

覆盖各个指定设备的全局默认隔离算法。

设备的默认隔离算法可设置为以下值之一:

pathcount

根据连接到共享设备的 DID 路径的数目来确定隔离协议。

  • 对于使用少于 3 个 DID 路径的设备,该命令会设置 SCSI-2 协议。

  • 对于使用不少于 3 个 DID 路径的设备,该命令会设置 SCSI-3 协议。

scsi3

设置 SCSI-3 协议。如果设备不支持 SCSI-3 协议,则隔离协议设置将保持不变。

useglobal

设置指定设备的全局默认隔离设置。

默认情况下,全局默认隔离算法将设置为 pathcount 。有关设置全局隔离默认值的信息,请参见 –G 选项的描述。

可以通过设备实例号指定要修改的设备。该命令接受以空格分隔的多个设备的列表。有关 instance 格式的设备名称的更多信息,请参见 –o 选项的描述。

–F 选项不影响已配置的法定设备的隔离协议。

您需要具有 solaris.cluster.device.modify RBAC 授权才能使用该命令选项。请参见 rbac(5)

–G

为所有共享设备设置或显示当前全局默认隔离算法。

单独指定时,–G 选项会显示当前全局默认隔离算法设置。

与设置值一起指定时,–G 选项会将所有设备的全局默认隔离设置为该值。全局默认隔离可以设置为以下值之一:

prefer3

为所有设备的设备隔离设置 SCSI-3 协议。pathcount 设置已指定给不支持 SCSI-3 协议的所有设备。

pathcount

根据连接到共享设备的 DID 路径的数目来确定隔离协议。

  • 对于使用少于 3 个 DID 路径的设备,该命令会设置 SCSI-2 协议。

  • 对于使用不少于 3 个 DID 路径的设备,该命令会设置 SCSI-3 协议。

默认情况下,全局默认隔离算法将设置为 pathcount

–G 选项不影响已配置的法定设备的隔离协议。

您需要具有 solaris.cluster.device.modify RBAC 授权才能使用该命令选项。请参见 rbac(5)

–g

指定复制设备组。

–h

列出设备映射时显示标头。

仅当与 –l– L 选项一起使用时,此选项才有意义。

–i

初始化 did 驱动程序。

仅可以在全局区域中使用此选项。

如果要启用 did 驱动程序的 I/O 请求,则使用此选项。

您需要具有 solaris.cluster.device.modify RBAC 授权才能使用该命令选项。请参见 rbac(5)

–L

列出 DID 配置文件中设备的所有路径,包括远程主机上的路径。

仅可以在全局区域中使用此选项。

可以使用 –o 选项定制此命令的输出。如果不指定 –o 选项,默认列表将显示 instance 号、所有本地和远程 fullpath 字符串以及 fullname

您需要具有 solaris.cluster.device.read RBAC 授权才能使用该命令选项。请参见 rbac(5)

–L

列出 DID 配置中的本地设备。

仅可以在全局区域中使用此选项。

可以使用 –o 选项定制此命令的输出。如果不指定 –o 选项,默认列表将显示 instance 号、本地 fullpathfullname

您需要具有 solaris.cluster.device.read RBAC 授权才能使用该命令选项。请参见 rbac(5)

–o fmt

根据格式规范 fmt 列出 did 驱动程序当前已知的设备。

可指定多个 –o 选项。fmt 规范体现为以逗号分隔的格式选项参数列表。仅当与 –l– L 选项一起使用时,此选项才有意义。可用的格式选项参数如下:

instance

显示 did 驱动程序已知的设备的实例号,例如 1

path

显示与此设备标识符关联的设备的物理路径名称,例如 /dev/rdsk/c0t3d0

fullpath

显示与此设备标识符关联的设备的完整物理路径名称。此路径名称包括主机,例如 phys-hostA:/dev/rdsk/c0t3d0

host

带有 –L 选项时,显示已连接至指定设备的所有主机名(每行一个)。带有 – l 选项时,显示已连接至指定设备的本地主机的名称。

name

显示与此设备标识符关联的设备的 DID 名称,例如 d1

fullname

显示与此设备标识符关联的设备的完整 DID 路径名称,例如 /dev/did/rdsk/d1

diskid

显示与列出的设备实例关联的设备标识符的十六进制表示。

asciidiskid

显示与列出的设备实例关联的设备标识符的 ASCII 表示。

defaultfencing

显示设备的默认隔离算法设置。

–R {path | instance | all}

在特定设备实例上执行修复过程。

仅可以在全局区域中使用此选项。

此命令的参数可以是已使用新设备进行替换的特定物理设备 path,也可以是刚替换的设备的 instance。与 all 关键字一起使用时,scdidadm 实用程序会更新连接到节点的所有设备的配置数据。

只能从以群集模式引导的节点使用此选项。

您需要具有 solaris.cluster.device.modify RBAC 授权才能使用该命令选项。请参见 rbac(5)

–r

重新配置数据库。

仅可以在全局区域中使用此选项。

如果指定此选项,将进行对 rdsk rmt 设备树的全面搜索。将为之前未识别的所有设备标识符分配新的实例号。将为每个新识别的设备添加新路径。

只能从以群集模式引导的节点使用此选项。

您需要具有 solaris.cluster.device.modify RBAC 授权才能使用该命令选项。请参见 rbac(5)

–T remote-nodename

配置 DID 设备以用于您使用 –ereplication—type 参数指定的基于存储的复制类型。

仅可以在全局区域中使用此选项。

仅从配置有复制设备的节点之一运行此选项。使用 remote-nodename 选项参数指定远程节点的名称。

本地节点上的 DID 实例将与远程节点上的相应 DID 实例组合到一起,从而将每对复制的设备合并为单个逻辑 DID 设备。

您需要具有 solaris.cluster.device.modify RBAC 授权才能使用该命令选项。请参见 rbac(5)

–t source-instance:destination-instance

将 DID 实例从原始源移动到您使用 destination-instance 选项参数指定的新目标实例。

仅可以在全局区域中使用此选项。

如果意外更改了本地实例,可使用此选项将 DID 实例移回其原始位置。 在已连接到共享存储的所有群集节点上运行该命令后,从某一节点运行 devfsadmscgdevs 命令以使用该配置更改来更新全局设备名称空间。

如果 destination-instance 不存在于群集中,则会删除并使用您指定的 destination-instance 重新创建对应于 source-instance 参数值的 DID 设备路径。

如果 destination-instance 已存在于群集中,则 source-instance 的一条或多条路径会与 destination-instance 的一条或多条路径组合到一起,产生包含这两个实例的所有路径的单个 DID 目标实例。

包括 –e 选项以指定复制类型。如果是使用 SRDF 复制设备,则必须使用 –g 选项来指定复制设备组。

您需要具有 solaris.cluster.device.modify RBAC 授权才能使用该命令选项。请参见 rbac(5)

–u

将设备标识符配置表加载到内核中。

仅可以在全局区域中使用此选项。

此选项可将有关设备路径及其相应实例号的所有当前已知配置信息加载到内核中。

您需要具有 solaris.cluster.device.modify RBAC 授权才能使用该命令选项。请参见 rbac(5)

–v

显示此程序的版本号。

仅可以在全局区域中使用此选项。

示例

示例 1 将连接到本地主机的设备添加到 CCR
# scdidadm -r
示例 2 列出设备的物理路径

以下示例列出了与 did 驱动程序的实例 2 相对应的设备的物理路径:

% scdidadm -l -o path 2
/dev/dsk/c1t4d0
示例 3 指定多个格式选项

您可以使用以下任一方法指定多个格式选项参数:

% scdidadm –l –o path –o name 2
% scdidadm -l -o path,name 2

在任一示例中,输出都可能类似如下:

/dev/dsk/c1t4d0 d1
示例 4 配置 DID 设备以用于基于 EMC SRDF 存储的复制

以下示例配置本地 DID 设备和远程 DID 设备,以用于基于 EMC SRDF 存储的复制。该命令从配置有复制设备的本地源节点上运行。源节点上的 DID 实例会与远程目标节点 phys-schost-1 上的相应 DID 实例组合到一起。

# scdidadm -t 15:10 -e srdf -g devgroup1
示例 5 取消配置复制的 DID 设备

以下示例将复制的 DID 设备 d25 返回至其原始 DID 设备组件。此 DID 设备是通过将 phys-schost--1 上的路径 d15phys-schost--2 上的路径 d25 组合到一起创建的。因为在两个路径进行组合时路径 d15 已合并到路径 d25 中,所以您必须从 phys-schost-1 运行命令以确保恢复路径 d15

phys-schost-1# scdidadm -b 25
示例 6 移动 DID 实例

以下示例将源实例 15 上的 DID 实例移动到新的 DID 实例 10, 然后在全局设备名称空间中更新该配置更改。

# scdidadm -t 15:10
# devfsadm
# scgdevs
示例 7 执行修复过程

以下示例为特定设备路径执行修复过程。设备 /dev/dsk/c1t4d0 已替换为关联有新设备标识符的新设备。更新数据库以显示此新设备标识符对应于之前与旧设备标识符相关联的实例号:

# scdidadm -R c1t4d0
示例 8 执行修复过程

执行修复过程的替代方法是使用与设备路径相关联的实例号。例如,如果上一示例中的设备 c1t4d0 的实例号是 2,则以下语法会执行与上一示例相同的操作:

# scdidadm -R 2
示例 9 全局设置 SCSI 协议

以下示例将群集中的所有 SCSI 设备设置为 SCSI-3 协议,已配置的法定设备和不支持 SCSI-3 协议的设备除外。不支持 SCSI-3 协议的所有设备将设置为 pathcount

# scdidadm -G prefer3
示例 10 显示单个设备的 SCSI 协议

以下示例显示设备 /dev/rdsk/c0t3d0 的 SCSI 协议设置。

# scdidadm -L -o defaultfencing /dev/rdsk/c0t3d0
示例 11 设置单个设备的 SCSI 协议

以下示例为设备 11(由实例编号指定)设置 SCSI-3 协议。此设备不是已配置的法定设备,且支持 SCSI-3 协议。

# scdidadm -F scsi3 11

退出状态

返回以下退出值:

0

命令已成功完成。

1

发生错误。

属性

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

属性类型
属性值
可用性
ha-cluster/system/core
接口稳定性
Stable(稳定)

另请参见

Intro(1CL)cldevice(1CL)devfsadm(1M)scgdevs(1M)did(7)

Oracle Solaris Cluster 系统管理指南

附注

每次进行物理连接时,每个多端口的磁带驱动器或 CD-ROM 驱动器在名称空间中显示一次。