IBM® Support Assistant Lite



Innhold

Innledning
Trinn-for-trinn
Verktøyinstallering
    Installere verktøyet
Bruk av verktøyet
    Definere JAVA_HOME-miljøvariabelen
    Starte verktøyet i grafisk Swing-modus
    Starte verktøyet i konsollmodus (fra kommandolinjen)
    Plassering av filer som blir opprettet under utføring
    Interaksjon med verktøyet i grafisk Swing-modus
    Validering av filnavn for zip-fil for innsamlede data
    Interaksjon med verktøyet i konsollmodus (fra kommandolinjen)
    Fastslå versjonsinformasjon
    Proxy-støtte for HTTPS-opplastinger
Varemerker

Innledning

IBM® Support Assistant Lite er et hjelpemiddel til feilsøking for IBM-programvareprodukter. Verktøyet fokuserer på automatisk innsamling av problemdata. Det gir også støtte for symptomanalyse for de ulike kategoriene av problemer som kan oppstå for IBM-programvareprodukter. Informasjon vedrørende en problemtype samles inn og analyseres, slik at man kan finne ut hva som forårsaker det aktuelle problemet. Verktøyet hjelper deg ved å redusere tiden det tar å reprodusere et problem med riktige sporingsnivåer, og til at det kreves mindre innsats for å sende inn den nødvendige logginformasjonen til IBMs brukerstøtte. I denne veiledningen viser vi deg hvordan du kommer i gang med verktøyet IBM Support Assistant Lite.


Trinn-for-trinn

I de fleste tilfeller gjør sekvensen av trinn som er gjengitt nedenfor, det mulig for deg å komme i gang med å bruke verktøyet. Får du problemer, eller trenger du mer informasjon om noen av disse trinnene, kan du slå opp i seksjonene nedenfor.

  1. Installer verktøyet ved å trekke ut filene fra arkivfilen du har lastet ned.
  2. Kjør verktøyet i grafisk modus eller konsollmodus (fra kommandolinje).

Verktøyinstallering

Installere verktøyet

I alle tilfeller går installeringen av IBM Support Assistant Lite-verktøyet ut på å trekke ut filene fra arkivet du lastet ned. Filene kan trekkes ut til en hvilken som helst filplassering på systemet der du skal kjøre verktøyet. Da blir underkatalogen \ISALite opprettet i målkatalogen.


Bruk av verktøyet

Definere JAVA_HOME-miljøvariabelen

Uansett om du bruker verktøyet IBM Support Assistant Lite i grafisk modus eller konsollmodus, bruker du samme fremgangsmåte for å starte det: Start det aktuelle oppstartsskriptet fra en kommandolinje. På et Windows-system er disse oppstartsskriptene satsfiler (batchfiler). For andre miljøer er de skallskripter.

Siden verktøyet er implementert som Java-applikasjon, må du definere miljøvariabelen JAVA_HOME før verktøyet kan startes. Hvis Java ikke er tilgjengelig i PATH, må du definere miljøvariabelen JAVA_HOME manuelt. IBM Support Assistant Lite krever en JRE på nivå 1.4.2 eller høyere (1.5 eller høyere på Windows 7 64-bit), så du må først sørge for at en egnet JRE er installert på systemet der verktøyet skal kjøres. Er dette i orden, må du gi en operativsystemspesifikk kommando for å definere variabelen JAVA_HOME til å peke på denne JRE. Microsoft JVM/JDK og gij (GNU libgcj) støttes ikke. Hvis du for eksempel har jdk1.4.2 installert i c:\jre1.4.2 på en Windows-plattform, definerer du JAVA_HOME med følgende kommando:

SET JAVA_HOME=c:\jre1.4.2

På en Linux-, AIX-, HP-UX- eller Solaris-plattform er syntaksen for å definere JAVA_HOME litt ulik avhengig av hvilke skall du bruker. Hvis du for eksempel bruker bash-skallet og har JDK installert i /opt/jre142, definerer du JAVA_HOME med følgende kommando:

export JAVA_HOME=/opt/jre142

Etter at du har installert verktøyet i en av standardstedene, vil du kanskje oppleve at det ikke starter, men i stedet gir feilmeldingen "FEIL: Dette verktøyet krever JRE 1.4.2 eller høyere for å kjøre." Denne meldingen viser at JRE er på et lavere nivå enn 1.4.2. I slike tilfeller må du definere JAVA_HOME-variabelen manuelt for å peke til et JRE med riktig nivå.

Starte verktøyet i grafisk modus

Du må bruke følgende oppstartsskript:

Starte verktøyet i konsollmodus (fra kommandolinjen)

Hvis det ikke er et grafisk brukergrensesnitt tilgjengelig, skal verktøyet starte i kommandolinjemodus automatisk. Hvis du vil bruke konsollmodus selv om det er et grafisk brukergrensesnitt tilgjengelig, oppgir du "-console" på kommandolinjen. I noen tilfeller vil det ikke være mulig å fastslå at det ikke finnes noe grafisk brukergrensesnitt, og da vil ikke verktøyet starte. I slike tilfeller må verktøyet startes på nytt med "-console".

