HighPoint 的 CLI 管理程式 (一)：查詢「硬碟裝置、陣列」

自從 HighPoint RocketRAID 的 GUI 不能使用後，只好改用「命令列」介面的管理程式。不過，安裝時卻有些麻煩，經過一番折騰才安裝妥當。詳細請參考：

• 解決「F22 不能安裝 RocketRAID 命令列管理程式」的問題
• 設定 RocketRAID 管理程式的「htpsvr 服務」為「開機自動啟動」

剛開始時，只是用它來查詢、或驗證「磁碟陣列」。最近做了一些進階操作，想說將步驟記下來，寫著、寫著、東加一點說明、西加一點補充，篇幅就愈來愈多，乾脆就將之分成幾篇方便不同用途參考一用。
　　首先，就來講HighPoint RocketRAID 管理程式 hptraidconf 的查詢功能。

一、啟動 hptraidconf

當然，要使用 CLI 管理程式就要先啟動它，但是 hptraidconf 要配合 hptsvr 才能正常使用。若未將 hptsvr 這個服務程式設定為「開機自動啟動」，要先『手動』啟動 hptsvr 服務。

[root@Core-i7 ~]# hptsvr

若已將 hptsvr 設定為「開機自動啟動」，則可直接啟動 hptraidconf。

[root@Core-i7 ~]# hptraidconf
                HighPoint RAID Management Command Line Utility v3.3
Copyright (C) 2009 HighPoint Technologies, Inc. All rights reserved.

Login:RAID
Password:
HighPoint CLI>

管理程式預設的登入帳戶名為『RAID』，密碼為『hpt』。輸入後即進入管理程式提供的 CLI 提示，接著就可以直接下命令了。

二、查詢「命令」的說明

手邊沒有參考手冊時，hptraidconf 也提供即時說明功能。『help』列出 hptraidconf 的所有命令，

HighPoint CLI> help
help [query|create|delete|OCE/ORLM|SAF-TE|rebuild|verify|unplug|
rescan|init|events|mail|task|set|pmstat|exit|help]

依上例所示，在 help 之後再加上命令，就可以得到更詳細的說明。

HighPoint CLI> help query
Query Command
	This command allows you to query devices or arrays' informations.
Syntax:
	query controllers
	query enclosures
	query devices
	query devices {device_id}
	query arrays
	query arrays {array_id}
Note:
	The query devices {device_id} has add S.M.A.R.T information in version 2.1.

接下來，就開始說明 query 這個命令的用法。

三、查詢「硬碟裝置」、「磁碟陣列」

若未將「磁碟陣列卡」上的狀態燈號拉至機殼外，當「磁碟陣列卡」發出『嗶––！嗶––！嗶––！．‧‧‧』的警告聲時，用查詢 (query) 功能就可以快速查到出問題的硬碟裝置 (devices) 或磁碟陣列 (arrays)。

A. 查詢『所有』硬碟陣列 ―― query arrays

列出「磁碟陣列卡」上已建立的「磁碟陣列」，

HighPoint CLI> query arrays
ID	Capacity(GB)	Type	Status	Block	Sector	Cache	Name
--------------------------------------------------------------------------------------------------------------
1	4500.66	RAID5	NORMAL	64k	512B	WB	RR20160131
2	1000.12	RAID1	INIT(B)	––	512B	NONE	RR20160305

上例中，列出兩個「磁碟陣列」的簡單資訊，其中

• ID：「磁碟陣列」的編號，進一步查詢時指定陣列用。
• Type：「磁碟陣列」的型式，筆者常用的是 RAID1 和 RAID5。由上例可以看出，可同時存在不同型式的「磁碟陣列」。
• Status：「磁碟陣列」的狀態，常見到的是 NORMAL (正常)、VERIFYING (驗證中)、CRITICAL (緊急的，常是接線不良) 和 INIT(B) (初始化，剛建立「磁碟陣列」時)。

B. 查詢『個別』硬碟陣列 ―― query arrays {array ID}

列出指定「磁碟陣列」的詳細設定、狀態等資訊。其中的 {array ID} 要換成上一步驟中所查得「磁碟陣列」編號。

