IBM® Support Assistant Lite



컨텐츠

소개
단계별 안내
도구 설치
    도구 설치
도구 사용법
    JAVA_HOME 환경 변수 설정
    Swing GUI 모드에서 도구 시작
    명령행 콘솔 모드에서 도구 시작
    실행 중에 작성된 파일의 위치
    Swing GUI 모드에서 도구와 상호작용
    콜렉션 Zip 파일 이름 유효성 검증
    명령행 콘솔 모드에서 도구와 상호작용
    버전 정보 판별
    HTTPS 업로드에 대한 프록시 지원
상표

소개

IBM® Support Assistant Lite 도구는 IBM 소프트웨어 제품의 문제점 해결을 돕는 지원 기능을 제공합니다. 이 도구는 문제점 데이터의 자동 콜렉션에 초점을 둡니다. 또한 이 도구는 IBM 소프트웨어 제품에 발생하는 다양한 유형의 문제점에 대한 증상 분석 지원을 제공합니다. 문제점 유형에 관련된 정보가 콜렉션 및 분석되어 조사 중인 문제점의 근본 원인을 식별하게 됩니다. 이 도구를 통해 고객은 적합한 추적 레벨 세트로 문제점을 재현하는 데 걸리는 시간을 줄이는 동시에 IBM Support에 적절한 로그 정보를 전송하기 위해 필요한 수고도 줄일 수 있습니다. 이 도움말 안내서에서는 IBM Support Assistant Lite 도구를 시작하여 실행하는 방법에 대해 설명합니다.


단계별 안내

대부분의 경우에는 다음과 같은 일련의 단계를 수행하여 도구를 시작하고 실행합니다. 문제가 발생하거나 이러한 단계에 대한 자세한 정보를 원하는 경우에는 아래 섹션을 참조하십시오.

  1. 다운로드한 아카이브 파일에서 파일 압축을 풀어서 도구를 설치합니다.
  2. GUI 모드 또는 명령행 콘솔 모드에서 도구를 실행합니다.

도구 설치

도구 설치

IBM Support Assistant Lite 도구를 설치하려면 다운로드한 아카이브에서 압축된 파일을 풀기만 하면 됩니다. 이 파일은 도구를 실행할 시스템에서 선택한 파일 시스템 위치로 압축을 풀 수 있습니다. 그러면 이 대상 디렉토리에 서브디렉토리 \ISALite가 작성됩니다.


도구 사용법

JAVA_HOME 환경 변수 설정

IBM Support Assistant Lite 도구를 GUI 모드와 명령행 콘솔 모드 중 어느 모드에서 사용하는지에 관계없이 명령행에서 적절한 실행 스크립트를 호출하는 동일한 프로시저를 사용하여 도구를 시작합니다. Windows 시스템의 경우 이러한 실행 스크립트는 일괄처리 파일입니다. 기타 환경의 경우에는 쉘 스크립트입니다.

이 도구는 Java 애플리케이션으로 구현되므로 도구를 시작하려면 먼저 JAVA_HOME 환경 변수를 설정해야 합니다. PATH에서 자바를 사용할 수 없는 경우 직접 JAVA_HOME 환경 변수를 설정해야 합니다. IBM Support Assistant Lite 도구를 사용하려면 JRE 레벨 1.4.2 이상(Windows 7 64비트의 경우에는 1.5 이상)이 필요하므로 도구를 실행할 시스템에 적절한 JRE가 설치되어 있는지 먼저 확인해야 합니다. 적절한 JRE가 설치된 경우 운영 체제에 특정한 명령을 실행하여 JAVA_HOME 변수가 이 JRE를 가리키도록 설정해야 합니다. Microsoft JVM/JDK 및 gij(GNU libgcj)는 지원되지 않습니다. 예를 들어, Windows 플랫폼에서 jdk1.4.2가 c:\jre1.4.2에 설치된 경우 다음 명령을 사용하여 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

기본 위치 중 하나에 도구를 설치하고 나면 이 도구가 시작하지 못하고 "ERROR: This tool requires JRE 1.4.2 or greater to run."이라는 오류 메시지가 표시된다는 것을 알 수 있습니다. 이 메시지는 JRE 레벨이 1.4.2보다 낮다는 것을 나타냅니다. 이 경우에는 적절한 레벨의 JRE를 가리키도록 JAVA_HOME 변수를 수동으로 설정해야 합니다.

GUI 모드에서 도구 시작

다음 실행 스크립트를 실행해야 합니다.

명령행 콘솔 모드에서 도구 시작

GUI를 사용할 수 없는 경우 도구는 명령행 모드에서 자동으로 시작되어야 합니다. GUI를 사용할 수 있는 경우라도 콘솔 모드를 선호하는 경우에는 명령행에서 "-console"을 지정합니다. 일부 경우에는 GUI를 사용할 수 없는지 판별할 수 없어 도구가 시작되지 않습니다. 이러한 경우에는 "-console"을 사용하여 도구를 다시 시작해야 합니다.

실행 중에 작성된 파일의 위치

기본적으로 ISA Lite 설치 디렉토리는 실행 중에 작성된 파일을 저장하는 데 사용됩니다. 일부 시스템에서는 ISA Lite 설치 디렉토리가 읽기 전용입니다. 이 경우에는 -useHome 매개변수를 사용합니다. 이 매개변수를 사용하면 임시 파일은 시스템 임시 디렉토리에 쓰여지고 지속 파일은 사용자 홈 디렉토리에 쓰여집니다.

GUI 모드에서 도구와 상호작용

IBM Support Assistant Lite 도구가 GUI 모드에서 시작되면 아래와 같은 그래픽 인터페이스가 표시됩니다.