Plassering av filer som blir opprettet under utføring

Som standard brukes ISA Lite-installeringskatalogen for å lagre filer som blir opprettet under utføringen. På noen systemer vil ISA Lite-installeringskatalogen være skrivebeskyttet. I slike tilfeller bruker du parameteren -useHome. Denne parameteren gjør at midlertidige filer blir skrevet til systemets midlertidige katalog, og faste filer blir skrevet til brukerens hjemmekatalog.

Interaksjon med verktøyet i grafisk modus

Når verktøyet IBM Support Assistant Lite er startet i grafisk modus, får du frem det grafiske grensesnittet som vist nedenfor.

Før verktøyet kan brukes til å utføre datainnsamling og analyse, må du velge en problemtype i vinduet Problemtype, slik det er vist nedenfor.

 

 

I tillegg til Problemtype trenger du bare å oppgi en verdi i ett annet inndatafelt i hovedbildet, og det er et filnavn for zip-filen for datainnsamlingen. På dette tidspunktet kan du velge et hvilket som helst filnavn, du kan for eksempel bruke filnavnet Installering_mislyktes_2010_01_03. Hvis du ikke oppgir det, legger verktøyet automatisk til filtypen "zip". Hvis du imidlertid har en åpen PMR for problemet som du skal utføre innsamlingen for, og hvis du har tenkt å la verktøyet sende innsamlingsresultatene ved hjelp av FTP til IBM Support automatisk, vil verktøyet ved FTP-overføringen bruke en bestemt navngivningskonvensjon som kreves av IBM Support: Filnavnet må starte med tre bestemte felt: <pmrnummer>.<filialnummer>.<landkode>.<kort beskrivelse>.zip. Dette er et eksempel på et filnavn av denne typen: 34143.055.000.logs.zip. For å være kompatibelt med et tidligere format blir også kommaer godtatt i stedet for de første tre punktumene (men ikke i stedet for det fjerde foran filtypen "zip"). Punktum er imidlertid det foretrukne skilletegnet.

Med disse verdiene utfylt er det neste trinnet å trykke på knappen Samle inn data. Når innsamlingsskriptet fortsetter, spør det deg etter eventuell tilleggsinformasjon det trenger for å fullføre innsamlingsaktivitetene. Et skript kan også spørre om konfigurasjonsinformasjon, om informasjon angående rekkefølgen på hendelser i forkant av problemet du prøver å løse, eller om hvordan du vil at innsamlingen skal fullføres. Når datainnsamleren har alle opplysningene den trenger, fortsetter skriptet med resten av innsamlingen.

 Når verktøyet har fullført datainnsamlingen, kan du sende resultatene til IBM Support. Du kan velge mellom FTP, som er ukryptert, og HTTPS, som er kryptert, for filoverføringen. Navnet på zip-filen som verktøyet sender til IBM Support, vil være det filnavnet du skrev i boksen Utdatafilnavn/Bane, med serverens vertsnavn og gjeldende tidsangivelse tilføyd.

 Eksempel: Hvis filnavnet i Utdatafilnavn/Bane var 34143.055.000.logs.zip, blir navnet på zip-filen som sendes til IBM, slik

34143.055.000.logs.zip-<vertsnavn>-<gjeldendeTidsangivelse>.zip.

Validering av filnavn for zip-fil for innsamlede data

Automatiseringen på FTP-stedet til IBM Support, ftp.emea.ibm.com, er helt avhengig av navngivningskonvensjonen for filer som er beskrevet i hovedgrensesnittet til IBM Support Assistant Lite. Hvis det mottar en fil med et navn som ikke følger denne konvensjonen, kommer denne filen aldri frem til IBM Support. Derfor er det slik at før verktøyet starter en FTP-operasjon for å sene en zip-fil fra innsamlingen til ftp.emea.ibm.com, kontrollerer det navnet på zip-filen mot konvensjonen. Hvis filnavnet ikke har riktig format, vil det bli vist et tilleggsvindu slik at du kan rette navnet. Det gjeldende navngivningsregelen for FTP-stedet er den som er dokumentert her, der de enkelte feltene i det sammensatte filnavnet er atskilt med punktum. Tidligere var konvensjonen imidlertid å bruke komma som skilletegn. Siden FTP-stedet fremdeles håndterer filer som er navngitt i henhold til den tidligere konvensjonen, godtar IBM® Support Assistant Lite-verktøyets valideringslogikk både punktum og komma som skilletegn.

Interaksjon med verktøyet i konsollmodus (fra kommandolinjen)

Når IBM Support Assistant Lite kjøres i kommandolinjemodus, er det ingen valglister eller skrivefelt for brukerinndata. I stedet blir tilgjengelig valg vist som nummererte lister, slik at du kan skrive nummeret for valget ditt og trykke på Enter-tasten. Inndatafelt blir omgjort til forespørsler, der du kan gi svaret ditt og trykke på Enter.

