HDLM工具介绍

HDLM提供了以下一些工具，以方便HDLM多路径管理。

1. dlmgetras

hdlm信息收集工具，用来收集hdlm相关的各种日志、trace、配置等文件，以方便进行hdlm故障分析。

命令格式

DLMgetras {Collection_information_output_point_directory [-f Collection_information_definition_file_name] | -h}

Collection_information_output_point_directory: 输出目录，dlmgetras收集的信息存储在此目录下

-f Collection_information_definition_file_name：指定需要收集的目录和文件

-h：显示命令帮助信息

-f参数的示例文件

# HDLM manager core file
/opt/DynamicLinkManager/bin/core
#
# Oracle initial parameter
/var/app/oracle/admin/sandb/pfile/init.ora
#
# Oracle Alert Directory
/var/app/oracle/rdbms/log

2. dlmcfgmgr

此工具的作用是让/kernel/drv/dlmfdrv.conf文件的配置不需要重启主机而立即生效。

命令格式

dlmcfgmgr {-a|-h}

-a: 将/kernel/drv/dlmfdrv.conf中的配置信息应用到HDLM driver, 即让配置立即生效

-h: 显示帮助信息

3. dlmsetconf

从OS上获得设备信息，生成HDLM driver配置定义文件dlmfdrv.conf和HDLM nexus driver配置定义文件dlmndrv.conf。

命令格式

dlmsetconf [-d output-directory-name] [-r|-u]

-d: 指定dlmfdrv.conf和dlmndrv.conf文件的生成目录

-r: 此参数使当前已经存在的配置定义文件失效, 并重新生成一个新的配置定义文件. 如果不指定-r参数, 新生成的配置定义文件会继承已存在的配置定义文件信息.  二者的区别在于: 如果使用-r参数, 则所有的LUN都要重配置, 这有可能会改变已配置LUN的instance number/ minor number, 造成SVM设备不可用; 如果不使用-r参数, 则HDLM只重配置改变的LUN, 没改变的LUN不重新配置. 如果系统上有些LUN还在使用, 应尽量避免使用-r参数

-u: 使用此参数只更新配置定义文件中LUN是否由HDLM管理这个属性(unconf 0表示由HDLM管理; 1表示从HDLM管理中移除). 此参数不会更新LUN的其它属性. 文件/opt/DynamicLinkManager/config/dlmfdrv.unconf中定义了希望从HDLM管理中移除的LUN信息.

示例:

dlmsetconf -u命令执行前的dlmfdrv.conf中的信息. 配置文件中有2个LUN, 每个LUN有4条路径. unconf属性为0, 表示LUN由HDLM管理.

-bash-3.2# more /kernel/drv/dlmfdrv.conf
......
################## Admin Device(Do not change this field) ##################
name="dlmfdrv" parent="pseudo" instance=0 AdminDevice;

#
################## T131328 D0(AMS.75040975.0049) ##################
name="dlmfdrv" parent="dlmndrv" instance=1
FilterPath="/pci@0/pci@0/pci@8/pci@0/pci@1/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f0,0"
major=0x76 minor=0x2 target=131328 lun=0 first=1
node-type="ddi_block:fabric" port-wwn="50060e80102a00f0"
unconf=0 LDEV="AMS.75040975.0049"
device-id="6964000100060014737364004849544143484920373530343039373530303439"
device-name="c4t50060E80102A00F0d0"
......
name="dlmfdrv" parent="dlmndrv" instance=3
FilterPath="/pci@0/pci@0/pci@8/pci@0/pci@1/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f3,0"
major=0x76 minor=0x1a target=131072 lun=0 first=0
node-type="ddi_block:fabric" port-wwn="50060e80102a00f3"
unconf=0 LDEV="AMS.75040975.0049"
device-id="6964000100060014737364004849544143484920373530343039373530303439"
device-name="c4t50060E80102A00F0d0"
......
name="dlmfdrv" parent="dlmndrv" instance=4
FilterPath="/pci@0/pci@0/pci@9/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f1,0"
major=0x76 minor=0x12 target=131072 lun=0 first=0
node-type="ddi_block:fabric" port-wwn="50060e80102a00f1"
unconf=0 LDEV="AMS.75040975.0049"
device-id="6964000100060014737364004849544143484920373530343039373530303439"
device-name="c4t50060E80102A00F0d0"
......
name="dlmfdrv" parent="dlmndrv" instance=2
FilterPath="/pci@0/pci@0/pci@9/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f2,0"
major=0x76 minor=0xa target=131328 lun=0 first=0
node-type="ddi_block:fabric" port-wwn="50060e80102a00f2"
unconf=0 LDEV="AMS.75040975.0049"
device-id="6964000100060014737364004849544143484920373530343039373530303439"
device-name="c4t50060E80102A00F0d0"
......
################## T131328 D1(AMS.75040975.0050) ##################
name="dlmfdrv" parent="dlmndrv" instance=5
FilterPath="/pci@0/pci@0/pci@8/pci@0/pci@1/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f0,1"
major=0x76 minor=0x22 target=131328 lun=1 first=1
node-type="ddi_block:fabric" port-wwn="50060e80102a00f0"
unconf=0 LDEV="AMS.75040975.0050"
device-id="6964000100060014737364004849544143484920373530343039373530303530"
device-name="c5t50060E80102A00F0d1"
......
name="dlmfdrv" parent="dlmndrv" instance=6
FilterPath="/pci@0/pci@0/pci@8/pci@0/pci@1/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f3,1"
major=0x76 minor=0x2a target=131072 lun=1 first=0
node-type="ddi_block:fabric" port-wwn="50060e80102a00f3"
unconf=0 LDEV="AMS.75040975.0050"
device-id="6964000100060014737364004849544143484920373530343039373530303530"
device-name="c5t50060E80102A00F0d1"
......
name="dlmfdrv" parent="dlmndrv" instance=7
FilterPath="/pci@0/pci@0/pci@9/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f1,1"
major=0x76 minor=0x32 target=131072 lun=1 first=0
node-type="ddi_block:fabric" port-wwn="50060e80102a00f1"
unconf=0 LDEV="AMS.75040975.0050"
device-id="6964000100060014737364004849544143484920373530343039373530303530"
device-name="c5t50060E80102A00F0d1"
......
name="dlmfdrv" parent="dlmndrv" instance=8
FilterPath="/pci@0/pci@0/pci@9/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f2,1"
major=0x76 minor=0x3a target=131328 lun=1 first=0
node-type="ddi_block:fabric" port-wwn="50060e80102a00f2"
unconf=0 LDEV="AMS.75040975.0050"
device-id="6964000100060014737364004849544143484920373530343039373530303530"
device-name="c5t50060E80102A00F0d1"
......
################## End of dlmfdrv.conf                    ##################