데이터 콜렉션 및 분석을 위해 도구를 사용하려면 먼저 아래와 같이 문제점 유형 창에서 문제점 유형을 선택해야 합니다.

 

 

문제점 유형 외에 기본 GUI에서 제공해야 하는 유일한 입력 필드 값은 데이터 콜렉션 Zip 파일의 파일 이름입니다. 여기서 파일 이름은 사용자가 원하는 모든 이름이 될 수 있습니다. 예를 들어, Install_failed_2007_01_03을 파일 이름으로 사용할 수 있습니다. 파일 이름을 제공하지 않으면 도구가 자동으로 "zip" 확장자를 추가합니다. 콜렉션을 수행 중인 문제점에 대해 PMR이 열려 있지만 도구가 콜렉션 결과를 FTP를 통해 자동으로 IBM Support에 전송하게 하는 경우 이 도구는 FTP 단계에서 IBM Support에 필요한 특정 파일 이름 지정 규칙을 적용합니다. 파일 이름은 다음과 같이 세 개의 특정 필드로 시작해야 합니다. <pmrnumber>.<branchnumber>.<countrycode>.<short description>.zip. 이 유형의 파일 이름 예제는 34143.055.000.logs.zip입니다. 이전 형식과의 호환성을 위해 처음 세 개의 마침표 위치에 쉼표도 사용할 수 있습니다. 하지만 "zip" 확장자 앞의 네 번째 마침표 위치에는 사용할 수 없습니다. 마침표는 선호되는 구분 기호입니다.

이러한 값이 채워지면 다음 단계는 데이터 콜렉션 단추를 누르는 것입니다. 이 단계가 진행되면 콜렉션 스크립트는 콜렉션 활동을 완료하기 위해 필요한 추가 정보를 사용자에게 요청합니다. 스크립트도 구성 정보, 처리하는 문제점의 발생 과정에 있는 일련의 이벤트에 대한 정보 또는 사용자가 선호하는 콜렉션 완료 방법을 요청할 수 있습니다. 필요한 정보가 모두 제공되면 스크립트는 나머지 콜렉션을 진행합니다.

 도구가 데이터 콜렉션을 완료하면 결과를 IBM Support에 전송할 수 있습니다. 파일 전송을 위해 암호화되지 않은 FTP와 암호화된 HTTPS 사이에서 선택할 수 있습니다. 도구가 IBM Support에 전송하는 Zip 파일의 이름은 출력 파일 이름/경로 상자에서 입력한 파일 이름(서버 호스트 이름과 현재 시간소인이 추가됨)입니다.

 예제: 사용된 출력 파일 이름/경로 파일 이름이 34143.055.000.logs.zip인 경우 IBM에 전송된 Zip 파일의 이름은 다음과 같습니다.

34143.055.000.logs.zip-<hostname>-<currentTimestamp>.zip.

콜렉션 Zip 파일 이름 유효성 검증

IBM Support FTP 사이트 ftp.emea.ibm.com에서의 자동화는 IBM Support Assistant Lite 도구의 기본 GUI에서 설명된 파일 이름 지정 규칙에 전적으로 종속됩니다. 이 규칙을 따르지 않는 이름을 가진 파일이 수신되면 해당 파일은 IBM Support에 표시되지 않습니다. 따라서 이 도구는 콜렉션 Zip 파일을 ftp.emea.ibm.com에 전송하기 위해 FTP 조작을 호출하기 전에 해당 규칙에 대해 콜렉션 Zip 파일의 이름을 유효성 검증합니다. 파일 이름의 형식이 올바르지 않으면 파일 이름을 정정할 수 있는 팝업 창이 표시됩니다. FTP 사이트의 현재 파일 이름 지정 규칙은 여기에 설명된 것과 같이 복합 파일 이름의 개별 필드가 마침표로 분리되는 규칙입니다. 하지만 이전에는 쉼표를 분리 문자로 사용하는 것이 규칙이었습니다. 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 특성 파일과 매우 비슷하여 '#'로 시작하는 주석과 일련의 키-값 쌍이 포함되어 있습니다.

이제 선호하는 편집기를 사용하여 이러한 새 응답 파일에 일시정지를 추가할 수 있습니다. 지원되는 두 가지 새로운 키에 대한 간략한 요약은 다음과 같습니다.

참고

버전 정보 판별

기본적으로 도구의 버전(및 다양한 서브컴포넌트)은 실행된 콘솔에 인쇄됩니다. GUI 모드에서 실행하는 경우에는 도움말 -> 정보 메뉴 옵션을 사용하여 버전 정보를 찾을 수도 있습니다. Java를 사용할 수 없거나 Java 애플리케이션이 시작될 수 없는 경우에는 "-version" 옵션을 사용하여 실행 스크립트를 실행하여 도구의 버전을 가져올 수도 있습니다.

"-version" 옵션을 사용하는 경우 실행 스크립트는 도구를 실제로 호출하지 않고 버전 정보를 인쇄합니다.

HTTPS 업로드에 대한 프록시 지원

JRE 1.5 이상 버전이 사용되는 경우 기본적으로 업로드에서는 시스템 정의 프록시를 사용합니다. Windows의 경우 JRE는 Internet Explorer의 프록시 구성을 사용합니다. Unix의 경우 JRE는 GNOME 2의 프록시 구성을 사용합니다. 이러한 구성을 대체하고 다른 프록시를 입력하려면 "-promptForProxy" 옵션을 사용합니다.

상표 

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의 등록상표입니다.

기타 회사, 제품 및 서비스 이름은 해당 회사의 상표 또는 서비스표입니다.