test

Sun Cluster 資料服務開發者指南 (適用於 Solaris 作業系統)

附錄 A 標準特性

本附錄說明標準資源類型、資源和資源群組的特性。還說明了變更系統定義的特性與建立延伸特性可用的資源特性性質。

備註 –

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

本附錄涵蓋以下主題︰

資源類型特性

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

資源類型特性無法透過管理公用程式更新，但 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

資源特性

本小節說明由 Sun Cluster 軟體定義的資源特性。特性值分類如下：

資源特性屬性中說明的 Tunable 屬性列出了您是否以及何時可以更新資源特性，如下所示︰

FALSE 或 NONE

從不

TRUE 或 ANYTIME

任何時候

AT_CREATION

在將資源加入叢集時

WHEN_DISABLED

在資源被停用時

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

Affinity_timeout (integer)

時間長度 (以秒為單位)，在此時間長度內，從資源中的任意服務之給定用戶端 IP 位址的連線被傳送到同一伺服器節點。

僅當 Load_balancing_policy 是 Lb_sticky 或者 Lb_sticky_wild 時，此特性才是有意義的。另外，必須將 Weak_affinity 設定為 FALSE。

此特性僅用於可延伸服務。

種類：

選項

預設值：

沒有預設值

可調：

ANYTIME

Boot_timeout 適用於類型中的每種回呼方法 (integer)

時延 (以秒為單位)，在此時延之後 RGM 會推斷出該方法的呼叫已失敗。對於給定的資源類型，僅定義在 RTR 檔案中已宣告的方法之逾時特性。

種類：

條件式或可選用的

預設值：

如果在 RTR 檔案中宣告了方法本身，則預設值為 3600 (1 小時)

可調：

ANYTIME

Cheap_probe_interval (integer)

在兩次資源故障快速探測的呼叫之間的秒數。僅當在 RTR 檔案中宣告了此特性時，RGM 才可以建立特性，且叢集管理員才可以使用它。如果在 RTR 檔案中指定了預設值，則此特性是可選用的。

如果在 RTR 檔案中未指定 Tunable 屬性，則特性的 Tunable 值為 WHEN_DISABLED。

種類：

條件式

預設值：

沒有預設值

可調：

WHEN_DISABLED

延伸特性

在資源類型的 RTR 檔案中宣告的延伸特性。資源類型的實作定義這些特性。資源特性屬性含有可以為延伸特性設定的個別屬性之資訊。

種類：

條件式

預設值：

沒有預設值

可調：

取決於特定的特性

Failover_mode (enum)

當資源無法成功啟動或停止時，或當資源監視器找到運作狀態不良的資源並因此請求重新啟動或容錯移轉時，會修改 RGM 採取的回復動作。

NONE、SOFT 或 HARD (方法失敗)

當啟動或停止方法 (Prenet_start、Start、Monitor_stop、Stop、Postnet_stop) 失敗時，這些設定僅影響容錯移轉的運作方式。一旦資源啟動成功，NONE、SOFT 和 HARD 對於隨後資源監視器使用 scha_control 指令或 scha_control() 函數初始化資源的重新啟動或停止運作方式沒有影響。請參閱 scha_control(1HA) 和 scha_control(3HA) 線上手冊。NONE 表示當先前列出的啟動或停止方法之一失敗時，RGM 將不採取任何回復動作。SOFT 或 HARD 表示如果 Start 或 Prenet_start 方法失敗，RGM 會將資源的群組遷移至其他節點。對於 Start 或 Prenet_start 失敗，SOFT 和 HARD 是相同的。

對於停止方法 (Monitor_stop、Stop 或 Postnet_stop) 失敗，SOFT 和 NONE 是相同的。如果 Failover_mode 設定為 HARD，則當其中的停止方法失敗時，RGM 將重新啟動節點以強制資源群組離線。然後，RGM 會嘗試在其他節點上啟動該群組。

RESTART_ONLY 或 LOG_ONLY

NONE、SOFT 和 HARD 會在啟動或停止方法失敗時影響容錯移轉運作方式，但 RESTART_ONLY 和 LOG_ONLY 與此不同，其會影響所有的容錯移轉運作方式。容錯移轉運作方式包含資源和資源群組之監視器初始化 (scha_control) 的重新啟動以及由資源監視器初始化 (scha_control) 的停止。RESTART_ONLY 表示監視器可以執行 scha_control 來重新啟動資源或資源群組。RGM 允許在 Retry_interval 內重新啟動 Retry_count 次。如果超過 Retry_count 次，將不再允許重新啟動。如果將 Failover_mode 設定為 LOG_ONLY，將不允許重新啟動或停止資源。將 Failover_mode 設定為 LOG_ONLY 與將 Failover_mode 設定為 RESTART_ONLY 且將 Retry_count 設定為零是相同的。

RESTART_ONLY 或 LOG_ONLY (方法失敗)

如果 Prenet_start、Start、Monitor_stop、Stop 或 Postnet_stop 方法失敗，則 RESTART_ONLY 和 LOG_ONLY 與 NONE 是相同的。也就是說，節點既不容錯移轉，也不重新啟動。

Failover_mode 設定對資料服務的影響

Failover_mode 的每個設定對資料服務產生的影響取決於資料服務是否受監視以及其是否基於資料服務開發程式庫 (DSDL)。

  • 如果資料服務實作 Monitor_start 方法並已啟用資源的監視功能，則資料服務將受到監視。在啟動資源本身後，RGM 會透過執行 Monitor_start 方法啟動資源監視器。資源監視器將探測資源的運作狀況。如果探測失敗，資源監視器會透過呼叫 scha_control() 函數請求重新啟動或容錯移轉。對於基於 DSDL 的資源，探測會顯示資料服務部分失敗 (降級) 或完全失敗。重複的部分失敗會累積為完全失敗。

  • 如果資料服務沒有提供 Monitor_start 方法或資源的監視功能已停用，則資料服務不受監視。

  • 基於 DSDL 的資料服務包含透過 Agent Builder、藉由 GDS 或直接使用 DSDL 開發的資料服務。開發某些資料服務 (如 HA Oracle) 無須使用 DSDL。

