安裝 Dispatcher

使用Dispatcher發行說明頁面，取得作業系統和Web伺服器的最新Dispatcher安裝檔案。 Dispatcher版本編號與Adobe Experience Manager版本編號無關，並與Adobe Experience Manager 6.x、5.x和Adobe CQ 5.x版本相容。

使用下列檔案命名慣例：

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

例如，dispatcher-apache2.4-linux-x86_64-ssl-4.3.1.tar.gz檔案包含適用於在Linux i686上執行且使用​tar​格式封裝的Apache 2.4 Web伺服器的Dispatcher 4.3.1版。

下表列出了用於每個Web伺服器的檔案名的Web伺服器標識符：

每個封存都包含下列檔案：

• Dispatcher模組
• 組態檔範例
• 包含安裝說明和最後時刻資訊的自述檔案
• 列出目前和過去版本中修正問題的CHANGES檔案

Microsoft Internet資訊伺服器

有關如何安裝此Web伺服器的資訊，請參閱以下資源：

• Microsoft在Internet Information Server上自己的文檔
• "官方的Microsoft IIS站點"

必需的IIS元件

IIS 8.5和10版要求安裝以下IIS元件：

• ISAPI擴充功能

同時，您必須添加Web伺服器(IIS)角色。 使用「伺服器管理器」添加角色和元件。

Microsoft IIS — 安裝Dispatcher模組

Microsoft Internet Information System所需的歸檔檔案是：

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

ZIP檔案包含下列檔案：

請依照下列步驟，將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

下表說明了每個屬性。

範例設定：

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

配置Microsoft IIS

配置IIS以整合Dispatcher ISAPI模組。 在IIS中，使用通配符應用程式映射。

配置匿名訪問 — IIS 8.5和10

已設定Author例項上的預設排清復寫代理，使其不會傳送具有排清請求的安全憑證。 因此，您使用Dispatcher快取的網站必須允許匿名存取。

如果您的網站使用驗證方法，則必須據以設定排清復寫代理。

1. 開啟「IIS管理器」，並選擇您使用的網站作為Disptcher快取。
2. 在「使用功能視圖」模式中，在IIS部分按兩下「身份驗證」。
3. 如果未啟用匿名身份驗證，請選擇匿名身份驗證，然後在「操作」區域中按一下啟用。

整合Dispatcher ISAPI模組 — IIS 8.5和10

請依照下列程式，將Dispatcher ISAPI模組新增至IIS。

1. 開啟IIS管理器。

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

為預設的「應用程式池」使用者提供寫入存取權，存取正用作Dispatcher快取的資料夾。

1. 以滑鼠右鍵按一下您用作Dispatcher快取之網站的根資料夾，然後按一下「屬性」，例如C:\inetpub\wwwroot。

2. 在「安全性」頁簽上，按一下「編輯」，然後在「權限」對話框上，按一下「添加」。 將開啟一個對話框，用於選擇用戶帳戶。 按一下「位置」按鈕，選擇電腦名稱，然後按一下「確定」。

   完成下一步時，請保持此對話框開啟。

3. 在「IIS管理器」中，選擇您用於Dispatcher快取的IIS站點，然後在窗口的右側按一下「高級設定」。

4. 選擇應用程式池屬性的值，並將其複製到剪貼簿。

5. 返回開啟的對話框。 在輸入要選擇的對象名稱框中，鍵入IIS AppPool\，然後貼上剪貼簿的內容。 值應如下列範例所示：

   IIS AppPool\DefaultAppPool

6. 按一下「檢查名稱」按鈕。 Windows解析用戶帳戶時，按一下「確定」。

7. 在Dispatcher資料夾的「權限」對話方塊中，選取您剛新增的帳戶，啟用帳戶​的所有權限，但完全控制​除外，然後按一下「確定」。 按一下「確定」(OK)以關閉資料夾「屬性」(Properties)對話框。

註冊JSON Mime類型 — IIS 8.5和10

當您希望Dispatcher允許JSON呼叫時，請依照下列程式來註冊JSON MIME類型。

1. 在IIS管理器中，選擇您的網站，並使用功能視圖，按兩下Mime類型。

2. 如果清單中沒有JSON擴充功能，請在「動作」面板中按一下「新增」，輸入下列屬性值，然後按一下「確定」：

   • 副檔名：.json
   • MIME類型：application/json

刪除bin隱藏段 — IIS 8.5和10

請依照下列步驟移除bin隱藏的區段。 非新網站可包含此隱藏區段。

1. 在「IIS管理器」中，選擇您的網站，並使用「功能視圖」，按兩下「請求篩選」。
2. 選擇bin段，按一下「刪除」，然後在確認對話框中按一下「是」。

將IIS消息記錄到檔案 — IIS 8.5和10

請依照下列程式將Dispatcher記錄檔訊息寫入記錄檔，而非Windows事件記錄檔。 您需要將Dispatcher設定為使用記錄檔，並為IIS提供檔案的寫入存取權。

