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