NONE、SOFT 或 HARD (探測失敗)

如果您將 Failover_mode 設定為 NONE、SOFT 或 HARD，且資料服務是受監視的基於 DSDL 的服務，並且如果探測完全失敗，則監視器將呼叫 scha_control() 函數以請求重新啟動資源。如果探測繼續失敗，資源將在 Retry_interval 內最多重新啟動 Retry_count 次。如果在達到重新啟動的 Retry_count 次後，探測再次失敗，則監視器會請求將資源的群組容錯移轉至其他節點。

如果將 Failover_mode 設定為 NONE、SOFT 或 HARD，並且資料服務是不受監視的基於 DSDL 的服務，則偵測到的唯一失敗是資源的程序樹狀結構中止。如果資源的程序樹狀結構中止，將重新啟動資源。

如果資料服務不是基於 DSDL 的服務，重新啟動或容錯移轉運作方式將取決於資源監視器的編碼方式。例如，可以透過重新啟動資源或資源群組，或透過容錯移轉資源群組來回復 Oracle 資源監視器。

RESTART_ONLY (探測失敗)

如果將 Failover_mode 設定為 RESTART_ONLY 且資料服務是受監視的基於 DSDL 的服務，並且如果探測完全失敗，則將在 Retry_interval 內重新啟動資源 Retry_count 次。然而，如果超過 Retry_count 次，則資源監視器會結束， 將資源狀態設定為 FAULTED，並產生狀態訊息「應用程式發生錯誤，但未重新啟動。探測正在退出。」此時，儘管仍然啟用了監視功能，但直到叢集管理員修復和重新啟動資源後，才能有效監視資源。

如果將 Failover_mode 設定為 RESTART_ONLY 且資料服務是不受監視的基於 DSDL 的服務，並且如果程序樹狀結構中止，則將不重新啟動資源。

如果受監視的資料服務不基於 DSDL，則回復運作方式將取決於資源監視器的編碼方式。如果將 Failover_mode 設定為 RESTART_ONLY，可以透過在 Retry_interval 內呼叫 scha_control() 函數 Retry_count 次來重新啟動資源或資源群組。如果資源監視器呼叫超過 Retry_count 次，則嘗試重新啟動失敗。如果監視器呼叫 scha_control() 函數以請求防故障備用，則該請求也會失敗。

LOG_ONLY (探測失敗)

如果將所有資料服務的 Failover_mode 設定為 LOG_ONLY，則將排除所有 scha_control() 請求，無論是重新啟動資源或資源群組，還是容錯移轉群組。如果資料服務基於 DSDL，則當探測完全失敗時將記錄一條訊息，但是不會重新啟動資源。如果在 Retry_interval 內，探測完全失敗超過 Retry_count 次，則資源監視器將結束，將資源狀態設定為 FAULTED，並產生狀態訊息「應用程式發生錯誤，但未重新啟動。探測正在退出。」此時，儘管仍然啟用了監視功能，但直到叢集管理員修復和重新啟動資源後，才能有效監視資源。

如果將 Failover_mode 設定為 LOG_ONLY 且資料服務是不受監視的基於 DSDL 的服務，並且如果程序樹狀結構中止，則將記錄一條錯誤訊息但不會重新啟動資源。

如果受監視的資料服務不基於 DSDL，則回復運作方式將取決於資源監視器的編碼方式。如果將 Failover_mode 設定為 LOG_ONLY，所有 scha_control() 請求均失敗，無論是重新啟動資源或資源群組，還是容錯移轉群組。

種類：

選項

預設值：

NONE

可調：

ANYTIME

Fini_timeout 適用於類型中的每種回呼方法 (integer)

時延 (以秒為單位)，在此時延之後 RGM 會推斷出該方法的呼叫已失敗。對於給定的資源類型，僅定義在 RTR 檔案中已宣告的方法之逾時特性。

種類：

條件式或可選用的

預設值：

如果在 RTR 檔案中宣告了方法本身，則預設值為 3600 (1 小時)

可調：

ANYTIME

Init_timeout 適用於類型中的每種回呼方法 (integer)

時延 (以秒為單位)，在此時延之後 RGM 會推斷出該方法的呼叫已失敗。對於給定的資源類型，僅定義在 RTR 檔案中已宣告的方法之逾時特性。

種類：

條件式或可選用的

預設值：

如果在 RTR 檔案中宣告了方法本身，則預設值為 3600 (1 小時)

可調：

ANYTIME

Load_balancing_policy (string)

定義所使用的負載平衡策略之字串。此特性僅用於可延伸服務。如果在 RTR 檔案中宣告了 Scalable 特性，則 RGM 將自動建立此特性。Load_balancing_policy 可以採用以下值：

Lb_weighted (預設值)。負載是依照 Load_balancing_weights 特性中所設定的權重而在各節點中分布的。

Lb_sticky。總是將可延伸服務的給定用戶端 (由用戶端 IP 位址識別) 發送到叢集的同一個節點。

Lb_sticky_wild。總是將與萬用字元居留服務的 IP 位址連線的給定用戶端 IP 位址傳送到同一個叢集節點，而不管該 IP 位址將要導向至哪個連接埠號。

種類：

條件式或可選用的

預設值：

Lb_weighted

可調：

AT_CREATION

Load_balancing_weights (string_array)

