RedHat Linux或Sun Solaris上的JBoss、Tomcat和WebLogic伺服器

有關在RedHat Linux 7.x或更高版本、Sun Solaris SPARC 2.6或更高版本或Sun Solaris x86 9或更高版本上運行的J2EE實施安裝和配置感測器的詳細說明。

感測器的程式檔案將打包在您從Adobe下載站點獲得的安裝檔案中。 如果您尚未擁有特定Web伺服器的感測器安裝檔案，請先下載該檔案（或從Adobe代表處獲取），然後開始執行以下步驟。

支援的J2EE實作包括：

• JBoss Server 3.2.x或更新版本
• Apache Jakarta Tomcat Server 4.1或更新版本
• WebLogic Server 6.x或更新版本

要安裝和配置感測器，必須執行以下步驟：

安裝程式檔案

解壓並安裝感測器程式檔案的過程。

1. 以root用戶或具有root權限的用戶身份登錄。

2. 使用以下命令解壓縮安裝檔案並解壓縮：

   • 在Linux上：

     tar -zxf installationFilename.tar.gz
     

   • 在Solaris上：

     unzip -d installationFilename.tar.gz 
      tar -xf installationFilename.tar
     

3. 將解壓縮的程式檔案複製到下表中標識的目錄：

程式檔案的權限

編輯感測器配置檔案

該文 txlogd.conf 件包含感測器的配置參數。

您必須編輯此檔案，以指定磁碟隊列檔案的大小和位置、Insight Server的地址以及將附加到此感測器生成的事件資料的ID等。

配置檔案包含必需參數和可選參數。

• 必要參數 是安裝感測器時必須指定的設定。 沒有這些設定，感測器無法成功運行。
• 可選參數 ，是預設為預先定義值（您可修改）或啟用可選功能的設定。

編輯感測器配置檔案

• 在文字 /etc/txlogd.conf 編輯器中開啟檔案，並設定所需參數以及任何所需的選用參數。
• 儲存並關閉檔案。

編輯感測器配置檔案

1. 在文字 /etc/txlogd.conf 編輯器中開啟檔案，並設定所需參數以及任何所需的選用參數。
2. 儲存並關閉檔案。

啟動發射器並建立磁碟隊列

配置txlogd.conf檔案後，可以啟動發射器程式，將其註冊為Windows服務，並建立磁碟隊列。

1. 如果磁碟隊列所在的目錄尚不存在，請建立該目錄。 確保目錄為收集器模組和發射器程式提供對檔案的讀／寫訪問。

   有關磁碟隊列檔案所需權限的詳細資訊，請參見Sensor UNIX File Permissions。

2. 在安裝感測器的電腦上，執行以下命令以啟動發射器：

   /usr/local/bin/txlogd -ic -f /etc/txlogd.conf
   

   • 此命令中的"i"選項以"互動式模式"啟動發射器。此模式在螢幕上顯示發射器消息，還允許您使用鍵盤命令與發射器交互。
   • "c"選項指示發射器建立磁碟隊列。
   • "f"選項指定配置檔案的位置。

   有關啟動發射器時可使用的選項的詳細資訊，請參閱感測器發射器命令行選項。

3. 驗證發射器是否已在QueueFile參數中指定的位置和QueueSize參數中指定的大小中建立磁碟隊列。

4. 如果未正確建立隊列，請鍵入Ctrl+C以終止發射器，然後執行以下操作：

   1. 檢查txtlogd.conf檔案並驗證QueueFile和QueueSize參數設定正確。
   2. 檢查分配了磁碟隊列的設備是否工作，並且有足夠的空間容納QueueSize參數中指定的大小的檔案。
   3. 進行任何必要的更正並重複此步驟。

將收集器添加到Web伺服器

對於Apache伺服器，收集器是一個動態共用對象，您將其載入到Web伺服器進程中。

要將收集器添加到Web伺服器，必須按照下面所述編 httpd.conf 輯檔案並重新啟動Web伺服器。

1. 使用文本編輯器開啟Sensor httpd.conf捕獲事件的Web伺服器的檔案。

