附錄 A 標準特性

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

本附錄包含下列小節：

• 資源類型特性

• 資源特性

• 資源群組特性

• 資源特性性質

資源類型特性

以下資訊描述 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 特性。

種類：

條件式

預設值：

沒有預設值

可調：

否

資源特性

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

• 必需的 – 管理員必須在使用管理公用程式建立資源時指定一個值。

• 可選擇的 – 如果管理員在建立資源群組時未指定值，則系統將提供一個預設值。

• 條件式 – 僅當在 RTR 檔案中宣告了該特性時，RGM 才會建立該特性。否則，該特性不會存在，系統管理員也就無法使用它。在 RTR 檔案中宣告的條件式特性是可選擇的或者必需的，這取決於是否在 RTR 檔案中指定預設值。如需詳細資訊，請參閱每個條件式特性的說明。

• 僅限於查詢 – 不能由管理工具直接設定。

[可調] 列出您是否以及何時可以更新資源特性，如下所示：

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

Affinity_timeout (整數)

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

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

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

種類：

可選用的

預設值：

沒有預設值

可調：

ANYTIME

Cheap_probe_interval (整數)

在兩次資源故障快速探測的呼叫之間的秒數。此特性由 RGM 建立，僅當在 RTR 檔案中宣告了此特性時，管理員才可以使用它。

如果在 RTR 檔案中指定了預設值，則此特性是可選用的。如果在資源類型檔案中未指定 Tunable 屬性，則此特性的 Tunable 值為 WHEN_DISABLED。

如果在 RTR 檔案中宣告了此特性，且未指定 Default 屬性，則此特性是必需的。

種類：

條件式

預設值：

沒有預設值

可調：

WHEN_DISABLED

延伸特性

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

種類：

條件式

預設值：

沒有預設值

可調：

取決於特定的特性

Failover_mode (列舉)

當 Start 方法 (Prenet_start 或 Start) 失敗時，NONE、SOFT 與 HARD 僅影響防故障備用行為。然而，當資源成功啟動後，NONE、SOFT 與 HARD 不會影響資源監視器使用 scha_control(1HA) 或 scha_control(3HA) 所引發的後續資源的重新啟動或停止行為。NONE (預設值) 指示 RGM 在方法失敗時設定資源狀態，並等待使用者介入。SOFT 指示在 Start 方法失敗時，RGM 重新將資源群組定位至其他節點。如果 Stop 或 Monitor_stop 方法失敗，RGM 會將資源設定為 Stop_failed 狀態，並將資源群組設定為 Error_stop_failed 狀態。然後，RGM 等待使用者介入。對於Stop 或 Monitor_stop 失敗，NONE 和 SOFT 是相同的。HARD 指示在 Start 方法失敗時，RGM 將重新定位群組。如果 Stop 或 Monitor_stop 方法失敗，則 RGM 會透過中斷叢集節點來停止資源。當 Start 或 Prenet_start 方法失敗時，HARD、NONE、SOFT 會影響防故障備用行為。

與 NONE、SOFT 和 HARD 不同，RESTART_ONLY 和 LOG_ONLY 會影響所有防故障備用行為，包括監視器引發的 (scha_control) 資源和資源群組的重新啟動，以及資源監視器 (scha_control) 引發的停止。RESTART_ONLY 指示監視器可以運行 scha_control 來重新啟動資源，但隨後使用 scha_control 嘗試執行資源群組的重新啟動或停止會失敗。RGM 允許在 Retry_interval 內重新啟動 Retry_count 次。如果超過 Retry_count 次，則不允許重新啟動資源。如果 Failover_mode 設定為 LOG_ONLY，則不允許重新啟動或停止資源。將 Failover_mode 設定為 LOG_ONLY，與將 Failover_mode 設定為 RESTART_ONLY (Retry_count 設定為零) 是等效的。如果 start 方法失敗，則 RESTART_ONLY 和 LOG_ONLY 與 NONE 是等效的：不會發生任何防故障備用，且資源轉為 Start_failed 狀態。

種類：

可選用的

預設值：

沒有預設值

可調：

ANYTIME

Load_balancing_policy (字串)

定義所使用的負載平衡策略之字串。此特性僅用於可延伸服務。如果在 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 (字串陣列)

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

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

種類：

條件式/選用

