第5章

SMS DR 程序－從系統控制器 (SC) 執行 (僅限高階)

本章節敘述如何在 Sun Fire 高階伺服器負責執行系統管理服務 (SMS) 軟體的系統控制器 (SC) 上面使用 DR。

注意 - 在您嘗試在板上或元件上執行任何 DR 作業之前，請根據準備使用 DR的說明，判定其狀態及狀況。

本章節涵蓋以下主題：

顯示裝置資訊

顯示平台資訊

顯示板資訊

新增板

刪除板

移動板

更換作用中的系統板

SMS DR 指令和選項

錯誤訊息說明系統

備註 - 在一項 DR 作業中，若是其一 SMS DR 指令執行失敗，板不會回復至其原來的狀態。如果錯誤可以修復，您可以重新執行指令。如果無法修復錯誤，您必須重新啟動網域方能使用板。

SMS DR 的指令 rcfgadm(1M) 與網域中的指令 cfgadm(1M) 用法相似，兩項指令接受同樣的選項。較明顯的差別是：rcfgadm(1M) 經常需要附加 -d domain_id 的參數。本章節集中討論其他的 SMS 指令。有關 rcfgadm(1M) 的資訊，請參閱 rcfgadm(1M) 指令。

顯示裝置資訊

在您嘗試執行任何 DR 作業之前，尤其在移除裝置之前，請使用 SMS 指令 showdevices(1M) 來顯示裝置資訊。

顯示裝置資訊

顯示網域的裝置資訊。

# showdevices -v -d domain_id

showdevices(1M) 將顯示網域裡所有裝置的資訊，並產生與下列表單相同的輸出結果。

表 5-1 `showdevices` 輸出範例，CPU
domain	board	id	state	speed	ecache	usage
A	SB1	40	online	400	4
A	SB1	41	online	400	4
A	SB1	42	online	400	4
A	SB1	43	online	400	4
A	SB2	55	online	400	4
A	SB2	56	online	400	4
A	SB2	57	online	400	4
A	SB2	58	online	400	4

表 5-2 `showdevices` 輸出範例，UltraSPARC IV+ ( `showdevices -d G` )
domain	board	id	state	speed	ecache
G	SB0	0	on-line	1050	8
G	SB0	1	on-line	1050	8
G	SB0	2	on-line	1050	8
G	SB0	3	on-line	1050	8
G	SB0	4	on-line	1050	8
G	SB0	5	on-line	1050	8
G	SB0	6	on-line	1050	8
G	SB0	7	on-line	1050	8
G	SB9	288	on-line	900	8
G	SB9	289	on-line	900	8
G	SB9	290	on-line	900	8
G	SB9	291	on-line	900	8
G	SB12	384	on-line	900	8
G	SB12	385	on-line	900	8
G	SB12	386	on-line	900	8
G	SB12	387	on-line	900	8

表 5-3 `showdevices` 輸出範例，過程中耗用的記憶體
domain	board	board mem MB	perm mem MB	base addr	domain mem MB	target board	deleted MB	remaining MB
A	SB1	2048	933	0x600000	4096	C2	250	1500
A	SB2	2048	0	0x200000	4096

表 5-4 `showdevices` 輸出範例， IO 裝置
domain	board	device	resource	usage
A	101	sd0
A	101	sd1
A	101	sd2
A	101	sd3	/dev/dsk/c0t3d0s0	mounted from filesystem "/"
A	101	sd3	/dev/dsk/c0t3d0s1	dump device (swap)
A	101	sd3	/dev/dsk/c0t3d0s1	swap area
A	101	sd3	/dev/dsk/c0t3d0s3	mounted filesystem "/var"
A	101	sd3	/var/run	mounted filesystem "/var/run"
A	101	sd4
A	101	sd5

欲了解更多資訊，參閱 showdevices(1M)，或是參閱 showdevices(1M) 線上手冊，以取得一系列完整的選項和引數，以及有關顯示裝置的特定資訊。

顯示平台資訊

