Sun Cluster 数据服务开发者指南（适用于 Solaris OS）

前言

《Sun Cluster 数据服务开发者指南（适用于 Solaris OS）》包含有关使用资源管理 API 在基于 SPARC® 和 x86 的系统上开发 Sun^TM Cluster 数据服务的信息。

注意：

在本文档中，术语“x86”是指 Intel 32 位微处理器芯片系列和 AMD 制造的兼容微处理器芯片系列。

注意：

Sun Cluster 软件在两种平台（SPARC 和 x86）上运行。除非在特殊章、节、说明、项目符号项、图、表或示例中另外指出，否则本文档中的信息均适用于这两种平台。

本手册的用途

本文档面向具有丰富的 Sun 软硬件知识的有经验的开发者。本书提供的信息是建立在假设您已对 Solaris^TM 操作系统有所了解的基础上的。

本书的结构

《Sun Cluster 数据服务开发者指南（适用于 Solaris OS）》包括以下章节和附录：

第 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 ^TMAgent 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 概念指南（适用于 Solaris OS）》
概述	《Sun Cluster 概述（适用于 Solaris OS）》
硬件管理	Sun Cluster 3.x Hardware Administration Manual for Solaris OS 各个硬件管理指南
软件安装	《Sun Cluster 软件安装指南（适用于 Solaris OS）》
数据服务管理	《Sun Cluster 数据服务规划和管理指南（适用于 Solaris OS）》各个数据服务指南
数据服务开发	《Sun Cluster 数据服务开发者指南（适用于 Solaris OS）》
系统管理	《Sun Cluster 系统管理指南（适用于 Solaris OS）》
错误消息	Sun Cluster Error Messages Guide for Solaris OS
命令和功能参考	Sun Cluster Reference Manual for Solaris OS

获得帮助

如果您在安装或使用 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 Web 站点联机访问 Sun 技术文档。您可以浏览 docs.sun.com 档案或查找某个具体的书名或主题。 URL 是 http://docs.sun.com。

订购 Sun 文档

Sun Microsystems 提供一些印刷的产品文档。有关文档列表以及如何订购它们，请参阅 http://docs.sun.com 上的“购买印刷的文档”。

印刷惯例

下表介绍了本书中使用的印刷惯例。

表 P–1 印刷惯例


字体或符号	含义	示例
`AaBbCc123`	命令、文件和目录的名称；计算机屏幕输出	编辑 `.login` 文件。使用 `ls -a`列出所有文件。 `machine_name% you have mail.`
`AaBbCc123`	您键入的内容，与计算机屏幕输出的内容相对照	`machine_name%` `su` `Password:`
`AaBbCc123`	命令行通配符：用实际名称或实际值替换	要删除文件，请键入 `rm` `filename`。
AaBbCc123	书名、新词、术语或要强调的词。	请参见《用户指南》第 6 章。这些称为类选项。必须是超级用户才能执行此操作。

命令示例中的 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 超级用户提示符	`#`

前言