2. 將下列元素 <filter> 和元 <filter-mapping> 素添加到描述符檔案中。 如果您未在/etc目錄中安裝txlogd.conf，則需要在元素中輸入此檔案的正確路 <param-value> 徑：

   <filter>
     <filter-name>VSCollectorFilter</filter-name> 
     <description></description> 
     <filter-class> 
         com.visualsciences.collector.VSCollectorFilter 
       </filter-class> 
     <init-param> 
       <param-name>configPath</param-name> 
       <param-value>/etc/txlogd.conf</param-value> 
     <description></description> 
     </init-param> 
   </filter> 
   
   <filter-mapping> 
     <filter-name>VSCollectorFilter</filter-name> 
     <url-pattern>/*</url-pattern> 
   </filter-mapping> 
   

   注意

   這些行區分大小寫。 請依上方顯示的方式輸入。

3. 重新啟動Web伺服器進程（您不必重新啟動整個伺服器電腦，只需重新啟動Web伺服器進程）。 收集器隨Web伺服器載入，開始收集事件資料並將其寫入磁碟隊列。

測試感測器

驗證收集器是否正在收集事件資料，而傳送器正在將它傳送至目標Insight Server。

1. 如果發射器尚未運行，請使用以下命令重新啟動它：

   /usr/local/bin/txlogd -i -f /etc/txlogd.conf 
   

2. 開啟瀏覽器（在任何電腦上），並從運行感測器的Web伺服器請求一個頁面（請務必選擇感測器監視的頁面）。

3. 在您發出請求後，請檢查傳送器的主控台，以取得指出傳送事件資料至目標Insight伺服器的訊息。

4. 如果感測器未成功傳輸資料，請驗證：

   • 目標Insight伺服器正在執行。
   • 在txtlogd.conf中可以正確設定ServerAddress和ServerPort參數。 如果您使用伺服器名稱指定ServerAddress，請改用其數值IP位址。
   • CertName參數的值與目標Insight Server的數位憑證上顯示的公用名稱完全相符。

將發射器添加到系統啟動指令碼

有關自動將發射器載入到系統啟動指令碼的資訊。

為確保發射器在Web伺服器電腦重新啟動時自動載入，請將以下命令（將啟動發射器）添加到系統啟動指令碼：

/usr/local/bin/txlogd -f /etc/txlogd.conf

此命令將發射器作為守護程式啟動。 發送器生成的操作和錯誤消息被寫入 syslog。

預設的Solaris設定為60。 根據使用Sensor（每個例項使用三個信號）進行的測試，Adobe建議您使用1024做為設定。 此數量足夠高，感測器可以與伺服器上任何其他可能需要信號的應用程式一起運行，但不會影響效能。 為支援此建議，請注意，Adrian Cockcroft在其《Sun Performance and Tuning》一書（Prentice Hall,1994年10月）中指出：「資料庫通常會使用大量共用記憶體和訊號量設定。 這些不會影響效能；只要它們足夠大，程式就會運行。」

擷取其他資料

所有平台的感測器都可以收集HTTP請求和回應標頭中可用的任何資料。

J2EE平台的Sensors提供了收集其他平台無法使用的資料的機制。 J2EE平台的收集器（J2EE收集器）位於應用程式層，可讓它收集僅適用於應用程式且不應透過頁面標籤或標題公開的敏感資料。

例如，J2EE收集器可用來擷取頁面上所顯示連結的每次點按成本(CPC)資料、頁面上的敏感合作夥伴資訊，以及許多其他資料點。 J2EE環境可讓您輕鬆修改WEBAPP，以使用我們的收集器類別擷取此自訂資料。

當J2EE平台的感測器收到請求時，它會叫用匯入appendToLog函式的收集器類別。 appendToLog函式會附加至初始請求中appendToLog函式中指定的查詢字串參數。 這會導致初始請求的URI包含與所擷取資料的名稱和值相對應的其他查詢字串名稱——值配對。 例如，當特定廣告位置或點進連結的值為20美分時，CPC=20會附加至初始請求。 Insight Server會將這些值處理至資料集以進行分析。 此收集方法的另一個好處是，它允許收集其他資料，而不會建立額外的記錄項目，就像使用頁面標籤方法所建立的一樣。

如需處理的詳細資訊，請參閱資料集設定指南。

若要從頁面擷取其他資料

1. 將下列程式碼新增至您要擷取資料的。jsp頁面頂端：

   <%@ page import="com.visualsciences.collector.VSCollector" %>
   

2. 使用收集器對象的appendToLog()方法，將所需的名稱——值對附加到請求的。jsp頁的查詢字串。 下列範例會將"A=1"和"B=2"附加至所要求。jsp頁面的/index.jsp頁面查詢字串：

   <html> 
   <body> 
     <h1>Hello World</h1> 
     <% 
       VSCollector collector = new VSCollector(request, response); 
       collector.appendToLog("A", "1"); 
       collector.appendToLog("B", "2"); 
     %> 
   </body> 
   </html>
   

   產生的請求URI為/index.jsp?A=1&B=2。

3. 對要從中捕獲其他資料的每個。jsp頁重複此過程。