在您於特定網域裡嘗試新增、移動或刪除板之前，請使用 showboards(1M) 的指令來判定網域 ID、網域裡可用的板，以及網域的狀態。

所有 DR 指令都可以使用網域 ID 來執行。您可以使用板清單來判定被指定的特定板屬於哪一個網域，也可以使用網域狀態來判定是否可以在網域裡新增、刪除或移動板。請使用 showplatform(1M) 的指令來判定該元件是否存在於可用元件清單 (ACL) 上。

要使用 showplatform(1M) 指令，必須擁有適當的特殊權限。欲了解更多，包括擁有使用權的使用者群組表格，請參閱 showplatform(1M)。

顯示平台資訊的方法

列出網域及 ACL 資訊

# showplatform

showplatform(1M) 指令將顯示網域 ID、ACL 以及網域狀態，如下列範例所示：

ACLs for domain domainA:

        slot0: SB0, SB1, SB2, SB3

        slot1: IO0, IO1, IO2, IO3

ACLs for domain domainB:

        slot0: None

        slot1: None

Domain        Solaris Nodename      Domain Status

domainA       sms3-b0               Powered Off

domainB       sms3-b1               Running Solaris

顯示板資訊

在您嘗試刪除或移動系統板之前，必須先查詢以判定板的狀態以及它被指定的網域之狀態。欲了解更多，包括擁有使用權的使用者群組表格以及 showboards(1M) 線上手冊，請參閱 showboards(1M)。

SC 狀態模型

在 Sun Fire 的高階伺服器 SC上，板有四種狀態：不可用 (unavailable)，可用的 (available)，指定的 (assigned)，或使用中 (active)。

備註 - SC 的板狀態不同於網域的板狀態。欲進一步了解網域的板狀態，請參閱 DR 概念。

表 5-5 Sun Fire 高階系統 SC 上的板狀態
名稱	說明
`unavailable`	板不可用，無法新增至網域。板仍未新增至特定網域之 ACL，或該板目前已被指定到另一網域。請注意：網域無法找到不在 ACL 清單上的板。在 `unavailable` 的狀態下，板不屬於特定網域。
`available`	板可用，可以新增至網域。板存在於該網域的 ACL。請注意：板的可用性不受限於網域之數量。在 `avaiblable` 狀態下，板不屬於邏輯網域。
`assigned`	板已被指定至網域，可能已存在於網域的 ACL。板對其他網域不可用。在 `assigned` 狀態下，板被視為邏輯網域的一部份。
`active`	板已連結。或是，板已連結，且配置至 Solaris OS，可供作業系統使用。在 `active` 的狀態下，板被視為實體網域的一部份。

`showboards`(1M) 指令

在您判定您要刪除或移動板的網域 ID 之後，或是在您判定某一特定板已被指定至特定網域之後，請使用 showboards(1M) 指令來判定板狀態。板的狀態可能讓您無法刪除或移動之。

備註 - showboards(1M) 指令的輸出，以使用者的特權為依據。例如，平台管理者可以取得伺服器上所有板子的資訊。至於網域管理者和網域配置者則只能在他們擁有存取權限的網域中，取得那些被指定的和可用的板子資訊。欲了解更多，請參閱 showboards(1M) 以及 showboards(1M) 線上手冊。

顯示板資訊的方法

顯示網域的板資訊。

# showboards -d domain_id

上述指令顯示的裝置資訊如下：

插槽	電源	板的類型	板的狀況	測試狀況	領域
SB0	啟動	CPU 板	作用中	略過	A
SB1	-	空插槽	指定的	-	A

您可以使用 showboards(1M) 的指令來顯示網域裡所有指定的及可用的系統板和所有 I/O 板。請參閱 showboards(1M) 線上手冊以了解更多有關顯示板的資訊。

新增板

新增板至網域的時候，板會經歷幾種狀態變化。若是該板尚未被指定，將先指定至網域。接著，它連結至網域，然後配置到 Solaris OS。連結之後，它被視為實體網域的一部份，可供作業系統使用。

