파일 다운로드
WildFly 설치 파일은 http://wildfly.org/downloads 에서 다운로드할 수 있다. 운영체제에 맞는 압축 파일을 내려받은 뒤, 설치할 서버의 적절한 디렉터리로 복사한다.
압축 해제
설치하고자 하는 위치에서 다운로드한 설치 파일의 압축을 해제한다. 압축 해제 후 bin 디렉터리는 다음과 같다.
$ ls -l total 236 -rw-r--r-- 1 wildfly wildfly 2178 Sep 25 12:11 add-user.bat -rw-r--r-- 1 wildfly wildfly 2444 Sep 25 12:11 add-user.properties -rwxr-xr-x 1 wildfly wildfly 2230 Sep 25 12:11 add-user.sh -rw-r--r-- 1 wildfly wildfly 3748 Sep 25 12:11 appclient.bat -rw-r--r-- 1 wildfly wildfly 1815 Sep 25 12:11 appclient.conf -rw-r--r-- 1 wildfly wildfly 2438 Sep 25 12:11 appclient.conf.bat -rwxr-xr-x 1 wildfly wildfly 4467 Sep 25 12:11 appclient.sh drwxr-xr-x 2 wildfly wildfly 4096 Oct 2 08:56 client -rw-r--r-- 1 wildfly wildfly 5915 Sep 25 12:11 domain.bat -rw-r--r-- 1 wildfly wildfly 2535 Sep 25 12:11 domain.conf -rw-r--r-- 1 wildfly wildfly 3305 Sep 25 12:11 domain.conf.bat -rw-r--r-- 1 wildfly wildfly 480 Sep 25 12:11 domain.ps1 -rwxr-xr-x 1 wildfly wildfly 10810 Sep 25 12:11 domain.sh drwxr-xr-x 2 wildfly wildfly 4096 Oct 2 08:56 init.d -rw-r--r-- 1 wildfly wildfly 2370 Sep 25 12:11 jboss-cli.bat -rw-r--r-- 1 wildfly wildfly 1852 Sep 25 12:11 jboss-cli-logging.properties -rw-r--r-- 1 wildfly wildfly 3564 Sep 25 12:11 jboss-cli.ps1 -rwxr-xr-x 1 wildfly wildfly 2556 Sep 25 12:11 jboss-cli.sh -rw-r--r-- 1 wildfly wildfly 1569 Sep 25 12:11 jboss-cli.xml -rw-r--r-- 1 wildfly wildfly 1664 Sep 25 12:11 jconsole.bat -rwxr-xr-x 1 wildfly wildfly 2139 Sep 25 12:11 jconsole.sh -rw-r--r-- 1 wildfly wildfly 1936 Sep 25 12:11 jdr.bat -rwxr-xr-x 1 wildfly wildfly 1996 Sep 25 12:11 jdr.sh -rw-r--r-- 1 wildfly wildfly 57 Sep 25 12:11 product.conf -rw-r--r-- 1 wildfly wildfly 410 Sep 25 12:11 run.bat -rwxr-xr-x 1 wildfly wildfly 440 Sep 25 12:11 run.sh drwxr-xr-x 3 wildfly wildfly 4096 Oct 2 08:56 service -rw-r--r-- 1 wildfly wildfly 8600 Sep 25 12:11 standalone.bat -rw-r--r-- 1 wildfly wildfly 2362 Sep 25 12:11 standalone.conf -rw-r--r-- 1 wildfly wildfly 2754 Sep 25 12:11 standalone.conf.bat -rw-r--r-- 1 wildfly wildfly 2777 Sep 25 12:11 standalone.conf.ps1 -rw-r--r-- 1 wildfly wildfly 4301 Sep 25 12:11 standalone.ps1 -rwxr-xr-x 1 wildfly wildfly 11713 Sep 25 12:11 standalone.sh -rw-r--r-- 1 wildfly wildfly 2028 Sep 25 12:11 vault.bat -rwxr-xr-x 1 wildfly wildfly 2229 Sep 25 12:11 vault.sh -rw-r--r-- 1 wildfly wildfly 43393 Sep 25 12:11 wildfly-launcher.jar -rw-r--r-- 1 wildfly wildfly 1555 Sep 25 12:11 wsconsume.bat -rwxr-xr-x 1 wildfly wildfly 2179 Sep 25 12:11 wsconsume.sh -rw-r--r-- 1 wildfly wildfly 1494 Sep 25 12:11 wsprovide.bat -rwxr-xr-x 1 wildfly wildfly 2001 Sep 25 12:11 wsprovide.sh
디렉터리 구조
디렉터리 이름 및 용도
appclient- 애플리케이션 클라이언트 컨테이너가 사용하는 파일들이 위치bin-standalone.sh,domain.sh등 실행 스크립트와standalone.conf등이 위치docs- 하위에examples와schema디렉터리가 위치domain- 도메인 모드 구성 파일과 관련 디렉터리가 위치modules- WildFly 모듈과 라이브러리가 위치standalone- 스탠드얼론 모드 사용 시 필요한 구성, 배포, 로그 디렉터리가 위치welcome-content- 기본 환영 페이지가 위치
WildFly는 크게 스탠드얼론 모드와 도메인 모드로 실행할 수 있다. 단일 서버 인스턴스를 간단히 실행하고 테스트하려면 보통 standalone 구성을 사용하고, 여러 서버를 중앙에서 관리해야 하는 경우에는 domain 구성을 검토한다.
bin 디렉터리
$ ls -l *.sh -rwxr-xr-x 1 wildfly wildfly 2230 Sep 25 12:11 add-user.sh -rwxr-xr-x 1 wildfly wildfly 4467 Sep 25 12:11 appclient.sh -rwxr-xr-x 1 wildfly wildfly 10810 Sep 25 12:11 domain.sh -rwxr-xr-x 1 wildfly wildfly 2556 Sep 25 12:11 jboss-cli.sh -rwxr-xr-x 1 wildfly wildfly 2139 Sep 25 12:11 jconsole.sh -rwxr-xr-x 1 wildfly wildfly 1996 Sep 25 12:11 jdr.sh -rwxr-xr-x 1 wildfly wildfly 440 Sep 25 12:11 run.sh -rwxr-xr-x 1 wildfly wildfly 11713 Sep 25 12:11 standalone.sh -rwxr-xr-x 1 wildfly wildfly 2229 Sep 25 12:11 vault.sh -rwxr-xr-x 1 wildfly wildfly 2179 Sep 25 12:11 wsconsume.sh -rwxr-xr-x 1 wildfly wildfly 2001 Sep 25 12:11 wsprovide.sh
주요 실행 파일은 다음과 같다.
add-user.sh- 관리 사용자 또는 애플리케이션 사용자를 추가standalone.sh- 스탠드얼론 모드로 서버 실행domain.sh- 도메인 모드로 서버 실행jboss-cli.sh- CLI(Command Line Interface) 모드 접속jconsole.sh- JConsole을 통해 JMX MBean 정보 확인jdr.sh- JBoss Diagnostics Report 생성
설치 확인은 bin 디렉터리에서 standalone.sh를 실행한 뒤, 브라우저에서 기본 HTTP 포트로 접속해 환영 페이지가 표시되는지 확인하는 방식으로 진행할 수 있다. 관리 콘솔을 사용하려면 먼저 add-user.sh로 관리 사용자를 추가해야 한다.
standalone 디렉터리
$ ls -l total 24 drwxr-xr-x 3 wildfly wildfly 4096 Oct 2 18:27 configuration drwxrwxr-x 6 wildfly wildfly 4096 Oct 2 09:45 data drwxr-xr-x 2 wildfly wildfly 4096 Oct 2 08:56 deployments drwxr-xr-x 3 wildfly wildfly 4096 Sep 25 12:11 lib drwxrwxr-x 2 wildfly wildfly 4096 Oct 5 10:41 log drwxr-xr-x 4 wildfly wildfly 4096 Oct 5 10:41 tmp
standalone 디렉터리에는 서버 실행 시 사용하는 설정 파일, 배포 파일, 로그와 임시 파일이 모인다. 애플리케이션을 배포할 때는 일반적으로 deployments 디렉터리를 사용하고, 실행 중 발생한 로그는 log 디렉터리에서 확인한다.
configuration 디렉터리
하위 XML 파일은 다음과 같다.
standalone.xml- Web Profilestandalone-full.xml- Full Profilestandalone-ha.xml- Web Profile + High Availability
필요한 기능에 따라 실행 시 사용할 설정 파일을 선택한다. 예를 들어 기본 웹 애플리케이션 테스트에는 standalone.xml로 충분한 경우가 많고, 메시징 등 더 많은 기능이 필요한 경우에는 standalone-full.xml을 검토한다.