Xprint 8.0 MyStats - Fujitsu manual server
Transcrição
Xprint 8.0 MyStats - Fujitsu manual server
Xprint 8.0C MyStats-Handbuch Ausgabe September 2009 Copyright © Océ Software Laboratories Namur S.A. 2009 Alle Recht vorbehalten. Auslieferung vorbehaltlich der Verfügbarkeit; das Recht auf technische Änderungen bleibt vorbehalten. Alle Hardware- und Softwarenamen sind Marken der jeweiligen Hersteller. OSL-Xprint80C-MST-De-02 2 Inhaltsverzeichnis VORWORT ................................................................................................................................................................. 4 INHALT ...................................................................................................................................................................... 4 ZIELGRUPPEN ............................................................................................................................................................. 4 WEITERE PUBLIKATIONEN IN DIESER GRUPPE............................................................................................................ 4 1 V E R W E N D U N G S Z W E C K .......................................................................................................................... 6 2 A R C H I T E K T U R .............................................................................................................................................. 7 3 B E N U T Z E R O B E R F L Ä C H E .................................................................................................................... 10 ACCOUNTING-INFORMATIONEN SAMMELN (COLLECT ACCOUNTING INFORMATION)............................................... 11 KONVERTIERUNG STARTEN (LAUNCH CONVERSION)............................................................................................... 12 BERICHT (REPORT) .................................................................................................................................................. 14 4 V E R W E N D U N G S M O D E L L ..................................................................................................................... 19 4.1 KONFIGURATION ................................................................................................................................................ 19 4.2 ANWENDUNGSFALL-BESCHREIBUNG ................................................................................................................. 21 ZUGEHÖRIGE PUBLIKATIONEN ...................................................................................................................... 22 OSL-Xprint80C-MST-De-02 3 Vorwort Inhalt Dieses Handbuch beschreibt die neue Funktion MyStats von Xprint 8.0C. Xprint V8 ist das Ausgabeverwaltungssystem von Océ Software Laboratories Namur S.A. für heterogene Netzwerke. Es ist für zahlreiche offene Systemplattformen (UNIX und Linux), für Microsoft Windows 2003® und für Windows 2000® verfügbar. Es kann auch mit Systemen wie MS-DOS®/MS Windows, BSD UNIX und BS2000, dem Mainframe-Betriebssystem von Fujitsu, interagieren. Dieses Handbuch dient als Ergänzung zu den Xprint 8.0A-/8.0B-Handbüchern. Eine vollständige Liste der verfügbaren Handbücher finden Sie im Abschnitt "Zugehörige Publikationen" auf Seite "21". Zielgruppen Dieses ergänzende Handbuch richtet sich an folgende Zielgruppen: • Systemadministratoren Diese Dokumentation enthält Informationen für die Systemadministratoren. Die lokale Installation und Konfiguration des MyStats-Pakets auf UNIX-, Linux- und Windows-Systemen wird beschrieben. • Xprint-Administratoren Die Richtlinien für die Verwendung der MyStats-Funktion werden erläutert sowie verschiedene Anwendungsfälle beschrieben. Weitere Publikationen in dieser Gruppe • Xprint V8.0 – Handbuch für Benutzer und Administratoren Dieses Handbuch beschreibt die Methoden zum Umgang mit Xprint-Objekten. Es dient als Einführung in den Druck mit Xprint und die Verwaltung des Xprint-Systems und beschreibt die Aufgaben, die mithilfe von Xprint und den erforderlichen Verfahren ausgeführt werden können. Die Informationen im Handbuch für Benutzer und Administratoren werden durch die Angaben in diesem Handbuch ergänzt. • Xprint V8.0 - Anwendungsprogrammierschnittstelle (API) Dieses Handbuch ist für Anwendungsprogrammierer mit soliden Kenntnissen der Programmiersprache C geschrieben, die auch über Grundkenntnisse der Administration und allgemeinen Verwendung von Xprint V8.0 verfügen. Die Anwendungsprogrammierschnittstelle (Application Programming Interface, API) erlaubt dem Programmierer, auf die Funktionen des Xprint V8.0-Systems zuzugreifen. Dieses Handbuch enthält Informationen über die C-Funktionen und C-Datenstrukturen, aus denen die API besteht. • Xprint V8.0 – Referenzhandbuch Dieses Handbuch dient hauptsächlich als Nachschlagewerk. Es enthält ausführliche Informationen über Befehle und deren Optionen. • Xprint V8.0 – Grafische Benutzeroberfläche Mercator ist die grafische Benutzeroberfläche für Xprint. Dieses Handbuch gibt eine Einführung in das Produkt und einen Überblick über die verfügbaren Funktionen. • Xprint V8.0 – Erste Schritte Diese Anleitung enthält eine schrittweise Beschreibung der Grundlagen zur Installation eines funktionierenden Xprint. • Xprint V8.0 – Domain Monitoring GUI Beschreibung der Schnittstelle, des Betriebs und der Fehlerbehebung der grafischen Benutzeroberfläche für die Domänenüberwachung (Domain Monitoring GUI, DMG). Diese OSL-Xprint80C-MST-De-02 4 grafische Benutzeroberfläche ist besonders für das Help Desk und für Administratoren geeignet, die die Aktivitäten in der gesamten Xprint-Domäne überwachen und steuern möchten. • Xprint V8.0B – Ergänzendes Handbuch In diesem Handbuch werden die neue Funktionen von Xprint 8.0B beschrieben. • Xprint V8.0C – Ergänzendes Handbuch - MyDocs In diesem Handbuch wird die neue MyDocs-Funktion von Xprint 8.0C beschrieben. • Wprint 4.0 – Benutzerhandbuch Dieses Dokument beschreibt die Installation, die Konfiguration und den Betrieb von Wprint V4.0, dem Xprint-Client für Windows. OSL-Xprint80C-MST-De-02 5 1 Verwendungszweck Die Funktion MyStats stellt IT-Managern Informationen über die Nutzung der Druck-Ressourcen bereit, die von Xprint gesteuert werden. Das Tool sammelt alle Ereignisse, die im Zusammenhang mit Druckaufträgen in einer Xprint-Domäne stehen, in einer Datenbank und stellt verschiedene Statistikberichte bereit: Verteilung von Aufträgen pro Gerät, Benutzer, Datum, Medium usw. Die von diesem Tool gelieferten Informationen führen zu einer besseren Kenntnis der Druckanforderungen und Druckmöglichkeiten in einem Betrieb. Das MyStats-Tool gestattet es den Produktadministratoren, alle von den verschiedenen Komponenten in der Xprint-Domäne produzierten Accoutinginformationen zentral zu sammeln. Diese Sammlung der Informationen erfolgt über eine Weboberfläche (Intelligent Accounting Tool oder kurz IAT), die von der vorhandenen Domain Monitoring GUI-Oberfläche unabhängig ist. Die gesammelten Informationen können über eine Berichtsfunktion angezeigt werden, die Statistikberichte in Form von Kuchen- oder Balkendiagrammen oder als Text bereitstellt. Die Berichte können auch in CSV-Format exportiert werden. OSL-Xprint80C-MST-De-02 6 2 Architektur Intelligentes Accounting Tool: Globales Architektur Host 1 DFC Daemon Host2 Host3 Xprint-Domäne DFC Daemon DFC Daemon DMG Server-Host Webclient DFC Server für IAT 2. Konvertieren Webclient IAT IAT SQLDB 1 Accounting-Info Sammeln Webclient 3. Berichterstellung Einige Erläuterungen: - Der DFC Daemon (Dialog File Collector) wird auf jedem Rechner installiert, auf dem Xprint läuft. Seine Aufgabe besteht darin, Accounting-Dateien und "Ereignisdateien" (XML-Dateien) an den DFC Server für IAT zu senden. - Der DFC Server für IAT führt die Accounting- und XML-Dateien zentral zusammen und sendet sie dann an den IAT-Webserver. - Der DFC Server für IAT ist von jedem Webbrowser aus als Webclient verfügbar und ist Bestandteil des IAT Server-Pakets. - IAT: Webclients können Accounting-Informationen sammeln und Statistikberichte anfordern und empfangen. OSL-Xprint80C-MST-De-02 7 Dynamische IAT-Architektur Produktdomäne Webclient Webanwendung DFC Server für IAT DFC Daemon Produkthost 1 2 Accounting-Informationen 3 sammeln Ausführung auf dem DFC Server für IAT (IAT Transfer Daemon) 4 Verbindung zum DFC Daemon AccountingInformationen vom Produkthost abrufen Gesammelte Accounting-Dateien 5 An den DFC Server für IAT zurück gesendeter Dateiinhalt Vom IAT Server (IAT Transfer Daemon) 6 in einem Ordner gespeicherte Dateien 7 ……………………………………………………………………………………………………………………….. Konvertieren 8 Ausführung auf dem DFC Server für IAT 9 Accounting-Daten in IAT DB-Datensätze konvertieren (Konvertierungsmodul) 10 ……………………………………………………………………………………………………………………….. 11 Berichterstellung Angeforderte Berichtsansicht (Berichtsmodul) erstellen 12 OSL-Xprint80C-MST-De-02 8 1. Der Auftrag zur Sammlung von Accounting-Daten wird von einem IAT-Webclient initiiert. 2. Der Auftrag wird von der IAT-Webanwendung verarbeitet, welcher daraufhin den DFC Server für IAT anweist (über die "exec"-Anweisung auf demselben Host), den Dateitransfer zu starten. Der Start des Dateitransfers ist Aufgabe des Transfer Daemons. 3. Über TCP/IP wird eine Verbindung zwischen dem DFC Server für IAT und dem DFC Daemon hergestellt, um die Accounting-Dateien für den spezifischen Host zu empfangen. 4. Die Sammlung der Dateien von dem DFC Daemon auf dem Zielhost wird ausgeführt. 5. Die Dateien wurden von dem DFC Daemon gesammelt. 6. Der Dateiinhalt wird über TCP/IP von dem DFC Daemon an den DFC Server für IAT gesendet. 7. Die Dateien werden vom DFC Server für IAT (Transfer Daemon) empfangen und in einem dedizierten Ordner unter dem IAT Server-Stammverzeichnis gespeichert. Die Dateien sind nun für andere Vorgänge verfügbar. 8. Die Konvertierungsfunktion wird vom IAT-Webclient initiiert. 9. Der Auftrag wird vom IAT Server verarbeitet, welcher daraufhin den DFC Server für IAT anweist (über die "exec"-Anweisung auf dem betreffenden Host), die Dateien im IAT ServerStammverzeichnis in IAT DB-Datensätze zu konvertieren. 10. Die für die Konvertierung verwendeten Dateien werden gelöscht. 11. Die Berichtsfunktion wird vom IAT-Webclient initiiert. 12. IAT erstellt die Berichte (gemäß den ausgewählten Kriterien: Berichtstyp, Format, Datum, Zeitintervalle, etc.) basierend auf den IAT DB-Datensätzen. OSL-Xprint80C-MST-De-02 9 3 Benutzeroberfläche Der Webbrowser stellt die Benutzeroberfläche bereit, über die alle von der MyStats-Funktion angebotenen Aktionen aufgerufen werden können: • Sammeln von Accounting-Informationen • Konvertieren der Accounting-Informationen • Erstellen der Berichte • Bereitstellen von Hilfe Stellen Sie zunächst eine Verbindung mit der MyStats-Weboberfläche her, indem Sie folgende URL aufrufen: http://<Servername>/IntAccTool/index.php Folgende Seite wird angezeigt: Diese Seite enthält verschiedene Links, über die Sie zu den verschiedenen Optionen gelangen, die im Folgenden beschrieben sind. OSL-Xprint80C-MST-De-02 10 Accounting-Informationen sammeln (Collect Accounting Information) Wenn Sie auf den Link Accounting-Informationen sammeln (Collect Accounting Information) klicken, erhalten Sie ein Protokoll der durchgeführten Vorgänge. OSL-Xprint80C-MST-De-02 11 Konvertierung starten (Launch Conversion) Bei diesem Konvertierungsvorgang werden die Accounting-Informationen in der MyStats-Datenbank konvertiert und gespeichert. Wenn Sie auf dieser Seite Ja (Yes) wählen, werden die Dateien mit den Accounting-Daten konvertiert. Der Inhalt der MyStats-Datenbank wird vollständig gelöscht und die Datenbank wird mit den soeben konvertierten Accounting-Daten gefüllt. Falls die Konvertierung versehentlich aufgerufen wurde, kann der Vorgang durch Klicken auf die Schaltfläche Abbrechen (Cancel) abgebrochen werden. OSL-Xprint80C-MST-De-02 12 Wenn die Konvertierung ausgeführt wurde, erhalten Sie einen Bericht über die verschiedenen Dateien, die verarbeitet wurden: OSL-Xprint80C-MST-De-02 13 Bericht (Report) Nach Abschluss des Konvertierungsvorgangs können verschiedene Berichte angefordert werden, wie auf den folgenden Abbildungen dargestellt. Dies ist die Liste der möglichen Berichtstypen: Dies ist die Liste der möglichen Zeitscheibenwerte: OSL-Xprint80C-MST-De-02 14 Dies ist die Liste der möglichen Berichtsformate: Text: Die berechneten Ergebnisse werden im Textformat bereitgestellt. Balkendiagramm (BarPlot): dargestellt. Die Ergebnisse werden in Form eines Balkendiagramms Tortendiagramm (PiePlot): dargestellt. Die Ergebnisse werden in Form eines Tortendiagramms CSV-Datei (CSV File): erstellt. Der Bericht wird im CSV-Format (Comma Separated Values) Wenn CSV-Datei (CSV File) ausgewählt wird, werden die Ergebnisse in einer Datei im CSV-Format ausgegeben. Diese Datei wird im Verzeichnis <IAT_Installationspfad>/CSV auf dem Rechner gespeichert, auf dem sich der Webserver befindet. Der Dateiname für diesen CSV-Bericht hat immer das Format <Berichtstyp>_<Zeitstempel>.csv Ein Link zu dieser Datei wird auf der Webseite angezeigt. Der Benutzer kann die Datei direkt öffnen, um die Daten anzuzeigen, oder die Zieldatendatei speichern und anschließend mit Tools verarbeiten, die das CSV-Format unterstützen. Hinweis: Wenn CSV-Datei (CSV File) ausgewählt wird, werden alle vorhandenen CSV-Berichte, die älter als 24 Stunden sind, automatisch aus dem Verzeichnis <IAT_Installationspfad>/CSV gelöscht. Im Folgenden sind einige Berichtsbeispiele vom Typ Auftragsgrößenverteilung (Anzahl von Aufträgen) (Job Size Distribution [number of jobs]) mit der Zeitscheibenzuordnung keine (none) beschrieben. Textformat OSL-Xprint80C-MST-De-02 15 Balkendiagrammformat Tortendiagrammformat OSL-Xprint80C-MST-De-02 16 CSV-Format Wenn Sie auf den Link klicken, wird der Inhalt der Datei im CSV-Format angezeigt: OSL-Xprint80C-MST-De-02 17 Wenn Sie mit der rechten Maustaste auf den Link klicken, werden verschiedene Aktionsmöglichkeiten zur Auswahl angezeigt: Wenn Sie Link speichern unter (save link as) auswählen, können Sie die Datei herunterladen und auf der Festplatte speichern. OSL-Xprint80C-MST-De-02 18 4 Verwendungsmodell In diesem Kapitel werden verschiedene Verwendungsmodelle vorgestellt. 4.1 Konfiguration Im Folgenden finden Sie einige Beispiele von Konfigurationen, in denen MyStats eingesetzt wird. Für die MyStats-Funktion sind folgende Komponenten erforderlich: 1. Mindestens ein unabhängiger Xprint-Host (Standalone) oder mehrere in einer Domäne organisierte Xprint-Hosts 2. Ein DMG Server 3. Das installierte IAT-Tool XPRINT XPRINT XPRINT DFCDaemon Webclient DFC Server für IAT 2. Konvertieren IAT IAT SQPLDB 1 Accounting-Info sammeln Webclient 3. Berichterstellung Webclient Beachten Sie, dass nur für die Hosts Statistiken bereitgestellt werden, auf denen der Accounting und/oder DMG Server gestartet wurde und für die die Überwachung durch die IATKonfigurationsdatei angefordert wurde (siehe weiter unten in diesem Dokument). Wie und wann werden Informationen gesammelt? Vor dem Festlegen von Optionen muss Folgendes geklärt werden: • Vom Kunden benötigte Berichte • Die Häufigkeit für die Erstellung dieser Berichte (jede Woche, jeden Monat, jedes Jahr etc.) • Die erforderliche Bearbeitung zur Darstellung kohärenter Informationen in den Berichten OSL-Xprint80C-MST-De-02 19 Damit die Berichte richtige Informationen enthalten (keine Lücken, keine Überschneidungen), muss die Datensammlung zu einem geeigneten Zeitpunkt erfolgen und bestimmte Regeln befolgen. Es gibt zwei Typen von gesammelten Informationen: • Die Accounting-Datei Die Accounting-Datei ist eine eindeutige Datei, die entsprechend den Druckaktivitäten größer wird. Sie enthält alle erforderlichen Informationen für die Erstellung von Statistiken über die Druckaufträge, die gedruckten Seiten, die verwendeten Geräte, die verwendeten Formulare usw. Zum Schließen einer Accounting-Datei und zum Beginnen einer neuen Accounting-Datei verwenden Sie folgenden Befehl: mv <AccDatei> <AccDatei_Sicherung> Mit diesem Befehl erstellen Sie eine neue Accounting-Datei mit neuen Daten. Alle alten Accounting-Daten befinden sich nun in der Datei <AccDatei_Sicherung>. Dabei ist <AccDatei> der Name der Accounting-Datei, die in der Xprint-Systemkonfiguration definiert ist (der Name kann mit dem Befehl "xpshow -sys -diLONG" angezeigt werden). <AccDatei_Sicherung> kann frei gewählt werden. • Die IAT-XML-Datei (Ereignissammlungsdatei) mit Informationen über die Druckeraktivität: Diese Datei enthält Informationen über die Druckeraktivität (Gerätefehler, Papierende usw.). Der Name dieser Datei wird in der Datei "config" im Verzeichnis /var/spool/DomMonGui/relay (Unix) bzw. C:\Programme\DomMonGui\Relay (Windows) über einen Parameter festgelegt. Im Folgenden sehen Sie ein Beispiel einer Unix-Konfigurationsdatei: LOGFNBR="10" LOGFNAME="/var/spool/DomMonGui/Relay/Collector" LOGFSIZE="1000" LOGFIAT="YES" LOGFCURRENT="1" Um alle Gerätefehler, die während den Druckaktivitäten auftreten, aufzuzeichnen, muss die IATXML-Datei vorhanden sein. Damit sie erstellt wird, muss der Parameter LOGFIAT den Wert "YES" haben. Somit wird eine Datei mit dem Präfix <LOGFNAME> und dem Suffix "IAT.xml" (in unserem Beispiel: /var/spool/DomMonGui/Relay/CollectorIAT.xml) erstellt und mit allen eventuellen Gerätefehlern gefüllt. Definition der IAT-Konfigurationsdatei Um Statistikergebnisse auf der IAT-Benutzeroberfläche zu erhalten, muss die Datenbank mit Accounting- und/oder DMG-XML-Dateien initiiert werden. Für die Übertragung dieser Dateien ist der IAT Transfer Daemon zuständig. Dieser Daemon kontaktiert den Diagnose Collection File Daemon mithilfe der Konfigurationsdatei TransfertConfig.config. Im Folgenden ist diese Datei beschrieben. Speicherort: Die Konfigurationsdatei TransfertConfig.config befindet sich im Verzeichnis <DMG_Server_Installationsverzeichnis>/Server/IntAccTool/Server Format: Die Konfigurationsdatei TransfertConfig.config ist eine ASCII-Datei. Jede Zeile bezieht sich auf einen Host und Dateien, die von diesem Host heruntergeladen werden müssen. Jede Zeile beginnt mit dem Zeichen "|", die Felder sind durch das Zeichen "||" voneinander getrennt und alle Zeilen enden mit den Zeichen "|;": OSL-Xprint80C-MST-De-02 20 |Hostname||Accouting_Dateipfad_Name||XML_Dateien_Pfadname|; Beispiel: |d241vm02||/var/spool/Xprint/config/AccountingDatei||/var/spool/Xprint/DomMonGui/Relay/*IAT.xml|; |d241s067||/var/spool/Xprint/config/AccountingDatei||/var/spool/Xprint/DomMonGui/Relay/*IAT.xml|; Die Datei TransfertConfig.config muss also aktualisiert werden, sodass sie die Dateien (Accounting-Dateien und Ereignissammlungsdateien) enthalten, die von den verschiedenen zu überwachenden Hosts heruntergeladen werden sollen. 4.2 Anwendungsfall-Beschreibung Angenommen das Drucksystem besteht aus mehreren Hosts, auf denen Xprint mit mehreren Druckern ausgeführt wird. Auf jedem Host, auf dem der DMG Collector läuft, werden Accounting-Informationen und Gerätefehlerinformationen generiert. Nach einer bestimmten Zeitspanne kann der Kunde anfordern, diese Accounting- und Fehlerinformationsdateien in der Datenbank für die Erstellung verschiedener Berichte zu sammeln. Wenn die alten Accounting-Informationen der verschiedenen Hosts zu einem bestimmten Zeitpunkt nicht mehr benötigt werden, müssen die Accounting-Dateien auf den verschiedenen Hosts geändert werden (siehe Befehl "mv" oben). OSL-Xprint80C-MST-De-02 21 Zugehörige Publikationen • Xprint V8.0 – Handbuch für Benutzer und Administratoren Dieses Handbuch beschreibt die Methoden zum Umgang mit Xprint-Objekten. Es dient als Einführung in den Druck mit Xprint und die Verwaltung des Xprint-Systems und beschreibt die Aufgaben, die mithilfe von Xprint und den erforderlichen Verfahren ausgeführt werden können. Die Informationen im Handbuch für Benutzer und Administratoren werden durch die Angaben in diesem Handbuch ergänzt. • Xprint V8.0 - Anwendungsprogrammierschnittstelle (API) Dieses Handbuch ist für Anwendungsprogrammierer mit soliden Kenntnissen der Programmiersprache C geschrieben, die auch über Grundkenntnisse der Administration und allgemeinen Verwendung von Xprint V8.0 verfügen. Die Anwendungsprogrammierschnittstelle (Application Programming Interface, API) erlaubt dem Programmierer, auf die Funktionen des Xprint V8.0-Systems zuzugreifen. Dieses Handbuch enthält Informationen über die C-Funktionen und C-Datenstrukturen, aus denen die API besteht. • Xprint V8.0 – Referenzhandbuch Dieses Handbuch dient hauptsächlich als Nachschlagewerk. Es enthält ausführliche Informationen über Befehle und deren Optionen. • Xprint V8.0 – Grafische Benutzeroberfläche Mercator ist die grafische Benutzeroberfläche für Xprint. Dieses Handbuch gibt eine Einführung in das Produkt und einen Überblick über die verfügbaren Funktionen. • Xprint V8.0 – Erste Schritte Diese Anleitung enthält eine schrittweise Beschreibung der Grundlagen zur Installation eines funktionierenden Xprint. • Xprint V8.0 – Domain Monitoring GUI Beschreibung der Schnittstelle, des Betriebs und der Fehlerbehebung der grafischen Benutzeroberfläche für die Domänenüberwachung (Domain Monitoring GUI, DMG). Diese grafische Benutzeroberfläche ist besonders für das Help Desk und für Administratoren geeignet, die die Aktivitäten in der gesamten Xprint-Domäne überwachen und steuern möchten. • Xprint V8.0B – Ergänzendes Handbuch In diesem Handbuch werden die neue Funktionen von Xprint 8.0B beschrieben. • Xprint V8.0C – Ergänzendes Handbuch - MyDocs In diesem Handbuch wird die neue MyDocs-Funktion von Xprint 8.0C beschrieben. • Wprint 4.0 – Benutzerhandbuch Dieses Dokument beschreibt die Installation, die Konfiguration und den Betrieb von Wprint V4.0, dem Xprint-Client für Windows. OSL-Xprint80C-MST-De-02 22