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

附錄 A 標準屬性

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

本附錄包括以下主要小節:


註解 –

屬性值 (例如 TrueFalse) 區分大小寫。


資源類型屬性

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

管理公用程式無法更新除 Installed_nodes 之外的資源類型屬性,因為在 RTR 檔案中無法宣告該屬性,必須由管理員來設定。

表 A–1 資源類型屬性

屬性名稱 

說明 

是否可以更新? 

種類 

Allow_hosts (字串陣列)

控制一組用戶端,這些用戶端經過允許可以使用 cl_apid 常駐程式註冊以接收叢集重新配置事件。 此屬性的一般格式為 ipaddress/masklength,定義允許用戶端註冊的子網路。 例如,設定 129.99.77.0/24 允許子網路 129.99.77 上的用戶端註冊事件。 又如,192.9.84.231/32 僅允許用戶端 192.9.84.231 註冊事件。 此屬性為 CRNP 提供安全性。 在 SUNW.Event(5) 中有對 cl_apid 常駐程式的說明。

此外,還可以識別以下特殊關鍵字。 LOCAL 指位於叢集直接連線子網路中的所有用戶端。 ALL 允許所有用戶端註冊。 請注意,如果某用戶端同時匹配 Allow_hostsDeny_hosts 屬性中的項目,則阻止該用戶端透過此實作來註冊。

預設值為 LOCAL

可選用的 

API_version (整數)

此資源類型實作所使用的資源管理 API 版本。  

Sun Cluster 3.1 4/04 的預設值為 2。  

N  

可選用的 

Boot (字串)

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

條件式/明確  

Client_retry_count (整數)

控制與外部用戶端進行通訊時,由 cl_apid 常駐程式所進行的嘗試次數。 如果用戶端無法在 Client_retry_count 次嘗試內做出回應,則該用戶端將逾時。 隨後用戶端會從有資格接收叢集重新配置事件的已註冊用戶端清單中移除。 用戶端必須重新註冊,才能再次開始接收事件。 請參閱 Client_retry_interval 屬性的描述,以詳細瞭解每隔多長時間透過該實作來進行這些重試。 在 SUNW.Event(5) 中有對 cl_apid 常駐程式的描述。

預設值為 3。 

可選用的 

Client_retry_interval (整數)

定義與未回應的外部用戶端進行通訊時,cl_apid 常駐程式所使用的時間間隔 (以秒為單位)。 在此間隔期間最多可嘗試 Client_retry_count 次聯絡用戶端。 在 SUNW.Event(5) 中有對 cl_apid 常駐程式的說明。

預設值為 1800。 

可選用的 

Client_timeout (整數)

在與外部用戶端通訊時,cl_apid 常駐程式使用的逾時值 (以秒為單位)。 但是,cl_apid 常駐程式會繼續嘗試聯絡用戶端達某可調次數。 請參閱 Client_retry_count 屬性和 Client_retry_interval 屬性的描述,以詳細瞭解可以用來協調此屬性的方法。 在 SUNW.Event(5) 中有對 cl_apid 常駐程式的說明。

預設值為 60。  

Y  

可選用的 

Deny_hosts (字串陣列)

控制無法註冊以接收叢集重新配置事件的用戶端集。 若要確定存取權限,此屬性的設定應優先於 Allow_hosts 清單中的那些設定。 此屬性的格式與 Allow_hosts 屬性中定義的格式相同。 此屬性為 CRNP 提供安全性。

預設值為 NULL

Y  

可選用的 

Failover (布林值)

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

可選用的 

Fini (字串)

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

條件式/明確 

Init (字串)

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

條件式/明確 

Init_nodes (列舉)

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

預設值為 RG_primaries

可選用的 

Installed_nodes (字串陣列)

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

預設值為所有叢集節點。 

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

Max_clients (整數)

控制可以使用 cl_apid 常駐程式來註冊以接收叢集事件通知的用戶端最大數目。 其他用戶端註冊事件的嘗試,遭到應用程式拒絕。 由於每個用戶端的註冊均使用叢集上的資源,因此微調此屬性可允許使用者控制外部用戶端對該叢集上資源的使用。 在 SUNW.Event(5) 中有對 cl_apid 常駐程式的說明。

預設值為 1000。 

可選用的 

Monitor_check (字串)

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

N  

條件式/明確 

Monitor_start (字串)

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

條件式/明確 

Monitor_stop (字串)

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

條件式/明確 

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

此屬性由 RGM 設定為在過去的 n 秒內為此節點上的此資源所進行的 scha_control RESTART 呼叫的數目,其中 n 為該資源 Retry_interval 屬性的值。 如果資源類型未宣告 Retry_interval 屬性,則 Num_resource_restarts 屬性不能用於該類型的資源。

僅限於查詢 

Pkglist (字串陣列)

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

N  

條件式/明確 

Postnet_stop (字串)

一個可選用的回呼方法: 在呼叫此類型資源取決於的任何網路位址資源 (Network_resources_used) 的 Stop 方法後,RGM 所呼叫的程式之路徑。 此方法預期將執行取消配置網路介面之後必需完成的 STOP 動作。

N  

條件式/明確 

Prenet_start (字串)

一個可選用的回呼方法: 在呼叫此類型資源取決於的任何網路位址資源 (Network_resources_used) 的 Start 方法前,RGM 所呼叫的程式之路徑。 此方法預期將執行在完成網路介面配置之前必需完成的 START 動作。

N  

條件式/明確 

Resource_type (字串)

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


scrgadm -p
在 Sun Cluster 3.1 及更高發行版本中,資源類型名稱強制性包含版本:

