安装 Dispatcher

使用 Dispatcher 发行说明页面可获取适用于您的操作系统和 Web 服务器的最新 Dispatcher 安装文件。Dispatcher 版本号独立于 Adobe Experience Manager 版本号,并且与 Adobe Experience Manager 6.x、5.x 和 Adobe CQ 5.x 版本兼容。

注意

请注意,Adobe Experience Manager 6.5 要求 Dispatcher 版本 4.3.2 或更高版本。也就是说,Dispatcher 版本独立于 AEM,例如 Dispatcher 版本 4.3.2 也与 Adobe Experience Manager 6.4 兼容。

使用以下文件命名约定:

dispatcher-<web-server>-<operating-system>-<dispatcher-version-number>.<file-format>

例如,dispatcher-apache2.4-linux-x86_64-ssl-4.3.1.tar.gz 文件包含适用于在 Linux i686 上运行的 Apache 2.4 Web 服务器的 Dispatcher 版本 4.3.1,并使用 tar 格式进行打包。

下表列出了在每个 Web 服务器的文件名中使用的 Web 服务器标识符:

Web 服务器 安装套件
Apache 2.4 dispatcher-apache 2.4-<其他参数>
Microsoft Internet Information Server 7.5、8、8.5 dispatcher-iis-<其他参数>
Sun Java Web Server iPlanet dispatcher-ns-<其他参数>
注意

您应安装适用于您的平台的最新版本的 Dispatcher。您每年都应将您的 Dispatcher 实例升级到最新版本以使用产品改进功能。

每个存档都包含以下文件:

  • Dispatcher 模块
  • 示例配置文件
  • 包含安装说明和最新信息的自述文件
  • 列出当前版本或过去版本中修复的问题的变更文件
注意

在开始安装之前,请查看自述文件以了解是否有任何最新的更改/特定于平台的说明。

Microsoft Internet Information Server

有关如何安装此 Web 服务器的信息,请参阅以下资源:

必需的 IIS 组件

IIS 版本 8.5 和 10 要求安装以下 IIS 组件:

  • ISAPI 扩展

您还必须安装 Web Server (IIS) 角色。使用 Server Manager 添加角色和组件。

Microsoft IIS - 安装 Dispatcher 模块

Microsoft Internet Information System 的必需存档为:

  • dispatcher-iis-<operating-system>-<dispatcher-release-number>.zip

ZIP 文件包含以下文件:

文件 描述
disp_iis.dll Dispatcher 动态链接库文件。
disp_iis.ini IIS 的配置文件。可根据您的要求更新此示例。注意:ini 文件必须具有与 dll 相同的命名根。
dispatcher.any Dispatcher 的示例配置文件。
author_dispatcher.any 使用创作实例的 Dispatcher 的示例配置文件。
自述文件 包含安装说明和最新信息的自述文件。注意:请先查看此文件,然后再开始安装。
变更文件 列出当前版本或过去版本中修复的问题的变更文件。

使用以下过程可将 Dispatcher 文件复制到正确位置。

  1. 使用 Windows 资源管理器创建 <IIS_INSTALLDIR>/Scripts 目录,例如 C:\inetpub\Scripts

  2. 将 Dispatcher 包中的以下文件提取到此 Scripts 目录中:

    • disp_iis.dll
    • disp_iis.ini
    • 下列文件之一,取决于 Dispatcher 是使用 AEM 创作实例还是发布实例:
      • 创作实例:author_dispatcher.any
      • 发布实例:dispatcher.any

Microsoft IIS - 配置 Dispatcher INI 文件

编辑 disp_iis.ini 文件可配置 Dispatcher 安装。.ini 文件的基本格式如下所示:

[main]
configpath=<path to dispatcher.any>
loglevel=1|2|3
servervariables=0|1
replaceauthorization=0|1

下表描述了每个属性。

