Unealta IBM® Support Assistant Lite este furnizată ca un ajutor pentru depanarea problemelor la produsele de software IBM. Unealta se concentrează pe colectarea automată a datelor problemelor. De asemenea furnizează un suport pentru analiza simptomurilor pentru diferitele categorii de probleme întâlnite în produsele software IBM. Informaţii pertinente despre tipul problemei sunt colectate şi analizate pentru a vă ajuta să identificaţi originea problemei care este investigată. Unealta vă ajută reducând durata necesară pentru a reproduce o problemă cu nivelurile corecte de urmărire setate, precum şi reducând efortul necesar pentru a aduna informaţiile de istoric corespunzătoare necesare pentru IBM Support. Dacă acest ajutor vă este de folos, vă vom spune cum să faceţi funcţională unealta IBM Support Assistant Lite.
În majoritatea cazurilor, următoarea secvenţă de paşi va pregăti unealta pentru a deveni funcţională. Dacă întâmpinaţi probleme sau dacă aţi dori informaţii suplimentare despre oricare dintre aceşti paşi, puteţi consulta secţiunile de mai jos care o urmează pe aceasta.
În toate cazurile, instalarea uneltei IBM Support Assistant Lite este pur şi simplu o problemă de extragere a fişierelor din arhiva pe care aţi descărcat-o. Fişierele se pot extrage în orice locaţie de sistem de fişier pe care o alegeţi dumneavoastră pe sistemul pe care veţi rula unealta. Aceasta va crea un subdirector \ISALite în acest director vizat.
Indiferent dacă veţi utiliza unealta IBM Support Assistant Lite în modul GUI sau în modul consolă linie de comandă, utilizaţi aceeaşi procedură pentru a o porni: invocaţi scriptul de lansare corespunzător dintr-o linie de comandă. În cazul unui sistem Windows, aceste scripturi de lansare sunt fişiere batch. Pentru celelalte medii, acestea sunt scripturi shell.
Din moment ce unealta este implementată ca o aplicaţie Java, este necesar să setaţi variabila de mediu JAVA_HOME, înainte ca unealta să poată să pornească. Dacă Java nu este disponibil în PATH, va trebui să setaţi manual variabila de mediu JAVA_HOME. Unealta IBM Support Assistant Lite solicită un JRE la nivelul 1.4.2 sau mai mare (1.5 sau mai mare pe Windows 7, 64 de biţi), astfel încât trebuie mai întâi să vă asiguraţi că un JRE potrivit este instalat pe sistemul pe care va rula unealta. Dacă este, atunci trebuie să emiteţi o comandă specifică sistemului de operare pentru a seta variabila JAVA_HOME pentru a arăta către acest JRE. Nu sunt suportate Microsoft JVM/JDK şi gij (GNU libgcj). De exemplu, dacă aveţi jdk1.4.2 instalat la c:\jre1.4.2 pe o platformă Windows, setaţi JAVA_HOME utilizând următoarea comandă:
SET JAVA_HOME=c:\jre1.4.2
Pe o platformă Linux, AIX, HP-UX sau Solaris, sintaxa exactă a comenzii de setare a variabilei de mediu JAVA_HOME depinde de ce shell folosiţi. De exemplu, dacă folosiţi bash shell şi aveţi JDK-ul instalat în /opt/jre142, veţi seta variabila JAVA_HOME folosind următoarea comandă:
export JAVA_HOME=/opt/jre142
După instalarea uneltei într-una din locaţiile implicite, s-ar putea să eşueze la pornire cu mesajul de eroare "EROARE: Această unealtă necesită JRE versiunea 1.4.2 sau versiuni ulterioare pentru a rula." Acest mesaj indică faptul că JRE este la un nivel mai mic decât 1.4.2. Dacă acesta este cazul, va trebui să setaţi manual variabila JAVA_HOME pentru a indica la un JRE de nivel corespunzător.
Va trebui să emiteţi următorul script de lansare:
Dacă nu este disponibilă o interfaţă grafică (GUI), unealta va porni automat în modul linie de comandă. Dacă se doreşte modul consolă chiar şi când este disponibilă o interfaţă grafică, specificaţi "-console" în linia de comandă. În unele cazuri, nu va fi posibil să se determine dacă o interfaţă grafică este sau nu disponibilă, iar unealta nu va porni. În aceste instanţe, unealta va trebui repornită folosind "-console".
Implicit, directorul de instalare ISA Lite este folosit pentru stocarea fişierelor create în timpul execuţiei. Pe unele sisteme, directorul de instalare ISA Lite va fi disponibil doar pentru citire. În acest caz, folosiţi parametrul -useHome. Acest parametru va face ca fişierele temporare să fie scrise în directorul temporar al sistemului şi fişierele persistente în directorul home al utilizatorului.
După ce unealta IBM Support Assistant Lite a fost pornită în modul GUI, se va afişa interfaţa grafică prezentată mai jos.
Înainte ca unealta să poată fi folosită pentru colectarea şi analiza datelor, trebuie mai întâi să selectaţi un tip de problemă în fereastra Tip problemă, aşa cum se arată mai jos.
În afară de tipul problemei, singura valoare de câmp de intrare pe care trebuie să o furnizaţi pe interfaţa grafică principală este numele fişierului pentru fişierul zip de colectare a datelor. La acest punct, numele fişierului poate fi orice doriţi, de exemplu folosiţi numele de fişier Instalare_esuata_2007_01_03. Dacă nuspecificaţi altceva, unealta va adăuga automat la sfârşit extensia "zip". Totuşi, dacă aveţi un PMR deschis pentru problema pentru care faceţi colectarea şi veţi lăsa unealta să trimită automat prin FTP rezultatele colecţiei la IBM Support, atunci pentru pasul FTP unealta va impune o convenţie de numire specifică cerută de IBM Support: numele fişierului trebuie să înceapă cu trei câmpuri specifice: <număr_pmr>.<număr_filială>.<cod_de_ţară>.<scurtă_descriere>.zip. Un exemplu de nume de fişier ar fi 34143.055.000.logs.zip. Pentru compatibilitatea cu formatul anterior, virgula este şi ea acceptată în locul primelor trei puncte (dar nu şi în locul celui de al patrulea dinaintea extensiei "zip"). Totuşi, punctele sunt preferate.
Cu aceste câmpuri completate în următorul pas trebuie să apăsaţi butonul Colectare Date. Pe măsură ce se derulează, scriptul de colectare vă va cere informaţii suplimentare de care are nevoie pentru finalizarea acţiunilor sale de colectare. Un script vă poate cere informaţii de configuraţie, informaţii despre secvenţa de evenimente care au dus la apariţia probleme cu care vă confruntaţi sau pentru preferinţele cu privire la modul în care ar trebui să finalizeze colectarea. După ce are toate informaţiile necesare, scriptul va continua cu restul colectării.
Când unealta termină colectarea datelor, puteţi trimite rezultatele la IBM Support. Puteţi alege pentru transferul fişierelor între FTP, care nu este criptat şi HTTPS, care este criptat. Numele fişierului zip pe care unealta îl trimite la IBM Support va fi numele de fişier introdus în caseta Nume fişier de ieşire/Cale, cu numele de gazdă al serverului şi amprenta de timp curentă adăugate la el.
Exemplu: dacă numele de fişier din Output Filename/Path a fost 34143.055.000.logs.zip, numele fişierului trimis la IBM va fi
34143.055.000.logs.zip-<hostname>-<currentTimestamp>.zip.
Automatizarea de pe situl FTP al IBM Support, ftp.emea.ibm.com, depinde în întregime de convenţia de numire a fişierelor descrisă în interfaţa grafică a uneltei IBM Support Assistant Lite. Dacă primeşte un fişier cu un nume care nu se supune acestei convenţii, atunci fişierul nu va fi văzut niciodată de IBM Support. În consecinţă, înainte de a invoca operaţia FTP pentru a trimite fişierul zip al colecţiei la ftp.emea.ibm.com, unealta verifică dacă numele fişierului zip al colecţiei este corespunzător convenţiei de numire. Dacă numele fişierului nu are forma corectă, vi se va prezenta o fereastră pop-up, ca să puteţi corecta numele fişierului. Convenţia de numire fişiere pentru situl FTP este cea documentată aici, unde câmpurile individuale din numele de fişier compus sunt separate de puncte. Înainte, convenţia presupunea folosirea virgulelor. Deoarece situl FTP încă mai tratează şi fişiere numite după convenţia anterioară, logica de validare a uneltei IBM® Support Assistant Lite acceptă amândoi separatorii, punctul şi virgula.
Când IBM Support Assistant Lite rulează în mod linie de comandă, nu există liste de selectări sau câmpuri de intrare pentru completare de către utilizator. În schimb, alegerile disponibile sunt prezentate ca liste numerotate şi introduceţi numărul selecţiei urmat de tasta Enter. Câmpurile de completat sunt transformate în prompt-uri la care introduceţi răspunsul şi apăsaţi Enter.
Pentru a opri unealta de colectare, tastaţi quit în modul consolă.
Unealta va afişa un prompt pentru numele de fişiere. Pe platformele Unix, nu este suportată folosirea "~" pentru desemnarea directorului HOME al utilizatorului. Dacă este folosit "~", va fi referit un subdirector de sub directorul de lucru curent cu numele "~".
Modul consolă vă furnizează de asemenea o caracteristică pentru colectarea silenţioasă care vă permite să înregistraţi răspunsurile de la o sesiune de consolă într-un fişier, şi apoi să folosiţi fişierul pentru a controla execuţii ulterioare ale aceluiaşi script de colectare.
Pentru a realiza aceasta, creaţi mai întâi un "fişier de răspunsuri" care conţine răspunsurile la toate întrebările pentru o anumită rulare prin colectorul de date. Data viitoare când aceeaşi colectare de date trebuie să fie executată, doar furnizaţi fişierul de răspunsuri la pornirea uneltei, iar răspunsurile care au fost furnizate anterior vor fi folosite pentru a răspunde la toate întrebările. Fişierele de răspunsri pot fi adaptate şi modificate pentru a varia răspunsurile în scopul realizării de colecţii de date diferite.
Pentru a crea un fişier de răspunsuri, veţi invoca unealta în modul consolă line de comandă cu opţiunea -record, urmată de numele fişierului de răspunsuri. De exemplu, într-un mediu Linux, veţi rula:
./runISALite.sh -console -record response.txt
Când rulaţi în acest mod, veţi fi dus într-o sesiune interactivă obişnuită, unde furnizaţi răspunsurile prompturilor scriptului. În plus faţă de influenţarea colectării curente, răspunsurile dumneavoastră sunt salvate în fişierul pe care l-aţi numit. după ce sesiunea interactivă se termină, puteţi folosi fişierul de răspunsuri pentru a executa acelaşi script în viitor fără a mai fi nevoie de intrări explicite de la utilizator.
De exemplu, pentru a rula unealta în modul silenţios într-un mediu UNIX folosind fişierul de răspunsuri pe care l-aţi înregistrat, rulaţi:
./runISALite.sh -console response.txt
Fişierul de răspunsuri este un fişier text simplu, pe care-l puteţi edita şi modifica răspunsurile după cum aveţi nevoie. De exemplu, dacă vreţi să rulaţi unealta pe un alt sistem decât pe cel pe care au fost înregistrate răspunsurile, s-ar putea să fie nevoie să ajustaţi unele dintre valorile din fişierul de răspunsuri.
Când folosiţi fişiere de răspuns, trebuie să ţineţi cont că în acestea sunt memorate şi informaţii sensibile, cum ar fi nume de utilizator şi parole, aşa că este important ca aceste fişiere să fie gestionate într-un mod în care să nu se permită accesul neautorizat. De asemenea, nu toate colectările se pretează la opţiunea de colectare silenţioasă. Unele colectări de date cer întotdeauna interacţiunea cu utilizatorul. De exemplu, vi se poate cere să reproduceţi problema în timpul colectării datelor, pentru a se colecta fişierele de urmărire şi istoricele corespunzătoare. În acest caz, colectarea silenţioasă nu este capabilă să înregistreze şi să reproducă acest pas.
Începând cu ISA Lite V1.3.4, formatul fişierului de răspunsuri a fost modificat pentru a putea fi mai uşor citit şi editat de către utilizator. Fişierul seamănă cu un fişier de proprietăţi Java, cu comentarii care încep cu '#' şi o serie de perechi cheie-valoare.
Există acum o posibilitate de a adăuga pauze în aceste noi fişiere de răspunsuri (folosind editorul dumneavoastră preferat). Urmează un mic sumar al celor două noi chei suportate:
Note
Implicit, versiunea uneltei (şi a diverselor sale componente) este tipărită la consola de pe care a fost lansată. Când rulaţi în modul GUI, informaţiile de versiune pot fi găsite folosind opţiunea de meniu Ajutor->Despre. Dacă Java nu este disponibil sau aplicaţia Java nu poate porni, puteţi să obţineţi versiunea uneltei prin rularea scripturilor cu opţiunea "-version".
Când folosiţi opţiunea "-version", scripturile de lansare vor tipări informaţiile de versiune, fără să lanseze de fapt unealta.
IBM, sigla IBM şi AIX sunt mărci comerciale sau mărci comerciale înregistrate deţinute de International Business Machines Corporation în Statele Unite, în alte ţări sau ambele:
Java şi toate mărcile comerciale bazate pe Java sunt mărci comerciale deţinute de Sun Microsystems, Inc. în Statele Unite, în alte ţări sau ambele.
Microsoft, Windows, Windows NT şi sigla Windows sunt mărci comerciale deţinute de Microsoft Corporation în Statele Unite, în alte ţări sau ambele.
UNIX este o marcă comercială înregistrată deţinută de The Open Group în Statele Unite şi în alte ţări.
Linux este o marcă comercială deţinută de Linus Torvalds în Statele Unite, în alte ţări sau ambele.
HP-UX este o marcă comercială a companiei Hewlett-Packard.
Alte nume de servicii, produse sau companii ar putea fi mărci comerciale sau mărci de servicii ale altora.