資源類型特性

以下資訊說明由 Sun Cluster 軟體定義的資源類型特性。特性值分類如下：

• 必需的。在資源類型註冊 (RTR) 檔案中，特性必須有一個明確的值。否則無法建立特性所屬的物件。不允許將空格或空字串作為值。

• 條件式。該特性若要存在，就必須在 RTR 檔案中進行宣告。否則，RGM 不會建立此特性，管理公用程式也就無法使用它。允許空格或空字串。如果在 RTR 檔案中已宣告該特性，但是未指定任何值，則 RGM 將提供一個預設值。

• 條件式或明確的。該特性若要存在，就必須在 RTR 檔案中以明確的值進行宣告。否則，RGM 不會建立此特性，管理公用程式也就無法使用它。不允許空格或空字串。

• 可選用。該特性可以在 RTR 檔案中進行宣告。如果在 RTR 檔案中未宣告此特性，則 RGM 會建立它，並提供一個預設值。如果在 RTR 檔案中已宣告特性，但未指定任何值，則 RGM 將提供同一預設值，如同在 RTR 檔案中未宣告此特性。

• 僅限於查詢 ─ 不能透過管理工具直接設定。

資源類型特性無法透過管理公用程式更新，但 Installed_nodes 和 RT_system 除外，這二者無法在 RTR 檔案中宣告，必須由叢集管理員設定。

首先會顯示特性名稱，其後跟隨相關描述。

資源類型特性名稱 (如 API_version 和 Boot) 不區分大小寫。當您指定特性名稱時，您可以使用大寫和小寫字母的任意組合。

API_version (integer)

支援此資源類型實作所必需的資源管理 API 之最低版本。

以下資訊概述 Sun Cluster 每個發行版本所支援的最高 API_version。

3.1 之前的版本及 3.1

2

3.1 10/03

3

3.1 4/04

4

3.1 9/04

5

3.1 8/05

6

在 RTR 檔案中宣告 API_version 值大於 2，將阻止資源類型在支援較低最高版本的 Sun Cluster 版本上進行安裝。例如，如果您為資源類型宣告 API_version=5，則該資源類型無法安裝於 3.1 9/04 之前發行的任何 Sun Cluster 版本上。

---

備註 –

如果不宣告此特性或將其設定為預設值 (2)，資料服務可以安裝在 Sun Cluster 3.0 之後的任何 Sun Cluster 版本上。

---

種類：

選項

預設值：

2

可調：

NONE

Boot (string)

一個可選用的回呼方法：RGM 在節點 (已管理了此類型的資源後，連結或重新連結叢集的節點) 上所執行的程式之路徑。此方法與 Init 方法初始化此類型之資源的方式相同。

種類：

條件式或明確的

預設值：

沒有預設值

可調：

NONE

Failover (boolean)

TRUE 表示不能於同時可在多個節點上處於線上的任何群組中配置此類型的資源。

下表顯示如何將此資源類型與 Scalable 資源類型結合使用。

Failover 資源類型的值	Scalable 資源的值	描述
TRUE	TRUE	請勿指定此非法組合。
TRUE	FALSE	為容錯移轉指定此組合。
FALSE	TRUE	為將 SharedAddress 資源用於網路負載平衡的可延伸服務指定此組合。 「Sun Cluster 概念指南 (適用於 Solaris 作業系統)」更詳細地說明 SharedAddress。
FALSE	FALSE	儘管它並非一般組合，您仍可以使用此組合選取不使用網路負載平衡的多重主控節點服務。

r_properties(5) 線上手冊中的 Scalable 說明和「Sun Cluster 概念指南 (適用於 Solaris 作業系統)」中的第 3 章「針對系統管理員和應用程式開發者的重要概念」含有附加資訊。

種類：

選項

預設值：

FALSE

可調：

NONE

Fini (string)

一個可選用的回呼方法：在從 RGM 管理中移除此類型的資源時，RGM 所執行的程式之路徑。

種類：

條件式或明確的

預設值：

沒有預設值

可調：

NONE

Init (string)

一個可選用的回呼方法：在此類型的資源成為 RGM 管理的資源時，RGM 所執行的程式之路徑。

種類：

條件式或明確的

預設值：

沒有預設值

可調：

NONE

Init_nodes (enum)

表示 RGM 要在其上呼叫 Init、Fini、Boot、Validate 方法的節點。其值可為 RG_PRIMARIES (可以主控資源的節點) 或 RT_INSTALLED_NODES (安裝此資源類型的所有節點)。

種類：

選項

預設值：

RG_PRIMARIES

可調：

NONE

Installed_nodes (string_array)

可以在其上執行此資源類型的叢集節點名稱之清單。RGM 自動建立此特性。叢集管理員可以設定值。您不能在 RTR 檔案中宣告這個特性。

種類：

可以由叢集管理員進行配置

預設值：

所有叢集節點

可調：

ANYTIME

Is_logical_hostname (boolean)

TRUE 指示此資源類型是管理防故障備用網際網路協定 (IP) 位址的某一版本的 LogicalHostname 資源類型。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

NONE

Is_shared_address (boolean)

TRUE 指示此資源類型是管理防故障備用網際網路協定 (IP) 位址的某一版本的 SharedAddress 資源類型。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

NONE

Monitor_check (string)

