IBM® Support Assistant Lite



Innehåll

Introduktion
Steg för steg
Installation av verktyget
    Installera verktyget
Använda verktyget
    Ange miljövariabeln JAVA_HOME
    Starta verktyget i Swing GUI-läge
    Starta verktyget i konsolläget
    Platsen för filer som har skapats under körningen
    Interagera med verktyget i Swing GUI-läge
    Validering av insamlingens zip-filnamn
    Interagera med verktyget i konsolläget
    Bestämma version
    Proxystöd för HTTPS-överföringar
Varumärken

Introduktion

Verktyget IBM® Support Assistant Lite är ett hjälpmedel för felsökning av IBM-programprodukter. Verktyget samlar automatiskt in problemdata. Det ger även symptomanalys för olika typer av problem hos IBM programvaruprodukter. Information som gäller en viss typ av fel samlas in och analyseras, så att felets orsak kan identifieras. Verktyget assisterar kunder genom att minska den tid det tar att återskapa ett fel med rätt spårningsnivåer angivna, och genom att minska det arbete som krävs för skicka logginformation till IBM Support. I den här hjälpguiden berättar vi hur du kommer igång med verktyget IBM Support Assistant Lite.


Steg för steg

I de flesta fall installerar du och kör verktyget med hjälp av nedanstående steg. Om du stöter på problem, eller om du vill ha mer information om något av stegen kan du läsa avsnitten nedanför.

  1. Installera verktyget genom att extrahera filer från arkivfilen du hämtade.
  2. Kör verktyget i det grafiska gränssnittet eller i kommandoläge.

Installation av verktyget

Installera verktyget

Du installerar IBM Support Assistant Lite genom att extrahera filerna i arkivfilen som du hämtade. Filerna kan extraheras till valfri plats i systemet där verktyget ska köras. Underkatalogen \ISALite skapas i målkatalogen.


Använda verktyget

Ange miljövariabeln JAVA_HOME

Oavsett om du använder IBM Support Assistant Lite i det grafiska gränssnittet eller i kommandokonsolen använder du samma procedur för att starta det. Du anropar lämpligt startskript från en kommandorad. I Windows är startskripten batch-filer. I andra miljöer är de skalskript.

Eftersom verktyget har implementerats som ett Java-program, är det nödvändigt att ställa in miljövariabeln JAVA_HOME innan verktyget kan börja. Om Java inte finns i PATH måste du ange JAVA_HOME-miljövariabeln manuellt. IBM Support Assistant Lite kräver JRE 1.4.2 eller senare (1.5 eller senare i Windows 7, 64-bitars) så kontrollera först att en passande JRE-version har installerats i det system verktyget ska användas. Om det har det måste du använda ett operativsystemspecifikt kommando till att ange JAVA_HOME-variabeln så att den pekar på den JRE-versionen. Microsoft JVM/JDK och gij (GNU libgcj) stöds inte. Om jdk1.4.2 har installerats med sökvägen C:\jre1.4.2 i Windows anger du JAVA_HOME med följande kommando:

SET JAVA_HOME=c:\jre1.4.2

I Linux, AIX, HP-UX och Solaris varierar den exakta kommandosyntaxen för att ange JAVA_HOME beroende på vilket skal du använder. Om du använder bash-skalet och har JDK installerat i /opt/jre142, skulle du ange JAVA_HOME med följande kommando:

export JAVA_HOME=/opt/jre142

När du har installerat verktyget på någon av standardplatserna, kanske det inte startar utan du får felmeddelandet "FEL: verktyget kräver JRE 1.4.2 eller senare för att köras." Meddelandet anger att JRE har en lägre nivå än 1.4.2. I så fall bör du ange variabeln JAVA_HOME manuellt så att den pekar på en JRE på rätt nivå.

Starta verktyget i GUI-läge

Kör följande startskript:

Starta verktyget i konsolläget

Om det inte finns något grafiskt användargränssnitt tillgängligt startar verktyget automatiskt i konsolläget. Om verktyget ska startas i konsolläge även när ett grafiskt användargränssnitt är tillgängligt, lägger du till parametern "-console" på kommandoraden. I vissa fall är det inte möjligt att fastställa att ett grafiskt användargränssnitt inte är tillgängligt och verktyget startar inte. I dessa fall måste verktyget startas om med parametern "-console".

Platsen för filer som har skapats under körningen

