将中继服务器组件部署到 Linux 上的 Apache

在 Linux 上，中继服务器文件作为 SQL Anywhere 安装的一部分安装到 /opt/sqlanywhere12。有关部署的信息，请参见以下主题。

有关支持 Linux 上哪些版本的 Apache 的信息，请参见 [external link] http://www.sybase.com/detail?id=1061806。

将以下可执行文件和共享对象从 /opt/sqlanywhere12 目录复制到 <apache-install-dir>\modules 目录中：
- mod_rs_ap_client.so
- mod_rs_ap_server.so
- rshost
- dblgen12.res
- libdbtasks12.so
- libdbicudt12.so
- libdbicu12_r.so
- libdblib12_r.so
- dbsupport
- dbfhide
- libdblib12.so
- mod_rs_ap_monitor.so
- mod_rs_ap_admin.so
创建中继服务器配置文件 rs.config。请参见中继服务器配置文件。
将 rs.config 复制到 <apache-install-dir>\modules 目录中。服务器模块预期 rshost 可执行文件位于在其中复制 rs.config 文件的目录中。
根据以下原则编辑中继服务器配置文件 rs.config。
- 文件应包含四个部分：
  - 中继服务器部分
  - 后端群部分
  - 后端服务器部分
  - 选项部分
- 各部分以部分标记开头，将标识部分名的关键字用方括号括起来。
- 为各部分添加相应的属性。定义属性的方法是在等号左侧指定属性名称，在等号右侧指定属性值。例如，属性名称 = 值。
- 配置文件应只包含 7-字节 ASCII 字符。
请参见中继服务器配置文件。
设置 PATH 和 LD_LIBRARY_PATH 环境变量以包含 Apache <apache-install-dir>\modules 目录。

编辑 Apache conf/httpd.conf 文件。

添加以下行来装载中继服务器客户端和服务器模块：

LoadModule iarelayserver_client_module modules/mod_rs_ap_client.so

LoadModule iarelayserver_server_module modules/mod_rs_ap_server.so

所有模块使用不同的 URL 调用，并且所有模块在 URL 路径中显式查找字符串 iarelayserver。那部分 URL 不需要更改。

添加以下行以装载 SQL Anywhere 监控器支持模块：

LoadModule iarelayserver_monitor_module modules/mod_rs_ap_monitor.so

添加以下行以装载 Remote 管理支持模块：

LoadModule iarelayserver_admin_module modules/mod_rs_ap_admin.so

添加以下行为客户端模块创建 <locationMatch> 部分：

<LocationMatch /cli/iarelayserver/* >
    SetHandler iarelayserver-client-handler
</LocationMatch>

添加以下行为服务器模块创建 <location> 部分：

<Location /srv/iarelayserver/* >
    SetHandler iarelayserver-server-handler
    RSConfigFile "/<apache-install>/modules/rs.config"
</Location>

必须指定 RSConfigFile 指令，它指定了中继服务器配置文件 rs.config 的位置。rs.config 文件必须驻留在部署 rshost 可执行文件的目录中。

添加以下行为 SQL Anywhere 监控器模块创建 <location> 部分：

 <Location  /mon/iarelayserver/* >
    SetHandler iarelayserver-monitor-handler
</Location>

添加以下行为 Remote 管理模块创建 <location> 部分：

<Location /admin/iarelayserver/* >
  SetHandler iarelayserver-admin-handler
</Location>

在 Linux 上，如果在 Apache 生成进程时，以下环境变量中的任何一个变量已设置为全局变量，则不需要进一步配置 Apache：$TMP、$TMPDIR 或 $TEMP。

如果以上环境变量都未设置为全局变量，或者如果您希望缺省中继服务器日志文件位于特定的临时目录（例如，当状态管理器自动启动但未进行自定义设置时）中，则编辑要设置的文件 /<apache-dir>/bin/envvars，然后导出 TMP。

例如，要编辑 envvars 文件中的 $TMP，请执行以下操作：
set TMP="/tmp" export TMP
这会在 shell 中设置 Apache 在生成其进程以前所创建的环境变量。

注意

Apache 用户进程必须对指定的 tmp 目录具有写权限。
如果要在中继服务器启动时更新其配置：
1. 将更新的配置文件复制到 Apache 安装目录下的 <apache-install-dir>\modules 目录中。如果使用自动启动，则必须将配置文件命名为 rs.config。
2. 从 /<Apache-install>/modules 目录中，运行以下命令行来应用配置更新：
  rshost -u -f rs.config
3. 如果中继服务器设置为含多个服务器的群，请对中继服务器群中的每台计算机重复以上操作步骤。

使用DocCommentXchange 讨论此页。