一個可選用的回呼方法：在執行監視器請求的此類型之資源的容錯移轉前，RGM 所執行的程式之路徑。

種類：

條件式或明確的

預設值：

沒有預設值

可調：

NONE

Monitor_start (string)

一個可選用的回呼方法：RGM 啟動此類型之資源的故障監視器所執行的程式之路徑。

種類：

條件式或明確的

預設值：

沒有預設值

可調：

NONE

Monitor_stop (string)

已設定 Monitor_start 時所必需的回呼方法：RGM 停止此類型之資源的故障監視器所執行的程式之路徑。

種類：

條件式或明確的

預設值：

沒有預設值

可調：

NONE

Pkglist (string_array)

納入資源類型安裝中的可選擇套件清單。

種類：

條件式或明確的

預設值：

沒有預設值

可調：

NONE

Postnet_stop (string)

一個可選用的回呼方法：在呼叫此類型之資源附屬的任何網路位址資源的 Stop 方法後，RGM 所執行的程式之路徑。配置網路介面離線後，此方法必須執行 Stop 動作。

種類：

條件式或明確的

預設值：

沒有預設值

可調：

NONE

Prenet_start (string)

一個可選用的回呼方法：在 RGM 呼叫此類型之資源附屬的任何網路位址資源的 Start 方法前，RGM 所執行的程式之路徑。此方法會執行在配置網路介面之前必須要執行的 Start 動作。

種類：

條件式或明確的

預設值：

沒有預設值

可調：

NONE

Resource_list (string_array)

此資源類型的所有資源之清單。叢集管理員不能直接設定此特性，而是在叢集管理員在資源群組中增加或移除此類型之資源時，由 RGM 更新此特性。

種類：

僅限於查詢

預設值：

空的清單

可調：

NONE

Resource_type (string)

資源類型的名稱。若要檢視目前已註冊的資源類型之名稱，請使用：

scrgadm -p

在 Sun Cluster 3.1 及更高發行版本中，資源類型名稱包含版本 (這是必要的)：

vendor-id.resource-type:rt-version

資源類型名稱的三個元件是在 RTR 檔案中指定為 vendor_id、resource_type 與 rt_version 的特性。scrgadm 指令插入句點 (.) 和冒號 (:) 分割元。資源類型名稱的 rt-version 字尾與 RT_version 特性是同一個值。若要確保 vendor-id 唯一，請使用建立資源類型的公司股票代號。在 Sun Cluster 3.1 之前建立的資源類型名稱將繼續使用以下語法：

vendor-id.resource-type

種類：

必需的

預設值：

空字串

可調：

NONE

RT_basedir (string)

用於完成回呼方法相對路徑的目錄路徑。必須將此路徑設定為安裝資源類型套裝軟體的目錄。此路徑必須為完整的路徑，即必須以正斜線 (/) 開頭。

種類：

除非所有方法路徑名稱均是絕對的，否則是必需的

預設值：

沒有預設值

可調：

NONE

RT_description (string)

資源類型的簡單說明。

種類：

條件式

預設值：

空字串

可調：

NONE

RT_system (boolean)

如果資源類型的 RT_system 特性為 TRUE，則您無法刪除資源類型 (scrgadm -r -t resource-type-name)。此特性可以防止意外刪除用來支援叢集基礎架構的資源類型 (如 LogicalHostname)。但是，您可以將 RT_system 特性套用至任何資源類型。

若要刪除其 RT_system 特性設定為 TRUE 的資源類型，必須先將此特性設定為 FALSE。刪除其資源支援叢集服務的資源類型時應謹慎。

種類：

選項

預設值：

FALSE

可調：

ANYTIME

RT_version (string)

從 Sun Cluster 3.1 開始，它是這個資源類型實作必需的版本字串。RT_version 是完整資源類型名稱的字尾部分。RT_version 特性在 Sun Cluster 3.0 中為可選用的特性，在 Sun Cluster 3.1 及更高版本中為必要的特性。

種類：

條件式/明確的或必需的

預設值：

沒有預設值

可調：

NONE

Single_instance (boolean)

如果為 TRUE，則表明叢集中僅可以存在一個此類型的資源。RGM 一次僅允許一個此類型的資源來執行整個叢集。

種類：

選項

預設值：

FALSE

可調：

NONE

Start (string)

一個回呼方法：RGM 啟動此類型的資源所執行的程式之路徑。

種類：

除非 RTR 檔案宣告了 Prenet_start 方法，否則是必需的

預設值：

沒有預設值

可調：

NONE

Stop (string)

一個回呼方法：RGM 停止此類型的資源所執行的程式之路徑。

種類：

除非 RTR 檔案宣告了 Postnet_start 方法，否則是必需的

預設值：

沒有預設值

可調：

NONE

Update (string)

一個可選用的回呼方法：變更此類型的執行資源之特性時，RGM 所執行的程式之路徑。

種類：

條件式或明確的

預設值：

沒有預設值

可調：

NONE

Validate (string)

一個可選用的回呼方法：RGM 為檢查此類型的資源的特性值所執行的程式之路徑。

種類：

條件式或明確的

預設值：

沒有預設值

可調：

NONE

Vendor_ID (string)

請參閱 Resource_type 特性。

種類：

條件式

預設值：

沒有預設值

可調：

NONE