IBM® Support Assistant Lite-værktøjet er en hjælp til fejlfinding i IBM-programmer. Værktøjet fokuserer på automatisk indsamling af data for problemer. Det understøtter også symptomanalyse for de forskellige typer af problemer, der kan opstå med IBM-programmer. Oplysninger om en problemtype indsamles og analyseres for at hjælpe med til at identificere årsagen til det problem, der undersøges. Værktøjet hjælper kunderne ved at reducere den tid, det tager at reproducere et problem med de relevante sporingsniveauer, samt ved at reducere det arbejde, der kræves for at sende de relevante logoplysninger til IBM Support. I denne vejledning fortæller vi dig, hvordan du kommer i gang med IBM Support Assistant Lite.
Hvis du følger nedenstående trin, kan du i de fleste tilfælde derefter anvende værktøjet. Hvis der opstår problemer, eller hvis du vil have flere oplysninger om disse trin, kan du læse de følgende afsnit.
Installation af IBM Support Assistant Lite-værktøjet foregår i alle tilfælde ved blot at pakke filerne ud fra det arkiv, du har hentet. Filerne kan pakkes ud til en hvilken som helst placering, som du vælger, i filsystemet på det system, hvor værktøjet skal udføres. Derved oprettes underbiblioteket \ISALite i målbiblioteket.
Uanset om du anvender IBM Support Assistant Lite-værktøjet i grafisk tilstand eller på kommandolinjen i konsoltilstand, startes værktøjet på samme måde: Du skal aktivere det relevante startscript fra en kommandolinje. Hvis det er et Windows-system, er disse startscripts batchfiler. I andre systemmiljøer er det shellscripts.
Da værktøjet er implementeret som et Java-program, skal JAVA_HOME-miljøvariablen angives, før værktøjet kan startes. Hvis Java ikke er tilgængelig i PATH-angivelsen, skal du angive JAVA_HOME-miljøvariablen manuelt. IBM Support Assistant Lite-værktøjet kræver JRE på niveau 1.4.2 eller højere (1.5 eller højere på Windows 7 64 bit), så du skal først kontrollere, at der er installeret en passende JRE på det system, hvor værktøjet skal køre. Hvis det er tilfældet, skal du udføre en styresystemspecifik kommando for at angive, at JAVA_HOME-variablen skal pege på denne JRE. Microsoft JVM/JDK og gij (GNU libgcj) understøttes ikke. Hvis du f.eks. har installeret jdk1.4.2 i c:\jre1.4.2 på en Windows-platform, skal du angive JAVA_HOME ved hjælp af følgende kommando:
SET JAVA_HOME=c:\jre1.4.2
På Linux, AIX, HP-UX eller Solaris afhænger den nøjagtige kommandosyntaks til angivelse af JAVA_HOME af, hvilket shell du bruger. Hvis du for eksempel bruger bash-shell, og du har installeret JDK i /opt/jre142, skal du angive JAVA_HOME ved hjælp af følgende kommando:
export JAVA_HOME=/opt/jre142
Når du har installeret værktøjet på en af standardplaceringerne, kan du komme ud for, at det ikke starter med fejlmeddelelsen "FEJL: Dette værktøj kræver JRE 1.4.2 eller nyere for at køre". Denne meddelelse betyder, at JRE er på et lavere niveau end 1.4.2. I så fald skal du angive variablen JAVA_HOME manuelt, så den peger på en JRE med det rigtige niveau.
Du skal sende følgende startscript:
Hvis der ikke er en grafisk brugergrænseflade tilgængelig, skulle værktøjet automatisk starte i kommandolinjetilstand. Hvis du vil benytte konsoltilstand, selvom en grafisk brugergrænseflade er tilgængelig, skal du skrive "-console" på kommandolinjen. I nogle tilfælde kan det ikke fastslås, at der ikke er en grafisk brugergrænseflade tilgængelig, og værktøjet kan ikke starte. I så fald skal værktøjet startes igen ved hjælp af "-console".
ISA Lite-installationsbiblioteket bruges som standard til at gemme filer, der oprettes under udførelsen. På nogle systemer er ISA Lite-installationsbiblioteket skrivebeskyttet. I så fald skal du bruge parameteren -useHome. Denne parameter gør, at midlertidige filer skrives til systemets temp-bibliotek, og faste filer skrives til brugerens hjemmebibliotek.
Når IBM Support Assistant Lite-værktøjet er startet i grafisk tilstand, vises den grafiske brugergrænseflade, der er vist nedenfor.
Før værktøjet kan bruges til at udføre dataindsamling og analyse, skal du vælge en problemtype i vinduet Problemtype som illustreret nedenfor.
Bortset fra Problemtype er den eneste værdi, du skal angive i et inputfelt i den grafiske brugergrænseflade, et filnavn til zip-filen til dataindsamling. På dette tidspunkt kan du angive det filnavn, du ønsker. Du kan f.eks. bruge filnavnet Installation_mislykket_2007_01_03. Hvis du ikke angiver filtypenavnet, vedhæfter værktøjet automatisk "zip" til filnavnet. Hvis du har en åben PMR for det problem, du udfører indsamlingen for, og du lader værktøjet overføre indsamlingsresultaterne automatisk via FTP til IBM Support, vil værktøjet i FTP-trinnet gennemtvinge en bestemt konvention for filnavn, som IBM Support kræver: Filnavnet skal starte med tre bestemte felter: <pmrnummer>.<branchenummer>.<landekode>.<kort beskrivelse>.zip. Et eksempel på et filnavn af denne type er 34143.055.000.logge.zip. Af hensyn til kompatibilitet med et tidligere format kan der også benyttes kommaer i stedet for de første tre punktummer (men ikke i stedet for det fjerde, der står før filtypenavnet "zip"). Det foretrukne skilletegn er dog punktum.
Når disse værdier er udfyldt, er næste trin at trykke på knappen Indsaml data. Mens indsamlingsscriptet kører, bliver du spurgt om eventuelle andre oplysninger, som scriptet skal bruge til at gennemføre indsamlingsaktiviteterne. Et script kan også spørge dig om konfigurationsoplysninger, oplysninger om rækkefølgen af hændelser, der førte frem til det problem, du arbejder med, eller om dine præferencer for, hvordan scriptet skal afslutte indsamlingen. Når scriptet har alle de oplysninger, det skal bruge, fortsætter det med resten af indsamlingen.
Når værktøjet er færdigt med dataindsamlingen, kan du sende resultaterne til IBM Support. Du kan vælge at overføre filen ved hjælp af FTP, der ikke er krypteret, og HTTPS, der er krypteret. Navnet på den zip-fil, som værktøjet sender til IBM Support, er det filnavn, der er indtastet i feltet Outputfilnavn/sti, med værtsnavnet på serveren og det aktuelle tidsstempel vedhæftet.
Eksempel: Hvis det anvendte Outputfilnavn/sti var 34143.055.000.logge.zip, er navnet på den zip-fil, der sendes til IBM:
34143.055.000.logge.zip-<værtsnavn>-<aktueltTidsstempel>.zip.
Automatiseringen af IBM Supports FTP-sted ftp.emea.ibm.com afhænger fuldt og helt af den konvention for filnavn, der er beskrevet i den overordnede grafiske brugergrænseflade i IBM Support Assistant Lite-værktøjet. Hvis der modtages en fil med et navn, der ikke overholder denne konvention, ser IBM Support aldrig filen. Før værktøjet starter en FTP-handling for at sende en indsamlings-zip-fil til ftp.emea.ibm.com, kontrollerer det derfor navnet på indsamlings-zip-filen i forhold til konventionen. Hvis filnavnet ikke er i det rigtige format, vises der et pop op-vindue, hvor du kan rette filnavnet. Den aktuelle konvention for filnavne på FTP-stedet er det format, der er dokumenteret her, hvor felterne i det sammensatte filnavn er adskilt med punktummer. Tidligere var konventionen imidlertid at benytte kommaer som skilletegn. Eftersom FTP-stedet stadig håndterer filer, der er navngivet i overensstemmelse med den tidligere konvention, accepterer IBM® Support Assistant Lite-værktøjets valideringslogik stadig både punktum og komma som skilletegn.
Når IBM Support Assistant Lite kører i konsoltilstand på kommandolinjen, er der ingen valglister eller indtastningsfelter til brugerinput. I stedet præsenteres de tilgængelige valg som nummererede lister, og du skal angive tallet for dit valg og derefter trykke på Enter. Inputfelter omdannes til instruktionstekster, hvor du skal angive dit svar og trykke på Enter.
Skriv quit i konsoltilstand for at stoppe indsamlingsværktøjet.
Værktøjet spørger om filnavne. På Unix-platforme understøttes brug af "~" som betegnelse for brugerens HOME-bibliotek ikke. Hvis der angives en "~", henvises der til et underbibliotek med navnet "~" under det aktuelle arbejdsbibliotek.
Konsoltilstand har også en funktion til indsamling uden brugerinput, hvor du kan registrere dine svar fra en session i konsoltilstand i en fil og derefter bruge filen til efterfølgende udførelse af det samme indsamlingsscript.
For at gøre dette skal du først oprette en "svarfil", der indeholder svarene på alle spørgsmål for en bestemt kørsel af dataindsamlingen. Næste gang den samme dataindsamling skal udføres, angiver du blot svarfilen, når du starter værktøjet. De svar, der tidligere blev opgivet, benyttes derefter til at besvare alle spørgsmål. Svarfiler kan også tilpasses og redigeres for at variere svarene med henblik på at udføre forskellige dataindsamlinger.
Hvis du vil oprette en svarfil, skal du blot starte værktøjet i konsoltilstand på kommandolinjen med parameteren -record efterfulgt af navnet på svarfilen. I et Linux-miljø ville du f.eks. køre:
./runISALite.sh -console -record svarfil.txt
Når du kører i denne tilstand, udføres der en normal interaktiv session, hvor du angiver svarene på scriptets spørgsmål. Men ud over at have betydning for den aktuelle indsamling bliver dine svar også gemt i den fil, du har angivet. Når den interaktive session er færdig, kan du bruge svarfilen til at udføre det samme script på et senere tidspunkt uden at have brug for eksplicit brugerinput.
Hvis du f.eks. vil køre værktøjet uden brugerinput i et UNIX-miljø med den svarfil, du indspillede, skal du køre:
./runISALite.sh -console svarfil.txt
Svarfilen er en almindelig tekstfil, så du kan redigere den for at rette brugersvarene efter behov. Hvis du for eksempel vil køre værktøjet på et andet system end det system, hvor svarfilen blev indspillet, skal du muligvis rette nogle af værdierne i svarfilen.
Når du bruger svarfiler, skal du være opmærksom på, at følsomme oplysninger som f.eks. brugernavne og kodeord kan blive gemt i filerne. Det er derfor vigtigt, at du håndterer filerne på en måde, der forhindrer uautoriseret adgang til følsomme oplysninger. Desuden er det ikke alle dataindsamlinger, der er egnet til indsamling uden brugerinput. Nogle dataindsamlinger kræver altid en vis grad af kommunikation med brugeren. Du kan f.eks. blive bedt om at genskabe problemet under dataindsamlingen for at oprette de korrekte log- og sporingsfiler. I sådanne tilfælde kan indsamling uden brugerinput ikke indspille og genskabe dette trin.
Fra og med ISA Lite V1.3.4 er formatet af svarfiler ændret, så de er lettere at læse og redigere. Filen ligner en Java-egenskabsfil med kommentarer, der starter med '#', og en række nøgle/værdi-par.
Det er nu muligt at tilføje pauser i de nye svarfiler i din foretrukne editor. Det følgende er en kort oversigt over de to nye nøgler, der understøttes:
Bemærkninger
Værktøjets version (og versionen af forskellige underkomponenter) vises som standard på den konsol, det blev startet fra. Når værktøjet kører i grafisk tilstand, kan du også finde versionsoplysningerne vha. menupunktet Hjælp->Om. Hvis Java ikke er tilgængelig, eller Java-programmet ikke kan starte, kan du også få oplyst værktøjets versionsnummer ved at køre startscriptene med parameteren "-version".
Når du bruger parameteren "-version", udskriver startscriptene versionsoplysningerne uden at starte værktøjet.
Varemærkerne IBM, IBM-logoet og AIX tilhører International Business Machines Corporation:
Varemærket Java og alle Java-baserede varemærker tilhører Sun Microsystems, Inc.
Varemærkerne Microsoft, Windows, Windows NT og Windows-logoet tilhører Microsoft Corporation.
Varemærket UNIX tilhører The Open Group.
Varemærket Linux tilhører Linus Torvalds.
Varemærket HP-UX tilhører Hewlett-Packard Company.
Alle andre varemærker anerkendes.