Einrichten der XML-Berichte

Application Launcher kann über das HTTP- oder HTTPS-Protokoll Ereignisinformationen als XML-Daten an das Anwendungs-Berichte-Servlet von Desktop Management (zfdamrServlet) senden. Das Servlet verarbeitet die Nachrichten und fügt diese einer JDBC-kompatiblen Datenbank hinzu, beispielsweise der Sybase-Datenbank von ZENworks.

Um XML-Berichte einzurichten, müssen Sie folgende Aufgaben ausführen:


Erfüllen der Anforderungen für das Berichte-Servlet

Das Berichte-Servlet benötigt eine der folgenden Serverumgebungen. Die aufgelisteten Versionsnummern sind die mindestens erforderlichen Versionen.

Server Java Servlet Engine JVM

NetWare 6 (Support Pack 2 oder höher) 1

Tomcat 3.3a

Novell JVM* for NetWare 1.3.1

Windows 2000 (mit aktuellem Service Pack)

Tomcat 3.3a

Sun JDK 1.3.1_01

1Support Pack 2 oder höher ist erforderlich. Ohne Support Pack ab Version 2 bewirkt das Berichte-Servlet, dass die Serverauslastung dauerhaft bei 100% verbleibt.

Informationen zur Installation von Tomcat unter NetWare 6 finden Sie in der Dokumentation zu NetWare 6.

Informationen zur Installation von Tomcat unter Windows 2000 finden Sie auf der Website von Apache Tomcat.


Installieren des Berichte-Servlet

  1. Vergewissern Sie sich, dass die Serverumgebung, in der Sie das Berichte-Servlet installieren, den Software-Anforderungen entspricht, die im vorherigen Abschnitt Erfüllen der Anforderungen für das Berichte-Servlet genannt werden.

  2. Kopieren Sie die Datei zfdamrServlet.war aus dem Verzeichnis sys:\public\reporting\canned\nal reports auf dem Desktop Management-Server in das Verzeichnis Tomcat webapps.

    Diese Datei ist ebenfalls im Verzeichnis zenworks\products\appmgmt\nal der ZENworks 6.5 Desktop Management-CD enthalten.

  3. Starten Sie Tomcat neu, um die Datei zfdamrServlet.war zu erweitern.

    oder

    Wenn Sie Tomcat nicht neu starten möchten, verwenden Sie die Werkzeuge von Tomcat, um die Datei zu erweitern.


Konfigurieren des Berichte-Servlet

Das Berichte-Servlet benötigt die Informationen zu der Datenbank, in die die Berichtsereignisse geschrieben werden. So stellen Sie diese Informationen bereit:

  1. Öffnen Sie die Datei web.xml. Die Datei befindet sich im Verzeichnis Tomcat webapps\zfdamrservlet\web-inf.

  2. Wenn Sie eine Sybase-Datenbank verwenden, wechseln Sie zum Parameter "dbip" und ändern den Parameterwert in die IP-Adresse des Datenbankservers. Die IP-Adresse ist der einzige Parameter, den Sie für eine Sybase-Datenbank ändern müssen.

    oder

    Wenn Sie keine Sybase-Datenbank verwenden, ändern Sie die Parameter für Ihre Datenbank entsprechend der unten angegebenen Beschreibung. Wenn Sie eine Microsoft SQL-Datenbank verwenden, befolgen Sie die Anweisungen in TID 10094306.

    dbuser: Geben Sie einen Benutzernamen an, der über Schreibzugriff auf die Datenbank verfügt. Es ist kein Lesezugriff erforderlich. Der vorkonfigurierte Benutzername (MW_DBA) ist der Standardbenutzername mit Lese-/Schreibzugriff auf die Sybase-Datenbank, die vom Desktop Management Server-Installationsprogramm erstellt wurde. Wenn Sie die Sybase-Datenbank von ZENworks verwenden und den Standardbenutzernamen mit Lese-/Schreibzugriff nicht geändert haben, müssen Sie diesen Parameter nicht ändern.

    dbpasswd: Geben Sie das Passwort für den im Parameter "dbuser" angegebenen Benutzernamen an. Das vorkonfigurierte Passwort (novell) ist das Standardpasswort mit Lese-/Schreibzugriff auf die Sybase-Datenbank, die vom Desktop Management Server-Installationsprogramm erstellt wurde. Wenn Sie die Sybase-Datenbank von ZENworks verwenden und das Standardpasswort mit Lese-/Schreibzugriff nicht geändert haben, müssen Sie diesen Parameter nicht ändern.

    dbip: Geben Sie die IP-Adresse des Servers an, auf dem die Datenbank ausgeführt wird.

    dbport: Geben Sie den Anschluss an, den die Datenbank überwacht. Der vorkonfigurierte Anschluss (2638) ist der Standardanschluss des NetWare-Servers für die Sybase-Datenbank, die vom Desktop Management Server-Installationsprogramm erstellt wurde. Wenn Sie die unter NetWare installierte Sybase-Datenbank von ZENworks verwenden und den Standardanschluss nicht geändert haben, müssen Sie diesen Parameter nicht ändern.

    dbprotocol: Geben Sie das Protokoll für den Zugriff auf die Datenbank an. Bei Sybase handelt es sich um "jdbc:" (der vorkonfigurierte Wert).

    dbsubprotocol: Geben Sie das Unterprotokoll für den Zugriff auf die Datenbank an. Bei Sybase handelt es sich um "sybase:" (der vorkonfigurierte Wert).

    dbsubname: Geben Sie den Unternamen für den Zugriff auf die Datenbank an. Bei Sybase handelt es sich um "Tds:" (vorkonfigurierter Wert).

    dbdriver: Geben Sie die vollständige Klasse des Treibers für den Zugriff auf die Datenbank an. Der Treiber muss das Protokoll unterstützen, das im Parameter "dbprotocol" angegeben ist. Bei Sybase handelt es sich um "com.sybase.jdbc2.jdbc.SybDriver" (der vorkonfigurierte Wert).

  3. Speichern Sie die Datei.

  4. Starten Sie Tomcat neu.


