IBM® Support Assistant Lite



Obsah

Úvod
Podrobný popis
Instalace nástroje
    Instalace nástroje
Použití nástroje
    Nastavení proměnné prostředí JAVA_HOME
    Spuštění nástroje v grafickém režimu Swing
    Spuštění nástroje v režimu konzoly příkazového řádku
    Umístění souborů vytvořených během spuštění
    Interakce s nástrojem v grafickém režimu Swing
    Ověřování názvu souboru ZIP kolekce
    Interakce s nástrojem v režimu konzoly příkazového řádku
    Zjišťování informací o verzi
    Podpora serveru proxy pro odeslání prostřednictvím protokolu HTTPS
Ochranné známky

Úvod

Nástroj IBM® Support Assistant Lite je poskytován jako pomocný nástroj pro odstraňování problémů softwarových produktů společnosti IBM. Zaměřuje se na automatické shromažďování informací o problémech. Dále poskytuje podporu analýzy symptomů pro různé kategorie problémů zjištěných v softwarových produktech společnosti IBM. Informace týkající se typu problému jsou shromažďovány a analyzovány k určení původu vyšetřovaného problému. Nástroj pomáhá zákazníkům omezit množství času vyžadované k opakování problému s nastavením správných úrovní trasování a omezit množství práce spojené s odesíláním příslušných informací protokolu podpoře společnosti IBM. V této příručce získáte informace o zahájení práce s nástrojem IBM Support Assistant Lite.


Podrobný popis

Ve většině případů instalaci a rozběhnutí nástroje provedete následujícím postupem. Pokud narazíte na potíže nebo potřebujete další informace o libovolném z uvedených kroků, můžete přejít na další oddíly uvedené za tímto postupem.

  1. Extrahujte soubory ze souboru archivu, který jste stáhli. Tím provedete instalaci nástroje.
  2. Spusťte nástroj v režimu grafického rozhraní nebo v režimu konzoly příkazového řádku.

Instalace nástroje

Instalace nástroje

Ve všech případech provedete instalaci nástroje IBM Support Assistant Lite jednoduše extrakcí souborů z archivu, který jste stáhli. Soubory lze extrahovat do libovolného umístění v systému souborů, odkud chcete nástroj spouštět. Při extrahování se v cílovém adresáři vytvoří podadresář \ISALite.


Použití nástroje

Nastavení proměnné prostředí JAVA_HOME

Bez ohledu na to, zda budete používat nástroj IBM Support Assistant v grafickém režimu nebo v režimu konzoly příkazového řádku, spustíte nástroj stejným postupem - vyvoláte odpovídající spouštěcí skript z příkazového řádku. V operačním systému Windows představují tyto spouštěcí skripty dávkové soubory. V ostatních prostředích se jedná o skripty shell.

Vzhledem k tomu, že nástroj je implementován jako aplikace Java, je nezbytnou podmínkou pro spuštění nástroje nastavení proměnné prostředí JAVA_HOME. Pokud prostředí Java není k dispozici v proměnné PATH, budete muset ručně nastavit proměnnou prostředí JAVA_HOME. Nástroj IBM Support Assistant Lite vyžaduje prostředí JRE na úrovni 1.4.2 nebo vyšší (1.5 nebo vyšší v 64bitovém systému Windows 7). Je proto nutné ověřit, že v systému, ve kterém chcete nástroj spustit, je instalováno odpovídající prostředí JRE. Je-li instalace v pořádku, bude zapotřebí provést specifický příkaz operačního systému, který nastaví proměnnou JAVA_HOME tak, aby odkazovala na toto prostředí JRE. Sady JVM a JDK společnosti Microsoft a sada gij (GNU libgcj) nejsou podporovány. Máte-li na platformě Windows nainstalované prostředí jdk1.4.2 například v adresáři c:\jre1.4.2, můžete proměnnou JAVA_HOME nastavit pomocí následujícího příkazu:

SET JAVA_HOME=c:\jre1.4.2

