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

資源屬性

表 A–2 描述 Sun Cluster 定義的資源屬性。 對屬性值進行分類,如下所示 (在 [種類] 欄中):

表 A–2 還列出了是否以及何時可以更新資源屬性 (在 [是否可以更新?] 欄中),如下所示:

None 或者 False

永不 

True 或者 Anytime

任何時候 

At_creation

在將資源加入叢集時 

When_disabled

在資源被停用時 

表 A–2 資源屬性

屬性名稱 

說明 

是否可以更新?  

種類 

Affinity_timeout (整數)

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

僅當 Load_balancing_policyLb_sticky 或者 Lb_sticky_wild 時,此屬性才是有意義的。 此外,必須將 Weak_affinity 設定為 False (預設值)。

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

任何時候 

可選用的 

Cheap_probe_interval (整數)

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

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

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

停用時  

條件式 

延伸屬性 

在資源類型的 RTR 檔案中宣告的延伸屬性。 資源類型的實作定義這些屬性。 如需有關您可以為延伸屬性設定的個別性質之資訊,請參閱表 A–4

取決於特定的屬性 

條件式 

Failover_mode (列舉)

可能的設定為 NONESOFTHARD。 控制 RGM 是否重新配置資源群組或中斷節點,以回應資源上 StartStopMonitor_stop 方法呼叫的失敗。 NONE 指示 RGM 應該僅在方法失敗時設定資源狀態,並等待作業者介入。 SOFT 指示 Start 方法的失敗會導致 RGM 將資源群組的位置重新確定至不同節點;StopMonitor_stop 方法的失敗會導致 RGM 將資源設定為 STOP_FAILED 狀態和將資源群組設定為 ERROR_STOP_FAILED 狀態,並等待作業者介入。 對於 StopMonitor_stop 失敗,NONE 設定與 SOFT 設定是等效的。 HARD 指示 Start 方法的失敗會導致重新配置群組;StopMonitor_stop 方法的失敗會透過中斷叢集節點而導致強制停止資源。

預設值為 NONE

任何時候  

可選用的 

Load_balancing_policy (字串)

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

Lb_weighted (預設值)。 負載是依照 Load_balancing_weights 屬性中所設定的權重而在各節點中進行分配的。 Lb_sticky。 總是將可延伸服務的給定用戶端 (由用戶端 IP 位址識別) 發送到叢集的同一個節點。 Lb_sticky_wild。 總是將與萬用字元黏性服務的 IP 位址連線的給定用戶端 (由用戶端 IP 位址識別) 傳送到同一個叢集節點,而不管該用戶端將要導向至哪個埠號碼。

預設值為 Lb_weighted

建立時  

條件式/可選用的 

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。 變更此屬性將只修改新連接的分配。

預設值為空字串 (“”)。 

任何時候  

條件式/可選用的 

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

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

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

任何時候 

條件式/ 

可選用的 

Monitored_switch (列舉)

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

預設值為 Enabled

永不 

僅限於查詢 

Network_resources_used (字串陣列)

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

如果在資源類型檔案中未指定 Tunable 性質,則該屬性的 Tunable 值為 At_creation

建立時  

條件式/必需的 

On_off_switch (列舉)

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

預設值為 Disabled

永不  

僅限於查詢 

Port_list (字串陣列)

伺服器在其上進行偵聽的通訊埠編號之清單。 附加至每個通訊埠編號的協定是此通訊埠使用的協定,例如,Port_list=80/tcp。 如果在 RTR 檔案中宣告了 Scalable 屬性,則 RGM 會自動建立 Port_list。 否則,此屬性是不可用的,除非在 RTR 檔案中明確宣告該屬性。

Sun Cluster Data Service for Apache Guide for Solaris OS中有對為 Apache 設定此屬性的描述。

建立時  

條件式/ 

必需的 

R_description (字串)

資源的簡單說明。 

預設值為空字串。 

任何時候 

可選用的 

Resource_name (字串)

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

永不  

必需的 

Resource_project_name (字串)

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


註解 –

對此屬性的變更將在資源重新啟動後生效。


預設值為空值。 

任何時候  

可選用的 

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

在每個叢集節點上由 RGM 決定的資源狀態。 可能的狀態包括 OnlineOfflineStop_failedStart_failedMonitor_failedOnline_not_monitored

使用者不可配置此屬性。 

永不 

僅限於查詢 

Retry_count (整數)

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

如果未在資源類型檔案中指定 Tunable 性質,則該屬性的 Tunable 值為 When_disabled

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

停用時 

條件式  

Retry_interval (整數)

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

如果未在資源類型檔案中指定 Tunable 性質,則該屬性的 Tunable 值為 When_disabled

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

停用時  

條件式 

Scalable (布林值)

指示資源是否可延伸。 如果在 RTR 檔案中宣告了此屬性,則 RGM 將為該類型的資源自動建立以下可延伸服務屬性: Network_resources_usedPort_listLoad_balancing_policyLoad_balancing_weights。 這些屬性均有其預設值,除非在 RTR 檔案中對它們進行了明確宣告。 Scalable 的預設值 (在 RTR 檔案中已被宣告時) 為 True

如果在 RTR 檔案中宣告了此屬性時,Tunable 性質必須設定為 At_creation,否則資源建立將失敗。

如果未在 RTR 檔案中宣告該屬性,則資源不可延伸,叢集管理員將無法協調此屬性,且 RGM 不設定任何可延伸服務屬性。 然而,必要時您可以在 RTR 檔案中明確宣告 Network_resources_used 屬性與 Port_list 屬性,因為這兩種屬性在非可延伸服務與可延伸服務中都可能有用。

建立時  

可選用的 

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

由資源監視器設定。 可能的值包括: OKdegradedfaultedunknownoffline。 RGM 在使資源上線時將值設定為 unknown,在使資源離線時將值設定為 Offline

永不 

僅限於查詢 

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

資源監視器設定 Status 屬性的同時進行設定。 可以每個資源、每個節點為單位來設定此屬性。 RGM 在使資源離線時將此屬性設定為空字串。

永不 

僅限於查詢 

Thorough_probe_interval (整數)

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

如果在資源類型檔案中未指定 Tunable 性質,則該屬性的 Tunable 值為 When_disabled

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

停用時  

條件式 

Type (字串)

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

永不 

必需的 

Type_version (字串)

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

其可調性源自:

  • 目前版本的資源類型

  • RTR 檔案中的 #$upgrade_from 指令

請參閱說明 

請參閱說明  

UDP_affinity (布林值)

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

僅當 Load_balancing_policyLb_sticky 或者 Lb_sticky_wild 時,此屬性才是有意義的。 此外,必須將 Weak_affinity 設定為 False (預設值)。

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

停用時 

可選用的 

Weak_affinity (布林值)

如果為 True,則啟用用戶端相似性的弱化形式。 這會允許從給定用戶端的連接發送到同一伺服器節點,以下情況除外: 

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

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

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

僅當 Load_balancing_policyLb_sticky 或者 Lb_sticky_wild 時,此屬性才是有意義的。

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

停用時  

可選用的