Som standard används ISA Lites installationskatalog för att lagra filer som skapas under körningen. På vissa system är ISA Lites installationskatalog skrivskyddad. I så fall anger du parametern - useHome. Den här parametern gör att tillfälliga filer skrivs till systemets temporära katalog och beständiga filer skrivs till användarens hemkatalog.

Interagera med verktyget i grafiskt gränssnittsläge

När verktyget IBM Support Assistant Lite har startats i grafiskt gränssnittsläge, visas det grafiska gränssnittet nedan.

Innan verktyget kan användas för uppgiftsinsamling och analys måste du först markera en problemtyp i problemtypsfönstret så som visas nedan.

 

 

Förutom problemtyp så är det enda fältvärdet som måste anges i de huvudsakliga användargränssnittet ett filnamn för datainsamlingens zip-fil. Filnamnet kan vara vad du vill, till exempel Installation_misslyckades_2007_01_03. Om du inte själv gör det, kommer verktyget automatiskt att lägga till ".zip" till filnamnet. Men om det finns en öppen PMR för problemet, och om verktyget automatiskt ska överföra insamlingsresultatet via FTP till IBM Support, så kommer verktyget att tillämpa en särskild filnamngivningsregel som krävs av IBM Support: Filnamnet måste börja med tre specifika fält: <pmrnummer>. <branschnummer>. <landskod>. < kort beskrivning > .zip. Ett exempel på ett filnamn av denna typ skulle vara 34143.055.000.logs.zip. För att ett tidigare format också ska kunna användas accepteras även komma i stället för de tre första punkterna (men inte i stället för den fjärde som är före tillägget "zip"). Punkt är dock den önskade avgränsaren.

Med dessa värden ifylla är nästa steg att trycka på knappen Samla in data. Insamlingsskriptet ber dig om eventuell ytterligare information som behövs att slutföra insamlingen. Ett skript kan också be dig om konfigurationsinformation, information om vilken händelseföljd som ledde till felet eller hur du vill att insamlingen ska slutföras. När skriptet har all information som behövs samlas återstående data in.

 När verktyget är klart med insamlingen av uppgifter kan du skicka resultaten till IBM Support. Du kan välja mellan FTP, som är okrypterat, och HTTPS, som är krypterat, för filöverföringen. Namnet på zip-filen som verktyget skickar till IBM Support blir det filnamn som angetts i rutan Utdatafilnamn/sökväg samt serverns värdnamn och aktuell tidsstämpel.

 Exempel: om utdatafilnamnet/sökvägsfilnamnet var 34143.055.000.logs.zip så kommer namnet på zip-filen som skickas till IBM att vara

34143.055.000.logs.zip-<värdnamn>-<aktuelltidsstämpel>.zip.

Validering av insamlingens zip-filnamn

För att automatiseringen på FTP-platsen för IBM Support ftp.emea.ibm.com ska fungera måste reglerna följas för filnamngivning så som de beskrivs i huvudgränssnittet för IBM Support Assistant Lite. Om FTP-platsen tar emot en fil med ett namn som inte följer dessa regler så kommer den aldrig att läsas av IBM Support. Innan verktyget startar en överföring via FTP av en insamlings-zip-fil till ftp.emea.ibm.com så kontrollerar det följaktligen att insamlings-zip-filens namn är korrekt. Om filnamnet inte har rätt form visas ett popup-fönster där du kan korrigera filnamnet. Den aktuella filnamnskonvention för FTP-platsen är dokumenterad här. De enskilda fälten i det sammansatta filnamnet är åtskilda av punkter. Tidigare var dock konventionen att använda kommatecken som avgränsare. Eftersom FTP-platsen fortfarande hanterar filer namngivna enligt den tidigare konventionen, accepterar valideringsfunktionen hos IBM® Support Assistant Lite både punkter och kommatecken som avgränsare.

Interagera med verktyget i konsolläget

När IBM Support Assistant Lite körs i konsolläge visas inga vallistor eller inmatningsfält för indata. I stället visas alternativen som numrerade listor och du väljer alternativ genom att skriva en siffra och trycka på Enter. Indatafält visas som uppmaningar där du anger ett svar och sedan trycker på Enter.

Om du vill stoppa insamlingsverktyget skriver du quit i konsolläge.

Verktyget frågar efter filnamn. I Unix är det inte möjligt att ange användarens hemkatalog med "~". Tecknet "~" skulle avse en underkatalog till den aktuella arbetskatalogen med namnet "~".