預設值：

空字串 (“”)

可調：

ANYTIME

適用於 Type (整數) 中的各種回呼方法之 method_timeout

時延 (以秒為單位)，在此時延之後 RGM 會推斷出該方法的呼叫已失敗。

種類：

條件式/選用

預設值：

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

可調：

ANYTIME

Monitored_switch (列舉)

如果叢集管理員使用管理公用程式啟用或停用監視器，則由 RGM 設定為 Enabled 或者 Disabled。如果設定為 Disabled，則在再次啟用監視器之前，監視器的 Start 方法不會被呼叫。如果資源不具有監視器回呼方法，則此特性不存在。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

永遠不

Network_resources_used (字串陣列)

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

如果在資源類型檔案中未指定 Tunable 屬性，則此特性的 Tunable 值為 AT_CREATION。

---

注意 –

SUNW.Event(5) 線上說明手冊描述了如何為 CRNP 設置此特性。

---

種類：

條件式/必需的

預設值：

沒有預設值

可調：

AT_CREATION

每個叢集節點上的 Num_resource_restarts (整數)

您無法直接設定此特性，因為此特性由 RGM 設定為在過去的 n 秒內在此節點上對此資源所進行的 scha_control、Resource_restart 或 Resource_is_restarted 呼叫之數目。n 為此資源 Retry_interval 特性的值。每當此資源執行 scha_control 停止時，無論停止嘗試是成功還是失敗，RGM 均會將資源重新啟動計數器重設為零。

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

種類：

僅限於查詢

預設值：

沒有預設值

可調：

否

每個叢集節點上的 Num_rg_restarts (整數)

您無法直接設定此特性，RGM 將其設定為在過去的 n 秒內在此節點上由此資源對包含的資源群組所進行的 scha_control Restart 呼叫之數目，其中 n 為此資源 Retry_interval 特性的值。如果資源類型未宣告 Retry_interval 特性，則 Num_rg_restarts 特性不能用於該類型的資源。

種類：

請參閱說明

預設值：

沒有預設值

可調：

否

On_off_switch (列舉)

如果叢集管理員使用管理公用程式啟用或停用資源，則由 RGM 設定為 Enabled 或者 Disabled。如果停用，則會使資源離線，並在再次啟用此資源之前，不會呼叫任何回呼。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

永遠不

Port_list (字串陣列)

伺服器在其上進行偵聽的通訊埠編號之清單。附加至各連接埠號的是一條斜線 (/)，其後跟隨該連接埠所使用的協定，例如，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 設置此特性的描述。

種類：

條件式/必需的

預設值：

沒有預設值

可調：

AT_CREATION

R_description (字串)

資源的簡單說明。

種類：

可選用的

預設值：

空字串

可調：

ANYTIME

Resource_dependencies (字串陣列)

相同群組或不同群組中的資源之清單，此資源對這些資源具有牢固依賴性。如果清單中的任一資源不在線上，則無法啟動此資源。如果此資源與清單中的一個資源同時啟動，則 RGM 會等到清單中的資源啟動之後再啟動此資源。如果此資源的 Resource_dependencies 清單中的資源未啟動，則此資源也會保持離線狀態。此資源的清單中的資源可能不啟動，原因是清單中資源的資源群組保持離線狀態，或清單中的資源處於 Start_failed 狀態。如果此資源因為依賴於其他啟動失敗的資源群組中的資源而保持離線狀態，則此資源的群組會進入 Pending_online_blocked 狀態。

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

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

在資源群組內，將以依賴性順序在運行 Start 方法之前運行 Prenet_start 方法。以依賴性順序在運行 Stop 方法之後運行 Postnet_stop 方法。在不同的資源群組中，依賴者等待所依賴的資源先完成 Prenet_start 和 Start，然後運行 Prenet_start。所依賴的資源等待依賴者先完成 Stop 和 Postnet_stop，然後運行 Stop。

種類：

可選用的

預設值：

空清單

可調：

ANYTIME

Resource_dependencies_restart (字串陣列)

相同群組或不同群組中的資源之清單，此資源對這些資源具有重新啟動依賴性。

如果重新啟動依賴性清單的任何資源重新啟動，則此資源會重新啟動，除此之外，此特性與 Resource_dependencies 的工作方式相同。在清單中的資源重新上線之後，此資源會重新啟動。