僅用於可延伸資源。如果在 RTR 檔案中宣告了 Scalable 特性，則 RGM 將自動建立此特性。其格式為 weight@node,weight@node，其中，weight 是一個整數，反映分配到指定 node 之負載的相對部分。分配到節點的負載分數值，是此節點的權重除以權重總量。例如，1@1,3@2 指定節點 1 接收負載的四分之一，節點 2 接收負載的四分之三。預設值空字串 (“”) 設定均勻的分配。未指定有明確權重的任何節點均會接收到預設權重 1。

如果在 RTR 檔案中未指定 Tunable 屬性，則特性的 Tunable 值為 ANYTIME。變更此特性將只修改新連接的分配。

種類：

條件式或可選用的

預設值：

空字串 (“”)

可調：

ANYTIME

Monitor_check_timeout 適用於類型中的每種回呼方法 (integer)

時延 (以秒為單位)，在此時延之後 RGM 會推斷出該方法的呼叫已失敗。對於給定的資源類型，僅定義在 RTR 檔案中已宣告的方法之逾時特性。

種類：

條件式或可選用的

預設值：

如果在 RTR 檔案中宣告了方法本身，則預設值為 3600 (1 小時)

可調：

ANYTIME

Monitor_start_timeout 適用於類型中的每種回呼方法 (integer)

時延 (以秒為單位)，在此時延之後 RGM 會推斷出該方法的呼叫已失敗。對於給定的資源類型，僅定義在 RTR 檔案中已宣告的方法之逾時特性。

種類：

條件式或可選用的

預設值：

如果在 RTR 檔案中宣告了方法本身，則預設值為 3600 (1 小時)

可調：

ANYTIME

Monitor_stop_timeout 適用於類型中的每種回呼方法 (integer)

時延 (以秒為單位)，在此時延之後 RGM 會推斷出該方法的呼叫已失敗。對於給定的資源類型，僅定義在 RTR 檔案中已宣告的方法之逾時特性。

種類：

條件式或可選用的

預設值：

如果在 RTR 檔案中宣告了方法本身，則預設值為 3600 (1 小時)

可調：

ANYTIME

Monitored_switch (enum)

如果叢集管理員使用管理公用程式啟用或停用監視器，則由 RGM 設定為 Enabled 或者 Disabled。如果設定為 Disabled，資源的監視功能將停止，儘管資源本身仍處於線上狀態。直到重新啟用監視功能，才會呼叫 Monitor_start 方法。如果資源不具有監視器回呼方法，則此特性不存在。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

NONE

Network_resources_used (string_array)

資源使用的邏輯主機名稱或共用位址網路資源之清單。對於可延伸服務，此特性必須是指存在於單獨資源群組的共用位址資源。對於故障轉移服務，此特性是指存在於同一資源群組之邏輯主機名稱或共用位址資源。如果在 RTR 檔案中宣告了 Scalable 特性，則 RGM 將自動建立此特性。如果在 RTR 檔案中未宣告 Scalable，則無法使用 Network_resources_used，除非在 RTR 檔案中明確宣告此特性。

如果在 RTR 檔案中未指定 Tunable 屬性，則特性的 Tunable 值為 AT_CREATION。

備註 –

SUNW.Event(5) 線上手冊說明如何設置 CRNP 的這一特性。

種類：

條件式或必需的

預設值：

沒有預設值

可調：

AT_CREATION

Num_resource_restarts 位於每個叢集節點上 (integer)

您不能直接設定此特性。RGM 會將該特性設定為在過去的 n 秒內在此節點上資源進行 scha_control、Resource_restart 或 Resource_is_restarted 呼叫的次數。n 是該資源的 Retry_interval 特性值。每當該資源執行 scha_control 停止功能時，不管嘗試停止成功還是失敗，RGM 都會將資源重新啟動計數器重設為零 (0)。

如果資源類型未宣告 Retry_interval 特性，則該類型的資源特性 Num_resource_restarts 不可用。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

NONE

Num_rg_restarts 位於每個叢集節點上 (integer)

您不能直接設定此特性。RGM 會將此特性設定為在過去的 n 秒內，資源在此節點上為其所在資源群組所進行的 scha_control Restart 呼叫次數。n 為此資源 Retry_interval 特性的值。如果資源類型未宣告 Retry_interval 特性，則該類型的資源特性 Num_rg_restarts 不可用。

種類：

請參閱說明

預設值：

沒有預設值

可調：

NONE

On_off_switch (enum)

如果叢集管理員使用管理公用程式啟用或停用資源，則由 RGM 設定為 Enabled 或者 Disabled。如果已停用，則資源將置於離線狀態，且直到被重新啟用後，才能執行回呼。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

NONE

Port_list (string_array)

伺服器在其上進行偵聽的通訊埠編號之清單。每個連接埠編號都附加有一條斜線 (/)，後接該連接埠正在使用的協定 (如 Port_list=80/tcp 或 Port_list=80/tcp6,40/udp6)。您可以指定下列協定值：

  • tcp (用於 TCP IPv4)

  • tcp6 (用於 TCP IPv6)

  • udp (用於 UDP IPv4)

  • udp6 (用於 UDP IPv6)

如果在 RTR 檔案中宣告了 Scalable 特性，則 RGM 會自動建立 Port_list。否則，此特性是不可用的，除非在 RTR 檔案中明確宣告該特性。

「Sun Cluster Data Service for Apache Guide for Solaris OS」說明設置 Apache 的該特性。

種類：

條件式或必需的

預設值：

沒有預設值

可調：

ANYTIME

Postnet_stop_timeout 適用於類型中的每種回呼方法 (integer)

時延 (以秒為單位)，在此時延之後 RGM 會推斷出該方法的呼叫已失敗。對於給定的資源類型，僅定義在 RTR 檔案中已宣告的方法之逾時特性。

種類：

條件式或可選用的

預設值：

如果在 RTR 檔案中宣告了方法本身，則預設值為 3600 (1 小時)

可調：

ANYTIME

Prenet_start_timeout 適用於類型中的每種回呼方法 (integer)

