
JBoss EAP6에서 인스턴스 시작 시 참조되는 바인딩 주소와 각종 디렉터리를 지정하는 시작 파라미터들에 대해 설명한다.
도메인모드와 스탠드얼론 모드 각각 $JBOSS_HOME/bin/domain.sh 와 $JBOSS_HOME/bin/standalone.sh 를 파라미터 없이 실행하면 기본 설정으로 JBoss EAP6 인스턴스가 실행된다.
아래에서 설명한 내용들은 다음의 URL에서 참조할 수 있다.
l JBoss AS7 Command line parameters
(https://docs.jboss.org/author/display/AS7/Command+line+parameters )
다음은 도메인모드로 JBoss EAP6을 실행할 때 각종 커맨드 라인 파라미터를 지정하여 실행하는 예이다.
./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 EAP6 루트 디렉터리 |
jboss.server.base.dir | 스탠드얼론 기본 디렉터리 | |
jboss.server.config.dir | 스탠드얼론 설정 파일 저장 디렉터리 | |
jboss.server.data.dir | 데이터 파일 저장 디렉터리 | |
jboss.server.log.dir | 로그 파일 저장 디렉터리 | |
jboss.server.temp.dir | 임시 파일 배포 디렉터리 | |
jboss.server.deploy.dir | 콘텐트 배포 디렉터리 |
1-2 도메인 모드
구분 |
패스(path) |
설명 |
java.ext.dirs | JDK 확장 디렉터리 지정 | |
jboss.home.dir | $JBOSS_HOME 변수로 설정 | JBoss EAP6 루트 디렉터리 |
jboss.domain.base.dir | 도메인 모드 루트 디렉터리 | |
jboss.domain.config.dir | 도메인 설정의 베이스 디렉터리 | |
jboss.domain.data.dir | 도메인 데이터 파일 저장 디렉터리 | |
jboss.domain.log.dir | 도메인 로그 파일 저장 디렉터리 | |
jboss.domain.temp.dir | 임시 파일 저장 디렉터리 | |
jboss.domain.deployment.dir | 배포된 콘텐트가 저장되는 디렉터리 | |
jboss.domain.servers.dir | Host 컨트롤러에서 생성한 각 서버 루트 디렉터리 |
2. 이외의 커맨드 라인 파라미터
JBoss EAP6 시작 파라미터로 지정할 수 있는 형태는
--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 | jboss.server.config.dir으로부터 경로 |
2-2.도메인 모드
구분 | 패스(path) | 설명 |
-domain-config | jboss.domain.config.dir/domain.xml | jboss.domain.config.dir 으로부터 경로 |
-host-config | jboss.domain.config.dir/host.xml | jboss.domain.config.dir 으로부터 경로 |
다음의 파라미터는 slave 호스트컨트롤러에서만 사용 가능한 파라미터이다.
구분 | 패스(path) |
-backup | 슬레이브 호스트 컨트롤러에 도메인 설정 파일의 로컬 복사본을 생성하고 저장 |
-cached-dc | l 슬레이브 호스트 컨트롤러가 시작할 때 마스터 도메인 컨트롤러에서 설정을 가져올 수 없는 경우 – backup을 사용하여 미리 작성된 로컬 설정 복사본을 사용하여 시작
l 슬레이브 호스트컨트롤러에 도메인의 변경된 설정이 적용되지 않지만 서버 시작은 가능 |
2-3. 공통 파라미터
다음은 스탠드얼론모드와 도메인모드 모두에 적용 가능한 파라미터이다.
옵션 |
설명 |
-b = |
바인딩 주소 (jboss.bind.address) 를 지정
(예, ./domain.sh –b 0.0.0.0 ) |
-b |
(예, ./domain.sh –bmanagement 0.0.0.0 ) |
–version
-V |
JBoss EAP 에 대한 버전을 출력 |
–help
-h |
시작 스크립트에 대한 옵션에 대한 도움말을 출력하고 종료 |
References & Related Links
- Command line parameters – JBoss AS 7.1 – Project Documentation – https://docs.jboss.org/author/display/AS71/Command+line+parameters
- How to pass the startup options in JBoss EAP 6 linux service? – https://access.redhat.com/solutions/1454983
- JBoss EAP7 CONFIGURING JVM SETTINGS – https://access.redhat.com/documentation/en-us/red_hat_jboss_enterprise_application_platform/7.0/html/configuration_guide/configuring_jvm_settings
![]() |
거침없이 배우는 JBoss – ![]() 전준식 엮음/지&선(지앤선) |