Elemzések kimenetei és formátumok

Az elemzés futtatásakor az IBM® Prerequisite Scanner a következő konzol és emberek számára olvasható fájlformátumokhoz állít elő kimenetet: parancsablak, információs és hibakeresési naplófájlok, illetve az eredmények szöveges és XML fájljai.

Az Prerequisite Scanner az elemzési eredményeket és a naplófájlt a ips_output_dir könyvtárba menti. Ezt a könyvtárat az outputDir bemeneti paraméterrel állíthatja be az eszköz futtatásakor. Ha nem állítja be ezt a paramétert, akkor az alapértelmezett kimeneti hely a következő: ips_root.

Megjegyzés: Az Prerequisite Scanner a végrehajtása során ideiglenes fájlokat hoz létre, de ezek a fájlok az eszköz futtatásának befejeződése előtt törlésre kerülnek. Ezek az ideiglenes fájlok a ips_output_dir/temp alkönyvtárban találhatók. Az eszköz a ips_output_dir/temp alkönyvtárat is törli, hacsak nem ez az alkönyvtár tartalmazza a UNIX rendszereken előállított hibakeresési fájlokat.

A paramétert használhatja a hely megadásához, ha azt választja, hogy az Prerequisite Scanner terméket egy behelyezett CD vagy DVD lemezről, vagy írásvédett fájlrendszerről vagy hálózati meghajtóról futtatja.

Fontos: Ha a kimeneti címtár nem létezik, akkor az Prerequisite Scanner létrehozza a könyvtárat. Írási engedélyekkel kell rendelkeznie ahhoz, hogy létrehozhassa a kimeneti könyvtárat vagy írhasson bele, amelybe az Prerequisite Scanner menti a fájlokat.

Parancssori kimenet

Az Prerequisite Scanner parancsfájl futtatásakor beállíthatja a nem kötelező detail paramétert és annak nem kötelező -s paraméterét. Ez az eredmények részletszintjét jelzi a parancsablakban. Ha nem állítja be a detail paramétert, akkor az eszköz csak a PASS, WARNING vagy FAIL eredményt jeleníti meg a parancsablakban.

1. Ábra Parancsfájl futtatása a részlet paraméter beállítása nélkül Windows rendszeren

Az Prerequisite Scanner a részletes eredményeket a ips_output_dir/result.txt fájlba is menti, függetlenül attól, hogy a detail paraméter be van-e állítva.

Megjegyzés: Az eszköz a részletes eredményeket az XML fájlba is menti, ha megadja a nem kötelező configHomeDir paramétert.

Az Prerequisite Scanner visszatérési kódokat is előállít az elemzés eredményeitől, illetve attól függően, hogy hiba miatt ki kell-e lépnie. Ezek a visszatérési kódok a naplófájlokba kerülnek beírásra, és a hiba visszatérési kódok is megjelennek a parancsablakban. Ha például az Prerequisite Scanner nem tudja futtatni az elemzést, mert nem tudja beolvasni a konfigurációs fájlt, akkor előállítja a 2-es visszatérési kódot. Ha az elemzés átfogó eredménye a WARNING, akkor a 3-as visszatérési kódot állítja elő.

Ha beállítja a detail paramétert az -s paraméter nélkül, akkor a részletes eredmények a következőket tartalmazzák:

Az Prerequisite Scanner verziószáma
Annak az operációs rendszernek a verziószáma, amelyen az eszköz futtatva lett
Az elemzés típusa és példahelyzet
- Előfeltétel elemzések: Példahelyzet: Előfeltétel elemzés
A termékek vagy összetevők neve, amelyekhez az előfeltétel vagy egészség ellenőrzések futtatva lettek
Minden egyes előfeltétel tulajdonság esetében: az ellenőrzött tulajdonság neve, a PASS, WARN vagy FAIL eredmény, a tényleges érték és az elvárt érték
Minden összetevő esetében: az ellenőrzött általános tulajdonság neve, a PASS, WARN vagy FAIL eredmény, a tényleges érték és az elvárt érték.
Az átfogó PASS, WARNING vagy FAIL eredmény minden elemzett termék és összetevő átfogó elemzési eredményével, amely vesszővel tagolt listaként van megadva () szögletes zárójelek között
Megjegyzés: Ha bármelyik egyéni vizsgálat sikertelen, akkor a teljes elemzés sikertelen lesz. Ha bármelyik vizsgálat eredménye figyelmeztetés, akkor a teljes elemzés eredménye figyelmeztetés lesz.
Minden FIGYELMEZTETŐ és HIBA üzenet, amely az elemzés futtatása közben történik
Információs üzenet, amely megadja a szakaszkiértékeléssel társított környezeti változókat az elemzett termék vagy összetevő konfigurációs fájljában:
Környezeti változó beállításai: [környezeti_változó_neve=környezeti_változó_értéke,környezeti_változó_neve=környezeti_változó_értéke, ...]
- A környezeti_változó_neve a környezeti változó neve.
- A környezeti_változó_értéke a környezeti változóhoz beállított érték, vagy [Not found], ha nem lett beállítva érték.