I konsolläget finns också en tyst insamlingsfunktion. Du kan registrera svaren från en konsolsession i en fil och sedan använda filen när du kör samma insamlingsskript nästa gång.

För att detta ska bli möjligt måste du först skapa en "svarsfil" som innehåller svaren på alla frågor för en viss körning genom datainsamlaren. Nästa gång samma datainsamling måste utföras hämtar du helt enkelt svarsfilen när du startar verktyget. De svar som gavs tidigare kommer att användas för att besvara alla frågor. Svarsfiler kan justeras så att svaren varieras och även olika datainsamlingar utförs.

Om du vill skapa en svarsfil kör du verktyget i konsolläge med alternativet -record, följt av namnet på svarsfilen. Till exempel i Linux:

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

I det här läget öppnas en vanlig interaktiv sessionen, där du svarar på skriptets frågor. Förutom att svaren har påverkan på den aktuella insamlingen, sparas de också i filen som du namngett. När den interaktiva sessionen har avslutats kan du köra samma skript med den här svarsfilen i framtiden utan att explicit behöva ange användardata.

Till exempel, om du vill köra verktyget i tyst läge i en UNIX-miljö med svarsfilen som du spelat in skriver du:

./runISALite.sh -console svar.txt

Svarsfilen är en oformaterad textfil, så du kan ändra användarens svar i den efter behov. Till exempel om du vill köra verktyget på ett annat system än det som registrerades i svarsfilen, kan du behöva justera vissa värden i svarsfilen.

När du använder svarsfiler måste du tänka på att känslig information, som användarnamn och lösenord, kan lagras i dessa filer. Därför är det viktigt att du hanterar filerna på ett sätt som förhindrar obehörig åtkomst till känslig information. Inte heller är alla datainsamlingar lämpliga för alternativet tyst insamling. Vissa datainsamlingar kräver alltid någon interaktion med användaren. Du kan till exempel uppmanas att återskapa problemet under insamlingen av uppgifter så att lämpliga logg- och spårningsfiler samlas in. En tyst insamling kan i detta fall inte att registrera och reproducera detta steg.

Att lägga till pauser i en svarsfil

Från och med ISA Lite V1.3.4, har svarsfilsformatet ändrats så att det enklare ska kunna läsas/redigeras av en människa. Filen ser mycket ut som en Java-egenskapsfil, med kommentarer som börjar med "#", och en serie av nyckel-värdepar.

Det finns nu ett sätt att lägga in pauser i dessa nya svarsfiler (med valfritt textredigeringsprogram). Följande är en kort sammanfattning av två nya nycklar som kan användas:

Anmärkningar

Bestämma version

Som standard skrivs versionen för verktyget (och dess olika delprojekt) till konsolen som det startades från. När du kör verktyget i det grafiska gränssnittet kan versionsinformationen också hittas under menyalternativet Hjälp -> Om. Om Java inte är tillgängligt, eller Java-programmet inte kan startas, kan du också få verktygets versionsnummer genom att köra startskriptet med alternativet "-version".

När du använder alternativet "-version" skriver startskriptet ut versionsinformationen utan att faktiskt starta verktyget.

Proxystöd för HTTPS-överföringar

Som standard används en systemdefinierad proxy för överföringar när JRE 1.5 eller senare används. I Windows använder JRE proxykonfigurationen för Internet Explorer. I Unix använder JRE proxykonfigurationen för GNOME 2. Om du själv vill ange proxy lägger du till alternativet "-promptForProxy".

Varumärken 

IBM, IBMs logotyp och AIX är varumärken eller registrerade varumärken som tillhör International Business Machines Corporation i USA och/eller andra länder:

 Java och alla Java-baserade varumärken är varumärken som tillhör Sun Microsystems, Inc. i USA och/eller andra länder.

Microsoft, Windows, Windows NT och Windows-logotypen är varumärken som tillhör Microsoft Corporation i USA och/eller andra länder.

UNIX är ett registrerat varumärke som tillhör The Open Group i USA och andra länder.

Linux är ett varumärke som tillhör Linus Torvalds i USA och/eller andra länder.

HP-UX är ett registrerat varumärke som tillhör Hewlett-Packard Company.

Andra namn på företag, produkter eller tjänster kan vara varumärken eller näringskännetecken som tillhör andra.