L'eina IBM® Support Assistant Lite es proporciona com a ajuda per resoldre problemes amb els productes de programari d'IBM. L'eina se centra en la recollida automàtica de dades sobre problemes. També proporciona suport d'anàlisi de símptomes per a diverses categories de problemes que detecten els productes de programari d'IBM. Es recull i s'analitza la informació pertinent a un tipus de problema per ajudar-vos a identificar l'origen del problema que s'investiga. L'eina ajuda als clients reduint la quantitat de temps que triga a reproduir un problema amb els nivells de traça adequats definits i reduint l'esforç necessari per enviar la informació d'anotacions adequada al servei de suport d'IBM. En aquesta guia d'ajuda, us indicarem com començar a utilitzar l'eina IBM Support Assistant Lite.
En la majoria dels casos, la seqüència de passos següent us permetrà començar a utilitzar l'eina. Si trobeu problemes o voleu més informació sobre qualsevol dels passos, podeu consultar els apartats següents.
En tots els casos, la instal·lació de l'eina IBM Support Assistant Lite consisteix simplement a extreure els fitxers de l'arxiu que heu baixat. Els fitxers es poden extreure a qualsevol ubicació del sistema de fitxers que trieu del sistema on executareu l'eina. Això crearà un subdirectori \ISALite en aquest directori de destinació.
Independentment de si utilitzeu l'eina IBM Support Assistant Lite en mode de GUI o en mode de consola de línia d'ordres, el procediment per iniciar-la és el mateix: s'invoca l'script d'inici corresponent des d'una línia d'ordres. En el cas d'un sistema Windows, aquests scripts d'inici són fitxers de lot. En el cas dels altres entorns, són scripts d'intèrpret d'ordres.
Com que l'eina s'implementa com una aplicació Java, cal definir la variable d'entorn JAVA_HOME perquè es pugui iniciar. Si Java no està disponible a la variable PATH, haureu de definir la variable d'entorn JAVA_HOME manualment. L'eina IBM Support Assistant Lite exigeix un JRE amb un nivell 1.4.2 o superior (1.5 o superior al Windows 7 de 64 bits), per la qual cosa cal que us assegureu que hi ha un JRE adequat instal·lat al sistema on s'executarà l'eina. Si n'hi ha un, haureu d'executar una ordre específica del sistema operatiu per definir la variable JAVA_HOME de manera que apunti a aquest JRE. La JVM i el JDK de Microsoft i gij (GNU libgcj) no s'admeten. Per exemple, si teniu jdk1.4.2 instal·lat a c:\jre1.4.2 en una plataforma Windows, definiríeu JAVA_HOME amb l'ordre següent:
SET JAVA_HOME=c:\jre1.4.2
En una plataforma Linux, AIX, HP-UX o Solaris, la sintaxis d'ordre exacta per definir JAVA_HOME varia en funció de l'intèrpret d'ordres que utilitzeu. Per exemple, si utilitzeu l'intèrpret d'ordres bash i teniu el JDK instal·lat a /opt/jre142, definiríeu JAVA_HOME amb l'ordre següent:
export JAVA_HOME=/opt/jre142
Després d'instal·lar l'eina en una de les ubicacions per defecte, és possible que trobeu que no pot iniciar-se i que mostra un missatge d'error semblant a "ERROR: Aquesta eina exigeix un JRE 1.4.2 o superior per executar-se." Aquest missatge indica que el JRE té un nivell inferior a 1.4.2. En aquest cas, haureu de definir la variable JAVA_HOME manualment perquè apunti a un JRE del nivell adequat.
Caldrà que executeu l'script d'inici següent:
Si no hi ha disponible una GUI, l'eina s'hauria d'iniciar en mode de línia d'ordres de forma automàtica. Si es prefereix el mode de consola encara que hi hagi una GUI disponible, especifiqueu "-console" a la línia d'ordres. En alguns casos, no serà possible determinar que una GUI no està disponible i l'eina no s'iniciarà. En aquests casos, caldrà reiniciar l'eina amb "-console".
Per defecte, el directori d'instal·lació de l'ISA Lite s'utilitza per emmagatzemar els fitxers creats durant l'execució. En alguns sistemes, el directori d'instal·lació de l'ISA Lite serà només de lectura. En aquest cas, utilitzeu el paràmetre -useHome. Aquest paràmetre farà que els fitxers temporals s'escriguin al directori temporal del sistema i els fitxers persistents s'escriguin al directori d'inici de l'usuari.
Un cop que s'ha iniciat l'eina IBM Support Assistant Lite en mode de GUI, apareixerà la interfície gràfica que es mostra tot seguit.
Per poder utilitzar l'eina per realitzar la recollida i l'anàlisi de les dades, cal que seleccioneu, en primer lloc, un tipus de problema a la finestra Tipus de problema, com es mostra tot seguit.
A banda del tipus de problema, l'únic valor de camp d'entrada que heu d'indicar a la GUI principal és un nom de fitxer per al fitxer zip de recollida de dades. En aquest punt, el nom del fitxer pot ser el que vulgueu: podeu utilitzar, per exemple, el nom de fitxer instal·lació_fallida_03_01_2007. Si no l'indiqueu, l'eina li afegirà de forma automàtica l'extensió "zip". Si teniu, però, un PMR obert per al problema per al qual efectueu la recollida i si deixeu que l'eina transmeti per FTP els resultats de la recollida al servei de suport d'IBM, l'eina, quan arribi al pas de transmissió per FTP, aplicarà un conveni de denominació específic necessari per al servei de suport d'IBM: el nom del fitxer ha de començar per tres camps específics: <númeroPRM>.<númeroBranca>.<codiPaís>.<descripció breu>.zip. Un exemple d'un nom de fitxer d'aquest tipus seria 34143.055.000.logs.zip. Per conservar la compatibilitat amb un format anterior, també s'accepten les comes en lloc dels tres primers punts (però no en lloc del quart punt abans de l'extensió "zip"). De tota manera, els punts són el delimitador preferit.
Amb aquests valors emplenats, el pas següent es prémer el botó Recollida de dades. Mentre treballa, l'script de recollida us demanarà informació addicional que li cal per dur a terme les seves activitats de recollida. Un script pot demanar-vos informació de configuració, informació sobre la seqüència d'incidències que us han dut al problema que teniu o les vostres preferències sobre com s'hauria de realitzar la recollida. Quan es tingui tota la informació necessària, l'script continuarà amb la resta de la recollida.
Quan l'eina finalitzi la recollida de dades, podeu enviar els resultats al servei de suport d'IBM. Podeu triar entre FTP, sense xifrar, i HTTPS, amb xifratge, per a la transferència del fitxer. El nom del fitxer zip que l'eina envia al servei de suport d'IBM serà el nom de fitxer que s'hagi introduït al quadre de nom i camí d'accés del fitxer de sortida, amb el nom de l'amfitrió del servidor i la indicació de data i hora afegits al nom.
Exemple: si el nom i el camí d'accés del fitxer de sortida que s'utilitza és 34143.055.000.logs.zip, el nom del fitxer zip que s'enviarà a IBM seria:
34143.055.000.logs.zip-<nomAmfitrió>-<indicacióDataHoraActual>.zip.
La automatització al lloc FTP del servei de suport d'IBM ftp.emea.ibm.com depèn totalment del conveni de denominació que es descriu a la GUI principal de l'eina IBM Support Assistant. Si rep un fitxer amb un nom que no segueix aquest conveni, el servei de suport d'IBM no veu mai aquest fitxer. Per tant, abans que l'eina invoqui una operació d'FTP per enviar un fitxer zip de recollida a ftp.emea.ibm.com, valida el nom del fitxer zip de recollida seguint el conveni. Si el nom del fitxer no té el format correcte, apareixerà una finestra emergent perquè pugueu corregir el nom del fitxer. El conveni de denominació de fitxers actual per al lloc FTP és el que es documenta aquí, on els camps individuals del nom de fitxer compost se separen mitjançant punts. Abans, però, el conveni era utilitzar comes com a separadors. Com que el lloc FTP encara gestiona els fitxers amb nom que s'ajusta al conveni anterior, la lògica de validació de l'eina IBM® Support Assistant Lite accepta tant punts com comes com a delimitadors.
Quan l'IBM Support Assistant Lite s'executa en mode de consola de línia d'ordres, no hi ha cap llista de selecció ni camp d'entrada per a l'entrada de l'usuari. En comptes, les opcions disponibles es presenten com a llistes numerades on cal entrar el número de selecció seguit per la tecla Retorn. Els camps d'entrada es transformen en sol·licituds en les quals s'especifica una resposta i es prem la tecla Retorn.
Per aturar l'eina del col·lector, escriviu quit al mode de consola.
L'eina us sol·licitarà noms de fitxer. A les plataformes Unix, no s'admet l'ús de "~" com a designació del directori inicial de l'usuari. Si s'utilitza "~", es referenciarà un subdirectori sota el directori de treball actual amb el nom "~".
El mode de consola també proporciona una característica de recollida silenciosa que permet enregistrar les respostes d'una sessió de mode de consola en un fitxer i, tot seguit, utilitzar el fitxer per controlar les execucions posteriors del mateix script de recollida.
Per aconseguir això, primer heu de crear un "fitxer de respostes" que contingui les respostes a totes les preguntes d'una execució concreta amb el col·lector de dades. La propera vegada que calgui executar la mateixa recollida de dades, només heu de proporcionar el fitxer de respostes quan inicieu l'eina i les respostes que heu indicat anteriorment s'utilitzaran per respondre a totes les preguntes. Els fitxers de respostes es poden manipular i modificar per canviar les respostes i dur a terme també diferents recollides de dades.
Per crear un fitxer de respostes, invoqueu simplement l'eina en mode de consola de línia d'ordres amb l'opció -record, seguida del nom del fitxer de respostes. Per exemple, en un entorn Linux, executaríeu:
./runISALite.sh -console -record response.txt
Quan treballeu en aquest mode, accedireu a una sessió interactiva ordinària, on indicareu les respostes a les sol·licituds de l'script. A més d'influir en la recollida actual, les respostes també es desen, però, al fitxer al qual heu assignat un nom. Un vegada que la sessió interactiva ha finalitzat, podeu utilitzar el fitxer de respostes per executar el mateix script en el futur sense la necessitat d'una entrada d'usuari explícita.
Per exemple, per executar l'eina en mode silenciós en un entorn UNIX amb el fitxer de respostes que heu enregistrat, executeu:
./runISALite.sh -console response.txt
El fitxer de respostes és un fitxer de text pla i, per tant, el podeu editar per canviar les respostes de l'usuari, segons calgui. Per exemple, si voleu executar l'eina en un sistema diferent del sistema on s'ha enregistrat el fitxer de respostes, és possible que hàgiu d'ajustar alguns dels valors del fitxer de respostes.
Quan utilitzeu fitxers de respostes, recordeu que la informació confidencial, com ara els noms d'usuari i les contrasenyes, es poden emmagatzemar en aquests fitxers, per la qual cosa és important que gestioneu aquests fitxers de manera que s'impedeixi l'accés no autoritzat a la informació confidencial. A més a més, no totes les recollides de dades són adequades per a l'opció de recollida silenciosa. Algunes recollides de dades sempre exigeixen algunes interaccions amb l'usuari. Per exemple, és possible que se us demani que reproduïu el problema durant la recollida de dades perquè es recullin els fitxers d'anotacions i traça adequats. En aquest cas, la recollida silenciosa no pot enregistrar i reproduir aquest pas.
A partir de l'ISA Lite V1.3.4, el format de fitxer de respostes ha canviat perquè es pugui llegir i editar millor. El fitxer té un aspecte molt similar a un fitxer de propietats Java, amb comentaris que comencen amb '#' i una sèrie de parells de clau i valor.
Ara es poden afegir pauses a aquests fitxers de respostes nous (amb l'editor favorit). Tot seguit hi ha un breu resum de les dues claus noves que s'admeten:
Notes
Per defecte, la versió de l'eina (i els seus diversos subcomponents) s'imprimeix a la consola des de la qual s'ha iniciat. Quan s'executa en mode de GUI, la informació de versió es pot trobar utilitzant l'opció de menú Ajuda->Quant a. Si Java no està disponible o l'aplicació Java no es pot iniciar, també podeu obtenir la versió de l'eina executant els scripts d'inici amb l'opció "-version".
Quan s'utilitza l'opció "-version", els scripts d'inici imprimeixen la informació de versió sense invocar realment l'eina.
IBM, el logotip d'IBM i AIX son marques comercials o marques registrades d'International Business Machines Corportation als Estats Units i/o a altres països.
Java i totes les marques registrades basades en Java són marques registrades de Sun Microsystems, Inc. als Estats Units i/o a altres països.
Microsoft, Windows, Windows NT i el logotip del Windows són marques registrades de Microsoft Corporation als Estats Units i/o a altres països.
UNIX és una marca registrada de The Open Group als Estats Units i/o a altres països.
Linux és una marca registrada de Linus Torvalds als Estats Units i/o a altres països.
HP-UX es una marca registrada de Hewlett-Packard Company.
Altres noms d'empreses, productes o serveis poden ser marques registrades o de servei de tercers.