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

使用 Agent Builder 创建使用 GDS 的服务

可以使用 Agent Builder 创建使用 GDS 的服务。第 9 章，SunPlex Agent Builder中对 Agent Builder 进行了详细介绍。

创建和配置基于 GDS 的脚本

如何启动 Agent Builder 和创建脚本

步骤

成为超级用户或作为等效角色。

启动 Agent Builder。
# /usr/cluster/bin/scdsbuilder

将显示 Agent Builder 的“创建”屏幕。

键入供应商名称。

键入应用程序名称。

注 –
自 Solaris 9 操作系统开始，供应商名称和应用程序名称的组合可超出九个字符。但是，如果使用的是早期版本的 Solaris 操作系统，则供应商名称和应用程序名称的组合不能超出九个字符。此组合用作脚本软件包的名称。

转到工作目录。

可以使用“浏览”下拉式菜单选择目录而不是键入路径。

选择该数据服务是可伸缩的，还是可进行故障转移的。

不必选择“网络可识别”，因为在创建 GDS 时该设置是默认值。

选择“GDS”。

（可选的）更改 RT 版本的所示默认值。

注 –
在“RT 版本”字段中不能使用以下字符：空格、制表符、斜杠 (/)、反斜杠 (\)、星号 (*)、问号 (?)、逗号 (,)、分号 (;)、左方括号 ([) 或右方括号 (])。

单击“创建”。

Agent Builder 将创建脚本。结果显示在“输出日志”区域中。

请注意，“创建”按钮将灰显。现在您就可以开始配置该脚本了。

单击“下一步”。

将显示“配置”屏幕。

如何配置脚本

创建脚本后，需要配置新服务。

步骤

键入 start 命令的位置，或单击“浏览”以找到 start 命令。

您可以指定属性变量。使用属性变量介绍了属性变量。

（可选的）键入 stop 命令的位置，或单击“浏览”以找到 stop 命令。

您可以指定属性变量。使用属性变量介绍了属性变量。

（可选的）键入 probe 命令的位置，或单击“浏览”以找到 probe 命令。

您可以指定属性变量。使用属性变量介绍了属性变量。

（可选的）为 start、stop 和 probe 命令指定新的超时值。

单击“配置”。

Agent Builder 将配置脚本。

注 –
Agent Builder 将供应商名称和应用程序名称组合在一起创建软件包名称。

将创建该脚本的软件包，并将其放置在以下目录中：
```
working-dir/vendor-name-application/pkg
```
例如，/export/wdir/NETapp/pkg。

在群集的每个节点上，成为超级用户或假定一个等效的角色。

在群集的每个节点上，安装完整的软件包。

对于分区域环境中的 Solaris 10 OS，请以全局区域中的全局管理员身份键入以下命令：

# cd /export/wdir/NETapp/pkg
# pkgadd -G -d . NETapp

指定的软件包将被添加到全局区域中，前提为软件包的内容不影响与非全局区域共享的全局区域的任何一部分。

以下是 pkgadd 安装的文件：

/opt/NETapp
/opt/NETapp/README.app
/opt/NETapp/man
/opt/NETapp/man/man1m
/opt/NETapp/man/man1m/removeapp.1m
/opt/NETapp/man/man1m/startapp.1m
/opt/NETapp/man/man1m/stopapp.1m
/opt/NETapp/man/man1m/app_config.1m
/opt/NETapp/util
/opt/NETapp/util/removeapp
/opt/NETapp/util/startapp
/opt/NETapp/util/stopapp
/opt/NETapp/util/app_config

对于非区域环境中其他版本的 Solaris OS 或 Solaris 10 OS，请键入以下命令：

# cd /export/wdir/NETapp/pkg
# pkgadd -d . NETapp

以下是 pkgadd 安装的文件：

/opt/NETapp
/opt/NETapp/README.app
/opt/NETapp/man
/opt/NETapp/man/man1m
/opt/NETapp/man/man1m/removeapp.1m
/opt/NETapp/man/man1m/startapp.1m
/opt/NETapp/man/man1m/stopapp.1m
/opt/NETapp/man/man1m/app_config.1m
/opt/NETapp/util
/opt/NETapp/util/removeapp
/opt/NETapp/util/startapp
/opt/NETapp/util/stopapp
/opt/NETapp/util/app_config

注 –

手册页和脚本的名称对应于先前在“创建”屏幕中键入的应用程序名称，放在脚本名称之后（例如 startapp）。

在群集的一个节点上，配置资源并启动应用程序。

# /opt/NETapp/util/startapp -h logicalhostname -p port-and-protocol-list

startapp 脚本的参数视资源类型的不同（故障转移或可伸缩）而有所变化。

注 –

要确定需要键入的命令行，请检查自定义的手册页或运行 startapp 脚本而不带任何参数以显示用法语句。

若要查看手册页，需要指定手册页的路径。例如，要查看 startapp(1M) 手册页，请键入：

# man -M /opt/NETapp/man startapp

要显示用法语句，请键入：

# /opt/NETapp/util/startapp
 The resource name of LogicalHostname or SharedAddress must be
 specified. For failover services:
 Usage: startapp -h logicalhostname
          -p port-and-protocol-list
          [-n ipmpgroup-adapter-list]
 For scalable services:
 Usage: startapp -h shared-address-name
          -p port-and-protocol-list
          [-l load-balancing-policy]
          [-n ipmpgroup/adapter-list]
          [-w load-balancing-weights]

Agent Builder 的输出

Agent Builder 将根据创建软件包时提供的输入生成三个脚本和一个配置文件。配置文件用于指定资源组和资源类型的名称。

脚本如下：

启动脚本。配置资源并启动处于 RGM 控制下的应用程序。
停止脚本。停止应用程序并关闭资源和资源组。
删除脚本。删除由启动脚本创建的资源和资源组。

这些脚本具有相同的接口，其功能与 Agent Builder 为基于非 GDS 的数据服务生成的实用程序脚本相同。这些脚本都放在可以跨多个群集重复使用的 Solaris 软件包中。

您可以自定义配置文件为资源组或其他参数提供自定义的名称，这些名称通常是在 scrgadm 命令中作为参数出现。如果不自定义脚本，Agent Builder 将提供 scrgadm 参数的默认值。