Na platformách Linux, AIX, HP-UX a Solaris se přesný příkaz k nastavení proměnné JAVA_HOME liší v závislosti na používaném shellu. Například pokud používáte shell bash a v adresáři /opt/jre142 je nainstalována sada JDK, nastavte proměnnou JAVA_HOME pomocí následujícího příkazu:

export JAVA_HOME=/opt/jre142

Po instalaci nástroje do jednoho z výchozích umístění můžete zjistit, že jeho spuštění selže se zprávou "CHYBA: Tento nástroj vyžaduje ke spuštění prostředí JRE 1.4.2 nebo novější." Tato zpráva indikuje, že prostředí JRE se nachází na nižší úrovni než 1.4.2. V tomto případě nastavte proměnnou JAVA_HOME ručně, aby odkazovala na správnou úroveň prostředí JRE.

Spuštění nástroje v grafickém režimu

Bude zapotřebí vyvolat následující spouštěcí skript:

Spuštění nástroje v režimu konzoly příkazového řádku

Pokud není k dispozici grafické uživatelské rozhraní, nástroj by měl být automaticky spuštěn v režimu příkazového řádku. Pokud vyžadujete režim konzoly i přes dostupnost grafického uživatelského rozhraní, zadejte na příkazovém řádku parametr "-console". V některých případech nebude možné určit, že grafické uživatelské rozhraní není k dispozici, a nástroj nebude spuštěn. V těchto případech bude nutné nástroj restartovat pomocí parametru "-console".

Umístění souborů vytvořených během spuštění

Při výchozím nastavení je k ukládání souborů vytvořených během spuštění používán instalační adresář produktu IBM Support Assistant Lite. V některých systémech bude instalační adresář produktu IBM Support Assistant Lite určen pouze pro čtení. V této instanci použijte parametr -useHome. Tento parametr způsobí, že dočasné soubory budou zapsány do dočasného adresáře systému a trvalé soubory budou zapsány do domovského adresáře uživatele.

Interakce s nástrojem v grafickém režimu

Po spuštění nástroje IBM Support Assistant Lite v grafickém režimu se zobrazí grafické rozhraní uvedené níže.

Před použitím nástroje k provedení operací shromáždění a analýzy dat je nejprve nutné vybrat typ problému v okně Typ problému, jak je uvedeno níže.

 

 

Kromě hodnoty Typ problému je jedinou další hodnotou vstupního pole, kterou musíte zadat v hlavním grafickém uživatelském rozhraní, název souboru ZIP kolekce dat. V tuto chvíli může být název souboru libovolný - můžete například použít název souboru Instalace_selhala_2007_01_03. Pokud nezadáte příponu, nástroj k souboru automaticky připojí příponu "zip". Pokud je však otevřen záznam PMR pro problém, pro který provádíte shromažďování, a pokud nástroji umožníte automaticky předat výsledky shromažďování podpoře společnosti IBM pomocí protokolu FTP, v kroku využití protokolu FTP nástroj vynutí specifickou konvenci pojmenování souboru vyžadovanou podporou společnosti IBM - název souboru musí začínat třemi konkrétními poli: <číslo_PMR>.<číslo_pobočky>.<kód_země>.<krátký_popis>.zip. Příkladem názvu souboru tohoto typu je název souboru 34143.055.000.logs.zip. Kvůli kompatibilitě s předchozím formátem jsou namísto prvních tří teček přijímány také čárky (ne však namísto čtvrté tečky před příponou "zip"). Tečky jsou však upřednostňovaným oddělovačem.

Po vyplnění těchto hodnot je dalším krokem stisknutí tlačítka Shromáždit data. Skript shromažďování v průběhu shromažďování vydá dotaz na další informace, které vyžaduje k dokončení shromažďování. Skript může také vydat dotaz na informace o konfiguraci, informace o posloupnosti událostí vedoucích k problému, který řešíte, nebo na vaše požadavky ohledně dokončení shromažďování. Po shromáždění všech informací bude skript pokračovat ve shromažďování.

 Poté, co nástroj dokončí shromažďování dat, můžete výsledky odeslat podpoře společnosti IBM. Pro přenos souboru můžete zvolit mezi protokolem FTP, který není šifrovaný, a protokolem HTTPS, který šifrovaný je. Názvem souboru ZIP, který nástroj odešle podpoře společnosti IBM, bude název souboru zadaný do pole Název souboru/cesta pro výstup s připojeným názvem hostitele serveru a aktuálním časovým razítkem.

 Příklad: Použijete-li v poli Název souboru/cesta pro výstup název souboru 34143.055.000.logs.zip, bude název souboru ZIP odeslaný společnosti IBM uveden ve tvaru

