설치하고 나서 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 게이트웨이 로깅 관리를 참조하십시오.
configure 유틸리티를 실행한 다음 iim.conf의 매개 변수를 설정하여 게이트웨이를 활성화합니다. 나중에 웹 컨테이너 또는 응용프로그램 서버에서 제공되는 도구를 사용하여 이 게이트웨이를 비활성화할 수 있습니다.
게이트웨이를 활성화하려면
configure 유틸리티를 실행합니다.
프롬프트가 메시지가 표시되면 게이트웨이를 배포하도록 선택합니다.
자세한 내용은 1 장, 설치 후 Instant Messaging 구성을 참조하십시오.
iim.conf에서 iim_agent.httpbind.enable 매개 변수를 true로 설정합니다.
예를 들면 다음과 같습니다.
iim_agent.httpbind.enable=true |
게이트웨이를 비활성화하려면 웹 서버 또는 응용 프로로그램 서버에서 제공되는 도구를 사용하여 webapp를 비활성화합니다.
JEP 124 표준 초안을 잘 알고 있어야 합니다. 자세한 내용은 http://www.jabber.org/jeps/jep-0124.html 페이지를 참조하십시오.
httpbind.conf를 엽니다.
이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.
httpbind.requests 매개 변수를 단일 클라이언트에서 게이트웨이에 보낼 수 있는 최대 동시 요청 수로 설정합니다.
기본값은 2입니다. 예를 들면 다음과 같습니다.
httpbind.requests=2 |
이 숫자는 클라이언트에서 게이트웨이로 보낼 수 있는 동시 요청의 개수입니다. 이 매개 변수 값은 클라이언트 요청의 JEP 124 hold 속성 값보다 작으면 hold+1로 설정됩니다. 성능에 심각한 영향을 미칠 수 있으므로 이 매개 변수를 1로 설정하지 마십시오. httpbind.hold 매개 변수에 대한 자세한 내용은 XMPP/HTTP 게이트웨이에 클라이언트 요청의 JEP 124 hold 속성을 설정하려면 및 표 B–1을 참조하십시오.
httpbind.conf를 저장하고 닫습니다.
웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.
JEP 124 표준 초안을 잘 알고 있어야 합니다. 자세한 내용은 http://www.jabber.org/jeps/jep-0124.html 페이지를 참조하십시오.
httpbind.conf를 엽니다.
이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.
httpbind.hold 매개 변수를 게이트웨이에서 클라이언트 요청의 hold 속성에 허용할 최대값으로 설정합니다.
기본값은 5입니다. 예를 들면 다음과 같습니다.
httpbind.hold=5 |
클라이언트에서 보낸 hold 값이 게이트웨이의 hold 값보다 크면 게이트웨이의 hold 값이 사용됩니다.
httpbind.conf를 저장하고 닫습니다.
웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.
httpbind.conf를 엽니다.
이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.
httpbind.inactivity 매개 변수를 게이트웨이에서 유휴 연결을 종료하는 데 필요한 경과 시간(초)으로 설정합니다.
기본값은 180초입니다. 예를 들면 다음과 같습니다.
httpbind.inactivity=180 |
이 시간이 경과하기 전에 클라이언트에서 게이트웨이를 폴링하지 않으면 게이트웨이에서 연결이 종료됩니다.
httpbind.conf를 저장하고 닫습니다.
웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.
httpbind.conf를 엽니다.
이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.
클라이언트에서 초기 요청에 내용 유형을 지정하지 않은 경우 httpbind.content_type 매개 변수를 게이트웨이에서 사용할 내용 유형으로 설정합니다.
기본값은 text/xml; charset=utf-8입니다. 예를 들면 다음과 같습니다.
httpbind.content_type=text/xml; charset=utf-8 |
httpbind.conf를 저장하고 닫습니다.
웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.
왕복 지연 시간은 게이트웨이와 클라이언트 사이의 왕복 지연에 허용되는 초과 시간(초)입니다. 이 값은 네트워크 대기 시간을 산정하는 데 유용합니다.
httpbind.conf를 엽니다.
이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.
필요에 따라 httpbind.round_trip_delay 매개 변수를 설정합니다.
이 값을 너무 크게 설정하면 성능이 저하될 수 있습니다. 이 값은 초 단위입니다. 기본값은 1초입니다. 예를 들면 다음과 같습니다.
httpbind.round_trip_delay=1 |
이 값을 너무 크게 설정하면 성능이 저하될 수 있습니다. 이 매개 변수는 일반적인 네트워크 대기 시간을 고려한 후에 변경하는 것이 좋습니다.
httpbind.conf를 저장하고 닫습니다.
웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.
httpbind.conf를 엽니다.
이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.
필요에 따라 httpbind.wait_time 매개 변수를 설정합니다.
이 매개 변수로 지정한 시간 내에 클라이언트에서 XMPP/HTTP 게이트웨이로부터 응답을 받을 수 있도록 보장합니다. 이 매개 변수를 설정할 때는 네트워크 속도를 고려하는 것이 좋습니다. XMPP/HTTP 게이트웨이에서 시간 내에 요청을 보내지 못할 수도 있으므로 이 값을 너무 낮게 설정하지 마십시오.
이 값은 초 단위입니다. 기본값은 120초입니다. 예를 들면 다음과 같습니다.
httpbind.wait_time=120 |
클라이언트에 설정된 값이 게이트웨이의 값보다 크면 게이트웨이 대기 시간이 사용됩니다.
httpbind.conf를 저장하고 닫습니다.
웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.
httpbind.conf를 엽니다.
이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.
Instant Messaging 게이트웨이 풀이 있는 배포 환경의 일부로 게이트웨이를 구성하려면 다음과 같이 수행합니다.
게이트웨이 풀에서 게이트웨이가 작동하지 않도록 구성하려면 httpbind.pool.support 매개 변수를 다음과 같이 설정합니다.
httpbind.pool.support=false |
httpbind.conf를 저장하고 닫습니다.
웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.
httpbind.conf를 엽니다.
이 파일을 찾으려면 httpbind.conf 파일 위치를 참조하십시오.
httpbind.config 매개 변수를 게이트웨이에서 사용할 아이디 목록으로 설정합니다.
각 도메인마다 별도의 아이디를 이 매개 변수에 지정해야 합니다. 예를 들면 다음과 같습니다.
httpbind.config=gwdomain-id |
여기서 gwdomain-id는 도메인에 사용할 식별자입니다.
예를 들면 다음과 같습니다.
httpbind.config=siroe.com |
지정하는 각 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의 게이트웨이 도메인 아이디 키 매개 변수를 참조하십시오.
httpbind.conf를 저장하고 닫습니다.
웹 서버 또는 응용 프로그램 서버에서 제공되는 도구를 사용하여 게이트웨이를 다시 시작합니다.