test

Sun Java System Instant Messaging 7.2 관리 설명서

Instant Messaging XMPP/HTTP 게이트웨이 구성

설치하고 나서 configure 유틸리티를 실행할 때 XMPP/HTTP 게이트웨이를 배포할지 선택할 수 있습니다. 이 게이트웨이가 사용되는 경우 configure 유틸리티는 게이트웨이의 기본 구성 파일(httpbind.conf)을 만듭니다. 이 파일의 값을 수정하면 구성을 변경할 수 있습니다. httpbind.conf 파일 구문, 파일 위치 및 이 파일의 구성 매개 변수 목록에 대한 설명은 부록 B, httpbind.conf의 Instant Messaging XMPP/HTTP 게이트웨이 구성 매개 변수를 참조하거나 이 절에 나오는 지침을 참조하십시오.

초기 구성에서 게이트웨이를 배포하도록 선택하는 경우 configure 유틸리티는im-svr-base/work 디렉토리에 war 파일을 만든 다음 코드베이스에 대해 지정된 디렉토리의 웹 또는 응용 프로그램 서버에 이 파일을 배포합니다.

웹 컨테이너의 클라이언트 자원과 함께 배포되는 web.xml의 값을 수정하면 기본 이외의 구성 파일을 사용하도록 게이트웨이를 구성할 수도 있습니다.

이 절의 지침에서는 게이트웨이 구성 파일이 httpbind.conf라고 가정합니다. 기본 이외의 구성 파일을 사용하는 경우 이 지침에 나오는 httpbind.conf를 해당 구성 파일로 대체하십시오.

httpbind.conf를 변경할 때마다 XMPP/HTTP 게이트웨이를 다시 시작해야 합니다.

이 절에서 설명되는 지침은 다음과 같습니다.

게이트웨이 로깅 구성에 대한 지침은 XMPP/HTTP 게이트웨이 로깅 관리를 참조하십시오.

ProcedureInstant Messaging XMPP/HTTP 게이트웨이를 활성화 또는 비활성화하려면

configure 유틸리티를 실행한 다음 iim.conf의 매개 변수를 설정하여 게이트웨이를 활성화합니다. 나중에 웹 컨테이너 또는 응용프로그램 서버에서 제공되는 도구를 사용하여 이 게이트웨이를 비활성화할 수 있습니다.

  1. 게이트웨이를 활성화하려면

    1. configure 유틸리티를 실행합니다.

    2. 프롬프트가 메시지가 표시되면 게이트웨이를 배포하도록 선택합니다.

      자세한 내용은 1 장, 설치 후 Instant Messaging 구성을 참조하십시오.

    3. iim.conf에서 iim_agent.httpbind.enable 매개 변수를 true로 설정합니다.

      예를 들면 다음과 같습니다.


      iim_agent.httpbind.enable=true

  2. 게이트웨이를 비활성화하려면 웹 서버 또는 응용 프로로그램 서버에서 제공되는 도구를 사용하여 webapp를 비활성화합니다.

ProcedureXMPP/HTTP 게이트웨이에서 처리되는 동시 요청 수를 구성하려면

시작하기 전에

JEP 124 표준 초안을 잘 알고 있어야 합니다. 자세한 내용은 http://www.jabber.org/jeps/jep-0124.html 페이지를 참조하십시오.

  1. httpbind.conf를 엽니다.

    이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.

  2. httpbind.requests 매개 변수를 단일 클라이언트에서 게이트웨이에 보낼 수 있는 최대 동시 요청 수로 설정합니다.

    기본값은 2입니다. 예를 들면 다음과 같습니다.


    httpbind.requests=2

    이 숫자는 클라이언트에서 게이트웨이로 보낼 수 있는 동시 요청의 개수입니다. 이 매개 변수 값은 클라이언트 요청의 JEP 124 hold 속성 값보다 작으면 hold+1로 설정됩니다. 성능에 심각한 영향을 미칠 수 있으므로 이 매개 변수를 1로 설정하지 마십시오. httpbind.hold 매개 변수에 대한 자세한 내용은 XMPP/HTTP 게이트웨이에 클라이언트 요청의 JEP 124 hold 속성을 설정하려면 및 표 B–1을 참조하십시오.

  3. httpbind.conf를 저장하고 닫습니다.

  4. 웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.