34143.055.000.logs.zip-<název_hostitele>-<aktuální_časové_razítko>.zip.

Ověřování názvu souboru ZIP kolekce

Automatizace na serveru FTP podpory společnosti IBM ftp.emea.ibm.com je zcela závislá na konvenci pojmenování popsané v hlavním grafickém uživatelském rozhraní nástroje IBM Support Assistant Lite. Pokud dojde k načtení souboru, který této konvenci neodpovídá, podpoře společnosti IBM se vůbec nezobrazí. Před vyvoláním operace protokolu FTP k odeslání souboru ZIP kolekce na server ftp.emea.ibm.com tedy nástroj ověří název souboru ZIP kolekce podle dané konvence. Pokud název souboru není uveden ve správném tvaru, zobrazí se informační okno, kde jej lze opravit. Aktuální konvencí pojmenování souborů pro serveru FTP je konvence zdokumentovaná zde, přičemž jednotlivá pole ve složeném názvu souboru jsou oddělena tečkami. Dříve však konvence používala jako oddělovače čárky. Vzhledem k tomu, že server FTP stále zpracovává soubory pojmenované podle předchozí konvence, logika ověřování nástroje IBM® Support Assistant Lite přijímá jako oddělovače čárky i tečky.

Interakce s nástrojem v režimu konzoly příkazového řádku

Pokud je nástroj IBM Support Assistant Lite spuštěn v režimu konzoly příkazového řádku, nejsou k dispozici výběrové seznamy ani pole položek uživatelského vstupu. Místo toho jsou dostupné volby prezentovány jako číslované seznamy a uživatel může zadat číslo výběru a potvrdit je klávesou Enter. Vstupní pole jsou transformována na výzvy, kde je možné zadat odpověď a potvrdit ji stisknutím klávesy Enter.

Chcete-li nástroj kolektoru ukončit, zadejte příkaz quit v režimu konzoly.

Nástroj vydá výzvu k zadání názvů souborů. Na platformách Unix není podporováno použití znaku "~" k označení domovského adresáře uživatele. Při použití znaku "~" dojde k vytvoření odkazu na podadresář aktuálního pracovního adresáře s názvem "~".

Režim konzoly dále poskytuje funkci tichého shromažďování, která umožňuje zaznamenávat vaše odpovědi v relaci konzoly do souboru a následně pomocí tohoto souboru znovu přehrát provedení stejného skriptu kolekce.

Chcete-li tuto možnost využít, vytvořte nejprve "soubor odpovědí" obsahující odpovědi na všechny otázky pro konkrétní průchod datovým kolektorem. Pokud znovu vyvstane potřeba spustit stejné shromažďování dat, stačí při spuštění nástroje zadat soubor odpovědí a zadané odpovědi budou použity k zodpovězení všech otázek. Soubory odpovědí lze vyladit a upravit, aby poskytovaly různé odpovědi pro různá shromažďování dat.

Chcete-li vytvořit soubor odpovědí, vyvolejte nástroj v režimu konzoly příkazového řádku s volbou -record následovanou názvem souboru odpovědí. Například v prostředí systému Linux spusťte následující příkaz:

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

Při spuštění v tomto režimu přejdete do běžné interaktivní relace, kde můžete poskytnout odpovědi na výzvy daného skriptu. Kromě ovlivnění aktuálního shromažďování budou však vaše odpovědi také uloženy do uvedeného souboru. Po dokončení interaktivní relace můžete pomocí tohoto souboru odpovědí spustit v budoucnu stejný skript bez nutnosti poskytování explicitního uživatelského vstupu.

