| |
| Sun Java System Message Queue 3 2005Q1 관리 설명서 | |
3장
브로커 및 클라이언트 시작Sun Java™ System Message Queue를 설치하고 몇 가지 준비 단계를 수행한 후 브로커와 클라이언트를 시작할 수 있습니다.
이 장은 다음 내용으로 구성되어 있습니다.
브로커 인스턴스의 구성은 일련의 구성 파일 및 imqbrokerd 명령과 함께 전달되는 옵션에 따라 결정되며, 옵션은 구성 파일의 해당 등록 정보를 대체합니다. 브로커 구성에 대한 자세한 내용은 4장, "브로커 구성"을 참조하십시오.
시스템 자원 준비브로커를 시작하기 전에 시스템 클럭 동기화 및 파일 설명자 제한 설정(Solaris 또는 Linux)의 두 가지 시스템 수준 작업을 수행해야 합니다. 다음 절에서는 이러한 작업에 대해서 설명합니다.
시스템 클럭 동기화
브로커 또는 클라이언트를 시작하기 전에 Message Queue 시스템과 상호 작용하는 모든 호스트에서 클럭을 동기화해야 합니다. 동기화는 메시지 만료(TimeToLive)를 사용할 경우에 특히 중요합니다. 동기화되지 않은 클럭의 타임스탬프는 TimeToLive 기능이 예상한 대로 작동하지 않게 하여 메시지 전달을 막을 수 있습니다. 브로커 클러스터에도 동기화가 중요합니다.
SNTP(Simple Network Time Protocol)와 같은 시간 동기화 프로토콜을 실행하도록 시스템을 구성합니다. 시간 동기화는 일반적으로 xntpd 데몬(Solaris 및 Linux)과 W32Time 시간 서비스(Windows)에 의해 지원됩니다. 이러한 서비스 구성에 대한 자세한 내용은 운영 체제 설명서를 참조하십시오.
브로커가 실행된 이후에는 시스템 클럭을 뒤로 설정하지 마십시오.
파일 설명자 제한 설정(Solaris 또는 Linux)
Solaris과 Linux 플랫폼에서는 클라이언트 또는 브로커가 실행 중인 쉘에 프로세스가 사용할 수 있는 파일 설명자 수에 대한 소프트 한계가 있습니다. Message Queue 시스템에서는 각 클라이언트가 만드는 연결 또는 각 브로커가 받아들이는 연결에 이 파일 설명자 중 하나를 사용합니다. 지속성 메시지를 갖는 각 물리적 대상 역시 파일 설명자를 사용합니다.
결과적으로 이러한 요소가 연결 수를 제한합니다. 따라서 파일 설명자 제한을 변경하지 않으면 Solaris에서는 256개, Linux에서는 1024개를 초과하는 연결에서 브로커나 클라이언트를 실행할 수 없습니다(지속성을 위해 파일 설명자를 사용하기 때문에 연결 제한은 실제로 더 낮음).
파일 설명자 제한을 변경하려면 ulimit 설명서 페이지를 참조하십시오. 클라이언트 또는 브로커가 실행될 각 쉘에서 한계를 변경해야 합니다.
대화식으로 브로커 시작명령줄에서 imqbrokerd 명령을 사용하여 브로커를 대화식으로 시작할 수 있습니다. Windows에서는 시작 메뉴에서 브로커를 시작할 수도 있습니다. 관리 콘솔(imqadmin) 또는 명령 유틸리티(imqcmd)를 사용하여 브로커를 시작할 수는 없습니다. 이러한 도구를 사용하려면 브로커가 이미 실행되고 있어야 합니다.
Solaris 및 Linux 플랫폼의 경우 브로커 인스턴스는 처음에 시작한 사용자가 항상 시작해야 합니다. 브로커 인스턴스가 처음 시작되면 Message Queue는 해당 사용자의 umask를 사용하여 구성 정보와 지속성 데이터가 들어 있는 브로커 인스턴스 디렉토리에 대한 사용 권한을 설정합니다. 각 브로커 인스턴스는 자체 구성 등록 정보 및 파일 기반 메시지 저장소를 가지고 있습니다.
브로커 인스턴스는 기본적으로 인스턴스 이름이 imqbroker입니다. 이 이름과 기본 구성을 사용하여 명령줄에서 브로커를 시작하려면 다음 명령을 사용하기만 하면 됩니다.
imqbrokerd
그러면 기본 포트 7676에 포트 매퍼가 있는 로컬 시스템에서 imqbroker라는 브로커 인스턴스를 시작합니다.
기본값이 아닌 인스턴스 이름을 지정하려면 -name 옵션을 imqbrokerd 명령에 사용합니다. 다음 명령은 인스턴스 이름이 myBroker인 브로커를 시작합니다.
imqbrokerd -name myBroker
imqbrokerd 명령줄에서 다른 옵션을 사용하여 다양한 브로커 작업을 제어할 수 있습니다. 다음 예에서는 -tty 옵션을 사용하여 명령 창에 오류 및 경고를 보냅니다(표준 출력).
imqbrokerd -name myBroker -tty
명령줄에서 -D 옵션을 사용하여 브로커의 인스턴스 구성 파일(config.properties)에 지정된 등록 정보 값을 무시할 수도 있습니다. 이 예에서는 imq.jms. max_threads 등록 정보를 사용하여 jms 연결 서비스에 사용할 수 있는 최대 스레드 수를 2000으로 늘립니다.
imqbrokerd -name myBroker -Dimq.jms. max_threads=2000
imqbrokerd 명령의 구문, 하위 명령 및 옵션에 대한 자세한 내용은 13장, "명령 참조"를 참조하십시오. 이 정보에 대한 빠른 요약을 보려면 다음을 입력합니다.
imqbrokerd -help
자동으로 브로커 시작브로커를 명령줄에서 명시적으로 시작하는 대신 시스템을 시작할 때 자동으로 시작하도록 설정할 수 있습니다. 이 방법은 브로커를 실행 중인 플랫폼(Solaris, Linux 또는 Windows)에 따라 다릅니다.
자동 시작(Solaris 및 Linux)
Solaris 및 Linux 시스템에서는 자동 시작을 활성화하는 스크립트가 Message Queue 설치 중에 /etc/rc* 디렉토리 트리에 저장됩니다. 이러한 스크립트를 사용하려면 구성 파일 /etc/imq/imqbrokerd.conf(Solaris) 또는 /etc/opt/sun/mq/imqbrokerd.conf(Linux)를 다음과 같이 편집해야 합니다.
자동 시작(Windows)
Windows 시스템을 시작할 때 브로커가 자동으로 시작되게 하려면 브로커를 Windows 서비스로 정의해야 합니다. Message Queue를 Windows 시스템에 설치할 때 브로커를 서비스로 설치할 수 있습니다. 설치 이후에 서비스 관리자 유틸리티 imqsvcadmin을 사용하여 다음 작업을 수행할 수 있습니다.
imqsvcadmin 명령의 구문, 하위 명령 및 옵션에 대한 자세한 내용은 13장, "명령 참조"를 참조하십시오.
브로커를 Windows 서비스로 설치한다는 것은 시스템을 시작할 때 시작하여 종료할 때까지 백그라운드로 실행하는 것을 의미합니다. 따라서 추가 인스턴스를 시작하는 경우가 아니면 imqbrokerd 명령을 사용해서 브로커를 시작하지 마십시오.
브로커에 시작 옵션을 전달하려면 -args 인수를 imqsvcadmin 명령에 사용합니다. 대화식으로 브로커 시작에서 설명한 대로 이 옵션은 imqbrokerd 명령의 -D 옵션과 동일하게 작동합니다. imqcmd 명령을 사용해서 보통의 경우와 같이 브로커를 제어합니다.
브로커가 Windows 서비스로 실행 중이면 작업 관리자에 해당 브로커가 두 개의 실행 가능 프로세스로 나열됩니다.
Windows 서비스로 실행 중인 브로커는 하나의 시스템에 하나만 있을 수 있습니다.
브로커 서비스 재구성
Windows 서비스를 재구성하는 순서는 다음과 같습니다.
대체 Java 런타임 사용
-javahome 또는 -jrehome 옵션을 사용하여 대체 Java 런타임의 위치를 지정할 수 있습니다. Windows 서비스 제어판 시작 매개 변수 필드에서 이러한 옵션을 지정할 수도 있습니다.
시작 매개 변수 필드에서는 백슬래시(\)가 제어 문자로 간주되기 때문에 백슬래시를 경로 구분자로 사용할 경우 두 번 입력해야 합니다. 예를 들면 다음과 같습니다.
-javahome d:\\jdk1.3.브로커 서비스 시작 옵션 표시
브로커 서비스의 시작 옵션을 결정하려면 imqsvcadmin 명령에 query 옵션을 사용합니다.
서비스 시작 문제 해결
서비스를 시작할 때 오류가 발생하는 경우 기록된 오류 이벤트를 볼 수 있습니다.
▶ 기록된 서비스 오류 이벤트를 보는 방법Windows 서비스로 실행 중인 브로커 제거
서비스로 실행 중인 브로커를 제거하려면 다음 중 하나를 수행합니다.
작업이 완료되면 컴퓨터를 다시 시작합니다.
Message Queue 클라이언트 시작클라이언트 응용 프로그램을 시작하기 전에 응용 프로그램 개발자로부터 시스템 설정 방법에 대한 정보를 얻습니다. Java 클라이언트 응용 프로그램을 시작할 경우 CLASSPATH 변수를 설정하고 올바른 jar 파일이 설치되었는지 확인해야 합니다. Message Queue Developer’s Guide for Java Clients에 시스템 설정에 대한 일반 단계와 관한 자세한 내용이 있지만 개발자에게 추가 정보가 있을 수도 있습니다.
Java 클라이언트 응용 프로그램을 시작하려면 다음 명령줄 형식을 사용합니다.
java clientAppName
C 클라이언트 응용 프로그램을 시작하려면 응용 프로그램 개발자가 제공한 형식을 사용합니다.
응용 프로그램에서 설정하는 속성 값에 대한 자세한 내용은 응용 프로그램 개발자에게 문의하거나 응용 프로그램 설명서를 참조하십시오. 응용 프로그램에서 설정한 일부 속성을 대체하려는 경우 명령줄에서 해당 속성을 지정하면 됩니다.
Java 클라이언트의 명령줄에서 JNDI 조회를 사용하여 연결 팩토리를 찾는 속성을 지정할 수도 있습니다. 조회에서 응용 프로그램보다 더 오래된 연결 팩토리를 반환할 경우 해당 연결 팩토리는 최신 속성을 지원하지 못할 수 있습니다. 그럴 경우 Message Queue는 해당 속성을 기본값으로 설정합니다. 명령줄에서 속성을 지정하여 기본값이 아닌 값으로 설정할 수 있습니다.
명령줄에서 속성 값을 제공하려면 Java 응용 프로그램에 대해 다음 명령줄 구문을 사용합니다.
java [[-Dattribute=value ]...] clientAppName
16장, "관리 대상 객체 속성 참조"에 표시된 대로 attribute 값은 연결 팩토리 관리 대상 객체 속성이어야 합니다. 값에 공백이 있는 경우 명령줄의 attribute=value 부분을 따옴표로 묶어야 합니다.
다음 예에서는 클라이언트 응용 프로그램 MyMQClient를 시작합니다. 응용 프로그램은 응용 프로그램에 설정된 호스트 이름과 포트를 무시하고 호스트 OtherHost의 7677 포트에 있는 브로커에 연결합니다.
java -DimqAddressList=mq://OherHost:7677/jms MyMQClient
명령줄을 사용하여 속성 값을 지정할 수 없는 경우도 있습니다. 관리자가 읽기 전용 액세스만 허용하도록 관리 대상 객체를 설정하거나 응용 프로그램 개발자가 읽기 전용 액세스만 허용하도록 클라이언트를 코딩할 수 있습니다. 클라이언트 프로그램을 시작하는 가장 좋은 방법을 알아보려면 응용 프로그램 개발자와 대화해야 합니다.
브로커 인스턴스 제거이 절에서는 Solaris 또는 Linux에서 브로커 인스턴스를 제거하는 방법에 관한 정보를 제공합니다. Windows 서비스 제거에 대한 자세한 내용은 Windows 서비스로 실행 중인 브로커 제거를 참조하십시오.
브로커 인스턴스를 제거하려면 imqbrokerd 명령에서 -remove 옵션을 사용합니다. 브로커 인스턴스 제거를 위한 명령 형식은 다음과 같습니다.
imqbrokerd [options..] -remove instance
예를 들어, 브로커 이름이 myBroker인 경우 명령은 다음과 같습니다.
imqbrokerd -name myBroker -remove instance
이 명령은 지정된 브로커에 대해 전체 인스턴스 디렉토리를 삭제합니다.
브로커를 제거할 때 사용할 수 있는 옵션 목록은 명령 참조의 imqbrokerd 참조 정보를 참조하십시오.
Solaris 또는 Linux에서 시스템을 시작할 때 브로커를 자동으로 시작하도록 설정하려면 구성 파일 /etc/imq/imqbrokerd.conf(Solaris) 또는 /etc/opt/sun/mq/imqbrokerd.conf(Linux)를 편집하고 AUTOSTART 등록 정보를 NO로 설정합니다.