JBoss EAP 시작 파라미터 살펴보기: Command Line 파라미터 설명

JBoss EAP 시작 파라미터에 대한 전체 설명을 지금 함께 알아보세요!!

JBoss Tips & Tricks : Red Hat JBoss Enterprise Application Platform

들어가며

JBoss EAP 6에서 인스턴스 시작 시, 참조되는 바인딩 주소와 각종 디렉터리를 지정하는 시작 파라미터들에 대해 설명한다.

도메인 모드와 스탠드얼론 모드 각각 ‘$JBOSS_HOME/bin/domain.sh’ 와 ‘$JBOSS_HOME/bin/standalone.sh’를 파라미터 없이 실행하면 기본 설정으로 JBoss EAP 6 인스턴스가 실행된다.

아래에서 설명한 내용들은 다음의 URL에서 참조할 수 있다.

JBoss AS7 Command Line Parameters (https://docs.jboss.org/author/display/AS7/Command+line+parameters)

다음은 도메인 모드로 JBoss EAP 6를 실행할 때, 각종 커맨드 라인 파라미터를 지정하여 실행하는 예이다.

./domain.sh -b 0.0.0.0 -bmanagement 0.0.0.0 -Djboss.domain.base.dir=/servers/jboss-eap-6.2/simple

예를 들어 스탠드얼론 모드에서 로깅 서브 시스템은 ‘jboss.server.log.dir’의 값을 참조하여 서버 Log 디렉터리를 지정하게 된다.

1. 시스템 프로퍼티 지정

시스템 프로퍼티에 jvm 옵션에서 지정하는 방법 이외에도 [Key=value] 형식의 프로퍼티 파일을 작성하고, 시작 스크립트에서 이 속성 파일을 지정해서 설정하는 것도 가능하다. 프로퍼티 파일을 지정 방법은 아래와 같다.

$JBOSS_HOME/bin/domain.sh --properties=/some/location/jboss.properties
$JBOSS_HOME/bin/domain.sh -P=/some/location/jboss.properties

시작 스크립트에서 프로퍼티 파일을 지정하는 방법은 ‘domain.sh’, ‘standalone.sh’ 또는 MS Windows에서 사용되는 ‘domain.bat’, ‘standalone.bat’ 모두 동일하다.

프로퍼티 파일의 내용은 아래와 같이 [Key=value] 형식의 표준 자바 프로퍼티 파일이다.

jboss.home.dir=/some/location/AS7/jboss-as
jboss.domain.config.dir=/some/location/AS7/custom-domain

1-1. 스탠드얼론 모드

구분	패스(path)	설명
java.ext.dirs		JDK 확장 디렉터리 지정
jboss.home.dir	$JBOSS_HOME 변수로 설정	JBoss EAP 6 루트 디렉터리
jboss.server.base.dir	/standalone	스탠드얼론 기본 디렉터리
jboss.server.config.dir	/configuration	스탠드얼론 설정 파일 저장 디렉터리
jboss.server.data.dir	/data	데이터 파일 저장 디렉터
jboss.server.log.dir	/log	로그 파일 저장 디렉터리
jboss.server.temp.dir	/tmp	임시 파일 배포 디렉터리
jboss.server.deploy.dir	/deployments	콘텐트 배포 디렉터

1-2. 도메인 모드

구분	패스(path)	설명
java.ext.dirs		JDK 확장 디렉터리 지정
jboss.home.dir	$JBOSS_HOME 변수로 설정	JBoss EAP 6 루트 디렉터리
jboss.domain.base.dir	/domain	도메인 모드 루트 디렉터리
jboss.domain.config.dir	/configuration	도메인 설정의 베이스 디렉터리
jboss.domain.data.dir	/data	도메인 데이터 파일 저장 디렉터리
jboss.domain.log.dir	/log	도메인 로그 파일 저장 디렉터리
jboss.domain.temp.dir	/tmp	임시 파일 저장 디렉터리
jboss.domain.deployment.dir	/content	배포된 콘텐트가 저장되는 디렉터리
jboss.domain.servers.dir	/log	Host 컨트롤러에서 생성한 각 서버 루트 디렉터리

2. 이외의 커맨드 라인 파라미터

JBoss EAP 6 시작 파라미터로 지정할 수 있는 형태는

--name=value

이며 예를 들자면 다음과 같이 사용한다.

$JBOSS_HOME/bin/standalone.sh --server-config=standalone-ha.xml

파라미터가 하나의 문자인 경우에는 ‘–’ 대시 “-“를 사용한다.

-x=value

예를 들자면 다음과 같이 사용한다.

$JBOSS_HOME/bin/standalone.sh -P=/some/location/jboss.properties

다음은 스탠드얼론과 도메 모드 각각에서 사용할 수 있는 파라미터를 설명한다.

2-1. 스탠드얼론 모드

구분	패스(path)	설명
-server-config	/standalone.xml	jboss.server.config.dir으로부터 경로

2-2. 도메인 모드

구분	패스(path)	설명
-domain-config	jboss.domain.config.dir/domain.xml	jboss.server.config.dir으로부터 경로
-host-config	jboss.domain.config.dir/host.xml	jboss.server.config.dir으로부터 경로

다음의 파라미터는 slave 호스트 컨트롤러에서만 사용 가능한 파라미터이다.

구분	패스(path)
-backup	슬레이브 호스트 컨트롤러에 도메인 설정 파일의 로컬 복사본을 생성하고 저장
-cached-dc	슬레이브 호스트 컨트롤러가 시작할 때, 마스터 도메인 컨트롤러에서 설정을 가져올 수 없는 경우 -backup을 사용하여 미리 작성된 로컬 설정 복사복을 사용하여 시작. 슬레이브 호스트 컨트롤러에 도메인의 변경된 설정이 적용되지 않지만, 서버 시작은 가능.

2-3. 공통 파라미터

다음은 스탠드얼론 모드와 도메인 모드 모두에 적용 가능한 파라미터이다.

구분	패스(path)
-b =	바인딩 주소 (jboss.bind.address)를 지정 (예, ./domain.sh -b 0.0.0.0)
-b =	-b로 지정한 인터페이스에 대한 바인딩 주소 (jboss.bind.address)를 지정 (예, ./domain.sh -bmanagement 0.0.0.0)
-version , -V	JBoss EAP에 대한 버전을 출력
-help , -h	시작 스크립트에 대한 옵션에 대한 도움말을 출력하고 종료

Reference & Related Links

거침없이 배우는 JBoss – 10점

전준식 엮음/지&선(지앤선)

Azul의 x86 용 Zing Elastic Java Runtime – 비교할 수 없는 극강의 자바 런타임

2014-02-03/in JBoss, OPENMARU/by 오픈마루 마케팅0

Azul 시스템은 대용량의 스케일업형 하드웨어에서 자바 애플리케이션을 운영할 수 있는 기술을 기반으로 하고 있다.
Azul이 제공하는 기술의 두 가지 핵심 구성요소는 리얼 타임에 특화된 자바 가비지 컬렉션과 오버 헤드가 거의 없는 진단/모니터링 도구 이다.