ProcedureXMPP/HTTP 게이트웨이에 클라이언트 요청의 JEP 124 hold 속성을 설정하려면

시작하기 전에

JEP 124 표준 초안을 잘 알고 있어야 합니다. 자세한 내용은 http://www.jabber.org/jeps/jep-0124.html 페이지를 참조하십시오.

  1. httpbind.conf를 엽니다.

    이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.

  2. httpbind.hold 매개 변수를 게이트웨이에서 클라이언트 요청의 hold 속성에 허용할 최대값으로 설정합니다.

    기본값은 5입니다. 예를 들면 다음과 같습니다.


    httpbind.hold=5

    클라이언트에서 보낸 hold 값이 게이트웨이의 hold 값보다 크면 게이트웨이의 hold 값이 사용됩니다.

  3. httpbind.conf를 저장하고 닫습니다.

  4. 웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.

ProcedureXMPP/HTTP 게이트웨이에 클라이언트 비활성 허용 시간을 지정하려면

  1. httpbind.conf를 엽니다.

    이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.

  2. httpbind.inactivity 매개 변수를 게이트웨이에서 유휴 연결을 종료하는 데 필요한 경과 시간(초)으로 설정합니다.

    기본값은 180초입니다. 예를 들면 다음과 같습니다.


    httpbind.inactivity=180

    이 시간이 경과하기 전에 클라이언트에서 게이트웨이를 폴링하지 않으면 게이트웨이에서 연결이 종료됩니다.

  3. httpbind.conf를 저장하고 닫습니다.

  4. 웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.

ProcedureXMPP/HTTP 게이트웨이에 내용 유형 HTTP 헤더를 설정하려면

  1. httpbind.conf를 엽니다.

    이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.

  2. 클라이언트에서 초기 요청에 내용 유형을 지정하지 않은 경우 httpbind.content_type 매개 변수를 게이트웨이에서 사용할 내용 유형으로 설정합니다.

    기본값은 text/xml; charset=utf-8입니다. 예를 들면 다음과 같습니다.


    httpbind.content_type=text/xml; charset=utf-8

  3. httpbind.conf를 저장하고 닫습니다.

  4. 웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.

ProcedureXMPP/HTTP 게이트웨이에 왕복 지연 시간을 설정하려면

왕복 지연 시간은 게이트웨이와 클라이언트 사이의 왕복 지연에 허용되는 초과 시간(초)입니다. 이 값은 네트워크 대기 시간을 산정하는 데 유용합니다.

  1. httpbind.conf를 엽니다.

    이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.

  2. 필요에 따라 httpbind.round_trip_delay 매개 변수를 설정합니다.

    이 값을 너무 크게 설정하면 성능이 저하될 수 있습니다. 이 값은 초 단위입니다. 기본값은 1초입니다. 예를 들면 다음과 같습니다.


    httpbind.round_trip_delay=1

    이 값을 너무 크게 설정하면 성능이 저하될 수 있습니다. 이 매개 변수는 일반적인 네트워크 대기 시간을 고려한 후에 변경하는 것이 좋습니다.

  3. httpbind.conf를 저장하고 닫습니다.

  4. 웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.

ProcedureXMPP/HTTP 게이트웨이에서 클라이언트로 응답을 보내는 기본 시간을 설정하려면

  1. httpbind.conf를 엽니다.

    이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.

  2. 필요에 따라 httpbind.wait_time 매개 변수를 설정합니다.

    이 매개 변수로 지정한 시간 내에 클라이언트에서 XMPP/HTTP 게이트웨이로부터 응답을 받을 수 있도록 보장합니다. 이 매개 변수를 설정할 때는 네트워크 속도를 고려하는 것이 좋습니다. XMPP/HTTP 게이트웨이에서 시간 내에 요청을 보내지 못할 수도 있으므로 이 값을 너무 낮게 설정하지 마십시오.

    이 값은 초 단위입니다. 기본값은 120초입니다. 예를 들면 다음과 같습니다.


    httpbind.wait_time=120

    클라이언트에 설정된 값이 게이트웨이의 값보다 크면 게이트웨이 대기 시간이 사용됩니다.

  3. httpbind.conf를 저장하고 닫습니다.

  4. 웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.