HighPoint CLI> query arrays 1
ID:	1	Name:	RR20160131
Type:	RAID5	Status:	VERIFYING
Capacity(GB):	4500.66	BlockSize:	64k
SectorSize:	512B	CachePolicy:	WB
Progress:	50.70%

ID	Capacity	MaxFree	Flag	Status	ModelNumber
--------------------------------------------------------------------------------------------------------------
1/5	2000.31	500.10	NORMAL	RAID	TOSHIBA DT01ACA200
1/6	1500.22	0	NORMAL	RAID	ST1500DM003-9YN16G
1/7	1500.22	0	NORMAL	RAID	ST1500DM003-9YN16G
1/8	1500.22	0	NORMAL	RAID	ST1500DM003-9YN16G

查詢的結果分兩部份，上半部是「磁碟陣列」的狀態，而下半部是組成「磁碟陣列」的「磁碟裝置」。

註：「磁碟裝置」的編號包含兩部份：『／」前是『控制卡編號』和『／」後是『插座編號』組成。

C. 查詢『所有』硬碟裝置 ―― query devices

列出接在「磁碟陣列卡」且已辨認成功的「磁碟裝置」，

HighPoint CLI> query devices
ID	Capacity	MaxFree	Flag	Status	ModelNumber
--------------------------------------------------------------------------------------------------------------
1/5	2000.31	500.10	RAID	NORMAL	TOSHIBA DT01ACA200
1/6	1500.22	0	RAID	NORMAL	ST1500DM003-9YN16G
1/7	1500.22	0	RAID	NORMAL	ST1500DM003-9YN16G
1/8	1500.22	0	RAID	NORMAL	ST1500DM003-9YN16G

上例中「硬碟裝置」1/5 為 2 TB 硬碟，只用了 1.5 TB 剩餘 500 GB。剩餘的硬碟空間可以另外納入另一個「硬碟陣列」使用。

D. 查詢『個別』硬碟裝置 ―― query devices {device ID}

想瞭解個別「磁碟裝置」的詳細狀態時，可以用這個命令。其中的 {array ID} 要換成「磁碟陣列」編號。

HighPoint CLI> query devices 1/5
Mode Number:	TOSHIBA DT01ACA200
Serial Number:	Y3SUHU2KS
Firmware Version:	MX4OABB0

Capacity(GB):	2000.31	TotalFree(GB):	500.10
Status:	RAID	Flag:	NORMAL
Read Ahead:	enabled	Write Cache:	enabled
TCQ:	––	NCQ:	enabled

--------------------------------------------------------------------------------------------------------------
S.M.A.R.T Attributes
Status: S.M.A.R.T OK.
ID	Name	Threshold	Value	Worst	Status
--------------------------------------------------------------------------------------------------------------
1	Raw Read Error Rate	16	100	100	OK
2	Throughput Performance	54	140	140	OK
3	Spin Up Time	24	129	129	OK
4	Start Stop Count	0	100	100	OK
5	Reallocated Sector Ct	5	100	100	OK
7	Seek Error Rate	67	100	100	OK
8	Seek Time Performance	20	124	124	OK
9	Power On Hours	0	100	100	OK
A	Spin Retry Count	0	100	100	OK
C	Power Cycle Count	0	100	100	OK
C0	Power-Off Retract Count	0	100	100	OK
C1	Emergency Retract Cycle Ct	0	100	100	OK
C2	Temperature Celsius	0	181	181	OK
C4	Reallocated Event Count	0	100	100	OK
C5	Current Pending Sector	0	100	100	OK
C6	Offline Uncorrectable	0	100	100	OK
C7	UDMA CRC Error Count	0	200	200	OK
--------------------------------------------------------------------------------------------------------------

查詢的結果分三部份，

• 上半部是「磁碟裝置」的型號、序號和韌軟版本，
• 中間部份則是「磁碟裝置的容量、驅動程式支援的功能，
• 下半部為「磁碟裝置」智慧型管理所回報的狀態。

---

已測試版本：

• Fedora: 20, 22, 23

參考資料：

• HighPoint Technologies, Inc., HighPoint RAID Management - Command Line Interface Guide, Rev. 3.3-2, Aug., 2009.