IBM® Support Assistant Lite



Содержимое

Введение
Пошаговый режим
Установка программы
    Установка программы
Использование программы
    Указание переменной среды JAVA_HOME
    Запуск программы в графическом режиме Swing
    Запуск программы в режиме командной строки
    Размещение файлов, создаваемых во время установки
    Взаимодействие с программой в графическом режиме Swing
    Проверка имени файла данных, собранного в формате Zip
    Взаимодействие с программой в режиме командной строки
    Определение версии
    Поддержка прокси для загрузок по протоколу HTTPS
Товарные знаки

Введение

IBM® Support Assistant Lite - это вспомогательное средство для устранения неполадок продуктов IBM. Данный инструмент предназначен для автоматического сбора данных о неполадках. С помощью него можно также анализировать симптомы различных неполадок продуктов IBM. С целью выявления причины исследуемой неполадки выполняется поиск и анализ связанной информации. Данный инструмент уменьшает время, необходимое для воспроизведения неполадки с заданными уровнями трассировки, а также облегчает процедуру сбора информации из протоколов. В данном руководстве приведена информация по установке и использованию инструмента IBM Support Assistant Lite.


Пошаговый режим

В большинстве случаев следующая последовательность этапов позволит вам освоить и использовать инструмент. В случае затруднений или необходимости получения дополнительной информации о любом из этих этапов обратитесь к последующим разделам.

  1. Для установки инструмента извлеките файлы из загруженного архивного файла.
  2. Запустите инструмент в режиме графического пользовательского интерфейса или в режиме консоли командной строки.

Установка программы

Установка программы

Во всех случаях установка инструмента IBM Support Assistant Lite заключается просто в извлечении файлов из загруженного архивного файла .zip. Файлы могут быть извлечены в любое место файловой системы, выбранное вами для запуска инструмента. В указанном каталоге создается подкаталог \ISALite.


Использование программы

Указание переменной среды JAVA_HOME

Независимо от использования инструмента 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 bit), поэтому перед запуском инструмента убедитесь, что необходимая JRE в системе установлена. Если она установлена, необходимо с помощью команды операционной системы настроить переменную JAVA_HOME так, чтобы она указывала на эту JRE. 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". Иногда инструмент не запускается, поскольку невозможно определить наличие или отсутствие графического режима. В таких случаях необходимо перезапустить инструмент, указав параметр In these instances "-console".

Размещение файлов, создаваемых во время установки

По умолчанию для хранения файлов используется каталог ISA Lite. В некоторых системах данный каталог может быть доступен только для чтения. В данном случае необходимо указать параметр -useHome. При этом временные файлы будут записываться в системный каталог временных файлов, а остальные - в домашний каталог пользователя.

Взаимодействие с программой в графическом режиме

При запуске инструмента IBM Support Assistant Lite в графическом режиме будет выведен интерфейс пользователя, показанный ниже.

Перед началом сбора и анализа данных необходимо указать тип неполадки в окне Тип неполадки согласно приведенным инструкциям.

 

 

Кроме типа неполадки необходимо указать имя архивного файла, в котором будут размещены данные. На данном этапе можно указать любое имя файла, например: Сбой_установки_2007_01_03. Если расширение "zip" не указано, то инструмент автоматически добавит его. Если для данной проблемы вы открыли заявку PMR и после сбора данных они автоматически загружаются на FTP-сайт IBM Support, то перед загрузкой на FTP-сервер файл будет переименован в соответствии со специальным соглашением. Имя файла будет представлено в следующем формате: <номер_pmr>.<номер_ветви>.<код_страны>.<краткое_описание>.zip. Пример имени файла 34143.055.000.logs.zip. Для совместимости со старым форматом вместо первых трех точек можно использовать запятые (кроме последней точки перед расширением "zip"). Тем не менее точки более предпочтительны в качестве разделителей.

После заполнения указанных полей можно нажать кнопку Сбор данных. При выполнении сценария сбора данных может быть запрошена дополнительная информация. Например, сценарий может запросить имя установочного каталога продукта, дополнительные сведения о конфигурации, информацию о последовательности событий, вызывающих неполадку, или ваши предпочтения относительно сбора данных. После сбора всей нужной информации сценарий выполняет заключительную часть операции.

 После завершения сбора данных можно отправить результаты в службу IBM Support. Можно выбрать передачу данных по FTP (незашифрованное соединение), либо по HTTPS (зашифрованное соединение). Конечное имя файла zip, отправляемого в службу IBM Support, будет содержать имя, введенное в поле Файл выходных данных, а также имя хоста сервера и системное время.

 Например, если в поле Файл выходных данных было указано имя 34143.055.000.logs.zip, , то имя отправляемого файла будет

34143.055.000.logs.zip-<имя_хоста>-<системное_время>.zip.

Проверка имени файла данных, собранного в формате Zip

