관리

본 장에서는 웹 서비스 게이트웨이(WSGW)의 상태 정보를 보거나 재시작하는 명령어와 유틸리티에 대해 설명한다.

1. 명령어

명령어는 상태 정보 조회를 위한 명령어와 동적 설정을 위한 명령어로 나뉜다.

1.1. wsgwinfo

WSGW의 상태 정보는 Tmax에서 제공하는 정보는 기본 정보와 추가된 명령어로 tmadmin에서 wsgwinfo를 통해서 알 수 있다.

tmadmin에서 wsgwinfo를 입력하면 전체 웹 서비스 게이트웨이의 정보들을 출력한다. 정보는 웹 서비스 게이트웨이가 부트된 시간(load_time), 현재 접속 중인 클라이언트 수(current_client), 한 서비스를 처리하기까지 걸린 최장 시간(max_attach_time)이다.

  • 사용 방법

    사용 방법은 다음과 같다.

    wsgwinfo [-i svrid[svrid]]

    옵션을 주지 않을 경우 모든 웹 서비스의 게이트웨이 정보를 출력한다.

  • 예제

    [-i] 옵션을 적용할 경우 뒤에 입력된 svrid의 웹 서비스 게이트웨이의 정보만 출력한다.

    wsgwinfo –i 0 1 2

1.2. wsgwreload

Tmax를 운영 중에 서비스 정보 설정을 변경하거나 웹 서비스 게이트웨이 설정을 변경할 상황이 생길 수 있다. 이런 경우는 Tmax 시스템은 tmadmin의 wsgwreload 명령어를 실행하여 적용한다. 명령어가 실행되면 웹 서비스 게이트웨이는 새롭게 요청되는 서비스에는 응답하지 않으며 이미 처리 중인 서비스만 처리한 후 설정을 적용하고 서비스를 처리하기 시작한다.

sgwreload만 실행하면 전체 웹 서비스 게이트웨이가 설정을 다시 로드한다. wsgwreload에 [–i] 옵션으로 특정 서버 ID 리스트를 지정하면 지정된 웹 서비스 게이트웨이만이 변경된 설정을 적용한다.

wsgwreload –i 0 1 2

2. 유틸리티

다음은 웹 서비스와 관련되어 제공되는 유틸리티 목록이다.

유틸리티 설명

tmmbfgen

서비스 정보 파일(text)을 서비스 정보 바이너리 파일로 만든다.

untmmbfgen

서비스 정보 바이너리 파일을 서비스 정보 파일(text)로 만든다.

xwsdlgen

웹 서비스 스펙 중 명세서 역할을 하는 WSDL 문서를 생성하는 생성한다.

2.1. tmmbfgen

서비스 정보 파일(text)을 서비스 정보 바이너리 파일로 만드는 명령어이다. 사용자가 작성한 서비스 정보 파일은 그대로 웹 서비스 게이트웨이와 xwsdlgen에서 사용할 수 없기 때문에 tmmbfgen으로 새로운 파일을 생성해야 한다.

tmmbfgen에 의해서 생성된 파일을 서비스 정보 바이너리 파일이라고 한다. tmmbfgen을 하면 문법을 체크하고 파라미터의 타입 체크를 통해서 웹 서비스 게이트웨이에서 참조하기 전에 미리 유효성 검사를 할 수 있으며 텍스트 문서를 여러 개로 분할하여 관리가 가능하다.

  • 사용 방법

    tmmbfgen [-r text_file ,] [-i text_file] [-d svc] -o binary_file -r
    항목 설명

    [-i text_file]

    서비스 정보 파일(text)을 입력한다.

    [-d svc]

    삭제할 서비스 이름 리스트를 입력한다.

    -o binary_file

    생성할(변경할) 서비스 정보 바이너리 파일(default = sample)이다.

  • 예제

    • 다음은 새로운 서비스 정보 바이너리 파일 생성하는 예제이다.

      sample을 생성하고 sample1.txt와 sample2.txt에 정의된 서비스 정보를 sample에 입력한다.

      tmmbfgen -r sample1.txt,sample2.txt -o sample

    • 다음은 기존 서비스 정보 바이너리 파일에 추가하는 예제이다.

      기존 sample 파일에 sample3.txt에 정의된 서비스 정보를 추가한다. 같은 서비스가 있는 경우 파일이 교체된다.

      tmmbfgen -i sample3.txt -o sample

    • 다음은 기존 서비스 정보 바이너리에서 특정 서비스 삭제하는 예제이다.

      sample 파일에서 서비스 SVC1, SVC2의 정보를 삭제한다.

      tmmbfgen -d SVC1,SVC2 -o sample

2.2. untmmbfgen

untmmbfgen은 서비스 정보 바이너리 파일을 서비스 정보 파일(text)로 만들어주는 명령어이다.

  • 사용 방법

    untmmbfgen -i binary_meta_file -o text_file
    항목 설명

    -i binary_meta_file

    서비스 정보 바이너리 파일을 지정한다.

    -o text_file

    생성될 서비스 정보 파일(text)을 지정한다.

  • 예제

    다음은 untmmbfgen으로 서비스 정보 바이너리 파일을 사용자들이 알아볼 수 있도록 다시 역변환하는 예제이다.

    untmmbfgen -i sample -o unsample.txt

2.3. xwsdlgen

웹 서비스 스펙 중 명세서 역할을 하는 WSDL 문서를 생성하는 명령어이다. 현재 WSDL 문서는 1.1, 2.0이 존재한다. xwsdlgen은 웹 서비스 게이트웨이 환경설정 파일과 서비스 정보 바이너리 파일을 입력받아서 WSDL 문서를 생성한다.

  • 사용 방법

    xwsdlgen [options] -g wsgw_config_file -m binary_meta_file -o wsdl_file

    • Options

      항목 설명

      w version

      다음의 값을 설정한다.

      • 0 : WSDL1.1 (기본값)

      • 1 : WSDL2.0

      b binding_style

      다음의 값을 설정한다.

      • 0 : rpc (기본값)

      • 1 : document

    • 설정 항목

      항목 설명

      -g wsgw_config_file

      웹 서비스 게이트웨이 환경설정 파일을 설정한다.

      -m binary_meta_file

      서비스 정보 바이너리 파일을 설정한다.

      -o wsdl_file

      생성할 WSDL 파일을 설정한다.