ProcedureInstant Messaging 게이트웨이 풀에 XMPP/HTTP 게이트웨이를 구성하려면

  1. httpbind.conf를 엽니다.

    이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.

  2. Instant Messaging 게이트웨이 풀이 있는 배포 환경의 일부로 게이트웨이를 구성하려면 다음과 같이 수행합니다.

    1. httpbind.pool.support 매개 변수를 true로 설정합니다.


      httpbind.pool.support=true

    2. httpbind.pool.nodeId 매개 변수를 게이트웨이의 전체 URL로 설정합니다.

      이 URL은 게이트웨이의 노드 아이디(nodeId)로 사용되며,이 아이디는 서버 풀 내에서 고유해야 합니다. 게이트웨이에서는 이 노드 아이디를 사용하여 수신된 요청을 서비스하거나 풀의 다른 게이트웨이로 해당 요청을 전달해야 하는지 결정합니다.

  3. 게이트웨이 풀에서 게이트웨이가 작동하지 않도록 구성하려면 httpbind.pool.support 매개 변수를 다음과 같이 설정합니다.


    httpbind.pool.support=false

  4. httpbind.conf를 저장하고 닫습니다.

  5. 웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.

Procedure지원되는 XMPP/HTTP 게이트웨이 도메인의 키 아이디 목록을 구성하려면

  1. httpbind.conf를 엽니다.

    이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.

  2. httpbind.config 매개 변수를 게이트웨이에서 사용할 아이디 목록으로 설정합니다.

    각 도메인마다 별도의 아이디를 이 매개 변수에 지정해야 합니다. 예를 들면 다음과 같습니다.


    httpbind.config=gwdomain-id

    여기서 gwdomain-id는 도메인에 사용할 식별자입니다.

    예를 들면 다음과 같습니다.


    httpbind.config=siroe.com

  3. 지정하는 각 gwdomain-id에 대해 다음 매개 변수를 httpbind.conf 파일에 추가합니다.


    gwdomain-id.domain=domain-name
gwdomain-id.hosts=gateway-host
gwdomain-id.componentjid=component-jid
gwdomain-id.password=password

    여기서

    • gwdomain-id는 이전 단계에서 httpbind.config의 게이트웨이에 대해 지정한 아이디입니다.

    • domain-name은 식별된 게이트웨이가 실행되는 도메인입니다.

    • gateway-host는 정규화된 도메인 이름(FQDN)과 이 도메인을 지원하는 게이트웨이 호스트의 포트 번호를 쉼표 또는 공백으로 구분한 목록입니다.

    • component-jid는 게이트웨이의 구성 요소 JID입니다.

    • password는 식별된 게이트웨이의 비밀번호입니다.

    예를 들어 gwdomain-id가 siroe로 설정된 경우 다음과 같습니다.


    siroe.domain=siroe.com
siroe.hosts=gateway.siroe.com:5222
siroe.componentjid=http.gateway.siroe.com
siroe.password=gatewaypassword

    이러한 키 매개 변수에 대한 자세한 내용은 httpbind.config의 게이트웨이 도메인 아이디 키 매개 변수를 참조하십시오.

  4. httpbind.conf를 저장하고 닫습니다.

  5. 웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.

Procedure기본 이외의 구성 파일을 사용하도록 Instant Messaging XMPP/HTTP 게이트웨이를 구성하려면

  1. Instant Messenger 자원 파일이 배포된 웹 컨테이너에서 web.xml 파일을 편집합니다.

    웹 컨테이너의 도구를 사용하여 이 파일을 편집합니다.

  2. httpbind.config.file 매개 변수 값을 게이트웨이에서 사용할 구성 파일의 위치로 변경합니다.