時延 (以秒為單位)，在此時延之後 RGM 會推斷出該方法的呼叫已失敗。對於給定的資源類型，僅定義在 RTR 檔案中已宣告的方法之逾時特性。

種類：

條件式或可選用的

預設值：

如果在 RTR 檔案中宣告了方法本身，則預設值為 3600 (1 小時)

可調：

ANYTIME

R_description (string)

資源的簡單說明。

種類：

選項

預設值：

空字串

可調：

ANYTIME

Resource_dependencies (string_array)

Resource_dependencies 資源對其具有強相依性的同一群組或不同群組中的資源之清單。如果清單中的任一資源不在線上，則無法啟動此資源。如果該資源與清單中的某一資源同時啟動，則要等到清單中的資源啟動後，RGM 才會啟動該資源。如果該資源的 Resource_dependencies 清單中的資源不啟動，則該資源將保持離線狀態。由於清單中資源的資源群組保持離線狀態或處於 START_FAILED 狀態，該資源的清單中的資源不會啟動。如果該資源由於對其他無法啟動的資源群組中資源具有相依性而保持離線狀態，則該資源的群組將進入 PENDING_ONLINE_BLOCKED 狀態。

如果讓此資源與清單中的那些資源同時離線，則此資源會先於清單中的那些資源停止。然而，如果此資源保持離線狀態或停止失敗，則清單中位於其他資源群組中的資源無論如何均會停止。除非先停用此資源，否則無法停用清單中的資源。

依預設，在資源群組中，應用程式資源對網路位址資源有隱式牢固資源依賴性。資源群組特性中的 Implicit_network_dependencies 含有更多資訊。

在資源群組內，將以依賴性順序在運行 Start 方法之前運行 Prenet_start 方法。Postnet_stop 方法在 Stop 方法之後以相依性順序執行。在不同的資源群組中，附屬資源要等其所附屬的資源完成 Prenet_start 和 Start 後，才能執行 Prenet_start。所附屬的資源要等附屬資源完成 Stop 和 Postnet_stop 後，才能執行 Stop。

種類：

選項

預設值：

空清單

可調：

ANYTIME

Resource_dependencies_restart (string_array)

Resource_dependencies_restart 資源對其具有重新啟動相依性的同一群組或不同群組中的資源之清單。

該特性的工作方式與 Resource_dependencies 相同，只有一點例外。如果重新啟動了重新啟動相依性清單中的任何資源，則將重新啟動該資源。在清單中的資源重新置於線上之後，RGM 會重新啟動該資源。

種類：

選項

預設值：

空清單

可調：

ANYTIME

Resource_dependencies_weak (string_array)

Resource_dependencies_weak 資源對其具有弱相依性的同一群組或不同群組中的資源之清單。弱相依性決定方法呼叫的順序。RGM 先呼叫此清單中資源的 Start 方法，然後再呼叫該資源的 Start 方法。RGM 先呼叫該資源的 Stop 方法，然後再呼叫清單中資源的 Stop。如果清單中的那些資源啟動失敗或保持離線狀態，則此資源仍可以啟動。

如果該資源和 Resource_dependencies_weak 清單中的資源同時啟動，RGM 會等到清單中的資源啟動後再啟動該資源。如果清單中的資源沒有啟動 (例如，如果清單中某一資源的資源群組保持離線狀態或清單中的資源處於 START_FAILED 狀態)，則該資源將重新啟動。在該資源的 Resource_dependencies_weak 清單中的資源啟動時，該資源的資源群組會暫時進入 PENDING_ONLINE_BLOCKED 狀態。當清單中的所有資源已啟動或無法啟動時，該資源將重新啟動，其群組會重新進入 PENDING_ONLINE 狀態。

如果讓此資源與清單中的那些資源同時離線，則此資源會先於此清單中的那些資源停止。如果此資源保持離線狀態或停止失敗，則清單中的資源無論如何均會停止。除非先停用此資源，否則無法停用清單中的資源。

在資源群組內，將以依賴性順序在運行 Start 方法之前運行 Prenet_start 方法。Postnet_stop 方法在 Stop 方法之後以相依性順序執行。在不同的資源群組中，附屬資源要等其所附屬的資源完成 Prenet_start 和 Start 後，才能執行 Prenet_start。所附屬的資源要等附屬資源完成 Stop 和 Postnet_stop 後，才能執行 Stop。

種類：

選項

預設值：

空清單

可調：

ANYTIME

Resource_name (string)

資源實例的名稱。此名稱在叢集配置中必須是唯一的，並且在建立資源後，無法對其進行變更。

種類：

必需的

預設值：

沒有預設值

可調：

NONE

Resource_project_name (string)

與資源關聯的 Solaris 專案名稱。使用這個特性將 Solaris 資源管理功能 (如 CPU 共用和資源集區) 套用至叢集資料服務。當 RGM 將資源置於線上時，便會啟動此專案名稱下的相關程序。如果未指定此特性，將從含有該資源的資源群組之 RG_project_name 特性取得專案名稱 (請參閱 rg_properties(5) 線上手冊)。如果兩種特性均未指定，則 RGM 將使用預定義的專案名稱 default。指定的專案名稱在專案資料庫中必須存在 (請參閱 projects(1) 線上手冊以及「System Administration Guide: Solaris Containers-Resource Management and Solaris Zones」)。

僅從 Solaris 9 開始才支援此特性。

備註 –

對此特性所做的變更將在下次啟動資源時生效。

種類：

選項

預設值：

Null (空)

可調：

ANYTIME

Resource_state 位於每個叢集節點上 (enum)

在每個叢集節點上由 RGM 決定的資源狀態。可能的狀態包含 ONLINE、OFFLINE、START_FAILED、STOP_FAILED、MONITOR_FAILED、ONLINE_NOT_MONITORED、STARTING 以及 STOPPING。

