부록 B httpbind.conf의 Instant Messaging XMPP/HTTP 게이트웨이 구성 매개 변수
Instant Messaging은 XMPP/HTTP 게이트웨이 구성 설정을 httpbind.conf 파일에 저장합니다. 이 부록의 다음 절에서는 구성 매개 변수와 파일을 설명합니다.
httpbind.conf 파일을 수정할 때마다 웹 컨테이너 또는 Application Server에서 제공되는 도구를 사용하여 XMPP/HTTP 게이트웨이를 다시 시작해야 합니다.
httpbind.conf 파일 위치
기본적으로 configure 유틸리티는 기본 서버 인스턴스의 구성 디렉토리(im-cfg-base) 내에 httpbind.conf 파일을 만듭니다. 예를 들면 다음과 같습니다.
-
Solaris:
/etc/opt/SUNWiim/default/config/httpbind.conf
-
Linux:
/etc/opt/sun/im/default/config/httpbind.conf
여러 Instant Messaging 인스턴스를 만든 경우 /default 디렉토리의 이름은 해당 인스턴스에 따라 달라집니다. 자세한 내용은 단일 Instant Messaging 설치에서 여러 인스턴스 만들기 를 참조하십시오. 이 파일은 configure 유틸리티를 통해 기본 인스턴스의 im-cfg-base 디렉토리에만 만들어집니다.
httpbind.conf 파일 구문
httpbind.conf 파일은 일반 ASCII 텍스트 파일이며, 각각의 줄에 게이트웨이 매개 변수와 그 값을 정의하고 있습니다.
-
매개 변수와 해당 값은 등호(=)로 구분되며, 등호 앞뒤에 공백과 탭이 입력될 수 있습니다.
-
값은 큰따옴표(" ")로 묶을 수 있습니다. 매개 변수에 값이 여러 개 사용되면 값 문자열 전체를 큰따옴표로 묶어야 합니다.
-
주석 줄에는 첫 번째 문자로 느낌표(!)가 사용되어야 합니다. 주석 줄은 정보를 제공하기 위한 것이며 서버에서는 무시됩니다.
-
매개 변수가 두 번 이상 사용되는 경우 먼저 나열된 값은 무시되고 마지막으로 나열된 값이 사용됩니다.
-
백슬래시(\)는 값이 두 줄 이상인 경우 연속된 값임을 나타내기 위해 사용됩니다.
-
각 줄은 줄 종결자(\n, \r 또는 \r\n)로 끝납니다.
-
키는 줄에서 공백이 아닌 첫 번째 문자로 시작하여 첫 번째 ASCII 등호(=) 또는 세미콜론(;)까지의 모든 문자로 구성됩니다. 키가 세미콜론으로 끝나면 그 뒤에 "lang-" 및 이 값이 해석되는 언어를 나타내는 태그가 옵니다. 언어 태그 뒤에는 등호(=)가 옵니다. 등호 앞뒤의 공백 문자는 모두 무시됩니다. 줄의 나머지 문자는 모두 관련된 값 문자열의 일부가 됩니다.
-
값 문자열에 값이 여러 개 있으면 쉼표(,)를 사용하여 구분합니다.
-
값에 쉼표, 공백, 새 줄, 탭, 큰따옴표 또는 백슬래시와 같은 특수 문자가 있으면 전체 값을 큰따옴표로 묶어야 합니다. 또한 값에 포함되는 캐리지 리턴, 줄 바꿈, 탭, 백슬래시 및 큰따옴표는 모두 백슬래시(\)로 지정해야 합니다.
-
httpbind.conf를 변경하는 경우 새 구성 설정을 적용하려면 게이트웨이의 웹 컨테이너를 새로 고쳐야 합니다.
주 –
httpbind.conf 파일은 configure 유틸리티로 초기화되며 이 설명서의 내용대로 수정되어야 합니다.
Instant Messaging XMPP/HTTP 게이트웨이 구성 매개 변수
표 B–1에서는 httpbind.conf의 구성 매개 변수를 설명합니다.
표 B–1 httpbind.conf의 XMPP/HTTP 게이트웨이 구성 매개 변수|
매개 변수 |
기본값 |
설명 |
|---|---|---|
|
httpbind.pool.nodeId |
해당 없음 |
httpbind.pool.support가 true로 설정되면 이 매개 변수는 서버 풀의 서버 노드에 대한 전체 URL을 지정합니다. 이 URL은 로드 밸런서가 아니라 Instant Messaging 서버 인스턴스를 가리켜야 합니다. |
|
httpbind.pool.support |
false |
이 매개 변수는 게이트웨이가 서버 풀 배포에 속하는지 여부를 정의합니다. httpbind.pool.nodeId를 지정하지 않은 경우 이 매개 변수 값은 false로 설정됩니다. 이 매개 변수 값은 다음과 같습니다.
|
|
httpbind.config |
해당 없음 |
각각 쉼표로 구분된 아이디 키 목록 또는 gwdomain-id가 포함되며, 사용할 도메인, 호스트, 호스트 비밀번호, 구성 요소 JID를 결정하기 위해 게이트웨이에서 사용되는 구성 키입니다. 자세한 내용은 표 B–2를 참조하십시오. |
|
httpbind.content_type |
text/xml; charset=utf-8 |
클라이언트로 응답을 보낼 때 게이트웨이에서 사용되는 내용 유형 HTTP 헤더의 기본값입니다. |
|
httpbind.hold |
해당 없음 |
JEP 124에 정의된 대로 클라이언트 요청의 hold 속성에 대한 최대 허용 값을 지정합니다. 클라이언트에서 요청에 대해 지정한 값이 게이트웨이의 값보다 크면 게이트웨이의 값이 사용됩니다. 그렇지 않으면 클라이언트 요청의 값이 사용됩니다. |
|
httpbind.inactivity |
180 |
클라이언트가 일정 시간 동안 비활성이면 게이트웨이에서 클라이언트 연결을 종료하게 되는 최대 비활성 시간(초)입니다. |
|
httpbind.log4j.config |
해당 없음 |
게이트웨이에서 로깅에 사용하는 log4j 구성 파일의 위치입니다. 이 매개 변수를 공백으로 두면 게이트웨이 로깅이 작동되지 않습니다. 로거 이름은 "httpbind"(log4j.logger.httpbind)입니다. |
|
httpbind.polling |
1(초) |
클라이언트에서 다른 요청을 보내기 전에 대기해야 하는 최소 시간(초)입니다. |
|
httpbind.requests |
2 |
클라이언트에서 게이트웨이로 동시에 보낼 수 있는 요청 개수입니다. 이 매개 변수 값이 클라이언트 요청의 JEP 124 hold속성 값보다 작으면 hold+1로 설정됩니다. 성능에 심각한 영향을 미칠 수 있으므로 이 매개 변수를 1로 설정하지 마십시오. 자세한 내용은 httpbind.hold를 참조하십시오. |
|
httpbind.round_trip_delay |
1(초) |
네트워크 지연 시간을 산정하기 위해 왕복 지연에 허용되는 초과 시간(초)입니다. 이 값을 너무 크게 설정하면 성능이 저하될 수 있습니다. |
|
httpbind.wait_time |
120(초) |
게이트웨이가 클라이언트에 응답을 전송하는 기본 제한 시간(초)입니다. 클라이언트 대기 시간이 게이트웨이 대기 시간보다 더 큰 값으로 설정되면 게이트웨이 대기 시간이 사용됩니다. |
httpbind.config의 게이트웨이 도메인 아이디 키 매개 변수
표 B–2에서는 httpbind.config 매개 변수의 각 아이디를 정의하는 데 사용되는 키를 설명합니다. 이 표에 나오는 각각의 키에서 gwdomain-id는 httpbind.config에 지정된 도메인 식별자입니다.
표 B–2 httpbind.config 아이디 키|
키 |
설명 |
|---|---|
|
gwdomain-id.domains |
쉼표로 구분된 이 아이디의 도메인 목록 |
|
gwdomain-id.hosts |
공백으로 구분된 이 아이디의 호스트 목록. 이 목록에 포함된 호스트는 각각 gwdomain-id.domains에 나열된 도메인을 서비스할 수 있어야 합니다. 이 목록은 도메인 전체에 페일오버를 제공하는 데 유용합니다. 요청에 명시적인 라우팅 호스트가 없으면 이 키에 나열된 호스트 중 하나가 해당 요청을 서비스하는 데 사용됩니다. |
|
gwdomain-id.componentjid |
호스트 연결에 사용하는 구성 요소 JID |
|
gwdomain-id.password |
호스트 연결에 사용하는 비밀번호 |
- © 2010, Oracle Corporation and/or its affiliates