vendor_id.resource_type:version
資源類型名稱的三個程式元件是在 RTR 檔案中指定為 Vendor_idResource_typeRT_version 的屬性。 scrgadm 指令插入句點和冒號分割元。 資源類型名稱的 RT_version 後綴與 RT_version 屬性的值相同。 為了確保 Vendor_id 唯一,建議您使用建立資源類型之公司的證券代號。 在 Sun Cluster 3.1 前建立的資源類型名稱將繼續使用以下語法:

vendor_id.resource_type
預設為空字串。

必需的 

RT_basedir (字串)

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

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

RT_description (字串)

資源類型的簡單說明。  

預設值為空字串。 

N  

條件式 

RT_version (字串)

從 Sun Cluster 3.1 開始,它是這個資源類型實作必需的版本字串。 RT_version 是完整資源類型名稱的字尾部分。 從 Sun Cluster 3.1 開始,在 Sun Cluster 3.0 中為選擇性的 RT_version 屬性將成為強制性的。

N  

條件式/明確 

Single_instance (布林值)

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

預設值為 False

可選用的 

Start (字串)

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

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

Stop (字串)

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

N  

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

Update (字串)

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

條件式/明確  

Validate (字串)

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

條件式/明確  

Vendor_ID (字串)

請參閱 Resource_type 屬性。

條件式 

資源屬性

表 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 時,此屬性才是有意義的。

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

停用時  

可選用的 

資源群組屬性

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

[是否可以更新?] 欄顯示屬性在初始設定之後可更新 (Y) 還是不可更新 (N)。

表 A–3 資源群組屬性

屬性名稱 

說明 

是否可以更新? 

種類 

Auto_start_on_new_cluster (布林值)

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

 

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

可選用的 

Desired_primaries (整數)

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

預設值為 1。如果 RG_mode 屬性為 Failover,則該屬性的值不得大於 1。如果 RG_mode 屬性為 Scalable,則允許值大於 1。

可選用的 

Failback (布林值)

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

預設值為 False

Y  

可選用的 

Global_resources_used (字串陣列)

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

預設值為所有全域資源。  

Y  

可選用的 

Implicit_network_dependencies (布林值)

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

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

預設值為 True

可選用的 

Maximum_primaries (整數)

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

預設值為 1。如果 RG_mode 屬性為 Failover,則此屬性的值不得大於 1。如果 RG_mode 屬性為 Scalable,則允許值大於 1。

可選用的 

Nodelist (字串陣列)

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

預設值為所有叢集節點的清單。  

Y  

可選用的 

Pathprefix (字串)

叢集檔案系統的一個目錄,在此目錄中群組內的資源可以寫入基本的管理檔案。 某些資源可能需要此屬性。 使 Pathprefix 針對每個資源群組均是唯一的。

預設值為空字串。 

可選用的 

Pingpong_interval (整數)

一個非負整數值 (以秒為單位),在重新配置時或者執行 scha_control -O GIVEOVER 指令或帶有 SCHA_GIVEOVER 引數的 scha_control() 函數時,RGM 使用它來確定在何處使資源群組上線。

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

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

預設值為 3,600 (1 小時)。 

可選用的 

Resource_list (字串陣列)

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

預設值為空清單。 

僅限於查詢 

RG_description (字串)

資源群組的簡單說明。 

預設值為空字串。 

可選用的 

RG_mode (列舉)

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

如果此屬性的值為 Scalable,則 RGM 將允許 Maximum_primaries 屬性的值大於 1,表明群組可由多個節點同時主控。 RGM 不允許將其 Failover 屬性為 True 的資源加入其 RG_modeScalable 的資源群組。

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

可選用的 

RG_name (字串)

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

N  

必需的 

RG_project_name (字串)

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

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


註解 –

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


任何時候 

必需的 

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

由 RGM 設定為 OnlineOfflinePending_onlinePending_offlinePending_online_blockedError_stop_failed 或者 Online_faulted,以說明每個叢集節點上群組的狀態。

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

僅限於查詢 

資源屬性性質

下表說明變更系統定義的屬性或者建立延伸屬性可以使用的資源屬性性質。


小心 – 小心 –

您不能指定 NULL 或者空字串 (“”) 作為 booleanenumint 類型的預設值。


表 A–4 資源屬性性質

屬性 

說明 

Property

資源屬性的名稱。 

Extension

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

Description

一個字串附註,用於對屬性作簡單說明。 對於系統定義的屬性,不能在 RTR 檔案中設定說明性質。 

屬性的類型 

可允許的類型包括: stringbooleanintenumstringarray。 對於系統定義的屬性,您不能在 RTR 檔案項目中設定類型性質。 類型決定了可接受的屬性值和在 RTR 檔案項目中所允許的類型特定性質。 enum 類型是一個字串值集。

Default

指示屬性的預設值。 

Tunable

指示叢集管理員何時可以在資源中設定此屬性的值。 可以設定為 None 或者 False,以免管理員設定此屬性。 允許管理員微調的值為: TrueAnytime (任何時候)、At_creation (僅當建立資源時) 或 When_disabled (當資源離線時)。

預設值為 True (Anytime)。

Enumlist

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

Min

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

Max

對於 int 類型,為此屬性所允許的最大值。

Minlength

對於 string 類型與 stringarray 類型,為所允許的最小字串長度。

Maxlength

對於 string 類型與 stringarray 類型,為所允許的最大字串長度。

Array_minsize

對於 stringarray 類型,為所允許的陣列元素之最小數目。

Array_maxsize

對於 stringarray 類型,為所允許的陣列元素之最大數目。