IBM® Support Assistant Lite



Obsah

Úvod
Krok za krokom
Inštalácia nástroja
    Inštalácia nástroja
Použitie nástroja
    Nastavenie premennej prostredia JAVA_HOME
    Spustenie nástroja v režime Swing GUI
    Spustenie nástroja v režime konzoly príkazového riadka
    Umiestnenie súborov vytváraných počas vykonávania
    Interakcia s nástrojom v režime Swing GUI
    Validácia názvu súboru zip so zhromaždenými údajmi
    Interakcia s nástrojom v režime konzoly príkazového riadka
    Určenie informácií o verzii
    Podpora proxy pre odosielanie cez HTTPS
Ochranné známky

Úvod

Nástroj IBM® Support Assistant Lite slúži ako pomôcka pri odstraňovaní problémov so softvérovými produktmi IBM. Nástroj sa zameriava na automatické zhromaždenie údajov o probléme. Poskytuje tiež podporu pre analýzu symptómov pre rôzne kategórie problémov, ktoré nastanú v softvérových produktoch IBM. Zhromažďovanie a analýza informácií súvisiacich s niektorým typom problému pomôže identifikovať pôvod vyšetrovaného problému. Nástroj pomáha zákazníkom redukovať množstvo času, ktorý je potrebný na reprodukciu problému s nastavenými správnymi úrovňami sledovania, a tiež redukovať úsilie potrebné na odoslanie príslušných informácií protokolu podpore IBM. V tejto pomoci sa dozviete, ako spustiť a používať nástroj IBM Support Assistant Lite.


Krok za krokom

Vo väčšine prípadov je na nastavenie a spustenie nástroja potrebné vykonať nasledujúcu postupnosť krokov. Ak nastane problém, alebo ak chcete viac informácií o ľubovoľnom z týchto krokov, môžete si pozrieť sekcie, ktoré nasledujú za touto.

  1. Nainštalujte nástroj rozbalením súborov z archívneho súboru, ktorý ste prevzali.
  2. Spustite nástroj v režime grafického užívateľského prostredia alebo v režime konzoly príkazového riadka.

Inštalácia nástroja

Inštalácia nástroja

Vo všetkých prípadoch je inštalácia nástroja IBM Support Assistant Lite iba rozbalením súborov z archívu, ktorý ste prevzali. Tieto súbory možno extrahovať do ľubovoľného umiestnenia v súborovom systéme systému, v ktorom spustíte nástroj. Toto vytvorí podadresár \ISALite v tomto cieľovom adresári.


Použitie nástroja

Nastavenie premennej prostredia JAVA_HOME

Bez ohľadu na to, či budete nástroj IBM Support Assistant Lite používať v režime grafického užívateľského prostredia alebo v režime konzoly, na jeho spustenie používate rovnakú metódu: zavoláte správny spúšťací skript z príkazového riadka. V prípade operačného súboru Windows sú tieto spúšťacie skripty dávkové súbory. Pre ostatné prostredia sú shell skripty.

Nástroj je implementovaný ako Java aplikácia, preto je pred spustením nástroja potrebné nastaviť premennú prostredia JAVA_HOME. Ak Java nie je dostupné v premennej PATH, budete musieť manuálne nastaviť premennú prostredia JAVA_HOME. Nástroj IBM Support Assistant Lite vyžaduje JRE, verzia 1.4.2 alebo novšia (1.5 alebo novšia pre 64-bitový operačný systém Windows 7), preto v systéme, v ktorom sa spustí nástroj, najprv musíte skontrolovať, či je nainštalované JRE. Ak je, musíte zadať príkaz špecifický pre operačný systém na nastavenie premennej JAVA_HOME, aby ukazovala na toto JRE. Microsoft JVM/JDK ani gij (GNU libgcj) nie sú podporované. Ak máte napríklad nainštalované jdk1.4.2 v adresári c:\jre1.4.2 v platforme Windows, premennú JAVA_HOME by ste nastavili týmto príkazom:

SET JAVA_HOME=c:\jre1.4.2

