Novell Documentation: ZENworks 7 - Einrichten der XML-Berichte

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

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

Tabelle 44-1 Anforderungen für das Berichte-Servlet

Server	Java Servlet Engine	JVM
NetWare® 6.5 (Support Pack 1 oder höher)	Tomcat 4.1x	Novell JVM^* for NetWare 1.4.2
NetWare 6 (Support Pack 2 oder höher) ¹	Tomcat 3.3a	Novell JVM for NetWare 1.3.1
Windows Server 2003 (mit aktuellem Service Pack)	Tomcat 3.3a	Sun JDK^* 1.3.1_01
Windows 2000 (mit aktuellem Service Pack)	Tomcat 3.3a	Sun JDK 1.3.1_01
SUSE Linux Enterprise Server (SLES) 9 SP 1	Tomcat 4.1x	JVM 1.4.2²
Novell Open Enterprise Server (Linux) 1.0	Tomcat 4.1x	JVM 1.4.2³

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

²JVM wird durch das Installationsprogramm von ZENworks 7 Middle Tier Server auf dem Server unter SLES 9 SP1 installiert.

³ Die JVM ist im Lieferumfang von Novell Open Enterprise Server enthalten und wird durch das zugehörige Installationsprogramm installiert.

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

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.

Tomcat ist im Lieferumfang von OES Linux enthalten und bereits installiert.

44.4.2 Installieren des Berichte-Servlet unter Linux

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.
Kopieren Sie die Datei zfdamrServlet.war aus dem Verzeichnis /opt/novell/zenworks/zdm/winutils/nalreporting auf dem Desktop Management-Server in das Verzeichnis /var/opt/novell/tomcat4/webapps.
Starten Sie Tomcat neu, um die Datei zfdamrServlet.war zu erweitern. Geben Sie zum Neustart von Tomcat unter Linux in der Befehlszeile Folgendes ein: /usr/share/tomcat/bin/startup.sh.

oder

Wenn Sie Tomcat nicht neu starten möchten, verwenden Sie zum Erweitern der Datei die Werkzeuge von Tomcat.

44.4.3 Installieren des Berichte-Servlet unter NetWare und Windows

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.
Kopieren Sie die Datei zfdamrServlet.war aus dem Verzeichnis sys:\public\reporting\canned\nal auf dem Desktop Management-Server in das Verzeichnis sys:\tomcat\4\webapps.
Starten Sie Tomcat neu, um die Datei zfdamrServlet.war zu erweitern.

oder

Wenn Sie Tomcat nicht neu starten möchten, verwenden Sie zum Erweitern der Datei die Werkzeuge von Tomcat.

44.4.4 Konfigurieren des Berichte-Servlet für die Verwendung mit Apache

Öffnen Sie die Datei sys:/apache2/conf/httpd.conf.
Fügen Sie am Ende der Datei die folgende Zeile hinzu:

Include sys:/public/Reporting/canned/Nal Reports/zfdamrServlet.conf
Speichern Sie die Datei httpd.conf.
Starten Sie Apache Web Server neu.

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

Öffnen Sie die Datei web.xml. Die Datei befindet sich im Tomcat-Verzeichnis webapps\zfdamrservlet\web-inf.
Wenn Sie eine Sybase-Datenbank verwenden, wechseln Sie zum Parameter dbip und ändern den Parameterwert auf 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 MicrosoftSQL-Datenbank verwenden, befolgen Sie die Anweisungen im Artikel TID 10094306.

dbuser: Geben Sie den Namen eines Benutzers 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 ist dies "jdbC:" (der vorkonfigurierte Wert).

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

dbsubname: Geben Sie den Unternamen für den Zugriff auf die Datenbank an. Bei Sybase ist dies "Tds:" (der vorkonfigurierte 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 ist dies com.sybase.jdbc2.jdbc.SybDriver (der vorkonfigurierte Wert).
Speichern Sie die Datei.
Starten Sie Tomcat neu.

44.4.6 Aktivieren der Richtlinie für XML-Ziele

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

Aktivieren Sie in ConsoleOne eine Richtlinie für XML-Ziele in einem Servicestandortpaket. Die Richtlinie für XML-Ziele identifiziert die Webstandorte (URLs), an die XML-Daten gesendet werden sollen. Wenn Sie das Berichte-Servlet der Anwendungsverwaltung verwenden, handelt es sich hierbei um die URL für das Servlet. Ein Servicestandortpaket kann jeweils nur eine Richtlinie für XML-Ziele verwenden. Wenn Sie kein Servicestandortpaket erstellt haben oder die Richtlinien für XML-Ziele der aktuellen Pakete für die Angabe anderer Standorte verwendet werden, müssen Sie ein neues Servicestandortpaket erstellen. Anweisungen finden Sie in den unten angegebenen Schritten.
Verknüpfen Sie das Servicestandortpaket mit den Containern, in denen sich die Benutzer bzw. Arbeitsstationen befinden, deren Berichte an die Web-URL gesendet werden sollen.

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

Klicken Sie in ConsoleOne mit der rechten Maustaste auf das gewünschte Servicestandortpaket und klicken Sie dann 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 dann auf Neu und anschließend auf Richtlinienpaket Folgen Sie zum Erstellen eines Servicestandortpakets den Anweisungen des Richtlinienpaketassistenten.
Markieren Sie zum Aktivieren der Richtlinie für XML-Ziele auf der Seite "Allgemein" das entsprechende Kontrollkästchen in der Spalte Aktiviert.
Wählen Sie zum Anzeigen der Eigenschaftsseite für die XML-Ziele die Richtlinie für XML-Ziele in der Liste aus und klicken Sie anschließend auf Eigenschaften.
Klicken Sie auf Hinzufügen, um das Dialogfeld "XML-URL" anzuzeigen. 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 muss die Anschlussnummer enthalten. Standardmäßig ist dies unter Windows oder NetWare Anschluss 8080 und unter OES Linux und SLES Anschluss 8180. In diesen Umgebungen ist dieser Anschluss der Standardanschluss für Tomcat und wird von der Servicestandort-Richtlinie für XML-Berichte für die Suche nach dem zfdamrServlet verwendet, das unter Tomcat ausgeführt wird.

Beispiel für die URL für das Berichte-Servlet unter Windows oder NetWare:
```
http://IP_Adresse:8080/zfdamrServlet/run
```
Beispiel für die URL für das Berichte-Servlet unter Linux (OES Linux oder SLES):
```
http://IP_Adresse:8180/zfdamrServlet/run
```
IP-Adresse ist die IP-Adresse oder der DNS-Hostname des Servers, auf dem das Berichte-Servlet ausgeführt wird.
Wiederholen Sie Schritt 4, um weitere URLs hinzuzufügen.
Wenn Sie alle URLs hinzugefügt haben, klicken Sie auf OK, um zur Seite "Allgemein" zurückzukehren.
Klicken Sie zum Anzeigen der Seite "Verknüpfungen" auf Verknüpfungen.

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 Benutzer- und Arbeitsstationsobjekte befinden, können Sie den übergeordneten Container anstelle der individuellen Container auswählen.
Klicken Sie auf Hinzufügen, markieren Sie ein Anwendungsobjekt und klicken Sie auf OK. Das Objekt wird zur Anwendungsliste hinzugefügt.
Wiederholen Sie Schritt 8, um weitere Container hinzuzufügen.
Wenn Sie alle Container hinzugefügt haben, klicken Sie zum Speichern der Informationen auf OK.

44.4.7 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 in Abschnitt 44.5, Konfigurieren von Anwendungsobjekten für Berichte.