出站启动器

出站启动器和后端服务器在同一台计算机上运行。其用途是：

打开在公司 LAN 中运行的计算机到在 DMZ 中运行的中继服务器群的出站连接。
将从中继服务器接收的客户端请求转发到后端服务器，并通过中继服务器将后端服务器响应转发回客户端。

出站启动器启动后，它发送 HTTP 请求以检索群中正在运行的中继服务器的列表。使用映射到中继服务器的 Web 服务器扩展组件的服务器 URL 来完成此操作。服务器 URL 可以直接映射到中继服务器，也可以映射到负载平衡器。如果服务器 URL 映射到负载平衡器，则该负载平衡器将请求转发到群中正在运行的中继服务器之一。接收到出站启动器请求的中继服务器返回群中所有中继服务器的连接信息。然后，出站启动器创建两个与返回的各中继服务器的出站连接（称为信道）。一个信道（称为上行信道）使用具有实质上无限响应的 HTTP 请求来创建。该响应是从中继服务器到出站启动器的客户端请求的连续流。另一个信道（称为下行信道）使用具有实质上无限内容长度的 HTTP 请求来创建。该请求由客户端请求的服务器响应的连续流形成。

出站启动器在接收到来自它已连接的中继服务器之一的上行信道上的客户端请求时，会将请求转发到它正在服务的后端服务器。接收到来自后端服务器的响应后，出站启动器会使用下行信道将响应转发到从中接收相应请求的中继服务器。

出站启动器语法

rsoe [option]+

rsoe @{ filename | environment-variable } ...

参数

选项以下选项可与出站启动器一起使用。-cr 选项为必选，其他均为可选。

rsoe 选项说明

@data

读取来自指定的环境变量或配置文件的选项。如果要保护口令或配置文件中的其它信息，可以使用文件隐藏实用程序对配置文件的内容进行模糊处理。请参见文件隐藏实用程序 (dbfhide)。

-cr "connection-string"

指定中继服务器连接字符串。中继服务器连接字符串的格式是以分号分隔的 "名称 - 值" 对的列表。"名称 - 值" 对包含以下内容：

host 中继服务器的 IP 地址或主机名。缺省值为 localhost。
port 中继服务器正在监听的端口。这是必需项。
url_suffix 中继服务器的服务器扩展的 URL 路径。
缺省情况下，rsoe 需要指定 url_suffix。
https 0 - HTTP（缺省值）
1 - HTTPS

对于 https=1，还可以指定以下选项：

tls_type RSA
certificate_name 证书的公用名字段。
certificate_company 证书的组织名字段。
certificate_unit 证书的组织单位字段。
trusted_certificates 包含受信任根证书列表的文件。

-cs "connection-string"

设置用于连接到后端服务器的主机和端口。缺省值为 "host=localhost;port=80"。

要启用定期后端服务器状态请求，需将 status_url 参数添加到 -cs。status_url 参数以 status_url=/<your-status-url> 格式指定。

下面举例说明如何使用 -cs 指定 status_url。

-cs "host=localhost;port=80;status_url=/getstatus/"

使用 -d 选项指定后端服务器状态请求的频率。

-d seconds

设置后端服务器活动 ping 和后端服务器状态请求的频率。缺省值为 5 秒。

-dl

使用此选项，在中继服务器出站启动器控制台显示日志消息。缺省情况下，详细程度级别 1 和 2 不显示日志消息。

-f farm

指定后端服务器所属的群的名称。

-id id

指定分配给后端服务器的名称。

-o

将输出消息记录到文件。

-oq

用于在发生启动错误时禁止出现错误窗口。

-os

设置消息日志文件的最大大小。最小值限制为 10 KB。

-ot

截断日志文件并将消息记录到该文件。

-q

在启动时以最小化窗口运行。

-qc

完成时关闭窗口。

-s

停止出站启动器。

-t token

设置要传递给中继服务器的安全标识。

-uc

以 shell 模式启动 rsoe。这是缺省设置。适用于 Unix 和 Mac OS X。

您应只指定 -uc、-ui、-um 或 -ux 中的一个。若指定 -uc，则启动 rsoe 的方式与该软件的先前版本相同。

-ud

指示 rsoe 作为守护程序运行。此选项仅适用于 Unix 平台。

-ui

如果可用显示不可用，则以 shell 模式启动 rsoe。此选项用于支持 X 窗口服务器的 Linux。

如果指定 -ui，服务器会尝试查找一个可用显示。如果没有找到，例如因为 X 窗口服务器没有运行，那么 rsoe 会以 shell 模式启动。

-ux

对于 Linux，用于打开显示消息的 rsoe 消息窗口。

当指定 -ux 时，rsoe 必须能够找到可用显示。如果找不到（例如，因为未设置 DISPLAY 环境变量或 X 窗口服务器未运行），则 rsoe 将无法启动。

若要以安静模式运行 rsoe 消息窗口，请使用 -q 选项。

在 Windows 上，rsoe 消息窗口将自动出现。

-v level

设置用于记录的详细程度级别。level 可以设为 0、1 或 2：

0 仅记录错误。此记录级别用于部署。
1 会话级记录。这是同步会话的更高级视图。
2 请求级记录。提供同步会话中 HTTP 请求的更详细视图。

级别 1 和 2 仅写入日志文件，不会显示。要显示所有日志消息，请使用 -dl 开关。

文件隐藏实用程序 (dbfhide)

语法

dbfhide original-configuration-file encrypted-configuration-file

选项	说明
original-configuration-file	指定原始文件的名称。
encrypted-configuration-file	指定模糊处理后新文件的名称。

中继服务器和出站启动器检测配置文件是否已被用 dbfhide 进行了模糊处理，并对该文件进行处理。

此实用程序不接受用于从配置文件中读入选项的 @data 参数。

集成出站启动器

通过对 mlsrv12 的 -x 选项使用 OE 协议，您可以使用集成出站启动器，而不使用通过 rsoe 命令调用的独立出站启动器。使用集成出站启动器具有以下优势：

减少对系统资源的使用，尤其是套接字。
实现单一、集成的日志文件。从集成出站启动器输出到 MobiLink 服务器日志的行将具有前缀 <OE>。
部署简化。
排除了出站启动器和 MobiLink 服务器之间的活动检查。

有关如何使用集成出站启动器的详细信息，请参见 -x mlsrv12 选项。

部署注意事项

使用出站启动器时应注意以下事项：

出站启动器作为服务 还可以使用服务实用程序将出站启动器作为服务来设置和维护。请参见出站启动器作为服务。
验证不能使用简单或摘要式验证。无论 Web 服务器类型或操作系统为何，rsoe.exe 都不支持使用 Web 服务器进行的简单或摘要式验证。

出站启动器作为服务

使用DocCommentXchange 讨论此页。