您必須擁有適當的特權才能新增板至網域。欲了解更多，包括使用此指令所需特權的說明，請參閱 addboard(1M) 以及 addboard(1M) 線上手冊。

備註 - 在您使用 DR 新增一個 COD 板到網域以前，請確定系統對目標網域擁有足夠的 RTU 授權，以啟動 COD 板上的每個使用中 CPU。否則，DR 將為每一個無法在網域裡啟動的 CPU 顯示一項訊息。欲了解更多有關 COD 選項的資訊，請參閱「系統管理服務 (SMS) 管理者指南」。

新增一個板至一個網域

新增板至網域。

# addboard -d domain_id board_id

以下是新增系統板 2 號 (SB2) 至網域 A 的範例。示範了兩次重試，若屬必要，兩次重試作業之間相隔了 10 分鐘 (600 秒鐘) 的等待時間。

# addboard -d A -r 2 -t 600 SB2

備註 - 如果 addboard(1M) 指令在 DR 作業時執行失敗，板不會回復其原來的狀態。網域會記錄一項 dxs 或 dca 的錯誤訊息。如果錯誤可以修復，您可以重新執行該指令。如果錯誤無法修復，您必須重新啟動網域才能使用板。

刪除板

從一個網域刪除一個板，該板將從其目前被指定的、可能使用中的網域被移除。欲刪除板，板必須在被指定的或使用中的狀態。

在您刪除網域的板之前，記得檢查板上元件的使用狀況。如果板擁有永久記憶體，記得在刪除板之前，將其記憶體移到同網域的其他板上。同樣地，在您嘗試移除板之前，如果有些裝置正在忙碌，您必須等待或確認系統已不再使用該裝置再進行刪除。

一個網域管理者可以取消板的配置和連結，但是不可以在網域裡取消指定一個板，除非該板在 ACL 上。欲了解更多，包括使用此指令所需特權的說明，請參閱 deleteboard(1M) 以及 deleteboard(1M) 線上手冊。

從網域刪除一個板

從網域刪除板。

# deleteboard board_id

以下是 deleteboard(1M) 指令在其目前網域將系統板 2 號刪除的範例。示範了兩次重試，若屬必要。兩次重試之間相隔了 15 分鐘 (900 秒鐘) 的等待時間。

# deleteboard -r 2 -t 900 SB2

備註 - 如果 deleteboard(1M) 指令在 DR 作業時執行失敗，板不會回復其原來的狀態。網域會記錄一項 dxs 或 dca 的錯誤訊息。如果錯誤可以修復，您可以重新執行該指令。如果錯誤無法修復，您必須重新啟動網域才能使用板。

移動板

將板從一個網域移到另一個網域需要若干步驟。首先，將板從其目前指定的且可能使用中的網域移除，板必須處在指定的或使用中的狀態。然後，將它指定至目標網域。接著，它連結至目標網域，配置到 Solaris OS，便能供系統使用。

每一次您要將板從網域移除的時候，都要檢查板上記憶體和裝置的使用狀況。如果板擁有永久記憶體，在板被移至另一網域以前，必須先將記憶體移至同網域的另一個板上。同樣地，在您嘗試移動板之前，若有些裝置正在忙碌，您必須等待或確認系統已不再使用該裝置再進行刪除。

欲了解更多，包括使用此指令所需特權的說明，請參閱 moveboard(1M) 以及 moveboard(1M) 線上手冊。

備註 - 在您使用 DR 移動一個 COD 板到網域以前，請確定系統對目標網域擁有足夠的 RTU 授權，以啟動 COD 板上的每個使用中 CPU。否則，DR 將為每一個無法在網域裡啟動的CPU 顯示一項訊息。欲了解更多有關 COD 選項的資訊，請參閱「系統管理服務 (SMS) 管理者指南」。

移動板的方法

將板從一個網域移動到另一個網域。

# moveboard -d domain_id board_id

以下是 moveboard(1M) 指令將系統板 2 號 (SB2) 從其目前網域移至網域 A 的範例。示範了兩次重試，若屬必要。兩次重試之間相隔 15 分鐘 (900 秒鐘) 的等待時間。