参数 描述
configpath dispatcher.any 在本地文件系统中的位置(绝对路径)。
logfile dispatcher.log 文件的位置。如果未设置,则日志消息将转到 Windows 事件日志。
loglevel 定义用于将消息输出到事件日志的日志级别。可以指定以下值:日志文件的日志级别:
0 - 仅错误消息。
1 - 错误和警告。
2 - 错误、警告和信息性消息
3 - 错误、警告和信息性消息和调试消息。
注意:建议在安装和测试期间将日志级别设置为 3,在生产环境中运行时将日志级别设置为 0。
replaceauthorization 指定如何处理 HTTP 请求中的授权标头。以下值有效:
0 - 未修改授权标头。
1 - 将除“Basic”以外的任何名为“Authorization”的标头替换为其 Basic <IIS:LOGON\_USER> 等效标头。
servervariables 定义如何处理服务器变量。
0 - IIS 服务器变量不会发送到 Dispatcher 和 AEM。
1 - 所有 IIS 服务器变量(例如 LOGON\_USER, QUERY\_STRING, ...)都与请求标头一起发送到 Dispatcher(如果未缓存,还将发送到 AEM 实例)。
服务器变量包括 AUTH\_USER, LOGON\_USER, HTTPS\_KEYSIZE 及其他。请参阅 IIS 文档以查看完整的变量列表以及详细信息。
enable_chunked_transfer 定义是为客户端响应启用 (1) 还是禁用 (0) 分块传输。默认值为 0。

示例配置:

[main]
configpath=C:\Inetpub\Scripts\dispatcher.any
loglevel=1
servervariables=1
replaceauthorization=0

配置 Microsoft IIS

配置 IIS 以集成 Dispatcher ISAPI 模块。在 IIS 中,您使用通配符应用程序映射。

配置匿名访问 - IIS 8.5 和 10

创作实例上的默认 Flush 复制代理已配置为不随刷新请求发送安全凭据。因此,您使用 Dispatcher 缓存的网站必须允许匿名访问。

如果您的网站使用身份验证方法,则必须相应地配置 Flush 复制代理。

  1. 打开 IIS Manager 并选择您将用作 Disptcher 缓存的网站。
  2. 通过使用“功能视图”模式,在 IIS 部分中双击“身份验证”。
  3. 如果未启用“匿名身份验证”,请选择“匿名身份验证”,并在“操作”区域中,单击“启用”。

集成 Dispatcher ISAPI 模块 - IIS 8.5 和 10

使用以下过程可将 Dispatcher ISAPI 模块添加到 IIS。

  1. 打开 IIS Manager。

  2. 选择您将用作 Dispatcher 缓存的网站。

  3. 通过使用“功能视图”模式,在 IIS 部分中双击“处理程序映射”。

  4. 在“处理程序映射”页面的“操作”面板中,单击“添加通配符脚本映射”,添加以下属性值,然后单击“确定”:

    • 请求路径:*
    • 可执行文件:disp_iis.dll 文件的绝对路径,例如 C:\inetpub\Scripts\disp_iis.dll
    • 名称:处理程序映射的描述性名称,例如 Dispatcher
  5. 在出现的对话框中,要将 disp_iis.dll 库添加到 ISAPI 和 CGI 限制列表,请单击“是”。

    对于 IIS 7.0 和 7.5,配置是完整的。如果您配置的是 IIS 8.0,请使用剩余步骤进行配置。

  6. (IIS 8.0) 在处理程序映射列表中,选择您刚刚创建的映射,然后在“操作”区域中单击“编辑”。

  7. (IIS 8.0) 在“编辑脚本映射”对话框中,单击“请求限制”按钮。

  8. (IIS 8.0) 要确保处理程序用于尚未缓存的文件和文件夹,请取消选择“仅在映射到请求时调用处理程序”,然后单击“确定”。

  9. (IIS 8.0) 在“编辑脚本映射”对话框中,单击“确定”。

配置对缓存的匿名访问 - IIS 8.5 和 10