2. Ábra Parancsfájl futtatása és a részlet paraméter beállítása UNIX rendszeren

Ha beállítja a detail paramétert az -s paraméterrel, akkor a rövidített eredmények a következőket tartalmazzák:

Minden egyes sikertelen ellenőrzés esetében: az ellenőrzött előfeltétel tulajdonság neve, a FAIL eredmény, a tényleges érték és az elvárt érték
Minden egyes figyelmeztető súlyosságot tartalmazó ellenőrzés esetében: az ellenőrzött előfeltétel tulajdonság neve, a WARN eredmény, a tényleges érték és az elvárt érték
Az átfogó PASS, WARNING vagy FAIL eredmény minden elemzett termék és összetevő átfogó elemzési eredményével, amely vesszővel tagolt listaként van megadva () szögletes zárójelek között
Megjegyzés: Ha bármelyik egyéni vizsgálat sikertelen, akkor a teljes elemzés sikertelen lesz. Ha bármelyik vizsgálat eredménye figyelmeztetés, akkor a teljes elemzés eredménye figyelmeztetés lesz.

Memória és lemezterület előfeltétel tulajdonságok összesítése

Ha több termékkódot is megad bemeneti paraméterként, akkor az Prerequisite Scanner eszköz futtatásával több termék vagy összetevő előfeltételeit ellenőrizheti egyidejűleg. Az Prerequisite Scanner összesíti a memória és a lemezterület előfeltétel ellenőrzések eredményeit a kimenet Elemzett termékek összesített tulajdonságai részébe, ha a társított előfeltétel tulajdonságok a konfigurációs fájlok egyikében lettek megadva.

Az általános előfeltétel tulajdonságok a következők:

A célkörnyezetben elérhető fizikai memória teljes mennyisége, azaz:
Memory
Fájlrendszerek lemezterülete a következő előfeltétel tulajdonságokhoz:
Platform Előfeltétel tulajdonságok
UNIX és Linux
os.space.home

os.space.opt

os.space.tmp

os.space.usr

os.space.var
Windows Disk

Platform	Előfeltétel tulajdonságok
UNIX és Linux	`os.space.home` `os.space.opt` `os.space.tmp` `os.space.usr` `os.space.var`
Windows	`Disk`

Megjegyzés: Ha az opt, usr és var nem lett megadva fájlrendszerként a cél számítógépen, akkor az Prerequisite Scanner nem jelenít meg ezeknek az előfeltétel tulajdonságoknak az elvárt értékeit és visszaadott értékei a leválogatott szakaszban.

Ezek az előfeltétel tulajdonságok támogatják az elvárt értéktartományt, amely az előfeltétel tulajdonság minimális elvárt értékét (minimum_property_value) és a javasolt értékét (recommended_property_value) ábrázolja. Ha ezeknek az előfeltétel tulajdonságoknak bármelyike rendelkezik egy elvárt értéktartománnyal a konfigurációs fájlokban, akkor az Prerequisite Scanner az elvárt értéktartományok és az egyedüli tulajdonságértékek összesítését az alábbiak szerint kezeli:

Kiszámítja az összesített minimális tulajdonságértéket az aggregated_minimum_property_value által ábrázolva, összeadva a minimális tulajdonságértékeket és az egyedüli tulajdonságértékeket:
```
aggregated_minimum_property_value = minimum_property_value + minimum_property_value_n + property_value + property_value_n
```
Kiszámítja az összesített javasolt tulajdonságértéket az aggregated_recommended_property_value által ábrázolva, összeadva a javasolt tulajdonságértékeket és az egyedüli tulajdonságértékeket:
```
aggregated_recommended_property_value = recommended_property_value + minimum_property_value_n + property_value +property_value_n
```
Összehasonlítja és kiértékeli az aktuális értéket az összesített elvárt értéktartománnyal a súlyossági ellenőrzési mechanizmus használatával, amely egy másik súlyossági szintet állít be és más eredményt ad vissza attól függően, hogy az aktuális érték a megadott összesített tartomány alatt, felett vagy benne van, az alábbiak szerint:
Aktuális érték < aggregated_minimum_property_value

