명령행에서 Liberty 서버 덤프 생성

명령행에서 server dump 또는 server javadump 명령을 사용하여 Liberty 서버에 대한 상태 정보를 캡처할 수 있습니다.

이 태스크 정보

결과 파일에 workarea 디렉토리의 배치된 애플리케이션의 세부사항과 로그 정보, 서버 구성이 포함되어 있으므로, server dump 명령은 Liberty 서버의 문제점 진단에 유용합니다. 이 명령은 실행 중이거나 중지된 서버에 적용할 수 있습니다.

실행 중인 서버일 경우, 다음 정보도 포함됩니다.
  • 서버의 개별 OSGi 번들 상태
  • 서버의 개별 OSGi 번들에 대한 배선 정보
  • SCR(Service Component Runtime) 환경에서 관리하는 컴포넌트 목록
  • SCR의 개별 컴포넌트에 대한 자세한 정보
  • 각 OSGi 번들의 구성 관리 데이터
  • 등록된 OSGi 서비스에 대한 정보
  • JVM(Java™ Virtual Machine), 힙 크기, 운영 체제, 스레드 정보 및 네트워크 상태와 같은 런타임 환경 설정
server javadump 명령은 정지 스레드 수, 교착 상태, 과다 처리, 과다 메모리 사용, 메모리 누수 및 가상 머신의 결함 수 등 JVM 레벨의 문제점 진단에 유용합니다. 이 명령은 실행 중인 서버에서만 사용할 수 있습니다. 각 덤프 유형은 하나의 파일을 작성하지만 모든 가상 머신에서 모든 덤프 유형을 지원하지는 않습니다. 서버 명령 옵션의 내용을 참조하십시오. 덤프 파일의 기본 디렉토리는 ${server.output.dir}입니다. 다른 기본 디렉토리를 설정하려면 IBM® JVM을 사용하고 다음과 같은 환경 변수를 설정해야 합니다.
  • IBM_HEAPDUMPDIR
  • IBM_COREDIR
  • IBM_JAVACOREDIR

프로시저

  1. 명령행을 열고 디렉토리를 wlp/bin 디렉토리로 변경하십시오.
  2. 다음 명령행 도구 중 하나를 사용하여 상태 정보를 캡처하십시오. 서버 이름을 지정하지 않을 경우 defaultServer가 사용됩니다.
    • 서버 상태의 스냅샷을 작성하려면 server dump 명령을 사용하십시오.
      • For distributed platformsFor IBM i platforms
        server dump server_name --archive=package_file_name.dump.zip --include=heap
        여기서 package_file_name.dump.zip은 사용자가 선택하는 파일 이름입니다. 이 파일 이름은 전체 경로 이름을 포함할 수 있습니다. 전체 경로가 생략된 경우, package_file_name.dump.zip이라는 압축 파일이 기본 디렉토리 ${server.output.dir}에 작성됩니다.

      --include 매개변수는 선택사항입니다. 추가의 메모리 덤프 유형을 요청할 수 있습니다. 예를 들어, --include=heap 옵션은 힙 덤프를 요청합니다. --include=thread,heap,system 옵션은 스레드 덤프, 힙 덤프, 시스템 덤프를 요청합니다.

    • JVM 상태의 스냅샷을 작성하려면 server javadump 명령을 사용하십시오.
      • For distributed platformsFor IBM i platforms
        server javadump server_name --include=heap

      --include 매개변수는 선택사항입니다. 추가의 메모리 덤프 유형을 요청할 수 있습니다. 예를 들어, --include=heap 옵션은 힙 덤프를 요청합니다. --include=heap,system 옵션은 힙 덤프와 시스템 덤프를 요청합니다. 출력 파일은 기본 디렉토리 ${server.output.dir}에 작성됩니다. 다른 기본 디렉토리를 설정하려면 IBM JVM을 사용하고 IBM_HEAPDUMPDIR, IBM_COREDIRIBM_JAVACOREDIR 환경 변수를 설정해야 합니다.

    참고: 결과 파일은 항목 이름에 UTF-8 인코딩을 사용하여 작성되므로 파일을 여는 데 사용하는 도구가 항목 이름에 UTF-8 인코딩을 사용할 수 있어야 합니다. Java SDK의 jar 명령은 이 형식을 사용합니다.

결과

지정된 서버가 존재하지 않으면 명령은 성공하지 않습니다. 지정된 서버가 존재하는 경우 서버의 상태 정보를 포함하는 결과 파일이 작성됩니다.

주제의 유형을 표시하는 아이콘 태스크 주제

파일 이름: twlp_setup_dump_server.html