向默认 App Pool 用户提供对将用作 Dispatcher 缓存的文件夹的写访问权限。

  1. 右键单击将用作 Dispatcher 缓存的网站的根文件夹,然后单击“属性”,例如 C:\inetpub\wwwroot

  2. 在“安全性”选项卡上,单击“编辑”,然后在“权限”对话框中,单击“添加”。这将打开一个对话框,可在其中选择用户帐户。单击“位置”按钮,选择您的计算机名称,然后单击“确定”。

    将此对话框保持打开状态,同时完成下一个步骤。

  3. 在 IIS Manager 中,选择将用于 Dispatcher 缓存的 IIS 站点,然后在窗口右侧单击“高级设置”。

  4. 选择应用程序池属性的值并将该值复制到剪贴板。

  5. 返回打开的对话框。在“输入要选择的对象名称”框中,键入 IIS AppPool\,然后粘贴剪贴板的内容。该值应与以下示例类似:

    IIS AppPool\DefaultAppPool

  6. 单击“检查名称”按钮。在 Windows 解析用户帐户时,单击“确定”。

  7. 在 dispatcher 文件夹的“权限”对话框中,选择您刚刚添加的帐户,启用该帐户的所有权限(完全控制权限除外),然后单击“确定”。单击“确定”以关闭“文件夹属性”对话框。

注册 JSON Mime 类型 - IIS 8.5 和 10

如果您希望 Dispatcher 允许 JSON 调用,可使用以下过程注册 JSON MIME 类型。

  1. 在 IIS Manager 中,选择您的网站并使用“功能视图”,双击“Mime 类型”。

  2. 如果 JSON 扩展未在列表中,请在“操作”面板中单击“添加”,输入以下属性值,然后单击“确定”:

    • 文件扩展名:.json
    • MIME 类型:application/json

删除 bin 隐藏部分 - IIS 8.5 和 10

使用以下过程可删除 bin 隐藏部分。非新网站可能包含此隐藏部分。

  1. 在 IIS Manager 中,选择您的网站并使用“功能视图”,双击“请求过滤”。
  2. 选择 bin 部分,单击“移除”,然后在确认对话框中,单击“是”。

将 IIS 消息记录到文件 - IIS 8.5 和 10

使用以下过程可将 Dispatcher 日志消息写入日志文件而非 Windows 事件日志。您需要配置 Dispatcher 以使用日志文件,并向 IIS 提供对该文件的写访问权限。

  1. 使用 Windows 资源管理器在 IIS 安装的日志文件夹下创建名为 dispatcher 的文件夹。典型安装的此文件夹的路径为 C:\inetpub\logs\dispatcher

  2. 右键单击 dispatcher 文件夹,然后单击“属性”。

  3. 在“安全性”选项卡上,单击“编辑”,然后在“权限”对话框中,单击“添加”。这将打开一个对话框,可在其中选择用户帐户。单击“位置”按钮,选择您的计算机名称,然后单击“确定”。

    将此对话框保持打开状态,同时完成下一个步骤。

  4. 在 IIS Manager 中,选择将用于 Dispatcher 缓存的 IIS 站点,然后在窗口右侧单击“高级设置”。

  5. 选择应用程序池属性的值并将该值复制到剪贴板。

  6. 返回打开的对话框。在“输入要选择的对象名称”框中,键入 IIS AppPool\,然后粘贴剪贴板的内容。该值应与以下示例类似:

    IIS AppPool\DefaultAppPool

  7. 单击“检查名称”按钮。在 Windows 解析用户帐户时,单击“确定”。

  8. 在 dispatcher 文件夹的“权限”对话框中,选择您刚刚添加的帐户,启用该帐户的所有权限(完全控制权限除外),然后单击“确定”。单击“确定”以关闭“文件夹属性”对话框。

  9. 使用文本编辑器打开 disp_iis.ini 文件。

  10. 添加与以下示例类似的文本行来配置日志文件的位置,然后保存该文件:

    logfile=C:\inetpub\logs\dispatcher\dispatcher.log
    

后续步骤

您必须先执行以下操作,然后才能开始使用 Dispatcher:

Apache Web Server

注意

此处介绍了 WindowsUnix 下的安装说明。请务必小心执行这些步骤。

安装 Apache Web Server

有关如何安装 Apache Web Server 的信息,请参阅安装手册 - 在线版本或分发版。

注意

如果通过编译源文件来创建 Apache 二进制文件,请确保启用​**“动态模块支持”**。可使用任意 –enable-shared 选项来执行此操作。最低要求是包含 mod_so 模块。

