Інструмент IBM® Support Assistant Lite створено як засіб для усунення неполадок програмного забезпечення IBM. Основне призначення інструменту - автоматичне збирання даних про неполадки. Крім того, він забезпечує підтримку аналізу симптомів для різноманітних категорій несправностей, що трапляються в програмному забезпеченні IBM. Збирається й аналізується інформація, суттєва для цього типу неполадки, що допомагає визначити походження неполадки, що наразі розглядається. Інструмент допомагає користувачеві, зменшуючи час на відтворення неполадки, якщо встановлено відповідні рівні трасування, а також зменшуючи обсяг роботи для надсилання інформації з відповідного протоколу до служби підтримки IBM. У цьому довідковому посібнику ми розповімо, як розпочати роботу з інструментом IBM Support Assistant Lite.
У більшості випадків розпочати роботу з інструментом можна за допомогою описаної нижче послідовності дій. Якщо виникають помилки або потрібно отримати додаткову інформацію про будь-яку з наведених дій, можна звернутися до наступних розділів.
У всіх випадках встановлення інструменту IBM Support Assistant Lite полягає у розпакуванні файлів із завантаженого архіву. Файли можна витягати у будь-якому каталозі в системі, де планується виконувати програму. У цьому цільовому каталозі буде створено вкладений каталог \ISALite.
Незалежно від того, чи будете ви використовувати інструмент IBM Support Assistant Lite у режимі графічного інтерфейсу чи в консольному режимі командного рядка, для запуску застосовується одна і та сама процедура: викликати відповідний сценарій запуску з командного рядка. В системі Windows сценаріями запуску є пакетні файли. В інших середовищах це сценарії командного процесору.
Оскільки утиліту реалізовано як прикладну програму Java, то для її запуску необхідно вказати змінну середовища JAVA_HOME. Якщо середовище Java не зазначено у змінній PATH, потрібно вручну вказати змінну середовища JAVA_HOME. Для роботи IBM Support Assistant Lite потрібне JRE рівня не менш 1.4.2 (1.5 або вище для Windows 7 64 біт), отже, спершу переконайтеся, що в системі, де виконуватиметься програма, встановлено потрібне JRE. Якщо це так, то необхідно вказати це JRE у змінній JAVA_HOME за допомогою системної команди. Microsoft JVM/JDK та gij (GNU libgcj) не підтримуються. Наприклад, якщо jdk1.4.2 встановлено за адресою c:\jre1.4.2 на платформі Windows, то необхідно вказати JAVA_HOME за допомогою такої команди:
SET JAVA_HOME=c:\jre1.4.2
На платформах Linux, AIX, HP-UX або Solaris фактичний синтаксис надання значення JAVA_HOME залежить від командного процесору. Наприклад, якщо застосовується bash, а JDK встановлено в /opt/jre142, то вказати JAVA_HOME можна за допомогою такої команди:
export JAVA_HOME=/opt/jre142
Після встановлення інструменту в одному з розташувань за замовчуванням може з'явитися помилка "ПОМИЛКА: Для запуску цього інструменту потрібне JRE 1.4.2 або вище." Це повідомлення свідчить про те, що JRE має нижчий рівень, ніж 1.4.2. У такому випадку необхідно вручну вказати значення JAVA_HOME, яке вказуватиме на JRE відповідного рівня.
Потрібно викликати такий сценарій запуску:
За відсутності графічного інтерфейсу інструмент запуститься у режимі командного рядка автоматично. Якщо консольний режим є бажаним навіть за наявності графічного інтерфейсу, вкажіть "-console" у командному рядку. У деяких випадках може бути неможливо визначити, що графічний інтерфейс є недоступним, і інструмент не буде запущено. У цих випадках буде необхідно перезапустити інструмент з використанням "-console".
За замовчуванням файли, створені під час виконання, зберігаються в каталозі встановлення ISA Lite. В деяких системах каталог встановлення ISA Lite призначено лише для читання. В такому разі скористайтеся параметром -useHome. Якщо зазначено цей параметр, то тимчасові файли записуватимуться до тимчасового каталогу системи, а постійні - до домашнього каталогу користувача.
Коли інструмент IBM Support Assistant Lite запущено в режимі графічного інтерфейсу, буде показано зображений нижче графічний інтерфейс.
Перед збиранням та аналізом даних необхідно вибрати тип неполадки в вікні Тип неполадки, як показано нижче.
Крім типу неполадки в графічному інтерфейсі слід ввести ім'я zip-файлу для збирання даних. На цьому етапі ім'я файлу може бути яким завгодно: можна, наприклад, зазначити ім'я Install_failed_2007_01_03. Якщо не зазначити розширення, то інструмент автоматично додасть розширення "zip" до імені файлу. Якщо для неполадки, про яку збираються дані, вже відкрито PMR, а зібрані дані передаватимуться до служби підтримки IBM через FTP в автоматичному режимі, то на етапі передачі через FTP інструмент примусово змінить ім'я згідно з правилами іменування файлів служби підтримки IBM: ім'я файлу має починатися з трьох наступних полів: <номер-pmr>.<номер-гілки>.<код-країни>.<короткий-опис> .zip. Прикладом імені файлу цього типу може бути 34143.055.000.logs.zip. Для сумісності з попереднім форматом замість перших трьох крапок допускаються коми (окрім четвертої крапки перед розширенням "zip"). Однак бажано використовувати крапки.
Після заповнення полів необхідно натиснути кнопку Зібрати дані. Під час збирання сценарій запитуватиме додаткову інформацію, яка йому може знадобитися під час збирання. Також сценарій може запитувати інформацію про конфігурацію, про послідовності дій, що призвели до вказаної неполадки, та про ваші побажання щодо способу збирання. Коли буде отримано всю необхідну інформацію, сценарій завершить решту операцій.
Після того як інструмент закінчить збирання даних, можна надіслати результати до служби підтримки IBM. Для передачі файлу можна вибрати незашифрований протокол FTP або зашифрований протокол HTTPS. До служби підтримки IBM буде надіслано zip-файл з ім'ям, що складається з імені файлу, введеного в полі Ім'я/Шлях вихідного файлу, та доданих до нього імені хоста та поточного системного часу.
Приклад: якщо в полі Ім'я/Шлях було вказано 34143.055.000.logs.zip, то до служби підтримки IBM буде надіслано zip-файл з ім'ям
34143.055.000.logs.zip-<хост>-<поточний-системний-час>.zip.
Автоматизація на FTP-сайті служби підтримки IBM ftp.emea.ibm.com цілком залежить від домовленості щодо іменування файлів, описаної в головному графічному інтерфейсі інструменту IBM Support Assistant Lite. Якщо отриманий файл не відповідає вимогам цієї домовленості, то цей файл ніколи не буде видимим для служби підтримки IBM. Тому перед викликом операції FTP для надсилання zip-файлу збирання до ftp.emea.ibm.com інструмент перевіряє його ім'я на відповідність домовленості. Якщо ім'я файлу не відповідає домовленості, то відкриється спливаюче вікно, в якому користувачеві буде запропоновано його виправити. Поточну домовленість щодо іменування файлів для сайту задокументовано тут; окремі поля складеного імені файлу розділено крапками. Однак раніше, згідно з домовленістю, як роздільники використовувалися коми. Оскільки FTP-сайт досі обробляє імена файлів, що відповідають попередній домовленості, логіка інструмента IBM® Support Assistant Lite приймає як роздільники і крапки, і коми.
Коли IBM Support Assistant Lite працює в консольному режимі командного рядка, списки вибору та поля для користувацького вводу відсутні. Натомість варіанти вибору представлено у вигляді нумерованих списків; виберіть номер і натисніть клавішу Enter. Поля вводу перетворюються на запрошення, на які потрібно ввести відповідь і натиснути Enter.
Для зупинки інструменту програми збору даних введіть quit у консольному режимі.
Інструмент запитає імена файлів. На платформах Unix не підтримується символ "~" для позначення користувацького каталогу HOME. В таких системах символ "~" є посиланням на вкладений каталог з ім'ям "~" у поточному робочому каталозі.
Консольний режим також дозволяє працювати з мінімальним втручанням, тобто спочатку записати відповіді з сеансу консолі, а потім використовувати цей файл під час наступних виконань того ж сценарію збирання даних.
Для цього попередньо створіть "файл відповідей" із відповідями на всі питання щодо певного запуску програми збору даних. Коли буде потрібно зібрати ті самі дані, вкажіть цей файл відповідей під час запуску інструменту, і на всі питання будуть дані попередні відповіді. Файли відповідей можна налаштовувати та змінювати для збору інших даних.
Для створення файлу відповідей необхідно викликати інструмент у консольному режимі командного рядка з опцією -record, після якої зазначається файл відповідей. Наприклад, у середовищі Linux можна запустити:
./runISALite.sh -console -record response.txt
У цьому режимі робота відбувається як у звичайному сеансі, коли користувач дає відповіді на запитання сценарію. Користувач керує виконанням збору даних, але його відповіді також записуються у вказаний файл. Після закінчення інтерактивного сеансу створений файл відповідей можна використовувати для виконання того ж сценарію в майбутньому без потреби в явному користувацькому вводі.
Наприклад, для роботи інструменту в режимі з мінімальним втручанням у середовищі UNIX з використанням записаного вами файлу відповідей, виконайте:
./runISALite.sh -console response.txt
Файл відповідей - це текстовий файл, тому його можна редагувати і змінювати відповіді відповідно до потреби. Наприклад, якщо необхідно запустити інструмент не на тій системі, що на ній було записано файл відповідей, то у файлі відповідей слід змінити деякі значення.
Під час використання файлів відповідей пам'ятайте, що в них може зберігатися конфіденційна інформація на кшталт імен та паролів користувачів, тому важливо працювати з файлами таким чином, щоб уникнути несанкціонованого доступу до конфіденційної інформації. Крім того, не всі збори даних можна виконувати з мінімальним втручанням. Деякі збори даних завжди потребують певної взаємодії з користувачем. Наприклад, під час збирання даних програмі може знадобитися, щоб користувач відтворив неполадку для збирання відповідних файлів протоколу і трасування. В режимі з мінімальним втручанням буде неможливо записати й відтворити таку дію.
Починаючи з ISA Lite V1.3.4, формат файлу відповідей змінено на користь легкості читання та редагування. Файл дуже нагадує файл властивостей Java з коментарями, що починаються з символу '#', та групами пар ключ-значення.
Тепер існує спосіб для додавання пауз у ці файли відповідей (за допомогою улюбленого редактора). Нижче наведено короткий огляд двох нових підтримуваних ключів:
Примітки
За замовчуванням, версію інструменту (і його різних компонентів) показано в консолі, з якої його було запущено. Під час виконання в режимі графічного інтерфейсу інформацію про версії можна знайти також за допомогою опції меню Довідка->Про програму. Якщо середовище Java не є доступним або якщо неможливо запустити прикладну програму Java, версію інструменту можна отримати виконавши сценарій запуску з опцією "-version".
Якщо вказано опцію "-version", сценарій запуску виведе інформацію про версію без фактичного виклику інструменту.
IBM, емблема IBM та AIX є товарними знаками або зареєстрованими товарними знаками International Business Machines Corporation у Сполучених Штатах Америки і/або в інших країнах:
Java і всі товарні знаки зі словом Java є товарними знаками Sun Microsystems, Inc. у Сполучених Штатах Америки і/або інших країнах.
Microsoft, Windows, Windows NT, та емблема Windows є товарними знаками Microsoft Corporation у Сполучених Штатах Америки і/або інших країнах.
UNIX є зареєстрованим товарним знаком The Open Group у США і/або інших країнах.
Linux є товарним знаком Linus Torvalds у США, інших країнах та в усьому світі.
HP-UX є зареєстрованим товарним знаком Hewlett-Packard Company.
Назви інших компаній, продуктів та послуг можуть бути товарними знаками або знаками обслуговування інших власників.