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 应用程序环境
资源组管理器模型
资源类型
资源
资源组
资源组管理器
回调方法
编程接口
Resource Management API(资源管理 API)
数据服务开发库
SunPlex Agent Builder
资源组管理器管理接口
SunPlex Manager
scsetup 实用程序
管理命令
第 2 章 开发数据服务
分析应用程序的适用性
确定要使用的接口
设置用来编写数据服务的开发环境
如何设置开发环境
将数据服务传送到群集
设置资源和资源类型属性
声明资源类型属性
声明资源属性
声明扩展属性
实现回调方法
访问资源和资源组属性信息
方法的幂等性
普通数据服务
控制应用程序
启动和停止资源
确定使用哪种 Start 或 Stop 方法
Init、Fini 和 Boot 方法
监视资源
向资源添加消息日志
提供进程管理
提供资源的管理支持
实现故障切换资源
实现可伸缩资源
可伸缩服务的验证检查
编写和测试数据服务
使用 TCP 持续连接保护服务器
测试 HA 数据服务
协调资源间的依赖性
第 3 章 资源管理 API 参考
RMAPI 访问方法
RMAPI Shell 命令
RMAPI 资源命令
资源类型命令
资源组命令
群集命令
C 函数
资源函数
资源类型函数
资源组函数
群集函数
公用程序函数
RMAPI 回调方法
可以提供给回调方法的参数
回调方法退出代码
控制和初始化回调方法
管理支持方法
与网络相关的回调方法
监视器控制回调方法
第 4 章 修改资源类型
有关修改资源类型的概述
设置资源类型注册文件的内容
资源类型名称
指定 #$upgrade 和 #$upgrade_from 指令
更改 RTR 文件中的 RT_version
Sun Cluster 早期版本中的资源类型名称
群集管理员进行升级时将出现的情况
实现资源类型监视器代码
确定安装要求和封包
更改 RTR 文件须知
更改监视器代码
更改方法代码
确定要使用的封包方案
针对已修改的资源类型提供的文档信息
有关安装升级软件包之前应做事情的信息
有关何时升级资源的信息
有关对资源属性所作更改的信息
第 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 概述
管理配置属性
启动和停止数据服务
实现故障监视器
访问网络地址信息
调试资源类型实现
启用具有高可用性的本地文件系统
第 7 章 设计资源类型
资源类型注册文件
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 方法
启动 X Font Server 之前验证服务
使用 svc_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 菜单
Agent Builder “文件”菜单
Agent Builder “编辑”菜单
使用“创建”屏幕
使用“配置”屏幕
使用 Agent Builder 基于 Korn Shell 的 $hostnames 变量
使用属性变量
属性变量列表
资源属性变量
资源类型属性变量
资源组属性变量
属性变量的语法
Agent Builder 替换属性变量的方式
重复使用使用 Agent Builder 创建的代码
克隆现有的资源类型的方法
编辑已生成的源代码
使用 Agent Builder 的命令行版本的方法
Agent Builder 创建的目录结构
Agent Builder 的输出
源文件和二进制文件
Sun 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 和 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 属性
使用 Agent Builder 创建使用 GDS 的服务
创建和配置基于 GDS 的脚本
如何启动 Agent Builder 和创建脚本
如何配置脚本
Agent Builder 的输出
使用 Sun Cluster 管理命令创建使用 GDS 的服务
如何使用 Sun Cluster 管理命令来创建使用 GDS 且具有高可用性的服务
如何使用 Sun Cluster 管理命令来创建使用 GDS 的可伸缩服务
Agent Builder 的命令行界面
如何使用命令行版本的 Agent Builder 创建使用 GDS 的服务
第 11 章 DSDL API 函数
通用函数
初始化函数
检索函数
故障转移和重新启动函数
执行函数
属性函数
网络资源访问函数
主机名函数
端口列表函数
网络地址函数
使用 TCP 连接进行故障监视
PMF 函数
故障监视器函数
实用程序函数
第 12 章 群集重新配置通知协议
CRNP 概念
CRNP 的工作原理
CRNP 语义学
CRNP 消息类型
客户机如何向服务器进行注册
管理员设置服务器的前提
服务器如何标识客户机
如何在客户机和服务器之间传送 SC_CALLBACK_REG 消息
SC_CALLBACK_REG 消息的内容
服务器如何对客户机进行应答
SC_REPLY 消息的内容
客户机如何处理错误状态
服务器如何向客户机传送事件
如何保障事件的传送
SC_EVENT 消息的内容
CRNP 如何鉴别客户机和服务器
创建使用 CRNP 的 Java 应用程序示例
如何设置环境
如何开始开发应用程序
如何解析命令行参数
如何定义事件接收线程
如何注册和取消注册回调
如何生成 XML
如何创建注册消息和取消注册消息
如何设置 XML 解析器
如何解析注册回复
如何解析回调事件
如何运行应用程序
附录 A 标准属性
资源类型属性
资源属性
资源组属性
资源特性属性
附录 B 数据服务样例代码列表
资源类型注册文件列表
Start 方法代码列表
Stop 方法代码列表
gettime 实用程序代码列表
PROBE 程序代码列表
Monitor_start 方法代码列表
Monitor_stop 方法代码列表
Monitor_check 方法代码列表
Validate 方法代码列表
Update 方法代码列表
附录 C DSDL 样例资源类型代码列表
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