有关更多信息,请参阅 Apache Web Server 安装手册。

另请参阅 Apache HTTP Server 安全提示安全报告

Apache Web Server - 添加 Dispatcher 模块

Dispatcher 的提供形式为:

  • Windows:动态链接库 (DLL)
  • Unix:动态共享对象 (DSO)

安装存档文件包含以下文件 - 取决于您选择的是 Windows 还是 Unix:

文件 描述
disp_apache<x.y>.dll Windows:Dispatcher 动态链接库文件。
dispatcher-apache<x.y>-<rel-nr>.so Unix:Dispatcher 共享对象库文件。
mod_dispatcher.so Unix:示例链接。
http.conf.disp<x> Apache Server 的示例配置文件。
dispatcher.any Dispatcher 的示例配置文件。
自述文件 包含安装说明和最新信息的自述文件。注意:请先查看此文件,然后再开始安装。
变更文件 列出当前版本或过去版本中修复的问题的变更文件。

使用以下步骤可将 Dispatcher 添加到 Apache Web Server:

  1. 将 Dispatcher 文件放置到适当的 Apache 模块目录中:

    • Windows:放置 disp_apache<x.y>.dll <APACHE_ROOT>/modules
    • Unix:根据安装找到 <APACHE_ROOT>/libexec<APACHE_ROOT>/modules 目录。
      dispatcher-apache<options>.so 复制到此目录中。
      要简化长期维护,您还可以创建指向 Dispatcher 的名为 mod_dispatcher.so 的符号链接:
      ln -s dispatcher-apache<x>-<os>-<rel-nr>.so mod_dispatcher.so
  2. 将 dispatcher.any 文件复制到 <APACHE_ROOT>/conf 目录。

    注意:​您可以将此文件放置到不同的位置,前提是相应地配置 Dispatcher 模块的 DispatcherLog 属性。(请参阅以下特定于 Dispatcher 的配置条目。)

Apache Web Server - 配置 SELinux 属性

如果您在支持 SELinux 的 RedHat Linux Kernel 2.6 上运行 Dispatcher,您可能会在 Dispatcher 日志文件中看到与以下内容类似的错误消息。

Mon Jun 30 00:03:59 2013] [E] [16561(139642697451488)] Unable to connect to backend rend01 (10.122.213.248:4502): Permission denied

这可能是由于启用的 SELinux 安全性导致的。之后,您需要执行以下任务:

  • 配置 Dispatcher 模块文件的 SELinux 上下文。
  • 启用 HTTPD 脚本和模块以建立网络连接。
  • 配置存储了缓存文件的 docroot 的 SELinux 上下文。

在终端窗口中输入以下命令,将 [path to the dispatcher.so file] 替换为已安装到 Apache Web Server 的 Dispatcher 模块的路径,并将 path to the docroot 替换为 docroot 的路径(例如 /opt/cq/cache):

semanage fcontext -a -t httpd_modules_t [path to the dispatcher.so file]
setsebool -P httpd_can_network_connect on
chcon -R --type httpd_sys_content_t [path to the docroot]
semanage fcontext -a -t httpd_sys_content_t "[path to the docroot](/.*)?"

Apache Web Server - 为 Dispatcher 配置 Apache Web Server

需要使用 httpd.conf 配置 Apache Web Server。在 Dispatcher 安装套件中,您将找到一个名为 httpd.conf.disp<x> 的示例配置文件。

必须执行以下步骤:

  1. 导航到 <APACHE_ROOT>/conf

  2. 打开 httpd.conf 以进行编辑。

  3. 必须按列出的顺序添加以下配置条目:

    • LoadModule,用于在启动时加载模块。
    • 特定于 Dispatcher 的配置条目,包括 DispatcherConfig、DispatcherLogDispatcherLogLevel
    • SetHandler,用于激活 Dispatcher。LoadModule
    • ModMimeUsePathInfo,用于配置 mod_mime 的行为。
  4. (可选)建议您更改 htdocs 目录的所有者:

    • Apache Server 以 root 身份启动,但子进程作为守护进程启动(出于安全目的)。DocumentRoot (<APACHE_ROOT>/htdocs) 必须属于用户守护进程:

      cd <APACHE_ROOT>  
      chown -R daemon:daemon htdocs
      