V platforme Linux, AIX, HP-UX alebo Solaris sa presná syntax príkazu na nastavenie premennej JAVA_HOME líši podľa použitého shellu. Napríklad, ak používate bash shell a JDK máte nainštalované v adresári /opt/jre142, premennú JAVA_HOME by ste nastavili pomocou tohto príkazu:

export JAVA_HOME=/opt/jre142

Po nainštalovaní nástroja do niektorého z predvolených umiestnení sa môže stať, že nástroj sa nespustí a zobrazí chybovú správu "CHYBA: Tento nástroj vyžaduje na spustenie JRE 1.4.2 alebo novšie." Táto správa znamená, že verzia JRE je staršia ako 1.4.2. V tomto prípade by ste mali nastaviť premennú JAVA_HOME manuálne, aby ukazovala na JRE správnej verzie.

Spustenie nástroja v režime grafického užívateľského rozhrania

Musíte zadať tento spúšťací skript:

Spustenie nástroja v režime konzoly príkazového riadka

Ak nie je dostupné grafické užívateľské rozhranie, nástroj by sa mal automaticky spustiť v režime príkazového riadka. Ak preferujete režim konzoly, hoci je dostupné grafické užívateľské rozhranie, na príkazovom riadku zadajte "-console". V niektorých prípadoch nebude možné určiť, že nie je dostupné grafické užívateľské rozhranie a nástroj sa nespustí. V takýchto prípadoch bude potrebné vykonať reštart s parametrom "-console".

Umiestnenie súborov vytváraných počas vykonávania

Inštalačný adresár ISA Lite sa predvolene používa na ukladanie súborov, ktoré sa vytvoria počas vykonávania. V niektorých systémoch bude inštalačný adresár ISA Lite len na čítanie. V tomto prípade použite parameter -useHome. Tento parameter spôsobí, že dočasné súbory sa zapíšu do systémového dočasného adresára a perzistentné súbory sa zapíšu do domovského adresára užívateľa.

Interakcia s nástrojom v režime grafického užívateľského rozhrania

Po spustení nástroja IBM Support Assistant Lite v režime grafického užívateľského rozhrania sa zobrazí grafické rozhranie uvedené dole.

Pred použitím nástroja na vykonanie zhromaždenia údajov a analýzy musíte vybrať typ problému v okne Typ problému, ako je znázornené dole.

 

 

Okrem Typu problému musíte v hlavnom grafickom užívateľskom rozhraní zadať do vstupného poľa názov súboru pre súbor zip so zhromaždenými údajmi. V tomto bode môže byť názov súboru čokoľvek: môžete napríklad vybrať názov súboru Inštalácia_zlyhala_2007_01_03. Ak nezadáte rozšírenie súboru, nástroj automaticky pridá rozšírenie "zip". Ak máte otvorené PMR pre problém, pre ktorý vykonávate zhromažďovanie, a dovolíte nástroju automaticky poslať výsledky zhromažďovania podpore IBM cez protokol FTP, v kroku prenosu cez FTP nástroj vnúti špecifickú konvenciu pomenúvania, ktorú vyžaduje podpora IBM: názov súboru musí začínať tromi špecifickými poliami: <pmrnumber>.<branchnumber>.<countrycode>.<short description>.zip. Príkladom tohto typu názvu súboru je 34143.055.000.logs.zip. Kvôli kompatibilite so starším formátom sú na miestach prvých troch bodiek akceptované aj čiarky (ale nie na mieste štvrtej pred rozšírením "zip"). Preferovaným oddeľovačom sú však bodky.

Keď ste vyplnili tieto hodnoty, v ďalšom kroku kliknete na tlačidlo Zhromaždiť údaje. Počas vykonávania vás skript na zhromažďovanie požiada o viac informácií, ktoré potrebuje na vykonanie svojich aktivít zhromažďovania. Skript vás tiež môže požiadať o informácie o konfigurácii, informácie o postupnosti udalostí, ktoré vedú k problému, ktorý riešite, alebo vaše preferencie ohľadom dokončenia zhromažďovania. Keď už bude mať všetky potrebné informácie, skript bude ďalej pokračovať v zhromažďovaní.

 Keď nástroj zhromaždí údaje, výsledky môžete poslať podpore IBM. Môžete vybrať prenos súborov cez protokol FTP, ktorý je nešifrovaný, a protokol HTTPS, ktorý je šifrovaný. Názov súboru zip, ktorý nástroj pošle podpore IBM, bude názov súboru zadaný v poli Názov výstupného súboru/cesta, pred ktorý sa pridá názov hostiteľa servera a aktuálna časová značka.

 Príklad: Ak sa použil Názov výstupného súboru/cesta 34143.055.000.logs.zip, názov súboru zip poslaného do IBM by bol

