Scanausgaben und Formate

Wenn Sie einen Scan durchführen, erzeugt IBM® Prerequisite Scanner Ausgaben für die folgenden Konsolendateiformate und lesbaren Dateiformate: Ausgabe im Befehlsfenster, Informations- und Debugprotokolldateien, Text- und XML-Dateien für die Ergebnisse.

Prerequisite Scanner speichert die Scanergebnisse und die Protokolldatei im Verzeichnis ips_output_dir. Sie können dieses Verzeichnis mit dem Eingabeparameter outputDir bei der Ausführung des Tools festlegen. Wenn Sie diesen Parameter nicht angeben, wird ips_root als Standardausgabeposition verwendet.

Anmerkung: Prerequisite Scanner erstellt während der Ausführung temporäre Dateien. Diese Dateien werden jedoch vor Abschluss der Toolausführung gelöscht. Diese temporären Dateien befinden sich im Unterverzeichnis ips_output_dir/temp. Außerdem löscht das Tool das Unterverzeichnis ips_output_dir/temp, sofern das Unterverzeichnis nicht die Debugdateien enthält, die nur auf UNIX-Systemen generiert werden.

Sie können den Parameter auch verwenden, um eine Position anzugeben, wenn Sie Prerequisite Scanner von einer angehängten CD, einer angehängten DVD oder über ein angehängtes schreibgeschütztes Dateisystem und Netzlaufwerk ausführen.

Wichtig: Wenn das Ausgabeverzeichnis nicht vorhanden ist, erstellt Prerequisite Scanner das Verzeichnis. Sie müssen Schreibberechtigungen besitzen, um das Ausgabeverzeichnis, in dem Prerequisite Scanner die Dateien speichert, zu erstellen oder zu beschreiben.

Befehlszeilenausgabe

Wenn Sie das Prerequisite Scanner-Script ausführen, können Sie den optionalen Parameter detail und die optionale Option -s angeben. Der Parameter gibt die Detailstufe der Ergebnisse im Befehlsfenster an. Wenn Sie den Parameter detail nicht definieren, zeigt das Tool nur das Ergebnis PASS, WARNING oder FAIL im Befehlsfenster an.

Abbildung 1. Script ohne den Parameter "detail" ausführen - Windows-Systeme

Ausführung des Scripts ohne den Parameter "detail" auf Windows-Systemen

Prerequisite Scanner speichert die ausführlichen Ergebnisse in der Datei ips_output_dir/result.txt unabhängig davon, ob der Parameter detail angegeben wird.

Anmerkung: Das Tool speichert die ausführlichen Ergebnisse in der XML-Datei, wenn Sie den optionalen Parameter configHomeDir angeben.

Prerequisite Scanner generiert Rückgabecodes, die von den Ergebnissen des Scans und davon abhängig sind, ob der Scanner aufgrund von Fehlern beendet werden muss. Diese Rückgabecodes werden in die Protokolldateien geschrieben und die Fehlercodes werden im Befehlsfenster angezeigt. Wenn Prerequisite Scanner den Scan beispielsweise nicht durchführen kann, weil die Konfigurationsdatei nicht gelesen werden kann, wird der Rückgabecode 2 generiert. Wenn das Gesamtergebnis des Scans WARNING ist, wird der Rückgabecode 3 generiert.

Wenn Sie den Parameter detail ohne die Option -s angeben, enthalten die detaillierten Ergebnisse folgende Informationen:

Version von Prerequisite Scanner
Version des Betriebssystems, unter dem das Tool ausgeführt wurde
Typ des Scans und Szenarios
- Scans nach Voraussetzungen: Szenario: Scans nach Voraussetzungen
Namen der Produkte oder Komponenten, für die die Prüfungen der Voraussetzungen oder Diagnosen durchgeführt wurden
Für jede vorausgesetzte Eigenschaft der Name der geprüften Eigenschaft, das Ergebnis PASS, WARN oder FAIL, der tatsächliche Wert und der erwartete Wert
Für alle Komponenten der Name der allgemeinen Eigenschaft, das Ergebnis PASS, WARN oder FAIL, der tatsächliche Wert und der erwartete Wert
Gesamtergebnis (PASS, WARNING oder FAIL) mit den Gesamtscanergebnissen für jedes gescannte Produkt und jede gescannte Komponente, die in Form einer durch Kommas getrennten Liste in () (runde Klammern) angegeben wurden
Anmerkung: Jede fehlgeschlagene Einzelprüfung führt zum Scheitern des gesamten Scans. Jede Warnung für eine einzelne Prüfung resultiert in einem Warnergebnis für den Gesamtscan.
Alle Warnungen und Fehlernachrichten, die während des Scans auftreten
Alle Informationsnachrichten, die die Umgebungsvariablen für die Abschnittsevaluierung in den Konfigurationsdateien gescannter Produkte oder Komponenten angeben:
Umgebungsvariableneinstellungen: [Umgebungsvariablenname=Umgebungsvariablenwert,Umgebungsvariablenname=Umgebungsvariablenwert, ...]
- Umgebungsvariablenname steht für den Namen der Umgebungsvariablen.
- Umgebungsvariablenwert steht für den Wert, der für die Umgebungsvariable definiert wurde. Wenn kein Wert definiert wurde, wird [Not found] ausgegeben.