# moveboard -d A -r 2 -t 900 SB2

備註 - 如果 moveboard(1M) 在 DR作業時執行失敗，板不會回復其原來的狀態。網域會記錄一項 dxs 或 dca 的錯誤訊息。如果錯誤可以修復，您可以重新執行該指令。如果錯誤無法修復，您必須重新啟動網域才能使用板。

更換作用中的系統板

本節說明如何更換在網域裡作用中的系統板。

更換作用中系統板的方法

1. 將系統板從其目前網域刪除。

# deleteboard board_id

以下是將系統板 2 號 (SB2) 從其目前網域刪除的範例。

# deleteboard -r 2 -t 900 SB2

2. 將替代板新增至特定網域。

# addboard -d domain_id board_id

以下是新增系統板 3 號 (SB3) 至網域 A 的範例。示範了兩次重試，若屬必要，兩次重試作業之間相隔了 15 分鐘 (900 秒鐘) 的等待時間。

# addboard -d A -r 2 -t 900 SB3

SMS DR 指令和選項

本節將說明 SMS DR 指令及相關的選項。欲進一步了解每一個 SMS DR 指令，請參閱「系統管理服務 (SMS) 參考手冊」。

`addboard`(1M)

addboard(1M) 指令將板與網域相關連。請參閱新增板以及 addboard(1M) 線上手冊以獲得更多資訊。

表 5-6 `addboard` 指令選項
選項與運算元	說明
board_id	將新增板 ID。板 ID 與板位置相符。例如， SB2 乃是在 2 號插槽的板。允許多個板識別碼。
`-c` function	將板配置為特定的配置狀態。你可以按照步驟新增板。例如，你可以指定一個板，連結之，然後配置之。
`-d` domain_id	在指定的網域執行 DR 作業。
`-f`	強制發生特定動作。這是安全功能中一項獨特的特定硬體覆寫動作。強制變更狀態的作業，可以允許使用處於 `ok` 或 `unknown` 狀況的硬體資源，以從屬硬體之安全檢查為依據。
`-h`	顯示說明 (用法) 資訊。
`-n`	對所有提示均以 No 回應。
`-q`	以無訊息模式執行。訊息及提示非以標準輸出之方式撰寫。獨自使用時，`-q` 對於所有提示的回應與 `-n` 選項相同。
`-r` retry_count	若作業執行失敗，請根據指定的次數重新執行。
`-t` timeout	重試作業之間，請在指定的時間 (以秒計算) 內等待。
`-y`	對所有提示均以 Yes 回應。

表 5-7 說明使用 addboard(1M) 指令所需之特權。平台作業員、平台服務以及超級使用者群組無法對此指令初始化。

表 5-7 使用 `addboard` 指令所需要的特權
平台管理者	網域管理者	網域配置者
可對網域指定一板，使用 `-c` 選項，配合 `assign` 功能。	若是板已被指定至某網域，或它出現在該網域的 ACL 上而且未被指定至其他網域，便可以將該板連結或配置給網域。	若是板已被指定至某網域，或它出現在該網域的 ACL 上而且未被指定至其他網域，便可以將該板連結或配置給網域。

以下範例示範系統板 2 號 (SB2) 如何與網域 A 相關連。示範了兩次重試，若屬必要。兩次重試之間相隔 10 分鐘 (600 秒鐘) 的等待時間。

# addboard -d domainA -r 2 -t 600 SB2

備註 - 如果 addboard(1M) 在 DR 作業時執行失敗，板不會回復其原來的狀態。網域會記錄一項 dxs 或 dca 的錯誤訊息。如果錯誤可以修復，您可以重新執行該指令。如果錯誤無法修復，您必須重新啟動網域才能使用板。

`deleteboard`(1M)

deleteboard(1M) 指令將板和網域分開。參閱刪除板以及 deleteboard(1M) 線上手冊以獲取更多資訊。

