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

資源類型屬性

下表描述 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 屬性。

條件式