Abbildung 2. Script ausführen und Parameter "detail" setzen - UNIX-Systeme

Ausführung des Scripts und Setzen des Parameters 'detail' auf UNIX-Systemen

Wenn Sie den Parameter detail mit der Option -s angeben, enthalten die gekürzten Ergebnisse folgende Informationen:

Für jede fehlgeschlagene Prüfung der Name der geprüften vorausgesetzten Eigenschaft, das Ergebnis FAIL, der tatsächliche Wert und der erwartete Wert
Für jede Prüfung mit der Wertigkeit "Warning" der Name der geprüften vorausgesetzten Eigenschaft, das Ergebnis WARN, der tatsächliche Wert und der erwartete Wert
Gesamtergebnis (PASS, WARNING oder FAIL) mit den Gesamtscanergebnissen für jedes gescannte Produkt und jede gescannte Komponente, die in Form einer durch Kommas getrennten Liste in () (runde Klammern) angegeben wurden
Anmerkung: Jede fehlgeschlagene Einzelprüfung führt zum Scheitern des gesamten Scans. Jede Warnung für eine einzelne Prüfung resultiert in einem Warnergebnis für den Gesamtscan.

Zusammenfassung der vorausgesetzten Eigenschaften für Hauptspeicher und Plattenspeicherplatz

Sie können Prerequisite Scanner ausführen, um die Voraussetzungen eines oder mehrerer Produkte oder einer oder mehrerer Komponenten gleichzeitig zu prüfen, indem Sie mehrere Produktcodes als Eingabeparameter angeben. Prerequisite Scanner fasst die Ergebnisse der Prüfung der Voraussetzungen für Hauptspeicher und Plattenspeicherplatz im Abschnitt Aggregated Properties for Scanned Products der Ausgabe zusammen, sofern die vorausgesetzten Eigenschaften in einer Konfigurationsdatei angegeben wurden.

Die allgemeinen vorausgesetzten Eigenschaften sind folgende:

Physische Gesamthauptspeicherkapazität, die in der Zielumgebung verfügbar ist:
Memory
Plattenspeicherplatz der Dateisysteme für die folgenden vorausgesetzten Eigenschaften:
Plattform Vorausgesetzte Eigenschaften
UNIX und Linux
os.space.home

os.space.opt

os.space.tmp

os.space.usr

os.space.var
Windows Disk

Plattform	Vorausgesetzte Eigenschaften
UNIX und Linux	`os.space.home` `os.space.opt` `os.space.tmp` `os.space.usr` `os.space.var`
Windows	`Disk`

Anmerkung: Wenn opt, usr und var nicht als Dateisysteme auf dem Zielcomputer definiert wurden, zeigt Prerequisite Scanner die erwarteten Werte nicht an und gibt Ergebnisse für diese vorausgesetzten Eigenschaften im zusammengefassten Abschnitt zurück.

Diese vorausgesetzten Eigenschaften unterstützen den erwarteten Wertebereich, der den minimalen erwarteten Wert für die vorausgesetzte Eigenschaft minimum_property_value darstellt, und den empfohlenen erwarteten Wert recommended_property_value. Wenn eine dieser vorausgesetzten Eigenschaften einen erwarteten Wertebereich in den Konfigurationsdateien hat, verarbeitet Prerequisite Scanner die Aggregation der erwarteten Wertebereiche und der einzelnen Eigenschaftswerte wie folgt:

Das Tool berechnet den aggregierten minimalen Eigenschaftswert, der von aggregated_minimum_property_value dargestellt wird, indem es die minimalen Eigenschaftswerte und die einzelnen Eigenschaftswerte addiert:
```
aggregated_minimum_property_value = minimum_property_value + minimum_property_value_n + property_value + property_value_n
```
Es berechnet den aggregierten empfohlenen Eigenschaftswert, der von aggregated_recommended_property_value dargestellt wird, indem es die empfohlenen Eigenschaftswerte und die einzelnen Eigenschaftswerte addiert:
```
aggregated_recommended_property_value = recommended_property_value + minimum_property_value_n + property_value +property_value_n
```
Das Tool vergleicht den tatsächlichen Wert mit dem aggregierten erwarteten Wertebereich mithilfe des Prüfmechanismus für Wertigkeiten, wertet das Ergebnis aus und gibt je nachdem, ob der tatsächliche Wert unterhalb, innerhalb oder oberhalb des angegebenen aggregierten Bereichs liegt, ein anderes Ergebnis zurück.
Tatsächlicher Wert < aggregated_minimum_property_value