LoadModule

下表列出了可以使用的示例;确切的条目取决于您的特定 Apache Web Server:

Windows ... LoadModule dispatcher_module modules\disp_apache.dll ...
Unix(使用符号链接) ... LoadModule dispatcher_module libexec/mod_dispatcher.so ...
注意

必须完全按照上述示例编写每个语句的第一个参数。

有关此命令的完整详细信息,请参阅提供的示例配置文件和 Apache Web Server 文档。

特定于 Dispatcher 的配置条目

特定于 Dispatcher 的配置条目将置于 LoadModule 条目之后。下表列出了适用于 Unix 和 Windows 的示例配置:

Windows 和 Unix

...
<fModule disp_apache2.c>
DispatcherConfig conf/dispatcher.any
DispatcherLog logs/dispatcher.log DispatcherLogLevel 3
DispatcherNoServerHeader 0 DispatcherDeclineRoot 0
DispatcherUseProcessedURL 0
DispatcherPassError 0
DispatcherKeepAliveTimeout 60
</IfModule>
...

单个配置参数:

参数 描述
DispatcherConfig Dispatcher 配置文件的位置和名称。
当此属性位于主服务器配置中时,所有虚拟主机都将会继承属性值。不过,虚拟主机可以包括 DispatcherConfig 属性来覆盖主服务器配置。
DispatcherLog 日志文件的位置和名称。
DispatcherLogLevel 日志文件的日志级别:
0 - 错误
1 - 警告
2 - 信息
3 - 调试
注意:建议在安装和测试期间将日志级别设置为 3,在生产环境中运行时将日志级别设置为 0。
DispatcherNoServerHeader 此参数已弃用,不再有效。

定义要使用的服务器标头:
  • 未定义或 0 - HTTP 服务器标头包含 AEM 版本。
  • 1 - 使用 Apache 服务器标头。
DispatcherDeclineRoot 定义是否拒绝对根“/”的请求:
0 - 接受对 / 的请求
1 - Dispatcher 未处理对 / 的请求;将 mod_alias 用于正确的映射。
DispatcherUseProcessedURL 定义是否将预处理的 URL 用于 Dispatcher 执行的所有进一步处理:
0 - 使用传递给 Web 服务器的原始 URL。
1 - Dispatcher 使用已由其前面的处理程序处理的 URL(即 mod_rewrite),而不是使用传递给 Web 服务器的原始 URL。例如,原始 URL 或处理后的 URL 与 Dispatcher 过滤器匹配。此 URL 也用作缓存文件结构的基础。有关 mod_rewrite 的信息,请参阅 Apache 网站文档;例如,Apache 2.4。在使用 mod_rewrite 时,建议使用标志“passthrough
DispatcherPassError 定义如何支持 ErrorDocument 处理的错误代码:
0 - Dispatcher 将所有错误响应假脱机到客户端。
1 - Dispatcher 不会将错误响应假脱机到客户端(其中,状态代码大于或等于 400),而是将状态代码传递到 Apache,从而让 ErrorDocument 指令处理此类状态代码。
代码范围 - 指定将其响应传递到 Apache 的错误代码的范围。其他错误代码将传递到客户端。例如,以下配置将错误 412 的响应传递到客户端,并将所有其他错误(DispatcherPassError 400-411、413-417)的响应传递到 Apache。
DispatcherKeepAliveTimeout 指定保持活动状态超时时间(以秒为单位)。从 Dispatcher 版本 4.2.0 开始,默认的保持活动状态值为 60。如果值为 0,则禁用保持活动状态。
DispatcherNoCanonURL 将此参数设置为“启用”会将原始 URL 传递到后端而不是规范化的 URL,并且将覆盖 DispatcherUseProcessedURL 的设置。默认值为“禁用”。
注意:Dispatcher 配置中的过滤器规则将始终根据经过处理的 URL 而不是原始 URL 进行评估。
注意