34143.055.000.logs.zip-<názov_hostiteľa>-<aktuálna_časová_značka>.zip.

Validácia názvu súboru zip so zhromaždenými údajmi

Automatizácia FTP lokality podpory IBM ftp.emea.ibm.com je úplne závislá od konvencie pomenúvania súborov, ktorá je opísaná v hlavnom grafickom užívateľskom rozhraní nástroja IBM Support Assistant Lite. Ak prijme súbor s názvom, ktorý nedodržiava túto konvenciu, súbor sa nikdy nedostane k podpore IBM. Z tohto dôvodu nástroj pred vykonaním operácie prenosu FTP na odoslanie súboru zip so zhromaždenými údajmi do ftp.emea.ibm.com skontroluje názov súboru zip so zhromaždenými údajmi voči konvencii. Ak názov súboru nemá správny tvar, zobrazí sa dialógové okno, v ktorom môžete opraviť názov súboru. Aktuálna konvencia pomenúvania súborov pre lokalitu FTP je tá, ktorá je zdokumentovaná tu, pričom jednotlivé polia zloženého názvu súboru sú oddelené bodkami. V minulosti sa ako oddeľovače používali čiarky. Lokalita FTP stále spracúva súbory pomenované prostredníctvom staršej konvencie, preto logika validácie nástroja IBM® Support Assistant Lite akceptuje ako oddeľovače bodky aj čiarky.

Interakcia s nástrojom v režime konzoly príkazového riadka

Keď sa IBM Support Assistant Lite spustí v režime konzoly príkazového riadka, neexistujú žiadne výberové zoznamy ani vstupné polia na zadávanie údajov užívateľom. Namiesto toho sú k dispozícii voľby v podobe číslovaných zoznamov a vy môžete zadať číslo vášho výberu a stlačiť kláves Enter. Polia pre zadávanie údajov sa transformovali na výzvy, do ktorých zadáte svoju odpoveď a stlačíte kláves Enter.

Ak chcete zastaviť nástroj kolektora, napíšte príkaz quit v režime konzoly.

Nástroj vás požiada o názvy súborov. V platformách Unix nie je podporované použitie znaku "~" na označenie domovského adresára užívateľa. Ak použijete znak "~", bude sa referencovať podadresár pod aktuálnym pracovným adresárom s názvom "~".

Režim konzoly tiež poskytuje funkciu tichého zhromažďovania na zaznamenanie vašich odpovedí z relácie režimu konzoly do súboru a použitie tohto súboru na riadenie ďalších vykonaní rovnakého skriptu na zhromažďovanie.

Ak to chcete spraviť, najprv vytvorte "súbor odpovedí", ktorý obsahuje odpovede na všetky otázky pre určité vykonanie kolektora údajov. Keď bude potrebné znova vykonať rovnaké zhromažďovanie údajov, pri spúšťaní nástroja zadáte súbor odpovedí a odpovede, ktoré sa poskytli v minulosti, sa použijú na zodpovedanie všetkých otázok. Súbory odpovedí možno ladiť a upravovať, aby mali rôzne odpovede na vykonanie rôznych zhromažďovaní údajov.

Ak chcete vytvoriť súbor odpovedí, zavolajte nástroj v režime konzoly príkazového riadka s voľbou -record, za ktorou uvediete názov súboru odpovedí. V prostredí Linux by ste napríklad spustili tento príkaz:

./runISALite.sh -console -record response.txt