Ha az aktuális érték kisebb, mint az összesített minimális elvárt érték, akkor az implicit súlyossági szint a FAIL. Az elemzés a FAIL eredményt adja vissza.

(Aktuális érték >= aggregated_minimum_property_value) ÉS (Aktuális érték < aggregated_recommended_property_value)

Ha az aktuális érték egyenlő vagy nagyobb, mint az összesített minimális elvárt érték, és kisebb, mint az összesített javasolt elvárt érték, akkor az implicit súlyossági szint a WARN. Az elemzés a WARN eredményt adja vissza.

Aktuális érték >= aggregated_recommended_property_value

Ha az aktuális érték nagyobb vagy egyenlő, mint az összesített javasolt elvárt érték, akkor az elemzés a PASS eredményt adja vissza.

Az Prerequisite Scanner nem jeleníti meg az összesített szakaszt, ha a memória és a lemezterület előfeltétel tulajdonság nem létezik a konfigurációs fájlokban.

Az Prerequisite Scanner a lemezterület értékek összehasonlítását és megjelenítését az elemzési eredmények összesített szakaszában másként kezeli, mint a fő szakaszban. Lásd: Kimeneti mértékegységek.

Hibakeresési naplófájl kimenet Windows rendszeren

Az Prerequisite Scanner a feldolgozási információkat, figyelmeztető és hibaüzeneteket és az elemzési eredményeket a ips_output_dir/precheck.log fájlba írja ki. Az Prerequisite Scanner parancsfájl futtatásakor és a nem kötelező debug paraméter beállításakor az Prerequisite Scanner további hibakeresési üzeneteket ír ki ebbe a fájlba.

3. Ábra precheck.log fájl

Hibakeresési naplófájl kimenet UNIX rendszeren

Az Prerequisite Scanner parancsfájl futtatásakor és a debug paraméter beállításakor az Prerequisite Scanner a részletes feldolgozási és hibakeresés információkat és az elemzési eredményeket a ips_output_dir/precheck.log fájlba írja ki. Ezenkívül a fájlba kiírja az információs, figyelmeztető és hibaüzeneteket is.

Ha nem állítja be a nem kötelező paraméter, akkor az Prerequisite Scanner az elemzési eredményeket, információs, figyelmeztető és hibaüzeneteket alapértelmezésben a ips_output_dir/precheck.log fájlba írja ki.

Figyelem: Az Prerequisite Scanner 1.2.0.1. változatnál régebbi változatokban az eszköz a hibakeresési információkat a ips_output_dir/temp/prs.debug fájlba naplózta. Ez a fájl most már elavult a precheck.log fájlba naplózott tartalommal

4. Ábra precheck.log UNIX rendszeren

Figyelem: Az Prerequisite Scanner 1.2.0.1. változata előtt az Prerequisite Scanner támogatott egy nem kötelező trace paramétert, amely a nyomkövetési információkat naplózta a ips_output_dir/temp/prs.trc fájlban. A bemeneti paraméter és a nyomkövetési fájl elavult. Ha a parancsablakban megadja a trace paramétert, akkor megjelenik egy figyelmeztető üzenet.

Szövegfájl kimenet

Az Prerequisite Scanner kiírja a részletes elemzési eredményeket a ips_output_dir/result.txt fájlba. Az eszköz az eredményeket a szövegfájlba menti függetlenül attól, hogy beállítja-e a detail paramétert.

5. Ábra result.txt fájl Windows rendszeren

6. Ábra result.txt fájl UNIX rendszeren

XML fájl kimenet

Az Prerequisite Scanner kiírja a részletes elemzési eredményeket a ips_output_dir/result.xml fájlba, ha megadja a nem kötelező xmlResult bemeneti paramétert. Ennek használatával jelezheti az eszköz számára, hogy az eredményeket az XML eredményfájlba is kiírja a sima szövegfájlon kívül. Az eredményeket az XML fájlba menti függetlenül attól, hogy beállítja-e a detail paramétert.

7. Ábra result.XML fájl Windows rendszeren

A fejlesztők az XML fájl értelmezéséhez és beolvasásához az Prerequisite Scanner alkalmazásprogramozási felületet használhatják.