資源類型特性

以下資訊描述 Sun Cluster 所定義的資源類型特性。對特性值進行分類，如下所示 (在 [種類] 之後)：

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

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

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

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

管理公用程式無法更新除 Installed_nodes 和 RT_system 之外的資源類型特性，這兩種特性無法在 RTR 檔案中進行宣告，必須由管理員來設定。

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

API_version (整數)

此資源類型實施所使用的資源管理 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

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

種類：

可選用的

預設值：

2

可調：

否

Boot (字串)

一個可選用的回呼方法：RGM 在節點 (已管理了此類型的資源後連結或重新連結叢集的節點) 上所呼叫的程式之路徑。在預期情況下，此方法會針對此類型資源執行類似於Init 方法的初始化動作。

種類：

條件式/明確

預設值：

無

可調：

否

Failover (布林值)

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

種類：

可選用的

預設值：

FALSE

可調：

否

Fini (字串)

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

種類：

條件式/明確

預設值：

無

可調：

否

Init (字串)

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

種類：

條件式/明確

預設值：

無

可調：

否

Init_nodes (列舉)

這些值可以是 RG_primaries (僅可以主控資源的節點) 或 RT_installed_nodes (安裝了資源類型的所有節點)。指示 RGM 要在其上呼叫 Init、Fini、Boot、Validate 方法的節點。

種類：

可選用的

預設值：

RG_primaries

可調：

否

Installed_nodes (字串陣列)

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

種類：

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

預設值：

所有叢集節點

可調：

是

Is_logical_hostname (布林值)

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

種類：

僅限於查詢

預設值：

沒有預設值

可調：

否

Is_shared_address (布林值)

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

種類：

僅限於查詢

預設值：

沒有預設值

可調：

否

Monitor_check (字串)

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

種類：

條件式/明確

預設值：

沒有預設值

可調：

否

Monitor_start (字串)

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

種類：

條件式/明確

預設值：

沒有預設值

可調：

否

Monitor_stop (字串)

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

種類：

條件式/明確

預設值：

沒有預設值

可調：

否

Pkglist (字串陣列)

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

種類：

條件式/明確

預設值：

沒有預設值

可調：

否

Postnet_stop (字串)

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

種類：

條件式/明確

預設值：

沒有預設值

可調：

否

Prenet_start (字串)

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

種類：

條件式/明確

預設值：

沒有預設值

可調：

否

Resource_type (字串)

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

scrgadm -p

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

vendor_id.resource_type:version

資源類型名稱的三個元件是在 RTR 檔案中指定為 Vendor_id、Resource_type 與 RT_version 的特性。scrgadm 指令插入句點 (.) 和冒號 (:) 分割元。資源類型名稱的 RT_version 後綴與 RT_version 特性的值相同。若要確保 Vendor_id 是唯一的，建議您在建立資源類型時使用公司的證券代號。在 Sun Cluster 3.1 之前建立的資源類型名稱將繼續使用以下語法：

vendor_id.resource_type

種類：

必需的

預設值：

空字串

可調：

否

RT_basedir (字串)

用於完成回呼方法相對路徑的目錄路徑。此路徑預期會設定為資源類型套件的安裝位置。此路徑必須為完整的路徑，即必須以正斜線 (/) 開始。如果所有方法路徑名稱均是絕對的，則此特性不是必需的。

種類：

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

預設值：

沒有預設值

可調：

否

RT_description (字串)

資源類型的簡單說明。

種類：

條件式

預設值：

空字串

可調：

否

RT_system (布林值)

指示資源類型設定為 TRUE 時，允許對該資訊類型執行的 scrgadm(1M) 作業會受到限制。其 RT_system 的值設定為 TRUE 的資源類型稱為系統資源類型。無論 RT_system 的目前值為何，編輯 RT_system 特性本身永遠不會受到限制。

種類：

可選用的

預設值：

FALSE

可調：

是

RT_version (字串)

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

種類：

可選擇性/明確或必需的

預設值：

沒有預設值

可調：

否

Single_instance (布林值)

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

種類：

可選用的

預設值：

FALSE

可調：

否

Start (字串)

一個回呼方法：RGM 為啟動此類型的資源而呼叫的程式之路徑。

種類：

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

預設值：

沒有預設值

可調：

否

Stop (字串)

一個回呼方法：RGM 為停止此類型資源而呼叫的程式之路徑。

種類：

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

預設值：

沒有預設值

可調：

否

Update (字串)

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

種類：

條件式/明確

預設值：

沒有預設值

可調：

否

Validate (字串)

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

種類：

條件式/明確

預設值：

沒有預設值

可調：

否

Vendor_ID (字串)

請參閱 Resource_type 特性。

種類：

條件式

預設值：

沒有預設值

可調：

否