44.4 設定 XML 報告

應用程式啟動器可以使用 HTTP 或 HTTPS 協定將事件資訊作為 XML 資料傳送至桌面管理應用程式報告伺服器常式 (zfdamrServlet)。該伺服器常式會處理這些訊息,並將它們新增至與 JDBC 相容的資料庫中,例如 ZENworks 隨附的 Sybase 資料庫。

若要設定 XML 報告,您需要完成以下任務:

44.4.1 滿足報告伺服器常式要求

報告伺服器常式要求以下伺服器環境之一。列出的版本號碼為最低版本要求。

表 44-1 報告伺服器常式要求

伺服器

Java 伺服器常式引擎

JVM

NetWare® 6.5 (Support Pack 1 或更新版本)

Tomcat 4.1x

Novell JVM* for NetWare 1.4.2

NetWare 6 (Support Pack 2 或更新版本) 1

Tomcat 3.3a

Novell JVM for NetWare 1.3.1

Windows Server 2003 (安裝最新服務套件)

Tomcat 3.3a

Sun JDK* 1.3.1_01

Windows 2000 (安裝最新服務套件)

Tomcat 3.3a

Sun JDK 1.3.1_01

SUSE Linux Enterprise Server (SLES) 9 SP1

Tomcat 4.1x

JVM 1.4.2 2

Novell Open Enterprise Server (Linux) 1.0

Tomcat 4.1x

JVM 1.4.2 3

1 必須為 Support Pack 2 或更新版本。沒有 Support Pack 2 或更新版本,報告伺服器常式會導致伺服器使用率跳至 100% 並會一直保持該水平。

2 ZENworks 7 中間層伺服器安裝程式已將 JVM 安裝在 SLES 9 SP1 伺服器上。

3 JVM 隨附於 Novell Open Enterprise Server 安裝程式並由其安裝。

如需有關在 NetWare 6.5 上安裝 Tomcat 的資訊,請參閱 NetWare 6.5 文件

如需有關在 NetWare 6 上安裝 Tomcat 的資訊,請參閱 NetWare 6 文件

如需有關在 Windows 2000 上安裝 Tomcat 的資訊,請參閱 Apache Tomcat 網站

OES Linux 隨附於安裝的 Tomcat。

44.4.2 在 Linux 上安裝報告伺服器常式

  1. 確保要安裝報告伺服器常式的伺服器環境滿足上一節「滿足報告伺服器常式要求」中列出的軟體要求。

  2. zfdamrServlet.war 檔案從桌面管理伺服器的 /opt/novell/zenworks/zdm/winutils/nalreporting 目錄複製到 /var/opt/novell/tomcat4/webapps

  3. 重新啟動 Tomcat,以顯示 zfdamrServlet.war 檔案的次目錄。若要在 Linux 上重新啟動 Tomcat,請在指令行上輸入 /usr/share/tomcat/bin/startup.sh

    或者

    如果您不想重新啟動 Tomcat,請使用 Tomcat 隨附的工具來顯示該檔案的次目錄。

44.4.3 在 NetWare 和 Windows 上安裝報告伺服器常式

  1. 確保要安裝報告伺服器常式的伺服器環境滿足上一節「滿足報告伺服器常式要求」中列出的軟體要求。

  2. zfdamrServlet.war 檔案從桌面管理伺服器的 sys:\public\reporting\canned\nal reports 目錄複製到 sys:\tomcat\4\webapps

  3. 重新啟動 Tomcat,以顯示 zfdamrServlet.war 檔案的次目錄。

    或者

    如果您不想重新啟動 Tomcat,請使用 Tomcat 隨附的工具來顯示該檔案的次目錄。

44.4.4 設定報告伺服器常式以與 Apache 配合使用

  1. 開啟 sys:/apache2/conf/httpd.conf 檔案。

  2. 將以下行新增至檔案的底部:

    Include sys:/public/Reporting/canned/Nal Reports/zfdamrServlet.conf

  3. 儲存 httpd.conf 檔案。

  4. 重新啟動 Apache Web 伺服器。

44.4.5 設定報告伺服器常式