表 5-8 `deleteboard` 指令選項
選項與運算元	說明
board_id	將刪除板 ID。板 ID 與板位置相符。例如，SB2 乃是 2 號插槽上的系統板。允許多個板識別碼。
`-c` function	將板配置為特定的配置狀態。你可以按照步驟刪除板。例如，你可以取消該板的配置，中斷其連結，再取消其指定。
`-f`	強制發生特定動作。這是安全功能中一項獨特的特定硬體覆寫動作。強制變更狀態的作業，可以允許使用處於 `ok` 或 `unknown` 狀況的硬體資源，以任何硬體從屬之安全檢查為依據。
`-h`	顯示說明 (用法) 資訊。
`-n`	對所有提示均以 No 回應。
`-q`	以無訊息模式執行。訊息及提示非以標準輸出之方式撰寫。獨自使用時，`-q` 對示所有提示的回應與 `-n` 選項相同。
`-r` retry_count	若作業執行失敗，請根據指定的次數重新執行。
`-t` timeout	重試作業之間，請在指定的時間 (以秒計算) 內等待。
`-y`	對所有提示均以 Yes 回應。

表 5-9 說明使用 deleteboard(1M) 指令所需要特權。平台作業員、平台服務和超級使用者群組無法對此指令初始化。

表 5-9 使用 `deleteboard` 指令的特權
平台管理者	網域管理者	網域配置者
使用 `-c` 選項和 `unassign` 功能來取消指定網域中未被使用的板。如果使用者擁有網域特權，`deleteboard` 也可以在取消板的指定之前，先取消該板的配置並中斷其連結。	可以將板從網域中取消配置、中斷連結或是取消指定。只有出現在 ACL 裡的板才可以從網域中取消指定。	可以將板從網域中取消配置、中斷連結或是取消指定。只有出現在 ACL 裡的板才可以從網域中取消指定。

下列範例呈現 deleteboard(1M) 指令如何將系統板 2 號從其目前網域中取消關連。此指令指定兩次重試，其間相隔 15 分鐘 (900 秒鐘)。

# deleteboard -r 2 -t 900 SB2

備註 - 如果 deleteboard(1M) 在 DR 作業時執行失敗，板不會回復其原來的狀態。一項 dxs 或 dca 的錯誤訊息已記錄到網域。如果錯誤可以修復，您可以重新執行該指令。如果錯誤無法修復，您必須重新啟動網域才能使用板。

`moveboard`(1M)

該 moveboard(1M) 指令先將板從一網域中取消關連，再將之與另一網域關連。請參閱移動板以及 moveboard(1M) 線上手冊以獲得更多資訊。

表 5-10 `moveboard` 指令選項
選項與運算元	說明
board_id	將移動板 ID。板 ID 與板位置相符。例如，SB2 乃是在 2 號插槽的板。允許多個板識別碼。
`-c` function	將板配置為特定的配置狀態。你可以按照步驟移動板。例如，你可以指定一個板，連結之，然後配置之。
`-d` domain_id	在指定的網域執行 DR 作業。
`-f`	強制發生特定動作。這是安全功能中一項獨特的特定硬體覆寫動作。強制變更狀態的作業，可以允許使用處於 `ok` 或 `unknown` 狀況的硬體資源，以任何硬體從屬之安全檢查為依據。
`-h`	顯示說明 (用法) 資訊。
`-n`	對所有提示均以 No 回應。
`-q`	以無訊息模式執行。訊息及提示非以標準輸出之方式撰寫。獨自使用時，`-q` 對於所有提示的回應與 `-n` 選項相同。
`-r` retry_count	若作業執行失敗，請根據指定的次數重新執行。
`-t` timeout	重試作業之間，請在指定的時間 (以秒計算) 內等待。
`-y`	對所有提示均以 Yes 回應。

表 5-11 說明使用 deleteboard(1M) 指令所需要特權。平台作業員、平台服務和超級使用者群組無法對此指令初始化。