您無法配置這個特性。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

NONE

Retry_count (integer)

資源失敗時監視器可以嘗試重新啟動資源的次數。如果超過 Retry_count 次，根據特定的資料服務以及 Failover_mode 特性的設定，監視器可能執行以下動作之一︰

  • 即使資源正處於錯誤狀態，仍允許資源群組保留在目前的主要節點上

  • 請求將資源群組容錯移轉至其他節點上

僅當在 RTR 檔案中宣告了此特性，RGM 才可以建立特性，且叢集管理員才可以使用它。如果在 RTR 檔案中指定了預設值，則此特性是可選用的。

如果在 RTR 檔案中未指定 Tunable 屬性，則特性的 Tunable 值為 WHEN_DISABLED。

備註 –

如果為此特性指定負值，則監視器會無數次嘗試重新啟動資源。

種類：

條件式

預設值：

請參閱上文

可調：

WHEN_DISABLED

Retry_interval (integer)

試圖重新啟動失敗資源的間隔秒數。資源監視器將此特性與 Retry_count 配合使用。僅當在 RTR 檔案中宣告了此特性，RGM 才可以建立特性，且叢集管理員才可以使用它。如果在 RTR 檔案中指定了預設值，則此特性是可選用的。

如果在 RTR 檔案中未指定 Tunable 屬性，則特性的 Tunable 值為 WHEN_DISABLED。

種類：

條件式

預設值：

沒有預設值 (請參閱上文)

可調：

WHEN_DISABLED

Scalable (boolean)

表示資源是否可延伸，即資源是否使用 Sun Cluster 軟體的網路負載平衡功能。

如果在 RTR 檔案中宣告了此特性，則 RGM 將為該類型的資源自動建立以下可延伸服務特性：Affinity_timeout、Load_balancing_policy、Load_balancing_weights、Network_resources_used、Port_list、UDP_affinity 以及 Weak_affinity。這些特性均有其預設值，除非在 RTR 檔案中對它們進行了明確宣告。Scalable 的預設值 (若在 RTR 檔案中已宣告) 為 TRUE。

如果此特性在 RTR 檔案中已宣告，將為其指定 AT_CREATION，而不能指定 Tunable 屬性。

如果在 RTR 檔案中未宣告此特性，則資源是不可延伸的，您無法調校此特性，並且 RGM 不會設定任何可延伸服務特性。然而，您可以在 RTR 檔案中明確宣告 Network_resources_used 和 Port_list 特性。這些特性在不可延伸服務和可延伸服務中都很有用。

r_properties(5) 線上手冊更加詳細地說明如何將資源特性與 Failover 資源類型特性結合使用。

種類：

選項

預設值：

沒有預設值

可調：

AT_CREATION

Start_timeout 適用於類型中的每種回呼方法 (integer)

時延 (以秒為單位)，在此時延之後 RGM 會推斷出該方法的呼叫已失敗。對於給定的資源類型，僅定義在 RTR 檔案中已宣告的方法之逾時特性。

種類：

條件式或可選用的

預設值：

如果在 RTR 檔案中宣告了方法本身，則預設值為 3600 (1 小時)

可調：

ANYTIME

Status 位於每個叢集節點上 (enum)

由資源監視器透過 scha_resource_setstatus 指令或 scha_resource_setstatus() 函數設定。可能的值包含 OK、degraded、faulted、unknown 以及 offline。當資源置於線上或離線狀態時，如果資源的監視器或方法未設定 Status 值，則 RGM 會自動設定 Status 值。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

NONE

Status_msg 位於每個叢集節點上 (string)

資源監視器設定 Status 特性的同時設定該特性。使資源上線或離線時，如果此資源的方法未設定此特性，則 RGM 會自動將此特性重設為空字串。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

NONE

Stop_timeout 適用於類型中的每種回呼方法 (integer)

時延 (以秒為單位)，在此時延之後 RGM 會推斷出該方法的呼叫已失敗。對於給定的資源類型，僅定義在 RTR 檔案中已宣告的方法之逾時特性。

種類：

條件式或可選用的

預設值：

如果在 RTR 檔案中宣告了方法本身，則預設值為 3600 (1 小時)

可調：

ANYTIME

Thorough_probe_interval (integer)

在兩次資源高耗用時間故障探測的呼叫之間的秒數。僅當在 RTR 檔案中宣告了此特性，RGM 才可以建立特性，且叢集管理員才可以使用它。如果在 RTR 檔案中指定了預設值，則此特性是可選用的。

如果在 RTR 檔案中未指定 Tunable 屬性，則特性的 Tunable 值為 WHEN_DISABLED。

種類：

條件式

預設值：

沒有預設值

可調：

WHEN_DISABLED

Type (string)

此資源的資源類型就是一個實例。

種類：

必需的

預設值：

沒有預設值

可調：

NONE

Type_version (string)

指定當前與此資源相關聯的資源類型之版本。RGM 自動建立這個無法在 RTR 檔案中宣告的特性。此特性的值與資源類型的 RT_version 特性相等。建立資源時，Type_version 特性未明確指定，儘管它可能作為資源類型名稱的後綴出現。編輯資源時，可以將 Type_version 特性變更為新的值。

此特性的可調性源自下列來源：

  • 目前版本的資源類型

  • RTR 檔案中的 #$upgrade_from 指令

種類：

請參閱說明

預設值：

沒有預設值

可調：

請參閱說明

UDP_affinity (boolean)

如果此特性設定為 TRUE，會將所有 UDP 流量從給定的用戶端傳送至目前處理此用戶端的所有 TCP 流量之同一伺服器節點。

僅當 Load_balancing_policy 是 Lb_sticky 或者 Lb_sticky_wild 時，此特性才是有意義的。另外，必須將 Weak_affinity 設定為 FALSE。

此特性僅用於可延伸服務。

種類：

選項