種類：

可選用的

預設值：

空清單

可調：

ANYTIME

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 方法。以依賴性順序在運行 Stop 方法之後運行 Postnet_stop 方法。在不同的資源群組中，依賴者等待所依賴的資源先完成 Prenet_start 和 Start，然後運行 Prenet_start。所依賴的資源等待依賴者先完成 Stop 和 Postnet_stop，然後運行 Stop。

種類：

可選用的

預設值：

空清單

可調：

ANYTIME

Resource_name (字串)

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

種類：

必需的

預設值：

沒有預設值

可調：

永遠不

Resource_project_name (字串)

與資源關聯的 Solaris 專案名稱。使用此特性可將 Solaris 資源管理功能 (例如 CPU 共用和資源集區) 套用至叢集資料服務。當 RGM 使資源上線運作時，此特性便會啟動此專案名稱下的相關程序。如果未指定此特性，則會將專案名稱從包含此資源的資源群組之 RG_project_name 特性中取出 (請參閱 rg_properties (5))。如果未指定兩種特性中的任一特性，則 RGM 會使用預先定義的專案名稱 default。指定的專案名稱必須存在於專案資料庫中，還必需將使用者 root 配置為命名專案的成員。僅在 Solaris 9 及更高版本的 Solaris 中才支援此特性。

---

注意 –

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

---

種類：

可選用的

預設值：

Null (空)

可調：

ANYTIME

每個叢集節點上的 Resource_state (列舉)

在每個叢集節點上由 RGM 決定的資源狀態。可能的狀態為 Online、Offline、Start_failed、Stop_failed、Monitor_failed、Online_not_monitored、Starting 與 Stopping。

您無法配置這個特性。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

永遠不

Retry_count (整數)

資源失敗時監視器可以嘗試重新啟動資源的次數。此特性由 RGM 建立，僅當在 RTR 檔案中宣告了此特性時，管理員才可以使用它。如果在 RTR 檔案中指定了預設值，則 Retry_count 是可選擇的。

如果在資源類型檔案中未指定 Tunable 屬性，則此特性的 Tunable 值為 WHEN_DISABLED。

如果在 RTR 檔案中宣告了此特性，且未指定 Default 屬性，則此特性是必需的。

種類：

條件式

預設值：

沒有預設值

可調：

WHEN_DISABLED

Retry_interval (整數)

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

如果在資源類型檔案中未指定 Tunable 屬性，則此特性的 Tunable 值為 WHEN_DISABLED。

如果在 RTR 檔案中宣告了此特性，且未指定 Default 屬性，則此特性是必需的。

種類：

條件式

預設值：

沒有預設值

可調：

WHEN_DISABLED

Scalable (布林值)

指示資源是否是可延伸的，也就是說，資源是否使用 Sun Cluster 的網路負載平衡功能。

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

如果在 RTR 檔案中宣告此特性，則不允許為其指定除 AT_CREATION 之外的 Tunable 屬性。

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

您可以將此資源特性與 Failover 資源類型特性結合使用，如下所示：

在 r_properties(5) 中更加詳細地描述了如何將此資源特性與 Failover 資源類型特性結合使用。

種類：

可選用的

預設值：

沒有預設值

可調：

AT_CREATION

每個叢集節點上的 Status (列舉)

由資源監視器使用 scha_resource_setstatus(1HA) 或 scha_resource_setstatus(3HA) 所設定。可能的值為 OK、degraded、faulted、unknown 與 offline。使資源上線或離線時，如果此資源的監視器或方法未設定 Status 的值，則 RGM 會自動設定 Status 的值。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

永遠不

每個叢集節點上的 Status_msg (字串)

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

種類：

僅限於查詢

預設值：

沒有預設值

可調：

永遠不

Thorough_probe_interval (整數)

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

如果在資源類型檔案中未指定 Tunable 屬性，則此特性的 Tunable 值為 WHEN_DISABLED。

如果在 RTR 檔案的特性宣告中未指定 Default 性質，則此特性是必需的。

種類：

條件式

預設值：

沒有預設值

可調：

WHEN_DISABLED

Type (字串)

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

種類：

必需的

預設值：

沒有預設值

可調：

永遠不

Type_version (字串)

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

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

• 目前版本的資源類型