路径条目相对于 Apache Web Server 的根目录。

注意

服务器标头的默认设置为:

ServerTokens Full

DispatcherNoServerHeader 0

其中显示了 AEM 版本(用于统计目的)。如果您想在标头中禁止显示此类信息,可以设置:

ServerTokens Prod

有关更多信息,请参阅有关 ServerTokens 指令的 Apache 文档(例如,适用于 Apache 2.4 的文档)

SetHandler

在这些条目之后,您必须将 SetHandler 语句添加到配置的上下文(<Directory><Location>)中以便 Dispatcher 处理传入请求。以下示例将 Dispatcher 配置为处理对整个网站的请求:

Windows 和 Unix

...  
<Directory />  
<IfModule disp\_apache2.c>  
SetHandler dispatcher-handler  
</IfModule>  
  
Options FollowSymLinks  
AllowOverride None  
</Directory>  
...

以下示例将 Dispatcher 配置为处理对虚拟域的请求:

Windows

...  
<VirtualHost 123.45.67.89>  
ServerName www.mycompany.com  
DocumentRoot _\[cache-path\]_\\docs  
<Directory _\[cache-path\]_\\docs>  
<IfModule disp\_apache2.c>  
SetHandler dispatcher-handler  
</IfModule>  
AllowOverride None  
</Directory>  
</VirtualHost>  
...

Unix

...  
<VirtualHost 123.45.67.89>  
ServerName www.mycompany.com  
DocumentRoot /usr/apachecache/docs  
<Directory /usr/apachecache/docs>  
<IfModule disp\_apache2.c>  
SetHandler dispatcher-handler  
</IfModule>  
AllowOverride None  
</Directory>  
</VirtualHost>  
...
注意

必须​完全按照上述示例​编写 SetHandler 语句的参数,因为这是模块中定义的处理程序的名称。

有关此命令的完整详细信息,请参阅提供的示例配置文件和 Apache Web Server 文档。

ModMimeUsePathInfo

SetHandler 语句之后,您还应添加 ModMimeUsePathInfo 定义。

注意

应仅在使用 Dispatcher 版本 4.0.9 或更高版本时使用和配置 ModMimeUsePathInfo 参数。

(请注意,Dispatcher 版本 4.0.9 已于 2011 年发布。如果您使用的是旧版本,最好是升级到最新的 Dispatcher 版本)。

应为所有 Apache 配置将 ModMimeUsePathInfo 参数设置为 On

ModMimeUsePathInfo On

mod_mime 模块(请参阅 Apache 模块 mod_mime)用于将内容元数据分配给为 HTTP 响应选择的内容。默认设置意味着,当 mod_mime 确定内容类型时,只会考虑映射到文件或目录的 URL 部分。

在设置为 On 时,ModMimeUsePathInfo 参数指定 mod_mime 以根据​完整 URL 确定内容类型;这意味着虚拟资源将根据其扩展应用元信息。

以下示例激活 ModMimeUsePathInfo

Windows 和 Unix

...  
<Directory />  
<IfModule disp\_apache2.c>  
SetHandler dispatcher-handler  
ModMimeUsePathInfo On  
</IfModule>  
  
Options FollowSymLinks  
AllowOverride None  
</Directory>  
...

启用对 HTTPS 的支持(Unix 和 Linux)

Dispatcher 使用 OpenSSL 实现 HTTP 上的安全通信。从 Dispatcher 版本 4.2.0 开始,支持 OpenSSL 1.0.0 和 OpenSSL 1.0.1。默认情况下,Dispatcher 使用 OpenSSL 1.0.0。要使用 OpenSSL 1.0.1,请使用以下过程创建符号链接,以便 Dispatcher 使用已安装的 OpenSSL 库。

  1. 打开终端,并将当前目录更改为安装了 OpenSSL 库的目录,例如:

    cd /usr/lib64
    
  2. 要创建符号链接,请输入以下命令:

    ln -s libssl.so libssl.so.1.0.1
    ln -s libcrypto.so libcrypto.so.1.0.1
    
注意

如果您使用的是自定义版本的 Apache,请确保使用相同版本的 OpenSSL 编译 Apache 和 Dispatcher。