1. 使用Windows資源管理器在IIS安裝的日誌資料夾下建立名為dispatcher的資料夾。 典型安裝的此資料夾路徑為C:\inetpub\logs\dispatcher。

2. 以滑鼠右鍵按一下Dispatcher資料夾，然後按一下「屬性」。

3. 在「安全性」頁簽上，按一下「編輯」，然後在「權限」對話框上，按一下「添加」。 將開啟一個對話框，用於選擇用戶帳戶。 按一下「位置」按鈕，選擇電腦名稱，然後按一下「確定」。

   完成下一步時，請保持此對話框開啟。

4. 在「IIS管理器」中，選擇您用於Dispatcher快取的IIS站點，然後在窗口的右側按一下「高級設定」。

5. 選擇應用程式池屬性的值，並將其複製到剪貼簿。

6. 返回開啟的對話框。 在輸入要選擇的對象名稱框中，鍵入IIS AppPool\，然後貼上剪貼簿的內容。 值應如下列範例所示：

   IIS AppPool\DefaultAppPool

7. 按一下「檢查名稱」按鈕。 Windows解析用戶帳戶時，按一下「確定」。

8. 在Dispatcher資料夾的「權限」對話方塊中，選取您剛新增的帳戶，啟用帳戶​的所有權限，但「完整控制」除外，​然後按一下「確定」。 按一下「確定」(OK)以關閉資料夾「屬性」(Properties)對話框。

9. 使用文本編輯器開啟disp_iis.ini檔案。

10. 新增類似下列範例的文字行，以設定記錄檔的位置，然後儲存檔案：

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

後續步驟

開始使用Dispatcher之前，您必須知道：

• 🔗 ConfigureDispatcher
• 設定 AEM以與Dispatcher搭配使用。

Apache Web Server

安裝Apache Web Server

有關如何安裝Apache Web Server的資訊，請參閱安裝手冊 — online或分發中。

另請參閱Apache HTTP Server Security Tips和 Security Reports。

Apache Web伺服器 — 新增Dispatcher模組

Dispatcher會以下列任一方式提供：

• Windows:動態連結庫(DLL)
• Unix:動態共用物件(DSO)

安裝歸檔檔案包含下列檔案（取決於您是選擇了Windows還是Unix）:

使用下列步驟將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伺服器 — 配置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指令碼和模組以建立網路連接。
• 配置快取檔案的資料夾的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伺服器 — 為Dispatcher配置Apache Web伺服器

需要使用httpd.conf配置Apache Web伺服器。 在Dispatcher安裝套件中，您會找到名為httpd.conf.disp<x>的範例設定檔案。

這些步驟是強制性的：

1. 導航到 <APACHE_ROOT>/conf.

2. 開啟httpd.conf進行編輯。

3. 必須依所列順序新增下列設定項目：

   • ​​LoadModule以在啟動時載入模組。
   • Dispatcher專用的設定項目，包括​DispatcherConfig、DispatcherLog​和​DispatcherLogLevel。
   • ​​SetHandlerto啟動Dispatcher。LoadModule。
   • ​​ModMimeUsePathInfo以配置mod_mime 的行為。

4. （選用）建議您變更htdocs目錄的擁有者：

   • Apache伺服器以root啟動，但子進程以守護程式啟動（出於安全目的）。 DocumentRoot(<APACHE_ROOT>/htdocs)必須屬於用戶守護程式：

     cd <APACHE_ROOT>  
     chown -R daemon:daemon htdocs
     

LoadModule

下表列出可使用的範例；確切的條目是根據您的特定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>
...

個別設定參數：

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>  
...

ModMimeUsePathInfo

在​SetHandler​語句後，您還應添加​ModMimeUsePathInfo​定義。

應為所有Apache配置設定OnModMimeUsePathInfo​參數：

ModMimeUsePathInfo On

mod_mime模組（例如，Apache模組mod_mime）用於將內容元資料分配給為HTTP響應選擇的內容。 預設設定表示當mod_mime決定內容類型時，將只考慮映射至檔案或目錄的URL的一部分。

當On時，ModMimeUsePathInfo參數指定mod_mime是根據​complete 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
   

後續步驟

開始使用Dispatcher之前，您現在必須：

• 🔗 ConfigureDispatcher
• 設定 AEM以與Dispatcher搭配使用。

Sun Java System Web Server / iPlanet

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）:

使用下列步驟將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.disp到obj.conf的初始化部分。

4. 儲存變更。

5. 開啟magnus.conf進行編輯。

6. 複製開始的兩行：
   Init funcs="dispService, dispInit"
   和
   Init fn="dispInit"
   從obj.conf.disp到magnus.conf的初始化部分。

7. 儲存變更。

初始化

下表列出可使用的範例；確切的輸入值會根據您的特定網站伺服器：

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"  
...

其中：

您可以根據您的需求，將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之前，您現在必須：

• 🔗 ConfigureDispatcher
• 設定 AEM以與Dispatcher搭配使用。