表 5-11 使用 `moveboard` 指令所需的特權
平台管理者	網域管理者	網域配置者
可以重新將板從一網域重新指定至另一網域，使用 `-c` 選項，配合 `assign` 功能。重新指定的板，不可以是指定網域裡使用中的板。	可以指定、連結或配置位於另一網域的板。如果該板在另一網域使用中，`moveboard` 指令將從該網域中取消板的配置並中斷其連結。只有在 ACL 裡的板，才可以用 `moveboard` 取消指定和重新指定。該 `moveboard` 指令可以連結及配置板。網域管理者必須擁有雙方網域的特權，才能 `moveboard`(1M) 指令。	可以指定、連結或配置位於另一網域的板。如果該板在另一網域使用中，`moveboard` 指令將從該網域中取消板的配置並中斷其連結。只有在 ACL 裡的板，才可以用 `moveboard` 取消指定和重新指定。該 `moveboard` 指令可以連結及配置板。網域管理者必須擁有雙方網域的特權，才能 `moveboard`(1M) 指令。

下列是 moveboard(1M) 指令將系統板 5 號 (SB5) 從其目前網域移至網域 B 的範例。此指令指定兩次間隔 15 分鐘 (900 秒鐘) 的重試。

# moveboard -d domainB -r 2 -t 900 SB5

備註 - 如果 moveboard(1M) 在 DR 作業時執行失敗，板不會回復其原來的狀態。網域會記錄一項 dxs 或 dca 的錯誤訊息。如果錯誤可以修復，您可以重新執行該指令。如果錯誤無法修復，您必須重新啟動網域才能使用板。

`rcfgadm`(1M) 指令

該 rcfgadm(1M) 指令在 SC 上執行 DR 作業，在裝置樹上的裝置節點，即附接點上提供遠端配置管理作業。參閱 rcfgadm(1M) 線上手冊以獲得更多資訊和如何使用此指令的範例。

表 5-12 說明該 rcfgadm(1M) 指令的選項和運算元。

表 5-12 `rcfgadm` 指令選項
選項與運算元	說明
`-a`	列出動態附接點。
`-c` function	將板配置為特定的配置狀態。`連結`，`中斷連結`， `配置`，或`取消配置`。
`-d` domain_id	在指定的網域執行 DR 作業。
`-f`	強制特定動作。
`-h` `-h` ap_id `-h` ap_type	列印特定的 help 訊息。如果加入 ap_id 或 ap_type 變數，為附接點顯示特定硬體的 help。
`-l` ap_id `\|` ap_type	列出特定附接點的狀態和狀況。
`-n`	對所有提示均以 No 回應。
`-o` hardware_options	使用特定的特定硬體選項。
`-r` retry_count	若作業執行失敗，請根據指定的次數重新執行。
`-s` listing_options	列出特定的排列選項。
`-T` timeout	重試作業之間，請在指定的時間 (以秒計算) 內等待。
`-t`	測試一個或多個附接點。
`-v`	以詳細模式執行。
`-x` hardware_function	使用特定硬體功能。
`-y`	對所有提示均以 Yes 回應。

表 5-13 說明使用 rcfgadm(1M) 指令所需之特權。平台作業員、平台服務和 superuser 群組無法對此指令初始化。

表 5-13 使用 `rcfgadm` 指令所需的特權
平台管理者	網域管理者	網域配置者
可以指定板至網域也可以從網域取消指定板，只要先後使用 `-x` 選項，配合 `assign` 或 `unassign` 功能。要使用 `unassign` 功能，板必須已被指定，而且在作業網域裡非使用中。	可以在網域裡對板進行中斷連結、連結、配置或取消配置的動作。若板在網域的 ACL 裡，可以指定或取消指定之。	可以在網域裡對板進行中斷連結、連結、配置或取消配置的動作。若板在網域的 ACL 裡，可以指定或取消指定之。

備註 - 如果 rcfgadm(1M) 在 DR 作業時執行失敗，板不會回復其原來的狀態。網域會記錄一項 dxs 或 dca 的錯誤訊息。如果錯誤可以修復，您可以重新執行該指令。如果錯誤無法修復，您必須重新啟動網域才能使用板。

`scdrhelp`(1M)

