前言

「Sun Cluster 資料服務開發者指南 (適用於 Solaris 作業系統)」包含有關使用資源管理 API 在 SPARC® 與 x86 型系統上開發 Sun^TM Cluster 資料服務的資訊。

---

注意 –

在本文件中，「x86」指 Intel 32 位元系列的微處理器晶片和由 AMD 製造的相容微處理器晶片。

---

---

注意 –

Sun Cluster 軟體在兩個平台 (SPARC 與 x86上) 上執行。本文件中的資訊適用於這兩個平台，除非在特定章節、小節、備註、項目符號、圖形、表格或範例中另行指定。

---

本書適用對象

本文件適合經驗豐富且對 Sun 軟硬體非常熟悉的開發者。本書中的資訊假定使用者瞭解 Solaris^TM 作業系統。

本書的組織架構

「Sun Cluster 資料服務開發者指南 (適用於 Solaris 作業系統)」包含下列章節與附錄︰

• 第 1 章, 資源管理簡介提供開發資料服務所需概念的簡介。

• 第 2 章, 開發資料服務提供有關開發資料服務的詳細資訊。

• 第 3 章, 升級資源類型論述升級資源類型與遷移資源所需瞭解的問題

• 第 4 章, 資源管理 API 參考提供了組成資源管理 API (RMAPI) 的存取函式與回呼方法的參考。

• 第 5 章, 資料服務範例提供了 in.named() 應用程式的 Sun Cluster 資料服務範例。

• 第 6 章, 資料服務開發程式庫 (DSDL)概述了組成資料服務開發程式庫 (DSDL) 的應用程式設計介面。

• 第 7 章, 設計資源類型說明 DSDL 在設計和實現資源類型方面的一般用法。

• 第 8 章, DSDL 資源類型實施範例描述一個使用 DSDL 實現的資源類型範例。

• 第 9 章, SunPlex Agent Builder描述 SunPlex ^TM Agent Builder。

• 第 10 章, 一般資料服務描述如何建立常規資料服務。

• 第 11 章, 資料服務開發程式庫參考描述 DSDL API 函式。

• 第 12 章, CRNP提供有關叢集重新配置通知協定 (CRNP) 的資訊。CRNP 使故障轉移應用程式與可延伸應用程式能夠「支援叢集」。

• 附錄 A, 標準特性描述了標準資源類型、資源群組與資源特性。

• 附錄 B, 範例資料服務程式碼清單 提供範例資料服務中每個方法的完整代碼。

• 附錄 C, 資料服務開發程式庫資源類型程式碼範例清單 列出 SUNW.xfnts() 資源類型中每個方法的完整代碼。

• 附錄 D, 合法的 RGM 名稱和值 列出對資源群組管理員 (RGM) 名稱與值的合法字元的要求。

• 附錄 E, 不支援叢集的應用程式的要求 列出對一般不支援叢集應用程式要達到高可用性的要求。

• 附錄 F, CRNP 的文件類型定義 列出 CRNP 的文件類型定義。

• 附錄 G, CrnpClient.java 應用程式 顯示在第 12 章, CRNP中論述之完整的 CrnpClient.java 應用程式。

相關說明文件

有關 Sun Cluster 相關主題的資訊可從下表中列出的說明文件獲得。所有 Sun Cluster 說明文件均可從 http://docs.sun.com 取得。

主題	文件資料
簡介	「Sun Cluster 簡介 (適用於 Solaris 作業系統)」
概念	「Sun Cluster 概念指南 (適用於 Solaris 作業系統)」
硬體安裝與管理	「Sun Cluster 3.x Hardware Administration Manual for Solaris OS」 個別硬體管理指南
軟體安裝	「Sun Cluster 軟體安裝指南 (適用於 Solaris 作業系統)」
資料服務安裝與管理	「Sun Cluster Data Services Planning and Administration Guide for Solaris OS」 個別資料服務指南
資料服務開發	「Sun Cluster 資料服務開發者指南 (適用於 Solaris 作業系統)」
系統管理	「Sun Cluster 系統管理指南 (適用於 Solaris 作業系統)」
錯誤訊息	「Sun Cluster Error Messages Guide for Solaris OS」
指令和功能參考	「Sun Cluster Reference Manual for Solaris OS」

如需 Sun Cluster 文件的完整清單，請參閱 http://docs.sun.com 上關於您的 Sun Cluster 軟體版本之版本說明。

Sun Cluster 文件的完整清單可於 http://docs.sun.com 處的您 Sun Cluster 發行版本的版本說明中取得。

取得說明

如果在安裝或使用 Sun Cluster 上有問題，請與您的服務供應商聯絡並提供下列資訊。

• 您的姓名和電子郵件地址 (如果有的話)

• 您的公司名稱、地址和電話號碼

• 您系統的機型和序號

• 作業系統的版次編號 (例如，Solaris 10)

• Sun Cluster 的版次編號 (例如，Sun Cluster 3.1)

請使用以下指令為服務供應商收集有關您系統的資訊。

指令	功能
prtconf -v	顯示系統記憶體的大小及報告周邊裝置的相關資訊
psrinfo -v	顯示處理器的相關資訊
showrev -p	報告安裝了哪些修補程式
SPARC: prtdiag -v	顯示系統診斷資訊
/usr/cluster/bin/scinstall - pv	顯示 Sun Cluster 版次與套件版本資訊

同時提供 /var/adm/messages 檔案的內容。

線上存取 Sun 說明文件

docs.sun.com^SM 網站可讓您存取 Sun 線上技術文件。您可以瀏覽 docs.sun.com 的歸檔檔案或搜尋特定書名或主題。其 URL 是 http://docs.sun.com。

訂購 Sun 說明文件

Sun Microsystems 提供列印的選取產品說明文件。如需文件清單及文件的訂購方式，請參閱 http://docs.sun.com/?l=zh_TW 網站上的「購買書面文件」。

印刷排版慣例

下表說明本書在印刷上所作的變更。

表 P–1 印刷排版慣例

字體或符號	涵義	範例
AaBbCc123	指令、檔案和目錄的名稱；電腦螢幕的輸出	編輯您的 .login 檔案。 使用 ls -a 列出所有檔案。 machine_name% you have mail。
AaBbCc123	您輸入的內容，與電腦螢幕上的輸出相對照	machine_name% su Password:
AaBbCc123	指令行預留位置：用實際名稱或值取代	若要刪除某個檔案，請輸入 rm 檔案名稱。
AaBbCc123	書名、新字詞、專有名詞或要強調的字	請閱讀「使用者指南」中的第 6 章。 這些稱為類別選項。 您必須是 root，才能執行此動作。

指令範例中的 Shell 提示符號

以下表格列出使用於 C shell、Bourne shell 和 Korn shell 的預設系統提示符號以及超級使用者提示符號。

表 P–2 Shell 提示符號

Shell	提示符號
C shell 提示符號	machine_name%
C shell 超級使用者提示符號	machine_name#
Bourne shell 和 Korn shell 提示符號	$
Bourne shell 和 Korn shell 超級使用者提示符號	#