• RTR 檔案中的 #$upgrade_from 指令

種類：

請參閱說明

預設值：

沒有預設值

可調：

請參閱說明

UDP_affinity (布林值)

如果為 True，則會將給定用戶端的所有 UDP 通訊發送到目前處理用戶端的所有 TCP 通訊之同一伺服器節點。

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

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

種類：

可選用的

預設值：

沒有預設值

可調：

WHEN_DISABLED

Weak_affinity (布林值)

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

• 例如，當伺服器偵聽程式由於故障監視器重新啟動、資源的防故障備用或切換保護移轉或者節點在發生故障後重新連結叢集而啟動時

• 當可延伸資源的 Load_balancing_weights 由於某個管理動作而變更時

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

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

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

種類：

可選用的

預設值：

沒有預設值

可調：

WHEN_DISABLED

資源群組特性

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

• 必需的 — 管理員必須在使用管理公用程式建立資源群組時指定一個值。

• 可選擇的 – 如果管理員在建立資源群組時未指定值，則系統將提供一個預設值。

• 僅限於查詢 – 不能由管理工具直接設定。

每個描述說明特性在初始設定之後是可更新 (Y) 還是不可更新 (N)。

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

Auto_start_on_new_cluster (布林值)

在新的叢集形成時，此特性不允許自動啟動資源群組。

如果已設定為 TRUE，則資源群組管理員會在重新啟動叢集時，試圖自動啟動該資源群組以達到 Desired_primaries。如果設定為 FALSE，則叢集重新啟動時，資源群組並不會自動啟動。

種類：

可選用的

預設值：

TRUE

可調：

是

Desired_primaries (整數)

群組需要同時在其上連線的節點之數目。

如果 RG_mode 特性為 Failover，則此特性的值不得大於 1。如果 RG_mode 特性為 Scalable，則允許值大於 1。

種類：

可選用的

預設值：

1

可調：

是

Failback (布林值)

一個布林值，指示當叢集成員資格發生變化時，是否重新計算其上群組已連線的節點集。重新計算將導致 RGM 使群組在喜好程度低的節點上離線，在喜好程度高的節點上上線。

種類：

可選用的

預設值：

FALSE

可調：

是

Global_resources_used (字串陣列)

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

種類：

可選用的

預設值：

所有全域資源

可調：

是

Implicit_network_dependencies (布林值)

一個布林值，當為 TRUE 時，指示 RGM 應該在群組內執行非網路位址資源對網路位址資源的隱式牢固依賴性。網路位址資源包括邏輯主機名稱和共用位址資源類型。

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

種類：

可選用的

預設值：

TRUE

可調：

是

Maximum_primaries (整數)

群組一次可以連線的最大節點數。

如果 RG_mode 特性為 Failover，則此特性的值不得大於 1。如果 RG_mode 特性為 Scalable，則允許值大於 1。

種類：

可選用的

預設值：

1

可調：

是

Nodelist (字串陣列)

叢集節點的清單，在這些節點上可以依喜好程度使群組上線。這些節點被稱為資源群組的潛在主節點或主控者。

種類：

可選用的

預設值：

所有叢集節點的清單

可調：

是

Pathprefix (字串)

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

種類：

可選用的

預設值：

空字串

可調：

是

Pingpong_interval (整數)

一個非負整數值 (以秒為單位)，RGM 使用它來確定在何處使資源群組上線。可能需要此特性的情況如下所示：

• 如果發生重新配置

• 執行 scha_control -O GIVEOVER 指令或者包含 SCHA_GIVEOVER 引數的 scha_control() 函式

發生重新配置時，如果資源群組在過去的 Pingpong_interval 秒內於特定節點上多次上線失敗，則該節點被視為無資格託管資源群組，RGM 將尋找其他主控者。資源群組上線失敗的原因是此資源的 Start 方法或 Prenet_start 方法以非零結束或逾時。

如果呼叫資源的 scha_control 指令或函式導致資源群組在過去的 Pingpong_interval 秒內於特定節點上離線，則會由於從其他節點接著呼叫 scha_control() 而使該節點無資格託管資源群組。

種類：

可選用的

預設值：

3,600 (1 小時)

可調：

是

Resource_list (字串陣列)