Aktivieren der Richtlinie für XML-Ziele

Bevor Application Launcher XML-Berichte für Anwendungsereignisse erstellen kann, müssen folgende Vorgänge ausgeführt werden:

So aktivieren Sie eine Richtlinie für XML-Ziele und verknüpfen sie mit Containern:

  1. Klicken Sie in ConsoleOne mit der rechten Maustaste auf das gewünschte Servicestandortpaket und klicken Sie auf "Eigenschaften".

    oder

    Wenn Sie über kein Servicestandortpaket verfügen, klicken Sie mit der rechten Maustaste auf den Container, in dem Sie ein Paket erstellen möchten, klicken Sie auf "Neu" und dann auf "Richtlinienpaket". Folgen Sie den Anweisungen, die im Richtlinienpaketassistenten enthalten sind, um ein Servicestandortpaket zu erstellen.


    Seite für allgemeine Richtlinien
  2. Zum Aktivieren der Richtlinie für XML-Ziele aktivieren Sie auf der Seite "Allgemein" das entsprechende Kontrollkästchen in der Spalte "Aktiviert".

  3. Zum Anzeigen der Eigenschaftsseite für die XML-Ziele wählen Sie die Richtlinie für XML-Ziele in der Liste aus und klicken Sie auf "Eigenschaften".


    Seite für XML-Ziele
  4. Zum Anzeigen des Dialogfelds "XML-URL" klicken Sie auf "Hinzufügen". Geben Sie die URL ein, an die die XML-Daten gesendet werden sollen, und klicken Sie auf "OK", um die URL zur Liste hinzuzufügen.

    Die URL für das Berichte-Servlet lautet:

    http://IP_Adresse/zfdamrServlet/run

    IP_Adresse ist die IP-Adresse oder der DNS-Hostname des Servers, auf dem das Berichte-Servlet ausgeführt wird.

  5. Wiederholen Sie Schritt 4, um weitere URLs hinzuzufügen.

  6. Wenn Sie alle URLs hinzugefügt haben, klicken Sie auf "OK", um zur Seite "Allgemein" zurückzukehren.

  7. Zum Anzeigen der Seite "Verknüpfungen" klicken Sie auf "Verknüpfungen".


    Seite "Verknüpfungen" für das Servicestandortpaket

    Auf dieser Seite verknüpfen Sie das Servicestandortpaket mit den Containern, in denen sich die Benutzer bzw. Arbeitsstationen befinden, deren XML-Berichte an die Web-URL gesendet werden sollen. Wenn ein übergeordneter Container verschiedene Container enthält, in denen sich Benutzerobjekte und Arbeitsstationsobjekte befinden, können Sie den übergeordneten Container anstelle der individuellen Container auswählen.

  8. Klicken Sie auf "Hinzufügen", markieren Sie ein Anwendungsobjekt und klicken Sie auf "OK". Das Objekt wird zur Anwendungsliste hinzugefügt.

  9. Wiederholen Sie Schritt 8, um weitere Container hinzuzufügen.

  10. Wenn Sie alle Container hinzugefügt haben, klicken Sie auf "OK", um die Informationen zu speichern.


Konfigurieren von Anwendungsobjekten für XML-Berichte

Nachdem Sie die Richtlinie für XML-Ziele aktiviert haben, können Sie damit beginnen, die Anwendungsobjekte für XML-Berichte zu konfigurieren. Da Ereignisberichte in Abhängigkeit von der Anwendung konfiguriert werden, können Sie festlegen, für welche Anwendungen die Ereignisberichte gesammelt werden sollen.

Detaillierte Anweisungen zum Konfigurieren von Anwendungen für XML-Berichte finden Sie unter Konfigurieren von Anwendungsobjekten für Berichte.