API 提供存取資源、資源類型、資源群組屬性以及其他叢集資訊的函式。 這些函式以 shell 指令形式與 C 函式形式提供,可讓資源類型提供者將控制程式作為 shell 程序檔或 C 程式實施。
Shell 指令將被用於資源類型 (表示叢集的 RGM 控制的服務的資源類型) 的回呼方法之 shell 程序檔實現中。 您可以使用這些指令來:
存取有關資源、資源類型、資源群組以及叢集的資訊
搭配使用監視器來設定資源的 Status 與 Status_msg 屬性
要求重新啟動或重新配置資源群組
儘管本節提供 shell 指令的簡要說明,但 1HA 區段中的個別線上援助頁仍將提供 shell 指令的決定性參考。 除非另外註明,否則每個指令將具有一個同名的線上援助頁。
您可以使用這些指令存取有關資源的資訊或設定資源的 Status 屬性與 Status_msg 屬性。
在 RGM 的控制下存取有關資源或資源類型的資訊。 它與 scha_resource_get() 函式提供的資訊相同。
在 RGM 的控制下設定資源的 Status 屬性與 Status_msg 屬性。 資源的監視器將使用此指令來指示其感知到的資源狀態。 它與 scha_resource_setstatus() C 函式提供的功能性相同。
儘管 scha_resource_setstatus() 對資源監視器特別有用,但任何程式都可以呼叫它。
該指令與 scha_resourcetype_get() C 函式提供的功能性相同。
您可以使用這些指令存取有關這些指令的資訊或重新啟動資源群組。
在 RGM 的控制下存取有關資源群組的資訊。 該指令與 scha_resourcetype_get() C 函式提供的功能性相同。
要求在 RGM 控制下重新啟動資源群組或將其重新配置到其他節點。 該指令與 scha_control() C 函式提供的功能性相同。
該指令存取有關叢集的資訊,如節點名稱、節點 ID 與節點狀態、叢集名稱、資源群組等。
該指令與 scha_cluster_get() C 函式提供的資訊相同。
C 函式將用於資源類型的回呼方法之 C 程式實作,表示叢集的 RGM 控制的服務。 您可以使用這些函式來執行以下作業:
存取有關資源、資源類型、資源群組以及叢集的資訊
搭配使用監視器來設定資源的 Status 與 Status_msg 屬性
要求重新啟動或重新配置資源群組
將錯誤碼轉換為適當的錯誤訊息
儘管本章提供 C 函式的簡要說明,但個別 (3HA) 線上援助頁 仍將提供 C 函式的決定性參考。 除非另外註明,否則每個函式將具有一個同名的線上援助頁。 請參閱 scha_calls( 3HA) 線上援助頁,以取得有關 C 函式的輸出引數與回覆碼之資訊。
這些函式存取有關 RGM 管理的資源之資訊,或指示監視器感知的資源狀態。
這些函式共同存取有關 RGM 管理的資源之資訊。 scha_resource_open() 函式初始化對資源的存取,並為 scha_resource_get() 傳回控點,該函式將存取資源資訊。 scha_resource_close() 函式將使控點無效,並釋放為 scha_resource_get() 傳回值配置的記憶體。
透過叢集重新配置或管理動作,在 scha_resource_open() 傳回資源的控點之後 (這種情況下,scha_resource_get() 透過該控點獲取的資訊可能不準確),資源可能會變更。 如果在資源上進行叢集重新配置或管理動作,RGM 將 scha_err_seqid 錯誤碼傳回至 scha_resource_get(),以指示有關資源的資訊可能已變更。 這是一種不嚴重的錯誤訊息;函數可以成功傳回。 您可以選擇忽略該訊息並接受傳回的資訊,或者可以關閉目前控點並開啟新的控點,以存取有關該資源的資訊。
單一線上援助頁可說明這三個函式。 您可以透過 scha_resource_open(3HA)、scha_resource_get(3HA) 或 scha_resource_close(3HA) 中任一個別函式來存取此線上說明手冊。
在 RGM 的控制下設定資源的 Status 屬性與 Status_msg 屬性。 資源的監視器使用此函式來指示資源的狀態。
儘管 scha_resource_setstatus() 對資源監視器特別有用,但任何程式都可以呼叫它。
這些函式可以共同存取有關藉由 RGM 註冊之資源類型的資訊。
scha_resourcetype_open() 函式初始化對資源的存取,並為 scha_resourcetype_get () 傳回控點,該函式將存取資源類型資訊。 scha_resourcetype_close() 函式將使控點無效,並釋放為 scha_resourcetype_get() 傳回值配置的記憶體。
透過叢集重新配置或管理動作,在 scha_resourcetype_open() 傳回資源類型的控點之後 (這種情況下,scha_resourcetype_get() 透過該控點獲取的資訊可能不準確) ,資源類型可能會變更。 如果在資源類型上進行叢集重新配置或管理動作,RGM 將 scha_err_seqid 錯誤碼傳回至 scha_resourcetype_get(),以指示有關資源類型的資訊可能已變更。 這是一種不嚴重的錯誤訊息;函數可以成功傳回。 您可以選擇忽略訊息並接受傳回的資訊,或者可以關閉目前的控點並開啟新控點,以存取有關資源類型的資訊。
單一線上援助頁可說明這三個函式。 您可以透過 scha_resourcetype_open(3HA)、scha_resourcetype_get(3HA) 或 scha_resourcetype_close(3HA) 中的任一個別函式來存取此線上說明手冊。
您可以存取有關這些函式的資訊或使用這些函式重新啟動資源群組。
這些指令共同存取有關 RGM 管理的資源群組之資訊。 scha_resourcegroup_open() 函式初始化對資源群組的存取,並為 scha_resourcegroup_get () 傳回控點,該函式將存取資源群組資訊。 scha_resourcegroup_close() 函式將使控點無效,並釋放為 scha_resourcegroup_get() 傳回值配置的記憶體。
透過叢集重新配置或管理動作,資源群組可以在 scha_resourcegroup_open() 傳回資源群組的控點之後變更,在這種情況下 scha_resourcegroup_get() 透過控點獲取的資訊可能不準確。 如果在資源群組上發生叢集重新配置或管理動作,RGM 將傳回 scha_err_seqid 錯誤碼至 scha_resourcegroup_get(),以指示有關資源群組的資訊可能已變更。 這是非嚴重錯誤訊息;函數會成功傳回。 您可以選擇忽略訊息並接受傳回的資訊,或者可以關閉目前的控點並開啟新控點,以存取有關資源群組的資訊。
要求在 RGM 控制下重新啟動資源群組或將其重新配置到其他節點。
這些函式將共同存取有關叢集的資訊,如節點名稱、節點 ID 與節點狀態、叢集名稱、資源群組,等等。
透過重新配置或管理動作,叢集可以在 scha_cluster_open() 傳回叢集的控點之後變更,在這種情況下 scha_cluster_get() 透過控點獲取的資訊可能不準確。 如果在叢集上進行重新配置或管理動作,RGM 將 scha_err_seqid 錯誤碼傳回至 scha_cluster_get(),以指示有關叢集的資訊可能已變更。 這是一種不嚴重的錯誤訊息;函數可以成功傳回。 您可以選擇忽略訊息並接受傳回的資訊,或者可以關閉目前的控點並開啟新控點,以存取有關叢集的資訊。
傳回目前作為叢集日誌使用的系統日誌工具之編號。 使用傳回值與 Solaris syslog() 函式,將事件與狀況訊息記錄到叢集日誌中。
傳回在其上呼叫函式之叢集節點的名稱。
將錯誤碼 (由 scha_ 函式之一傳回) 轉換為相應的錯誤訊息。 使用該函式與 logger 將訊息記錄到系統日誌 (syslog) 中。