Chcete-li nástroj spustit například v tichém režimu v prostředí systému UNIX pomocí zaznamenaného souboru odpovědí, spusťte následující příkaz:

./runISALite.sh -console response.txt

Soubor odpovědí je prostým textovým souborem, takže odpovědi uživatele můžete podle potřeby upravovat. Chcete-li nástroj například spustit v jiném systému, než je systém, kde došlo k záznamu daného souboru odpovědí, může být nutné některé hodnoty v souboru odpovědí upravit.

Při použití souborů odpovědí mějte na paměti, že v těchto souborech mohou být uloženy citlivé informace, jako jsou například jména uživatelů a hesla, takže je důležité s soubory pracovat tak, aby nedošlo k neoprávněnému přístupu k těmto citlivým informacím. Dále pamatujte, že ne všechna shromažďování dat jsou vhodná pro použití volby tichého shromažďování. Některá shromažďování dat vyžadují interakci s uživatelem za všech okolností. V průběhu shromažďování dat můžete být například vyzváni, abyste reprodukovali daný problém, aby bylo možné shromáždit příslušné soubory protokolu a trasovací soubory. V tomto případě tiché shromažďování nemůže daný krok zaznamenat a reprodukovat.

Přidání pozastavení do souboru odpovědí

Počínaje produktem ISA Lite verze 1.3.4 byl formát souborů odpovědí změněn, aby jej uživatelé mohli snáze číst a upravovat. Soubor se podobá souboru vlastností jazyka Java a obsahuje komentáře začínají znakem '#' a sérii dvojic klíč-hodnota.

Nyní existuje způsob, jak do nových souborů odpovědí přidat pozastavení (pomocí vašeho oblíbeného editoru). Dále je uveden krátký souhrn informací o dvou nových podporovaných klíčích:

Poznámky

Zjišťování informací o verzi

Při výchozím nastavení je verze nástroje (a jeho různých dílčích komponent) zobrazena v konzole, ze které byla spuštěna. Při spuštění v grafickém režimu lze informace o verzi nalézt také pomocí volby nabídky Nápověda->O produktu. Pokud jazyk Java není k dispozici nebo pokud nelze spustit aplikaci jazyka Java, získáte informace o verzi nástroje také spuštěním spouštěcích skriptů s volbou "-version".

Při použití volby "-version" spouštěcí skripty zobrazí informace o verzi, aniž by nástroj vyvolaly.

Podpora serveru proxy pro odeslání prostřednictvím protokolu HTTPS

Při výchozím nastavení budou v případě, že je používáno prostředí JRE verze 1.5 nebo vyšší, odeslání používat server proxy definovaný systémem.V systému Windows prostředí JRE využívá konfiguraci serveru proxy aplikace Internet Explorer. V systému Unix prostředí JRE využívá konfiguraci serveru proxy prostředí GNOME 2. Chcete-li tuto volbu přepsat a zadat jiný server proxy, použijte volbu "-promptForProxy".

Ochranné známky 

IBM, logo IBM a AIX jsou ochranné známky nebo registrované ochranné známky společnosti International Business Machines Corportation ve Spojených státech a případně v dalších jiných zemích:

 Java, všechny ochranné známky odvozené od názvu Java jsou ochranné známky společnosti Sun Microsystems, Inc. ve Spojených státech a případně v dalších jiných zemích.

Microsoft, Windows, Windows NT a logo Windows jsou ochranné známky společnosti Microsoft Corporation ve Spojených státech a případně v dalších jiných zemích.

UNIX je registrovaná ochranná známka společnosti The Open Group ve Spojených státech a případně dalších jiných zemích.

Linux je ochranná známka Linuse Torvaldse ve Spojených státech a případně dalších jiných zemích.

HP-UX je registrovaná ochranná známka společnosti Hewlett-Packard Company.

Jména dalších společností, produktů nebo služeb mohou být ochrannými známkami nebo značkami služeb ostatních společnost.