Wenn der tatsächliche Wert kleiner ist als der zusammengefasste minimale erwartete Wert, ist die implizite Wertigkeit FAIL. Der Scan gibt das Ergebnis FAIL zurück.

(Tatsächlicher Wert >= aggregated_minimum_property_value) AND (Tatsächlicher Wert < aggregated_recommended_property_value)

Wenn der tatsächliche Wert größer-gleich dem aggregierten minimalen erwarteten Wert und kleiner als der aggregierte empfohlene erwartete Wert ist, ist die implizite Wertigkeit WARN. Der Scan gibt das Ergebnis WARN zurück.

Tatsächlicher Wert >= aggregated_recommended_property_value

Wenn der tatsächliche Wert größer-gleich dem aggregierten empfohlenen erwarteten Wert ist, gibt der Scan das Ergebnis PASS zurück.

Prerequisite Scanner zeigt den zusammengefassten Abschnitt nicht an, wenn in den Konfigurationsdateien weder vorausgesetzte Eigenschaften für den Hauptspeicher noch vorausgesetzte Eigenschaften für den Plattenspeicherplatz angegeben sind.

Prerequisite Scanner verarbeitet den Vergleich und die Anzeige von Plattenspeicherplatzwerten im zusammengefassten Abschnitt der Scanergebnisse anders als im Hauptabschnitt. Weitere Informationen finden Sie unter Maßeinheiten in der Ausgabe.

Ausgabe in der Debugprotokolldatei auf Windows-Systemen

Prerequisite Scanner gibt Verarbeitungsinformationen, Warnungen und Fehlernachrichten sowie Scanergebnisse in der Datei ips_output_dir/precheck.log aus. Wenn Sie das Prerequisite Scanner-Script ausführen und den optionalen Parameter debug setzen, gibt Prerequisite Scanner weitere Debugnachrichten in dieser Datei aus.

Abbildung 3. Datei "precheck.log"

Ausgabe in der Debugprotokolldatei auf UNIX-Systemen

Wenn Sie das Prerequisite Scanner-Script ausführen und den optionalen Parameter debug definieren, gibt Prerequisite Scanner detaillierte Verarbeitungs- und Debugging-Informationen sowie die Scanergebnisse in der Datei ips_output_dir/precheck.log aus. Das Tool gibt auch Informations-, Warn- und Fehlernachrichten in der Datei aus.

Wenn Sie den optionalen Parameter nicht definieren, gibt Prerequisite Scanner die Scanergebnisse sowie Informations-, Warn- und Fehlernachrichten standardmäßig in der Datei ips_output_dir/precheck.log aus.

Achtung: Vor Prerequisite Scanner Version 1.2.0.1 wurden die Debugging-Informationen von dem Tool in der Datei ips_output_dir/temp/prs.debug protokolliert. Diese Datei ist mittlerweile veraltet und der Inhalt wird in der Datei precheck.log protokolliert

Abbildung 4. Datei "precheck.log" auf UNIX-Systemen

Achtung: Vor Prerequisite Scanner Version 1.2.0.1 unterstützte Prerequisite Scanner den optionalen Parameter trace, der Traceinformationen in der Datei ips_output_dir/temp/prs.trc protokollierte. Der Eingabeparameter und die Tracedatei sind veraltet. Wenn Sie den Parameter trace im Befehlsfenster angeben, wird eine Warnnachricht angezeigt.

Ausgabe in einer Textdatei

Prerequisite Scanner gibt detaillierte Scanergebnisse in der Datei ips_output_dir/result.txt aus. Der Scanner speichert die Ergebnisse in der Textdatei, unabhängig davon, ob Sie den Parameter detail setzen oder nicht.

Abbildung 5. Datei "result.txt" auf Windows-Systemen

Abbildung 6. Datei "result.txt" auf UNIX-Systemen

Ausgabe in einer XML-Datei

Prerequisite Scanner gibt detaillierte Scanergebnisse in der Datei ips_output_dir/result.xml aus, wenn Sie den optionalen Eingabeparameter xmlResult setzen. Sie können diesen Parameter verwenden, um das Tool anzuweisen, die Ergebnisse nicht nur in der einfachen Textergebnisdatei, sondern auch in der XML-Ergebnisdatei auszugeben. Die Ergebnisse werden in der XML-Datei gespeichert, unabhängig davon, ob Sie den Parameter detail setzen oder nicht.

Abbildung 7. Datei "result.XML" auf Windows-Systemen

Entwickler können die API von Prerequisite Scanner verwenden, um die XML-Datei zu parsen und zu lesen.