Соблюдение соглашения об именах файлов IBM Support Assistant Lite является необходимым условием для правильной работы FTP-сайта IBM Support ftp.emea.ibm.com. Файлы с именами, не соответствующими указанному соглашению, не обрабатываются. Поэтому перед отправкой файла на сайт ftp.emea.ibm.com инструмент проверяет имя файла на соответствие соглашению. Если имя файла недопустимо, то будет выведено всплывающее окно, в котором можно будет изменить имя. В настоящее время действует соглашение об именах, описанное в данном руководстве. Отдельные поля в имени разделяются точками. Обратите внимание, что ранее в качестве разделителей использовались запятые. Поскольку FTP-сайт до сих пор поддерживает имена, соответствующие старому соглашению, то инструмент ® Support Assistant Lite также поддерживает запятые и точки в качестве разделителей.

Взаимодействие с программой в режиме командной строки

Когда IBM Support Assistant Lite выполняется в режиме командной строки, списки опций или поля ввода для заполнения пользователем отсутствуют. Доступные опции представлены в виде пронумерованных списков, в которых требуется ввести номер нужной опции и нажать клавишу Enter. Вместо полей ввода применяются приглашения, в которых требуется ввести ответ и нажать клавишу Enter.

Для завершения работы инструмента сбора данных введите quit.

Инструмент запросит имена файлов. На платформах Unix не поддерживается использование символа "~" в качестве обозначения домашнего каталога пользователя. Данный символ используется для обозначения подкаталога.

Инструмент содержит несколько средств, помогающих взаимодействовать с ним в режиме консоли, включая функцию неинтерактивного сбора, которая позволяет регистрировать ответы из сеанса режима консоли в файле и затем использовать этот файл для управления последующими действиями того же сценария сбора данных.

Для этого необходимо создать "файл ответов", содержащий ответы на все вопросы отдельного выполнения инструмента сбора данных. Если будет необходимо собрать подобные данные снова, то при запуске инструмента можно просто указать файл ответов. Файлы ответов можно изменять для сбора различных типов данных.

Для создания файла ответов запустите инструмент в режиме командной строки, указав опцию -record и имя файла ответов. Пример команды для Linux:

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

В этом режиме будет запущен обычный интерактивный сеанс, в котором нужно указать ответы на все запросы сценария. При этом все вводимые ответы будут сохранены в указанном файле. После завершения данного интерактивного сеанса можно использовать получившийся файл ответов для неинтерактивного запуска сценариев.

Например, для запуска инструмента в неинтерактивном режиме для платформы UNIX:

./runISALite.sh -console response.txt

Файл ответов сохраняется как обычный текстовый файл, поэтому его можно при необходимости изменить. Например, для запуска инструмента на другой системе нужно изменить некоторые ответы в файле.

Обратите внимание, что в файлах ответов может сохраняться конфиденциальная информация (например, имена пользователей и пароли), поэтому необходимо обеспечить меры по предотвращению несанкционированного доступа к этим файлам. Не все сборы данных могут выполняться в неинтерактивном режиме. В некоторых случаях всегда необходимо вмешательство пользователя. Например, может потребоваться повторное воспроизведение проблемы с целью получения файлов протокола и трассировки. В таком случае неинтерактивный режим не сможет записать данный шаг.

Добавление пауз в файл ответов

Начиная с ISA Lite V1.3.4 файл ответов стал более понятен для чтения человеком. Этот файл очень похож на файл свойств Java, в котором комментарии начинаются со знака '#', а значения задаются в формате ключ=значение.

В файлы ответов можно добавлять паузы при помощи вашего любимого редактора. Ниже приводится краткое описание двух новых поддерживаемых ключей:

Примечания

Определение версии

По умолчанию версия инструмента и его компонентов выводится в консоль, из был запущен данный инструмент. При работе в графическом режиме сведения о версиях компонентов можно просмотреть в меню Справка->О программе. Если Java недоступна или приложение Java не может быть запущено, то версию инструмента можно просмотреть с помощью опции "-version".

При наличии опции "-version" информация о версии будет выведена без запуска инструмента.

Поддержка прокси для загрузок по протоколу HTTPS

Если используется JRE 1.5 или более поздняя версия, то при загрузке используется прокси-сервер по умолчанию. В Windows в качестве параметров прокси для JRE используются настройки Internet Explorer. В Unix в качестве параметров прокси для JRE используются настройки GNOME 2. Для переопределения настроек используйте параметр "-promptForProxy".

Товарные знаки  

IBM, эмблема IBM и AIX являются зарегистрированными товарными знаками International Business Machines Corportation в США и/или других странах.

 Java и все товарные знаки Java являются товарными знаками Sun Microsystems Inc. в США и/или других странах.

Microsoft, Windows и Windows NT - это товарные знаки Microsoft Corporation в США и других странах.

UNIX является зарегистрированным товарным знаком The Open Group в США и других странах.

Linux является товарным знаком Линуса Торвальдса (Linus Torvalds) в США и/или других странах.

HP-UX является зарегистрированным товарным знаком компании Hewlett-Packard.

Названия других компаний, продуктов и услуг могут быть товарными знаками или знаками обслуживания соответствующих организаций.