Documentation Home
> Sun Cluster 数据服务开发者指南(适用于 Solaris OS)
Sun Cluster 数据服务开发者指南(适用于 Solaris OS)
Book Information
索引
数字和符号
A
B
C
D
E
F
G
H
I
J
L
M
N
O
P
R
S
T
U
V
W
X
安
编
变
菜
参
测
持
出
存
错
代
二
方
服
格
故
管
规
函
合
回
获
监
检
脚
界
进
可
克
客
扩
类
枚
幂
描
命
目
配
屏
普
区
全
缺
群
日
软
升
实
使
手
守
属
数
特
网
文
消
协
选
验
依
移
语
源
支
值
指
重
主
注
资
组
浏
前言
第 1 章 资源管理概述
Sun Cluster 应用程序环境
RGM 模型
资源类型
资源
资源组
资源组管理器
回调方法
编程接口
RMAPI
数据服务开发库 (DSDL)
SunPlex Agent Builder
资源组管理器管理接口
SunPlex Manager
管理命令
第 2 章 开发数据服务
分析应用程序的适用性
确定要使用的接口
设置用来编写数据服务的开发环境
设置开发环境
将数据服务传送到群集
设置资源和资源类型特性
声明资源类型特性
声明资源特性
声明扩展特性
实现回调方法
访问资源和资源组特性信息
方法的幂等性
普通数据服务
控制应用程序
启动和停止资源
决定使用哪种 Start 或 Stop 方法
Init、Fini 和 Boot 方法
监视资源
向资源添加消息日志
提供进程管理
提供资源的管理支持
实现故障转移资源
实现可伸缩资源
可伸缩服务的验证检查
编写和测试数据服务
使用持续连接机制
测试 HA 数据服务
协调资源间的依赖性
第 3 章 升级资源类型
概述
资源类型注册文件
资源类型名称
指令
更改 RTR 文件中的 RT_Version
Sun Cluster 早期版本中的资源类型名称
资源的 Type_version 特性
将资源移植到其他版本
升级和降级资源类型
缺省特性值
资源类型开发者文档
资源类型名称和资源类型监视器实现
应用程序升级
资源类型升级实例
资源类型软件包的安装要求
您在更改 RTR 文件之前需了解的信息
更改监视器代码
更改方法代码
第 4 章 资源管理 API 参考
RMAPI 存取方法
RMAPI Shell 命令
RMAPI 资源命令
资源类型命令
资源组命令
群集命令
C 函数
资源函数
资源类型函数
资源组函数
群集函数
实用程序函数
RMAPI 回调方法
方法参数
出口代码
控制和初始化回调方法
管理支持方法
与网络相关的回调方法
监视器控制回调方法
第 5 章 数据服务样例
数据服务样例概述
定义资源类型注册文件
RTR 文件概述
RTR 文件样例中的资源类型特性
RTR 文件样例中的资源特性
RTR 文件中的系统定义的特性
RTR 文件中的扩展特性
为所有方法提供通用功能
标识命令解释程序并输出路径
声明 PMF_TAG 和 SYSLOG_TAG 变量
分析函数参数
生成错误消息
获取特性信息
控制数据服务
Start 方法
Start 概述
检验配置
启动应用程序
Start 退出状态
Stop 方法
Stop 概述
停止应用程序
Stop 退出状态
定义故障监视器
探测程序
探测程序概述
获取特性值
检查服务的可靠性
评估重启和故障转移
重启数据服务
探测程序退出状态
Monitor_start 方法
Monitor_start 概述
启动探测程序
Monitor_stop 方法
Monitor_stop 概述
停止监视器
Monitor_stop 退出状态
Monitor_check 方法
处理特性更新
Validate 方法
Validate 概述
Validate 方法分析函数
验证 Confdir
Validate 退出状态
Update 方法
Update 概述
使用 Update 停止监视器
重启监视器
Update 退出状态
第 6 章 数据服务开发库 (DSDL)
DSDL 概述
管理配置特性
启动和停止数据服务
实现故障监视器
存取网络地址信息
调试资源类型实现
启用具有高可用性的本地文件系统
第 7 章 设计资源类型
RTR 文件
Validate 方法
Start 方法
Stop 方法
Monitor_start 方法
Monitor_stop 方法
Monitor_check 方法
Update 方法
Init、Fini 和 Boot 方法
设计故障监视器守护程序
第 8 章 DSDL 资源类型实现样例
X Font Server
X Font Server 配置文件
TCP 端口号
命名约定
SUNW.xfnts RTR 文件
scds_initialize() 函数
xfnts_start 方法
在启动之前验证服务
启动服务
从 svc_start() 返回
xfnts_stop 方法
xfnts_monitor_start 方法
xfnts_monitor_stop 方法
xfnts_monitor_check 方法
SUNW.xfnts 故障监视器
xfonts_probe 主循环
svc_probe() 函数
确定故障监视器操作
xfnts_validate 方法
xfnts_update 方法
第 9 章 SunPlex Agent Builder
Agent Builder 概述
Agent Builder 使用前须知
创建具有多个独立的进程树的资源类型
使用 Agent Builder
分析应用程序
安装和配置 Agent Builder
Agent Builder 屏幕
启动 Agent Builder
浏览 Agent Builder
浏览
菜单
“文件”菜单
“编辑”菜单
使用“创建”屏幕
“创建”屏幕
使用“配置”屏幕
“配置”屏幕
使用 Agent Builder 提供的 适用于 Korn Shell 的 $hostnames 变量
特性变量
特性变量列表
特性变量的语法
Agent Builder 替换特性变量的方式
重复使用完成的工作
克隆现有的资源类型的方法
编辑已生成的源代码
使用 Agent Builder 的命令行版本的方法
目录结构
Agent Builder 的输出
源文件和二进制文件
实用程序脚本和手册页
支持文件
软件包目录
rtconfig 文件
Agent Builder 的 Cluster Agent 模块
安装和设置 Cluster Agent 模块的方法
启动 Cluster Agent 模块的方法
使用 Cluster Agent 模块
Cluster Agent 模块和 Agent Builder 之间的区别
第 10 章 普通数据服务
GDS 概述
预编译的资源类型
使用 GDS 的优点与不足
创建使用 GDS 的服务的方法
GDS 和 SunPlex Agent Builder
GDS 和标准的 Sun Cluster 管理命令
选择创建基于 GDS 的服务时所应使用的方法
GDS 记录事件的方式
GDS 日志文件
必需的 GDS 特性
Start_command 扩展特性
Port_list 特性
可选的 GDS 特性
Network_resources_used 特性
Stop_command 特性
Probe_command 特性
Start_timeout 特性
Stop_timeout 特性
Probe_timeout 特性
Child_mon_level 特性
Failover_enabled 特性
Stop_signal 特性
Log_level 特性
使用 SunPlex Agent Builder 创建使用 GDS 的服务
创建并配置脚本
SunPlex Agent Builder 的输出
使用标准的 Sun Cluster 管理命令来创建使用 GDS 的服务
SunPlex Agent Builder 的命令行界面
第 11 章 数据服务开发库参考
DSDL 函数
通用函数
特性函数
网络资源存取函数
使用 TCP 连接进行故障监视
PMF 函数
故障监视器函数
实用程序函数
第 12 章 CRNP
CRNP 概述
CRNP 协议概述
CRNP 协议的语义
CRNP 使用的消息类型
客户机如何向服务器进行注册
管理员设置服务器的前提
服务器如何标识客户机
如何在客户机和服务器之间传送 SC_CALLBACK_REG 消息
SC_CALLBACK_REG 消息的内容
服务器如何对客户机进行应答
SC_REPLY 消息的内容
客户机如何处理错误状态
服务器如何向客户机传送事件
如何保障事件的传送
SC_EVENT 消息的内容
CRNP 如何鉴别客户机和服务器
创建使用 CRNP 的 Java 应用程序
附录 A 标准特性
资源类型特性
资源特性
资源组特性
资源特性属性
附录 B 数据服务样例代码列表
资源类型注册文件列表
Start 方法
Stop 方法
gettime 实用程序
PROBE 程序
Monitor_start 方法
Monitor_stop 方法
Monitor_check 方法
Validate 方法
Update 方法
附录 C 数据服务开发库资源类型代码列表样例
xfnts.c
xfnts_monitor_check 方法
xfnts_monitor_start 方法
xfnts_monitor_stop 方法
xfnts_probe 方法
xfnts_start 方法
xfnts_stop 方法
xfnts_update 方法
xfnts_validate 方法的代码列表
附录 D 合法的 RGM 名称和值
RGM 合法名称
命名规则(不包括资源类型名称的命名规则)
资源类型名称的格式
RGM 值
附录 E 对不支持群集的应用程序的要求
多主机数据
将符号链接用于多主机数据放置
主机名
多地址主机
绑定到 INADDR_ANY 与绑定到特定的 IP 地址
客户机重试
附录 F CRNP 的文档类型定义
SC_CALLBACK_REG XML DTD
NVPAIR XML DTD
SC_REPLY XML DTD
SC_EVENT XML DTD
附录 G CrnpClient.java 应用程序
CrnpClient.java 的内容
© 2010, Oracle Corporation and/or its affiliates