預設值：

沒有預設值

可調：

WHEN_DISABLED

Update_timeout 適用於類型中的每種回呼方法 (integer)

時延 (以秒為單位)，在此時延之後 RGM 會推斷出該方法的呼叫已失敗。對於給定的資源類型，僅定義在 RTR 檔案中已宣告的方法之逾時特性。

種類：

條件式或可選用的

預設值：

如果在 RTR 檔案中宣告了方法本身，則預設值為 3600 (1 小時)

可調：

ANYTIME

Validate_timeout 適用於類型中的每種回呼方法 (integer)

時延 (以秒為單位)，在此時延之後 RGM 會推斷出該方法的呼叫已失敗。對於給定的資源類型，僅定義在 RTR 檔案中已宣告的方法之逾時特性。

種類：

條件式或可選用的

預設值：

如果在 RTR 檔案中宣告了方法本身，則預設值為 3600 (1 小時)

可調：

ANYTIME

Weak_affinity (boolean)

如果此特性設定為 TRUE，則將啟用用戶端關聯性的弱化形式。用戶端關聯性的弱化形式允許將自給定用戶端的連線傳送到同一伺服器節點，以下情況除外：

  • 針對故障監視器重新啟動、資源容錯移轉或切換保護轉移，或節點發生故障後重新連結叢集等情況，啟動伺服器偵聽程式

  • 由於叢集管理員執行了管理動作，可延伸資源的 Load_balancing_weights 發生變更

弱關聯性在記憶體消耗與處理器週期方面為預設形式提供了低耗用時間的選擇。

僅當 Load_balancing_policy 是 Lb_sticky 或者 Lb_sticky_wild 時，此特性才是有意義的。

此特性僅用於可延伸服務。

種類：

選項

預設值：

沒有預設值

可調：

WHEN_DISABLED

資源群組特性

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

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

Auto_start_on_new_cluster (boolean)

此特性控制 Resource Group Manager (RGM) 是否在形成新叢集時自動啟動資源群組。預設值為 TRUE。

如果設定為 TRUE，則在叢集的所有節點同時重新啟動時，RGM 會嘗試自動啟動資源群組以達成 Desired_primaries。

如果設定為 FALSE，則叢集重新啟動時，資源群組不會自動啟動。資源群組會一直保持離線狀態，直到首次透過使用 scswitch 指令或等效的 GUI 指令手動將資源群組切換為線上。此後，資源群組將繼續一般的容錯移轉運作方式。

種類：

選項

預設值：

TRUE

可調：

ANYTIME

Desired_primaries (integer)

可以同時執行群組之節點的喜好數量。

預設值為 1。如果 RG_mode 特性為 Failover，則該特性的值必須不大於 1。如果 RG_mode 特性為 Scalable，則允許大於 1 的值。

種類：

選項

預設值：

1

可調：

ANYTIME

Failback (boolean)

一個布林值，表示當叢集成員資格變更時，是否重新計算群組已處於線上狀態的節點集。重新計算將導致 RGM 使群組在喜好程度低的節點上離線，在喜好程度高的節點上上線。

種類：

選項

預設值：

FALSE

可調：

ANYTIME

Global_resources_used (string_array)

指示叢集檔案系統是否由此資源群組中的任何資源使用。叢集管理員可以指定的合法值是星號 (*) (表示所有全域資源) 以及空字串 (“”) (表示沒有全域資源)。

種類：

選項

預設值：

所有全域資源

可調：

ANYTIME

Implicit_network_dependencies (boolean)

一個布林值，當為 TRUE 時，表示 RGM 應該在群組內執行非網路位址資源對網路位址資源的隱含強相依性。這表示在群組內，RGM 會在啟動所有其他資源之前，先啟動所有網路位址資源，並在停止所有其他資源之後，才停止網路位址資源。網路位址資源包含邏輯主機名稱和共用位址資源類型。

在可延伸資源群組中，可延伸資源群組不含有任何網路位址資源，因此該特性不起作用。

種類：

選項

預設值：

TRUE

可調：

ANYTIME

Maximum_primaries (integer)

群組可以同時處於線上的最大節點數。

如果 RG_mode 特性為 Failover，則該特性的值必須不大於 1。如果 RG_mode 特性為 Scalable，則允許大於 1 的值。

種類：

選項

預設值：

1

可調：

ANYTIME

Nodelist (string_array)

叢集節點清單，可按照喜好順序在這些節點上將群組置於線上。這些節點被稱為資源群組的潛在主節點或主控者。

種類：

選項

預設值：

所有叢集節點依照任意順序排列的清單。

可調：

ANYTIME

Pathprefix (string)

叢集檔案系統中的目錄；群組中的資源可在其中寫入必要的管理檔案。某些資源可能需要此特性。使 Pathprefix 針對每個資源群組均是唯一的。

種類：

選項

預設值：

空字串

可調：

ANYTIME

Pingpong_interval (integer)

一個非負整數值 (以秒為單位)，由 RGM 用來決定在以下情況中將資源群組置於線上狀態的位置︰

  • 在重新配置時

  • 執行 scha_control GIVEOVER 指令或函數之後

在重新配置時，資源群組在過去的 Pingpong_interval 秒內多次連線到特定節點會失敗。這種失敗是因為資源的 Start 或 Prenet_start 方法以非零狀態結束或逾時。因此，會認為節點不適合管理資源群組，RGM 將尋找其他主控者。

如果資源在給定節點上執行 scha_control 指令或 scha_control GIVEOVER 指令而導致其資源群組容錯移轉至其他節點，則直到 Pingpong_interval 結束後，該資源才會將第一個節點 (執行 scha_control 指令的節點) 作為其他 scha_control GIVEOVER 的目標。

種類：

選項

預設值：

3600 (1 小時)

可調：

ANYTIME

Resource_list (string_array)

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

種類：

