이 문서는 ActiveMQ Classic을 Unix와 Windows 플랫폼에 설치하고 설정하는 방법을 설명합니다.
설치 전 요구 사항
하드웨어:
- ActiveMQ Classic 바이너리 배포판: 60MB의 여유 디스크 공간.
- ActiveMQ Classic 소스 코드 또는 개발자 배포판: 200MB의 여유 디스크 공간.
운영 체제:
- Windows: Windows XP SP2, Windows 2000.
- Unix: Ubuntu Linux, Powerdog Linux, MacOS, AIX, HP-UX, Solaris 또는 Java를 지원하는 모든 Unix 플랫폼.
환경:
- 배포를 위한 JDK 1.7.x 이상, 컴파일/빌드를 위한 Java 7 (1.7.x).
- JAVA_HOME 환경 변수는 JDK 설치 디렉토리를 가리켜야 합니다. 예: `c:\\Program Files\\jdk1.7.0_xx_xx`.
- Maven 3.0 이상(소스 코드 또는 개발자 버전 설치 시 필요).
- 사용할 JAR 파일들은 클래스패스에 추가되어야 합니다.
Windows 설치 단계
Windows 바이너리 설치
- 브라우저에서 activemq.apache.org로 이동합니다.
- 다운로드 링크를 클릭합니다.
- 가장 최신 배포 버전을 선택하거나 아카이브로 이동하여 이전 버전을 선택합니다. 바이너리 배포판의 파일 이름은 `activemq-x.x.x.zip` 형태입니다.
- ZIP 파일의 내용을 원하는 디렉토리에 압축 해제합니다.
- 다음 섹션의 ActiveMQ Classic 시작 부분으로 이동합니다.
- 시작 후, 설치 테스트 부분으로 이동합니다.
cd [activemq_install_dir]
mvn clean install
위 빌드가 일부 테스트에서 실패하면 다음 명령을 사용할 수 있습니다:
cd [activemq_install_dir]
mvn clean install -DskipTests=true
Unix 설치 단계
Unix 바이너리 설치
- 다운로드 링크를 통해 ActiveMQ gzip 파일을 Unix 머신에 다운로드합니다. 예를 들어 wget, scp, ftp 등을 사용할 수 있습니다.
wget http://activemq.apache.org/path/tofile/apache-activemq-5.8-tar.gz - gzip 파일의 내용을 원하는 디렉토리에 압축 해제합니다.
tar zxvf activemq-x.x.x.tar.gz - `activemq` 스크립트가 실행 가능하지 않으면 권한을 변경합니다.
chmod 755 bin/activemq - ActiveMQ Classic 시작 부분으로 이동합니다.
ActiveMQ Classic 시작
Windows에서
cd [activemq_install_dir]
bin\activemq start
Unix에서
cd [activemq_install_dir]
bin/activemq start
설치 테스트
ActiveMQ Classic이 정상적으로 실행되면, Windows 콘솔 창이나 Unix 명령 shell에 다음과 유사한 로그 메시지가 표시됩니다:
INFO ActiveMQ JMS Message Broker (ID:apple-s-Computer.local-51222-1140729837569-0:0) has started
ActiveMQ Classic의 기본 포트는 61616입니다. 다른 창에서 netstat 명령을 사용하여 포트 61616을 확인할 수 있습니다.
ActiveMQ Classic 모니터링
웹 콘솔을 사용하여 ActiveMQ Classic을 모니터링할 수 있습니다. 웹 브라우저를 http://localhost:8161/admin 주소로 열면 됩니다. 기본 사용자 이름과 비밀번호는 admin/admin이며, conf/jetty-real.properties 파일에서 구성할 수 있습니다.
ActiveMQ Classic 중지
Windows와 Unix 모두에서 "CTRL-C"를 눌러 ActiveMQ Classic을 실행 중인 콘솔이나 명령 shell을 종료할 수 있습니다. Unix에서 백그라운드 프로세스로 시작된 경우, 다음 명령을 사용하여 프로세스를 종료할 수 있습니다:
bin/activemq stop