44.4 XMLを使用するレポート機能のセットアップ

Application LauncherはHTTPまたはHTTPSプロトコルを使用して、イベント情報をXMLデータとしてDesktop Management Application Reportingサーブレット(zfdamrServlet)に送信できます。サーブレットはメッセージを処理して、ZENworksに同梱されているSybaseデータベースなどのJDBC対応データベースに追加します。

XMLを使用するレポート機能をセットアップするには、次の作業を実行します。

44.4.1 Reportingサーブレットの要件を満たす

Reportingサーブレットを使用するには、次のいずれかのサーバ環境が必要です。表示されているバージョン番号は最低限のバージョン要件です。

表 44-1 Reportingサーブレットの要件

サーバ

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 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またはそれ以降が適用されていない場合、Reportingサーブレットのサーバ利用率は100%に上昇して、そのまま変わりません。

2 JVMは、ZENworks 7 Middle Tier ServerのインストールプログラムによってSLES 9 SP1サーバにインストールされます。

3 JVMは、Novell Open Enterprise Serverに同梱され、Novell Open Enterprise Serverのインストールプログラムによってインストールされます。

NetWare 6.5へのTomcatのインストールについては、NetWare 6.5のマニュアルを参照してください。

NetWare 6へのTomcatのインストールについては、NetWare 6のマニュアルを参照してください。

Windows 2000へのTomcatのインストールについては、Apache TomcatのWebサイトを参照してください。

OES LinuxはTomcatをインストールした状態で出荷されます。

44.4.2 LinuxへのReportingサーブレットのインストール

  1. Reportingサーブレットをインストールするサーバ環境が、前の節(Reportingサーブレットの要件を満たす)に表示されたソフトウェア要件を満たしていることを確認します。

  2. Desktop Managementサーバの/opt/novell/zenworks/zdm/winutils/nalreportingディレクトリから/var/opt/novell/tomcat4/webappszfdamrServlet.warファイルをコピーします。

  3. Tomcatを再起動して、zfdamrServlet.warファイルを展開します。LinuxでTomcatを再起動するには、コマンドラインで「/usr/share/tomcat/bin/startup.sh」と入力します。

    または

    Tomcatを再起動しない場合は、Tomcatに同梱されているツールを使用して、ファイルを展開します。

44.4.3 NetWareまたはWindowsへのReportingサーブレットのインストール

  1. Reportingサーブレットをインストールするサーバ環境が、前の節(Reportingサーブレットの要件を満たす)に表示されたソフトウェア要件を満たしていることを確認します。

  2. Desktop Managementサーバのsys:\public\reporting\canned\nalレポートディレクトリからsys:\tomcat\4\webappszfdamrServlet.warファイルをコピーします。

  3. Tomcatを再起動して、zfdamrServlet.warファイルを展開します。

    または

    Tomcatを再起動しない場合は、Tomcatに同梱されているツールを使用して、ファイルを展開します。

44.4.4 Apacheで使用するReportingサーブレットの設定

  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 Reportingサーブレットの設定

Reportingサーブレットでは、レポートイベントの書き込み先のデータベースに関する情報が必要です。この情報を指定するには、次の手順に従います。

  1. web.xmlファイルを開きます。このファイルはTomcatのwebapps\zfdamrservlet\web-infディレクトリにあります。

  2. Sybaseデータベースを使用している場合は、dbipパラメータを検索して、パラメータの値をデータベースサーバのIPアドレスに変更します。Sybaseデータベースの場合、変更する必要があるパラメータはIPアドレスだけです。

    または

    Sybase以外のデータベースを使用している場合は、使用するデータベースに合わせて、下で説明するパラメータを変更します。Microsoft SQLデータベースを使用している場合は、TID 10094306の説明に従ってください。

    dbuser: データベースへの書き込みアクセス権を持つユーザ名を指定します。読み取りアクセス権は必要ありません。設定済みのユーザ名(MW_DBA)は、Desktop Management Serverインストールプログラムによって作成されるSybaseデータベースに対するデフォルトの読み書き可能ユーザ名です。ZENworks Sybaseデータベースを使用していて、デフォルトの読み書き可能ユーザ名を変更していない場合は、このパラメータを変更する必要はありません。

    dbpasswd: dbuserパラメータで指定したユーザ名に対するパスワードを指定します。設定済みのパスワード(novell)は、Desktop Management Serverインストールプログラムによって作成されるSybaseデータベースに対するデフォルトの読み書き可能ユーザのパスワードです。ZENworks Sybaseデータベースを使用していて、デフォルトの読み書き可能ユーザのパスワードを変更していない場合は、このパラメータを変更する必要はありません。

    dbip: データベースを実行しているサーバのIPアドレスを指定します。

    dbport: データベースがリッスンしているポートを指定します。設定済みのポート(2638)は、Desktop Management Serverインストールプログラムによって作成される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ターゲットポリシーの有効化