報告伺服器常式需要瞭解它將向其寫入報告事件的資料庫的資訊。提供此資訊的步驟:

  1. 開啟 web.xml 檔案。該檔案位於 Tomcat webapps\zfdamrservlet\web-inf 目錄中。

  2. 如果您使用的是 Sybase 資料庫,則找到 dbip 參數,然後將參數值變更為資料庫伺服器的 IP 位址。該 IP 位址是您需要為 Sybase 資料庫修改的唯一參數。

    或者

    如果您使用的不是 Sybase 資料庫,則按資料庫的要求 (如下所述) 修改參數。如果您使用的是 Microsoft SQL 資料庫,請按 TID 10094306 中的說明進行操作。

    dbuser: 指定具有資料庫寫入存取權限的使用者名稱。不必具有讀取存取權限。預先設定的使用者名稱 (MW_DBA) 是桌面管理伺服器安裝程式建立的 Sybase 資料庫的預設讀寫使用者名稱。如果您使用的是 ZENworks Sybase 資料庫且未變更預設讀寫使用者名稱,則不需要修改此參數。

    dbpasswd: 為在 dbuser 參數中指定的使用者名稱指定密碼。預先設定的密碼 (novell) 是桌面管理伺服器安裝程式建立的 Sybase 資料庫的預設讀寫使用者的密碼。如果您使用的是 ZENworks Sybase 資料庫且未變更預設讀寫使用者的密碼,則不需要修改此參數。

    dbip: 指定執行該資料庫的伺服器 IP 位址。

    dbport: 指定該資料庫偵聽的連接埠。預先設定的連接埠 (2638) 是桌面管理伺服器安裝程式建立的 Sybase 資料庫的預設 NetWare 伺服器連接埠。如果您使用的是安裝在 NetWare 上的 ZENworks Sybase 資料庫且未變更預設連接埠,則不需要修改此參數。

    dbprotocol: 指定存取資料庫時要使用的協定。對於 Sybase,此為 jdbc: (預先設定的值)。

    dbsubprotocol: 指定存取資料庫時要使用的子協定。對於 Sybase,此為 sybase: (預先設定的值)。

    dbsubname: 指定存取資料庫時要使用的子名稱。對於 Sybase,此為 Tds: (預先設定的值)。

    dbdriver: 指定存取資料庫時要使用的驅動程式的完整類別。驅動程式必須支援 dbprotocol 參數中列出的協定。對於 Sybase,此為 com.sybase.jdbc2.jdbc.SybDriver (預先設定的值)。

  3. 儲存檔案。

  4. 重新啟動 Tomcat。

44.4.6 啟用 XML 目標規則

在應用程式啟動器可以透過 XML 報告應用程式事件之前,您需要:

  • 在 ConsoleOne 中,在服務位置套件中啟用 XML 目標規則。XML 目標規則會識別 XML 資料要傳送至的 Web 位置 (URL)。如果您使用的是應用程式管理報告伺服器常式,則此為該伺服器常式的 URL。服務位置套件只能有一條 XML 目標規則。如果您尚未建立服務位置套件,或目前套件的 XML 目標規則正用於指定其他位置,則需要建立新服務位置套件。下列步驟中將提供說明。
  • 將服務位置套件與使用者或工作站 (您要將其報告傳送至 Web URL) 所在的容器相關聯。

啟用 XML 目標規則並將其與容器相關聯的步驟:

  1. 在 ConsoleOne 中,於要使用的服務位置套件上按一下滑鼠右鍵,然後按一下「內容」。

    或者

    如果您沒有服務位置套件,請於要建立此套件的容器上按一下滑鼠右鍵,按一下「新建」,然後按一下「規則套件」。遵循「規則套件精靈」中所提供的指示,建立一個「服務位置套件」。

    「一般規則」頁。
  2. 在「一般」頁上,選取「已啟用」欄中的方塊以啟用 XML 目標規則。

  3. 選取清單中的「XML 目標規則」,然後按一下「內容」以顯示「XML 目標」內容頁。

    「XML 目標」頁。
  4. 按一下「新增」以顯示「XML URL」對話方塊,輸入要將 XML 資料傳送至的 URL,然後按一下「確定」以將 URL 新增至清單中。

    URL 需要包含連接埠號碼,依預設,在 Windows 或 NetWare 上是連接埠 8080,在 OES Linux 和 SLES 上是 8180。此連接埠是這些環境中的預設 Tomcat 連接埠,並且是 XML 報告的服務位置套件尋找 Tomcat 上執行的 zfdamrServlet 所必需的。

    Windows 或 NetWare 上報告伺服器常式的 URL 是:

    http://ip_address:8080/zfdamrServlet/run
    

    而 Linux (OES Linux 或 SLES) 上報告伺服器常式的 URL 是:

    http://ip_address:8180/zfdamrServlet/run
    

    其中 ip_address 是執行報告伺服器常式的伺服器 IP 位址或 DNS 主機名稱。

  5. 重複步驟 4,以新增其他 URL。

  6. 新增完 URL 之後,按一下「確定」以返回「一般」頁。

  7. 按一下「關聯」以顯示「關聯」頁。

    服務位置套件「關聯」頁。

    使用此頁將服務位置套件與使用者或工作站 (您要將其 XML 報告傳送至 Web URL) 所在的容器相關聯。如果父容器中包含使用者和工作站物件所在的數個容器,則可以選取父容器,而不必分別選取個別容器。

  8. 按一下「新增」,瀏覽要新增的容器並將其選取,然後按一下「確定」,以將其新增至清單。

  9. 重複步驟 8,以新增其他容器。

  10. 新增完容器之後,按一下「確定」以儲存資訊。

44.4.7 設定應用程式物件以使用 XML 報告

啟用 XML 目標規則後,您可以開始設定應用程式物件以使用 XML 報告。由於事件報告是根據每個應用程式來設定的,因此您可以選擇要為哪些應用程式收集事件報告,不要為哪些應用程式收集事件報告。

如需有關設定應用程式以使用 XML 報告的詳細說明,請參閱節 44.5, 設定應用程式以使用報告