群組中包含的資源之清單。管理員不會直接設定這個特性。相反，RGM 在管理員於資源群組內新增或移除資源時更新此特性。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

否

RG_affinities (字串)

RGM 嘗試在其他給定資源群組的目前主節點 (正相似性) 上尋找資源群組，或者在給定資源群組的非目前主節點 (負相似性) 上尋找資源群組。

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

• ++ 或強的正相似性

• + 或弱的正相似性

• - 或弱的負相似性

• -- 或強的負相似性

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

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

「Sun Cluster Data Services Planning and Administration Guide for Solaris OS」的「Administering Data Service Resources」中對使用 RG_affinities 進行了描述。

種類：

可選用的

預設值：

空字串

可調：

是

RG_dependencies (字串陣列)

可選擇的資源群組清單，這些資源群組指示在同一節點上使其他群組上線或離線的喜好排序。所有強的 RG_affinities (正、負) 及 RG_dependencies 的圖形均不可包含循環。

例如，假定資源群組 RG2 列於資源群組 RG1 的 RG_dependencies 清單中。換言之，假定 RG1 對 RG2 具有資源群組依賴性。以下清單概述了此資源群組依賴性的效果：

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

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

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

• 如果在嘗試切換 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。

種類：

可選用的

預設值：

空清單

可調：

是

RG_description (字串)

資源群組的簡單說明。

種類：

可選用的

預設值：

空字串

可調：

是

RG_is_frozen (布林值)

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

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

種類：

可選用的

預設值：

沒有預設值

可調：

否

RG_mode (列舉)

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

如果此特性的值為 Scalable，則 RGM 會允許 Maximum_primaries 特性的值大於 1。因此，群組可由多個節點同時主控。RGM 不允許將其 Failover 特性為 TURE 的資源加入其 RG_mode 為 Scalable 的資源群組。

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

種類：

可選用的

預設值：

依賴於 Maximum_primaries 的值

可調：

否

RG_name (字串)

資源群組的名稱。此名稱在叢集中必須是唯一的。

種類：

必需的

預設值：

沒有預設值

可調：

否

RG_project_name (字串)

與資源群組關聯的 Solaris 專案名稱。使用此特性可將 Solaris 資源管理功能 (例如 CPU 共用和資源集區) 套用至叢集資料服務。當 RGM 使資源群組上線時，此特性會針對未設定 Resource_project_name 特性的資源啟動此專案名稱下的相關程序。指定的專案名稱必須存在於專案資料庫中，還必需將使用者 root 配置為命名專案的成員。

僅在 Solaris 9 及更高版本的 Solaris 中才支援此特性。

---

注意 –

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

---

種類：

可選用的

預設值：

文字字串「default」

可調：

ANYTIME

每個叢集節點上的 RG_state (列舉)

由 RGM 設定為 Unmanaged、Online、Offline、Pending_online、Pending_offline、Pending_online_blocked、Error_stop_failed、Online_faulted 或 Pending_online_blocked，描述每個叢集節點上群組的狀態。

您無法配置這個特性。然而，您可以透過呼叫 scswitch(1M) 或者使用等效的 scsetup(1M) 或 SunPlex Manager 指令來間接設定此特性。

種類：

僅限於查詢

預設值：

沒有預設值

可調：

否

RG_system (布林值)

如果資源群組的 RG_system 特性為 TRUE，則會限制針對該資源群組及其包含的資源之特定作業。此限制旨在協助防止對重要資源群組和資源的意外修改或刪除。僅有 scrgadm(1M) 和 scswitch(1M) 指令受此特性的影響。針對 scha_control(1HA) 和 scha_control(3HA) 的作業不受影響。

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

其 RG_system 值設定為 TRUE 的資源群組稱為系統資源群組。無論 RG_system 的目前值為何，編輯 RG_system 特性本身永遠不會受到限制。rg_properties(5) 線上說明手冊更加詳細地描述了這些限制。

種類：

可選用的

預設值：

FALSE

可調：

是

資源特性性質

下列資訊描述可用來變更系統定義的特性或建立延伸特性的資源特性特性。

您不能指定 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、int、enum 與 stringarray。對於系統定義的特性，您不能在 RTR 檔案項目中設定類型性質。類型決定了可接受的特性值和在 RTR 檔案項目中所允許的類型特定性質。enum 類型是一個字串值集。