后续步骤

您现在必须先执行以下操作,然后才能开始使用 Dispatcher:

Sun Java System Web Server/iPlanet

注意

此处介绍了 Windows 和 Unix 环境的说明。

请务必小心选择要执行的操作。

Sun Java System Web Server/iPlanet - 安装您的 Web 服务器

有关如何安装这些 Web 服务器的完整信息,请参阅它们各自的文档:

  • Sun Java System Web Server
  • iPlanet Web Server

Sun Java System Web Server/iPlanet - 添加 Dispatcher 模块

Dispatcher 的提供形式为:

  • Windows:动态链接库 (DLL)
  • Unix:动态共享对象 (DSO)

安装存档文件包含以下文件 - 取决于您选择的是 Windows 还是 Unix:

文件 描述
disp_ns.dll Windows:Dispatcher 动态链接库文件。
dispatcher.so Unix:Dispatcher 共享对象库文件。
dispatcher.so Unix:示例链接。
obj.conf.disp iPlanet/Sun Java System Web Server 的示例配置文件。
dispatcher.any Dispatcher 的示例配置文件。
自述文件 包含安装说明和最新信息的自述文件。注意:请先查看此文件,然后再开始安装。
变更文件 列出当前版本或过去版本中修复的问题的变更文件。

使用以下步骤可将 Dispatcher 添加到您的 Web 服务器:

  1. 将 Dispatcher 文件放置到 Web 服务器的 plugin 目录中:

Sun Java System Web Server/iPlanet - 针对 Dispatcher 进行配置

需要使用 obj.conf 配置 Web 服务器。在 Dispatcher 安装套件中,您将找到一个名为 obj.conf.disp 的示例配置文件。

  1. 导航到 <WEBSERVER_ROOT>/config

  2. 打开 obj.conf 以进行编辑。

  3. 复制以下行:
    Service fn="dispService"
    obj.conf.dispobj.conf 的初始化部分。

  4. 保存更改。

  5. 打开 magnus.conf 以进行编辑。

  6. 复制以下两行:
    Init funcs="dispService, dispInit"

    Init fn="dispInit"
    obj.conf.dispmagnus.conf 的初始化部分。

  7. 保存更改。

注意

以下配置都应位于一个行中,并且必须将 $(SERVER_ROOT)$(PRODUCT_SUBDIR) 替换为相应的值。

Init

下表列出了可以使用的示例;确切的条目取决于您的特定 Web 服务器:

Windows 和 Unix

...  
Init funcs="dispService,dispInit" fn="load-modules" shlib="$(SERVER\_ROOT)/plugins/dispatcher.so"  
Init fn="dispInit" config="$(PRODUCT\_SUBDIR)/dispatcher.any" loglevel="1" logfile="$(PRODUCT\_SUBDIR)/logs/dispatcher.log"  
keepalivetimeout="60"  
...

其中:

参数 描述
config 配置文件 dispatcher.any. 的位置和名称。
logfile 日志文件的位置和名称。
loglevel 在将消息写入日志文件时的日志级别:
0 错误
1 警告
2 信息
3 调试
注意:​建议在安装和测试期间将日志级别设置为 3,在生产环境中运行时将日志级别设置为 0。
keepalivetimeout 指定保持活动状态超时时间(以秒为单位)。从 Dispatcher 版本 4.2.0 开始,默认的保持活动状态值为 60。如果值为 0,则禁用保持活动状态。

根据您的要求,您可以将 Dispatcher 定义为对象的服务。要为整个网站配置 Dispatcher,请修改默认对象:

Windows

...  
NameTrans fn="document-root" root="$(PRODUCT\_SUBDIR)\\dispcache"  
...  
Service fn="dispService" method="(GET|HEAD|POST)" type="\*\\\*"  
...

Unix

...  
NameTrans fn="document-root" root="$(PRODUCT\_SUBDIR)/dispcache"  
...  
Service fn="dispService" method="(GET|HEAD|POST)" type="\*/\*"  
...

后续步骤

您现在必须先执行以下操作,然后才能开始使用 Dispatcher:

在此页面上