Pri spustení v tomto režime sa dostanete do bežnej interaktívnej relácie, v ktorej zadávate odpovede na výzvy skriptu. Okrem riadenia aktuálneho zhromažďovania sa však vaše odpovede tiež uložia do vami určeného súboru. Po dokončení interaktívnej relácie môžete použiť tento súbor odpovedí na vykonanie rovnakého skriptu v budúcnosti bez nutnosti explicitného vstupu od užívateľa.

Ak chcete napríklad spustiť nástroj v tichom režime v prostredí Linux pomocou súboru odpovedí, ktorý ste zaznamenali, spustite tento príkaz:

./runISALite.sh -console response.txt

Súbor odpovedí je súbor s prostým textom, preto ho môžete zmeniť, ak chcete upraviť odpovede užívateľa. Ak chcete napríklad spustiť nástroj v inom systém ako v tom, v ktorom ste zaznamenali súbor odpovedí, môže byť potrebné upraviť niektoré hodnoty v súbore odpovedí.

Keď používate súbory odpovedí, nezabudnite, že v týchto súboroch môžu byť uložené dôverné informácie, napríklad mená užívateľov a heslá, preto je dôležité manažovať tieto súbory spôsobom, ktorý bráni neautorizovanému prístupu k dôveryhodným informáciám. Okrem toho, nie všetky zhromažďovania údajov sú vhodné pre voľbu tichého zhromažďovania. Niektoré zhromažďovania údajov vždy vyžadujú istú interakciu s užívateľom. Môžete byť napríklad požiadaný o reprodukovanie problému počas zhromažďovania údajov, aby sa zhromaždili potrebné protokolovacie súbory a súbory sledovania. V tomto prípade nedokáže tiché zhromažďovanie zaznamenať a reprodukovať tento krok.

Pridanie páuz do súboru odpovedí

Od verzie 1.3.4 nástroja ISA Lite sa zmenil formát súboru odpovedí, aby bol lepšie človekom čitateľný a upraviteľný. Súbor vyzerá veľmi podobne ako súbor vlastností Java. Komentáre začínajú znakom '#' a informácie sú tvorené pármi kľúč-hodnota.

Teraz existuje možnosť pridať do nových súborov odpovedí pauzy (pomocou vášho obľúbeného editora). Nasleduje stručný súhrn dvoch nových podporovaných kľúčov:

Poznámky

Určenie informácií o verzii

Verzia nástroja (a jeho rôznych podkomponentov) je predvolene uvedená v konzole, z ktorej sa spustil nástroj. Ak používate režim grafického užívateľského rozhrania, informácie o verzii tiež možno nájsť vo voľbe ponuky Pomoc -> Informácie. Ak nie je dostupné Java alebo Java aplikáciu nemožno spustiť, verziu nástroja tiež môžete zistiť spustením spúšťacích skriptov s voľbou "-version".

Keď použijete voľbu "-version", spúšťacie skripty vypíšu informácie o verzii bez skutočného spustenia nástroja.

Podpora proxy pre odosielanie cez HTTPS

Ak sa používa JRE, verzia 1.5 alebo novšia, pre odosielanie sa predvolene použije proxy definované v systéme. V operačnom systéme Windows prostredie JRE používa konfiguráciu proxy z prehliadača Internet Explorer. V operačnom systéme Linux prostredie JRE používa konfiguráciu proxy z GNOME 2. Ak chcete toto správanie nahradiť a zadať iné proxy, použite voľbu "-promptForProxy".

Ochranné známky 

IBM, logo IBM a AIX sú ochranné známky alebo registrované ochranné známky spoločnosti International Business Machines v USA alebo iných krajinách.

 Java a všetky s ňou súvisiace ochranné známky sú ochrannými známkami spoločnosti Sun Microsystems, Inc. v USA alebo iných krajinách.

Microsoft, Windows, Windows NT a logo Windows sú ochranné známky spoločnosti Microsoft Corporation v USA alebo iných krajinách.

UNIX je registrovaná ochranná známka spoločnosti Open Group v USA a iných krajinách.

Linux je ochranná známka Linusa Torvaldsa v USA alebo iných krajinách.

HP-UX je registrovaná ochranná známka spoločnosti Hewlett-Packard Company.

Iné názvy spoločností, produktov alebo služieb môžu byť ochranné známky alebo značky služieb iných subjektov.