Application LauncherでXMLを使用してアプリケーションイベントをレポートできるようにするには、次の作業を実行します。

  • ConsoleOneで、SLPのプロパティパッケージのXMLターゲットポリシーを有効にします。XMLターゲットポリシーは、XMLデータの送信先になるWebの場所(URL)を識別します。アプリケーション管理Reportingサーブレットを使用している場合は、そのサーブレットのURLです。SLPのプロパティパッケージにはXMLターゲットポリシーを1つしか含めることができません。SLPのプロパティパッケージをまだ作成していない、または現在のパッケージのXMLターゲットポリシーが他の場所を指定するのに使用されている場合は、SLPのプロパティパッケージを新しく作成する必要があります。手順については、次で説明します。
  • Web URLに送信されるレポートの対象になるユーザまたはワークステーションが配置されているコンテナとSLPのプロパティパッケージを関連付けます。

XMLターゲットポリシーを有効にして、コンテナと関連付けるには

  1. ConsoleOneで、使用するSLPのプロパティパッケージを右クリックし、[プロパティ]をクリックします。

    または

    SLPのプロパティパッケージがない場合は、新しいパッケージを作成するコンテナを右クリックし、[新規]>[ポリシーパッケージ]の順にクリックします。ポリシーパッケージウィザードに従って、SLPのプロパティパッケージを作成します。

    [一般ポリシー]ページ
  2. [一般]ページで、[使用可能]列のチェックボックスを選択し、[XMLターゲット]ポリシーを有効にします。

  3. リストから[XMLターゲット]ポリシーを選択し、[プロパティ]をクリックして、[XMLターゲット]プロパティページを表示します。

    [XMLターゲット]ページ
  4. [追加]をクリックして[XML URL]ダイアログボックスを表示します。XMLデータの送信先のURLを入力して[OK]をクリックすると、入力したURLがリストに追加されます。

    URLにはポート番号が含まれている必要があります。デフォルトでは、WindowsまたはNetWareではポート8080、およびOES LinuxおよびSLESではポート8180です。これらの環境ではこのポートはデフォルトのTomcatポートであり、XMLレポーティングのService Location Policyが、Tomcat上で実行されているzfdamrServletを検索するために必要です。

    WindowsまたはNetWare上のReportingサーブレットのURLは次のとおりです。

    http://ip_address:8080/zfdamrServlet/run
    

    Linux (OES LinuxまたはSLES)のReportingサーブレットのURLは次のとおりです。

    http://ip_address:8180/zfdamrServlet/run
    

    ここで、ip_addressは、Reportingサーブレットが実行されているサーバのIPアドレスまたはDNSホスト名です。

  5. ステップ 4を繰り返して、さらにURLを追加します。

  6. URLを追加し終わったら、[OK]をクリックして[一般]ページに戻ります。

  7. [関連付け]をクリックして[関連付け]ページを表示します。

    SLPのプロパティパッケージの[関連付け]ページ

    このページを使用して、Web URLに送信するXMLレポートの対象になるユーザまたはワークステーションが配置されているコンテナにSLPのプロパティパッケージを関連付けます。ユーザオブジェクトおよびワークステーションオブジェクトが配置されているコンテナがペアレントコンテナに複数含まれている場合は、各コンテナを選択する代わりに、ペアレントコンテナを選択することができます。

  8. [追加]をクリックし、追加するコンテナを参照して選択します。[OK]をクリックして、選択したコンテナをリストに追加します。

  9. ステップ 8を繰り返して、さらにコンテナを追加します。

  10. コンテナを追加し終わったら、[OK]をクリックして情報を保存します。

44.4.7 XMLを使用したレポート機能を実現するためのアプリケーションオブジェクトの設定

XMLターゲットポリシーを有効にしたら、XMLレポート機能を使用するためにアプリケーションオブジェクトを設定できます。イベントのレポート機能はアプリケーションごとに設定します。したがって、イベントのレポートを収集するアプリケーションと、収集しないアプリケーションを選択できます。

XMLレポート機能を使用するためにアプリケーションを設定する方法については、セクション 44.5, レポート機能を使用するためのアプリケーションの設定を参照してください。