修改/opt/DynamicLinkManager/config/dlmfdrv.unconf文件, 将LUN50从HDLM管理中移除
-bash-3.2# more /opt/DynamicLinkManager/config/dlmfdrv.unconf
#
# All Rights Reserved. Copyright (C) 2003, 2012, Hitachi, Ltd.
#
# dlmfdrv.unconf by dlmsetconf 7.31.0   2012/05/17
#
# Usage: To Unconfigure a LU from HDLM, remove only the character '#'
#        in front of the "LDEV" property line corresponding to the LU,
#        and then execute "dlmsetconf -u" and "reboot -- -r" commands.
# Note1: "LDEV" property represents logical unit (LU) in storage subsystem.
# Note2: Do not edit other character except for the character '#'
#        in front of the "LDEV" property lines.
#
##################### HDLM unconfiguration definition file #####################

#
################## T131328 D0(AMS.75040975.0049) ##################
### Device=ssd0 target=131328 lun=0
### Path=/pci@0/pci@0/pci@8/pci@0/pci@1/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f0,0
### Device=ssd3 target=131072 lun=0
### Path=/pci@0/pci@0/pci@8/pci@0/pci@1/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f3,0
### Device=ssd2 target=131072 lun=0
### Path=/pci@0/pci@0/pci@9/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f1,0
### Device=ssd1 target=131328 lun=0
### Path=/pci@0/pci@0/pci@9/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f2,0
#LDEV=AMS.75040975.0049;
################## T131328 D1(AMS.75040975.0050) ##################
### Device=ssd4 target=131328 lun=1
### Path=/pci@0/pci@0/pci@8/pci@0/pci@1/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f0,1
### Device=ssd5 target=131072 lun=1
### Path=/pci@0/pci@0/pci@8/pci@0/pci@1/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f3,1
### Device=ssd6 target=131072 lun=1
### Path=/pci@0/pci@0/pci@9/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f1,1
### Device=ssd7 target=131328 lun=1
### Path=/pci@0/pci@0/pci@9/QLGC,qlc@0/fp@0,0/ssd@w50060e80102a00f2,1
LDEV=AMS.75040975.0050;

##################### End of dlmfdrv.unconf                #####################

执行dlmsetconf -u:
-bash-3.2# dlmsetconf -u
KAPL10204-I dlmsetconf completed successfully.

dlmfdrv.conf文件中LUN50的unconf值变为1
-bash-3.2# grep -i unconf /kernel/drv/dlmfdrv.conf
unconf=0 LDEV="AMS.75040975.0049"
unconf=0 LDEV="AMS.75040975.0049"
unconf=0 LDEV="AMS.75040975.0049"
unconf=0 LDEV="AMS.75040975.0049"
unconf=1 LDEV="AMS.75040975.0050"
unconf=1 LDEV="AMS.75040975.0050"
unconf=1 LDEV="AMS.75040975.0050"
unconf=1 LDEV="AMS.75040975.0050"