該 scdrhelp(1M) shell 程序檔啟動 Sun Fire 高階伺服器動態再配置錯誤輔助系統。該補助系統使用 JavaHelp trademark hsviewer 程序檔。

所有使用者特權群組可以使用此指令，除了網域管理者和網域配置者。

參閱錯誤訊息說明系統以及 scdrhelp(1M) 線上手冊以獲取更多有關此程序檔的資訊。

`showboards`(1M)

showboards(1M) 指令顯示網域裡系統板的指定資訊和狀態，且指出該板是不是 COD (Capacity On Demand) 板。參閱顯示板資訊以及 showboards(1M) 線上手冊以獲取更多資訊。

雖然 showboards(1M) 不是特定 DR 指令，Sun 建議您執行此指令時與 DR 指令一起使用。表 5-14 說明 showboards(1M) 的指令選項。

表 5-14 `showboards` 指令選項
選項	說明
`-d` domain_id	在指定網域執行 DR 作業。
`-h`	顯示 Help (用法) 資訊。
`-v`	以詳細模式執行。在此模式中，此指令顯示所有元件，包括網域可配置單元 (DCUs)，包含 CPU、PCI 和 SC。

所有使用者特權群組可以使用此指令，但是網域管理者和網域配置者只能在他們擁有特權的網域裡顯示板資訊。

`showdevices`(1M)

showdevices(1M) 指令顯示系統板上已配置的實體裝置以及這些裝置提供的可用資源。雖然 showdevices(1M) 指令不是特定 DR 指令， Sun 建議您執行此指令時與 DR 指令一同使用。參閱顯示裝置資訊以及 showdevices(1M) 線上手冊以獲得更多資訊。

正在管理系統資源的應用程式及子系統將提供使用資訊。欲了解在系統板上執行 DR 作業的預期結果，可對所管理的資源作離線查詢。

表 5-15 `showdevices` 指令選項
選項與運算元	說明
board_id	將新增板 ID。板 ID 與板位置相符。例如，SB2 乃是在 2 號插槽的系統板。允許多個板識別碼。
`-d` domain_id	在指定的網域執行 DR 作業。
`-h`	顯示 Help (用法) 資訊。
`-p` reports	顯示離線查詢的資訊。
`-v`	顯示所有 I/O 裝置的資訊。

只有網域管理者和網域配置者可以顯示有關一個網域的裝置資訊。而且他們惟有在其擁有特權的網域才能如此做。

`showplatform`(1M)

showplatform(1M) 的指令顯示 ACL，每個網域的狀態，以及 COD (Capacity on Demand) 資訊。雖然 showplatform(1M) 不是特定 DR 指令，Sun 建議您執行此指令時與 DR 指令一同使用。參閱顯示平台資訊以及 showplatform(1M) 線上手冊以獲取更多資訊。

表 5-16 `showplatform` 指令選項
選項與運算元	說明
`-d` domain_id	在指定的網域執行 DR 作業。
`-h`	顯示 Help (用法) 資訊。
`-p domains \| available ethernet \| cod`	顯示包含 COD 資訊的報告，根據以下特定方式組合：網域狀態 (`domains`) 網域 ACL (`available`) 網域乙太網路卡位址 (`ethernet`)
`-v`	顯示所有可用指令的資訊。

所有使用者特權群組，除了平台服務和 superuser 群組以外，均可使用此指令。但是網域管理者和網域配置者只能在其擁有特權的網域顯示平台資訊。

錯誤訊息說明系統

SMS 軟體含有一個錯誤訊息說明系統，可以幫助您找到特定錯誤訊息之說明和修復程序。

要啟動 DR 錯誤訊息說明系統，請使用下列指令：

# /opt/SUNWSMS/jh/scdrhelp/scdrhelp &

標準的 JavaHelp 系統檢視器，hsviewer，顯示 DR 錯誤訊息說明系統。此檢視器含有一行工具列和兩個窗格：內容窗格和瀏覽窗格，如圖 5-1 所示：

圖 5-1 `hsviewer` GUI 元件

JavaHelp 內容表格