Du stopper innsamlerverktøyet ved å skrive quit i konsollmodus.

Verktøyet vil spørre etter filnavn. På Unix-plattformer er det ikke mulig å bruke "~" som en angivelse av brukerens HOME-katalog. Hvis "~" brukes, vil det bli referert til en underkatalog under den gjeldende arbeidskatalogen med navnet "~".

Konsollmodus har også en funksjon for stille innsamling, som lar deg registrere svarene dine fra en konsollmodussesjon i en fil og så bruke filen til å kjøre senere utførelse av det samme innsamlingsskriptet.

Hvis du skal gjøre dette, må du først opprette en "responsfil" som inneholder svarene på alle spørsmålene for en bestemt kjøring via datainnsamleren. Den neste gangen de samme datainnsamlingen må utføres, oppgir du rett og slett responsfilen når du starter verktøyet, så brukes svarene du tidligere har gitt, til å besvare alle spørsmålene. Responsfiler kan også tilpasses og endres for å variere svarene slik at du kan utføre andre datainnsamlinger.

Når du skal opprette en responsfil, starter du verktøyet i kommandolinjemodus med alternativet -record, etterfulgt av navnet på responsfilen. I et Linux-miljø kan du for eksempel kjøre denne kommandoen:

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

Når du kjører i denne modusen, vil du få frem en vanlig interaktiv sesjon, der du gir svarene til skriptets spørsmål. I tillegg til å påvirke den gjeldende innsamlingen, blir imidlertid svarene dine også lagret i filen du oppgav navnet på. Så snart den interaktive sesjonen er fullført, kan du bruke denne responsfilen til å utføre det samme skriptet senere uten at du må gi noen eksplisitte svar selv.

Hvis du for eksempel vil kjøre verktøyet i stille modus i et UNIX-miljø ved hjelp av responsfilen du har lagret, kjører du denne kommandoen:

./runISALite.sh -console response.txt

Responsfilen er en ren tekstfil, så du kan redigere den for å endre svarene etter behov. Hvis du for eksempel vil kjøre verktøyet på et annet system enn det responsfilen ble opprettet på, kan du for eksempel justere noen av verdiene i responsfilen.

Når du bruker responsfiler, må du huske på at sensitiv informasjon, for eksempel brukernavn og passord, kanskje blir lagret i disse filene. Det er derfor viktig at du administrerer disse filene på en slik måte at uvedkommende ikke får tilgang til sensitiv informasjon. Det er heller ikke alle datainnsamlinger som passer for stille innsamlingsmodus. Noen datainnsamlinger krever alltid en viss interaksjon med brukeren. Du kan for eksempel bli bedt om å gjenskape problemet under datainnsamlingen, slik at de aktuelle logg- og sporingsfilene blir samlet inn. I slike tilfeller er det ikke mulig å bruke stille innsamling til å registrere og gjenskape dette.

Legge inn pauser i en responsfil

Fra og med ISA Lite V1.3.4 er formatet for responsfiler endret slik at det er enklere å lese og redigere manuelt. Filen likner mye på en Java-egenskapsfil, med kommentarer som starter med '#', og en rekke par av nøkkel/verdi.

Det er nå mulig å legge inn pauser i disse nye responsfilene (ved hjelp av ditt foretrukne redigeringsprogram). Nedenfor finner du et kort sammendrag av de to nye nøklene som støttes:

Merk

Fastslå versjonsinformasjon

Som standard blir versjonen for verktøyet (og de ulike underkomponentene) skrevet til konsollen som det ble startet fra. Når du kjører i GUI-modus, finner du også versjonsinformasjonen ved hjelp av menyalternativet Hjelp->Om. Hvis Java ikke er tilgjengelig, eller Java-applikasjonen ikke klarer å starte, kan du også finne versjonen for verktøyet ved å kjøre oppstartsskript med alternativet "-version".

Når du bruker alternativet "-version", skriver oppstartsskriptene ut versjonsinformasjonen uten egentlig å starte verktøyet.

Proxy-støtte for HTTPS-opplastinger

Som standard bruker opplastinger en systemdefinert proxy når det brukes JRE 1.5 eller nyere. På Windows bruker JRE proxykonfigurasjonen for Internet Explorer. På Unix bruker JRE proxykonfigurasjonen for GNOME 2. Du kan overstyre dette og oppgi en annen proxy med alternativet "-promptForProxy".

Varemerker 

IBM, IBM-logoen og AIX er varemerker eller registrerte varemerker for International Business Machines Corporation i USA og/eller andre land.

 Java og alle Java-baserte varemerker er varemerker for Sun Microsystems, Inc. i USA og/eller andre land.

Microsoft, Windows, Windows NT og Windows-logoen er varemerker for Microsoft Corporation i USA og/eller andre land.

UNIX er et registrert varemerke for The Open Group i USA og andre land.

Linux er et varemerke for Linus Torvalds i USA og/eller andre land.

HP-UX er et registrert varemerke for Hewlett-Packard Company.

Andre navn kan være varemerker for andre selskaper.