僅限於查詢

預設值：

沒有預設值

可調：

NONE

RG_affinities (string)

RGM 將嘗試在其他給定資源群組的目前寄主之節點上 (正關聯性) 或不是給定資源群組的目前寄主之節點上 (負關聯性) 找到資源群組。

您可以將 RG_affinities 設定為下列字串：

  • ++ 或強的正關聯性

  • + 或弱的正關聯性

  • - 或弱的負關聯性

  • -- 或強的負關聯性

  • +++ 或具有防故障備用委派的強的正關聯性

例如，RG_affinities=+RG2,--RG3 指示此資源群組的 RG2 具有弱的正關聯性，RG3 具有強的負關聯性。

「Sun Cluster Data Services Planning and Administration Guide for Solaris OS」中的第 2 章「Administering Data Service Resources」說明如何使用 RG_affinities。

種類：

選項

預設值：

空字串

可調：

ANYTIME

RG_dependencies (string_array)

資源群組的可選用清單，表示在同一節點上將其他群組置於線上或離線狀態的喜好順序。所有強 RG_affinities (正值和負值) 和 RG_dependencies 的圖形含有循環。

例如，假定資源群組 RG2 位於群組 RG1 的 RG_dependencies 清單中，即 RG1 對 RG2 具有資源群組相依性。以下清單概述了此資源群組相依性的影響︰

  • 當某節點連結叢集時，直到該節點的所有 Boot 方法在 RG2 的資源上完成之後，才會於 RG1 的資源上運行該節點的 Boot 方法。

  • 如果 RG1 和 RG2 在同一節點上同時處於 PENDING_ONLINE 狀態，則直到 RG2 中的所有資源完成啟動方法 (Prenet_start 或 Start) 後，RG1 中的資源上才會執行啟動方法。

  • 如果 RG1 和 RG2 在同一節點上同時處於 PENDING_OFFLINE 狀態，則直到 RG1 中的所有資源都完成停止方法 (Stop 或 Postnet_stop) 後，RG2 中的資源上才會執行停止方法。

  • 如果在嘗試切換 RG1 或 RG2 的主節點時，使 RG1 在任一節點上線，而 RG2 在所有節點離線，則切換主節點會失敗。scswitch(1M) 和 scsetup(1M) 線上手冊含有更多資訊。

  • 如果在 RG2 上將 Desired_primaries 設定為零，則不允許在 RG1 上將 Desired_primaries 特性設定為大於零的值。

  • 如果在 RG2 上將 Auto_start_on_new_cluster 特性設定為 FALSE，則不允許在 RG1 上將 Auto_start_on_new_cluster 特性設定為 TRUE。

種類：

選項

預設值：

空清單

可調：

ANYTIME

RG_description (string)

資源群組的簡單說明。

種類：

選項

預設值：

空字串

可調：

ANYTIME

RG_is_frozen (boolean)

一個布林值，指示是否對資源群組所依賴的全域裝置進行故障保護移轉。如果此特性設定為 TRUE，則正在切換保護轉移全域裝置。如果此特性設定為 FALSE，則不對全域裝置進行故障保護移轉。資源群組依賴全域裝置，如其 Global_resources_used 特性所指示。

您不會直接設定 RG_is_frozen 特性。在全域裝置的狀態變更時，RGM 會更新 RG_is_frozen 特性。

種類：

選項

預設值：

沒有預設值

可調：

NONE

RG_mode (enum)

表示資源群組是容錯移轉群組或是可延伸群組。如果值為 Failover，則 RGM 將群組的 Maximum_primaries 特性設定為 1，並限制資源群組由單一節點主控。

如果此特性的值為 Scalable，則 RGM 允許將 Maximum_primaries 特性設定為大於 1 的值。從而群組可由多個節點同時主控。RGM 不允許將 Failover 特性為 TRUE 的資源增加到其 RG_mode 為 Scalable 的資源群組中。

如果 Maximum_primaries 為 1，則預設值為 Failover。如果 Maximum_primaries 大於 1，則預設值為 Scalable。

種類：

選項

預設值：

依賴於 Maximum_primaries 的值

可調：

NONE

RG_name (string)

資源群組的名稱。此特性是必需的，且在叢集中必須唯一。

種類：

必需的

預設值：

沒有預設值

可調：

NONE

RG_project_name (string)

與資源群組關聯的 Solaris 專案名稱 (請參閱 projects(1) 線上手冊)。使用這個特性將 Solaris 資源管理功能 (如 CPU 共用和資源集區) 套用至叢集資料服務。RGM 將資源群組置於線上後，將此專案名稱下啟動不具有 Resource_project_name 特性設定之資源的相關程序 (請參閱 r_properties(5) 線上手冊)。指定的專案名稱在專案資料庫中必須存在 (請參閱 projects(1) 線上手冊以及「System Administration Guide: Solaris Containers-Resource Management and Solaris Zones」)。

僅從 Solaris 9 開始才支援此特性。

備註 –

對此特性所做的變更將在資源下次啟動時生效。

種類：

選項

預設值：

文字字串「default」

可調：

ANYTIME

RG_state 位於每個叢集節點上 (enum)

由 RGM 設定為 UNMANAGED、ONLINE、OFFLINE、PENDING_ONLINE、PENDING_OFFLINE、ERROR_STOP_FAILED、ONLINE_FAULTED 或 PENDING_ONLINE_BLOCKED，用來說明群組在每個叢集節點上的狀態。

您無法配置這個特性。但是，您可以透過執行 scswitch 指令或使用等效的 scsetup 或 SunPlex Manager 指令直接設定此特性。當群組不在 RGM 控制下時，它可以以 UNMANAGED 狀態存在。

以下說明概述了每種狀態。

備註 –

狀態僅套用至個別節點，但 UNMANAGED 狀態除外，其套用至所有節點。例如，資源群組可能在節點 A 上為 OFFLINE，但在節點 B 上為 PENDING_ONLINE。

