JBoss EAP & Wildfly

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 /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 EAP6 루트 디렉터리
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 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 /standalone.xml 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 = 으로 지정한 인터페이스에 대한  바인딩 주소 (jboss.bind.address)를 지정

(예, ./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
거침없이 배우는 JBoss10점
전준식 엮음/지&선(지앤선)