DR 錯誤訊息根據其錯誤類型而分類到不同的邏輯組，如圖 5-1 所示。這些群組代表了在內容表格的最上層標題所呈現的重要主題。錯誤訊息的數量及 (或) 縮寫文字將出現在其所屬的群組名稱之下。

JavaHelp 索引

DR 錯誤訊息已做成索引，其關鍵主題將如同下列索引圖 (圖 5-2)。我們將在適當的地方內嵌索引主題。以這些主題而言，只有內嵌式主題才會與錯誤訊息相連結。

圖 5-2 JavaHelp 索引圖

JavaHelp 搜尋

DR 錯誤訊息說明系統提供全文搜尋的功能。搜尋資料庫的資料乃建立自錯誤訊息說明檔案的索引。

在搜尋特定的錯誤訊息以前，先在錯誤訊息裡搜與特定的字串。而且，避免使用數字，因為它們被視為可替代的文字。JavaHelp 發生錯誤後的系統視窗如下圖所示：

第5章

SMS DR 程序 － 從系統控制器 (SC) 執行 (僅限高階)

顯示裝置資訊

顯示裝置資訊

表 5-1 showdevices 輸出範例，CPU

表 5-2 showdevices 輸出範例，UltraSPARC IV+ ( showdevices -d G )

表 5-3 showdevices 輸出範例，過程中耗用的記憶體

表 5-4 showdevices 輸出範例， IO 裝置

顯示平台資訊

顯示平台資訊的方法

顯示板資訊

SC 狀態模型

表 5-5 Sun Fire 高階系統 SC 上的板狀態

showboards(1M) 指令

新增板

新增一個板至一個網域

刪除板

從網域刪除一個板

移動板

移動板的方法

更換作用中的系統板

更換作用中系統板的方法

SMS DR 指令和選項

addboard(1M)

表 5-6 addboard 指令選項

表 5-7 使用 addboard 指令所需要的特權

deleteboard(1M)

表 5-8 deleteboard 指令選項

表 5-9 使用 deleteboard 指令的特權

moveboard(1M)

表 5-10 moveboard 指令選項

表 5-11 使用 moveboard 指令所需的特權

rcfgadm(1M) 指令

表 5-12 rcfgadm 指令選項

表 5-13 使用 rcfgadm 指令所需的特權

scdrhelp(1M)

showboards(1M)

表 5-14 showboards 指令選項

showdevices(1M)

表 5-15 showdevices 指令選項

showplatform(1M)

表 5-16 showplatform 指令選項

錯誤訊息說明系統

圖 5-1 hsviewer GUI 元件

JavaHelp 內容表格

JavaHelp 索引

圖 5-2 JavaHelp 索引圖

JavaHelp 搜尋

圖 5-3 JavaHelp 搜尋圖

SMS DR 程序－從系統控制器 (SC) 執行 (僅限高階)

表 5-1 `showdevices` 輸出範例，CPU

表 5-2 `showdevices` 輸出範例，UltraSPARC IV+ ( `showdevices -d G` )

表 5-3 `showdevices` 輸出範例，過程中耗用的記憶體

表 5-4 `showdevices` 輸出範例， IO 裝置

`showboards`(1M) 指令

`addboard`(1M)

表 5-6 `addboard` 指令選項

表 5-7 使用 `addboard` 指令所需要的特權

`deleteboard`(1M)

表 5-8 `deleteboard` 指令選項

表 5-9 使用 `deleteboard` 指令的特權

`moveboard`(1M)

表 5-10 `moveboard` 指令選項

表 5-11 使用 `moveboard` 指令所需的特權

`rcfgadm`(1M) 指令

表 5-12 `rcfgadm` 指令選項

表 5-13 使用 `rcfgadm` 指令所需的特權

`scdrhelp`(1M)

`showboards`(1M)

表 5-14 `showboards` 指令選項

`showdevices`(1M)

表 5-15 `showdevices` 指令選項

`showplatform`(1M)

表 5-16 `showplatform` 指令選項

圖 5-1 `hsviewer` GUI 元件