UNMANAGED

新建資源群組的初始狀態或先前管理的資源群組之狀態。Init 方法未在群組的資源上執行，或 Fini 方法已經在群組的資源上執行。

群組不由 RGM 管理。

ONLINE

在節點上已啟動。也就是說，啟動方法 Prenet_start、Start 和 Monitor_start 適用於每種資源，在群組中所有啟用的資源上成功執行。

OFFLINE

資源群組在節點上已停止。也就是說，停止方法 Monitor_stop、Stop 和 Postnet_stop 適用於每種資源，在群組中所有啟用的資源上成功執行。在資源群組在節點上首次啟動之前，也會套用此狀態。

PENDING_ONLINE

資源群組在節點上正在啟動。啟動方法 Prenet_start、Start 和 Monitor_start 適用於每種資源，正在群組中啟用的資源上執行。

PENDING_OFFLINE

資源群組在節點上正在停止。停止方法 Monitor_stop、Stop 和 Postnet_stop 適用於每種資源，正在群組中啟用的資源上執行。

ERROR_STOP_FAILED

資源群組中的一種或多種資源無法成功停止並處於 Stop_failed 狀態。群組中的其他資源可能保持線上狀態或離線狀態。直到清除 ERROR_STOP_FAILED 狀態後，才允許此資源群組在任何節點上啟動。

您必須使用管理指令 (如 scswitch -c) 手動停止 Stop_failed 資源並將其狀態重設為 OFFLINE。

ONLINE_FAULTED

資源群組處於 PENDING_ONLINE 並在此節點上已完成啟動。但是，一個或多個資源以 Start_failed 狀態或 Faulted 狀態結束。

PENDING_ONLINE_BLOCKED

資源群組無法完全啟動，因為此資源群組中的一個或多個資源對其他資源群組中的資源具有未滿足的強資源相依性。這些資源保持 OFFLINE。滿足資源相依性後，資源群組會自動返回 PENDING_ONLINE 狀態。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

NONE

RG_system (boolean)

如果資源群組的 RG_system 特性為 TRUE，對資源群組和資源群組所含有的資源執行的特定作業將受到限制。此限制旨在協助防止對重要資源群組和資源的意外修改或刪除。此特性僅影響 scrgadm 和 scswitch 指令。不影響對 scha_control(1HA) 和 scha_control(3HA) 的作業。

在對資源群組 (或資源群組的資源) 執行限制作業之前，您必須先將資源群組的 RG_system 特性設定為 FALSE。當您修改或刪除支援叢集服務的資源群組，或者修改或刪除此類資源群組包含的資源時，請小心操作。

作業 

範例 

刪除資源群組 

scrgadm -r -g RG1

編輯資源群組特性 (RG_system 除外)

scrgadm -c -t RG1 -y nodelist=...

向資源群組增加資源 

scrgadm -a -j R1 -g RG1

從資源群組刪除資源 

scrgadm -r -j R1 -g RG1

編輯屬於資源群組的資源之特性 

scrgadm -c -j R1

將資源群組切換為離線 

scswitch -F -g RG1

管理資源群組 

scswitch -o -g RG1

解除管理資源群組 

scswitch -u -g RG1

啟用資源 

scswitch -e -j R1

啟用資源的監視功能 

scswitch -e -M -j R1

停用資源 

scswitch -n -j R1

停用資源的監視功能 

scswitch -n -M -j R1

如果資源群組的 RG_system 特性為 TRUE，則您唯一可以編輯的資源群組的特性為 RG_system 特性本身。也就是說，編輯 RG_system 特性永遠不受限制。

種類：

選項

預設值：

FALSE

可調：

ANYTIME

資源特性屬性

本小節說明您可以用來變更系統定義的特性或建立延伸特性之資源特性屬性。

注意 – 注意 –

您不能將 Null 或空字串 (“”) 指定為 boolean、enum 或 int 類型的預設值。

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

Array_maxsize

對於 stringarray 類型，此為所允許的陣列元素之最大數量。

Array_minsize

對於 stringarray 類型，此為所允許的陣列元素之最小數量。

Default

指示特性的預設值。

Description

一個字串附註，用於對特性作簡短描述。對於系統定義的特性，不能在 RTR 檔案中設定 Description 特性。

Enumlist

對於 enum 類型，為此特性所允許的一個字串值集。

Extension

如果使用，則表明 RTR 檔案項目宣告一種由資源類型實施所定義的延伸特性。否則，此項目為系統定義的特性。

Max

對於 int 類型，此為所允許的特性之最大值。

Maxlength

對於 string 和 stringarray 類型，此為所允許的最大字串長度。

Min

對於 int 類型，此為特性所允許的最小值。

Minlength

對於 string 和 stringarray 類型，此為所允許的最小字串長度。

Property

資源特性的名稱。

Tunable

指示叢集管理員何時可以在資源中設定此特性的值。設定為 NONE 或 FALSE，以防止叢集管理員設定此特性。能讓叢集管理員調校特性的值是 TRUE 或 ANYTIME (隨時)、AT_CREATION (僅當建立資源時)，或 WHEN_DISABLED (停用資源時)。若要建立其他條件 (如「停用監視功能時」或「離線時」)，請將此屬性設定為 ANYTIME，並使用 Validate 方法驗證資源的狀態。

每個標準資源特性的預設值均不同，如以下項目中所示。如果未在 RTR 檔案中指定調校延伸特性的預設設定，則應為 TRUE (ANYTIME)。

特性的類型

允許的類型為 string、boolean、integer、enum 和 stringarray。對於系統定義的特性，您不能在 RTR 檔案項目中設定類型性質。類型決定了可接受的特性值和在 RTR 檔案項目中所允許的類型特定屬性。enum 類型是一個字串值集。