JBOSS 서버에서 웹개발을 위한 여러 도구가 있지만, 이클립스를 사용하기로 했다.
다만 나는 한글판을 쓰지 않고 영문판을 사용한다. 앞으로 설명은 Helois 영문판 기준으로 진행할 것이다.
(나중에 JBOSS에 붙여야 할 여러 기능들이 이클립스에서 통합사용하는쪽이 편하기 때문에)
1. 이클립스를 깔아야 한다
고민하지 말고 그냥 최신(Helios) Eclipse for Java EE를 깐다(http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/heliosr). 다운로드해서, 원하는 디렉터리에 푼다음, eclipse 실행파일이 있는 디렉터리를 환경변수 PATH에 등록한다.
2. jboss지원도구를 깐다
jboss.org에 가면 관련 툴 다운로드가 가능하다(http://www.jboss.org/tools). 관련 zip파일(헬리오스용 3.2 개발버전)을 다운로드 받은 다음에, Eclipse에서 설정을 해야 한다. 이클립스의 설정 절차는 다음과 같다.
Help>Install New Software를 하면 다음과 같은 소프트웨어 설치 창이 뜬다.
설치창에서 Add버튼을 클릭하면 다음과 같은 리포지터리 추가창이 뜬다.
여기서 Archive버튼을 클릭하면 파일 선택창이 뜬다. 아까 다운로드 받았던 jboss툴관련 zip파일을 선택하고 OK를 누른다.
다음과 같은 패키지 선택 화면이 나타난다. 필요한 것을 선택한다. 귀찮으면 다 --;;.웹개발/Java EE개발 관련은 포함시켜야 한다.
Next를 누르면 의존성검사등을 시행하고 선택한 패키지 목록을 다시 보여준다. 오류가 뜨면 해당 오류를 해결하고 다시 시도한다. 잘 모르겠으면 오류 내용을 가지고 구글링을 하거나, 친한 고수/친구/후배사원에게 부탁한다.
Next를 누르면 다음과 같은 사용권 관련 창이 뜬다. 자세히 읽어보던지 하고, 아래에 동의 라디오 버튼을 선택한 다음 Finish를 클릭한다.
설치가 진행될 것이다. 다음과 같은 설치 진행 표시창이 뜬다. 중간에 사인이 안된 패키지가 있다는 경우도 있다. 의심스러우면 설치를 중단하고, 그냥 한번 믿어보고 싶으면 OK를 눌러서 계속한다.
설치가 완료되면 다음과 같이 적용/재시작 여부를 묻는다. 잘 모르겠으니 그냥 재시작한다.
이제 jboss툴 설치는 완료되었다.
다음에는 mysql을 설치하고(기본으로 함께 들어오는 내장데이터베이스가 있어서 연습시에는 사실 따로 설정할 필요는 없지만), Java EE에서 사용할 수 있게 데이터 소스를 jboss에 만드는 방법과, Java EE 어플리케이션 프로젝트 생성 및 eclipse에서 jboss서버를 설정/제어하는 것에 대해 다룰 것이다.
3개의 서로 다른 서버 설정이 기본적으로 포함되어 있음. <jboss_home>/server/ 디렉터리 밑에 minimal, default, standard, all, web의 5개 디렉터리가 있으며, 이들은 각기 사용 목적에 따라 포함된 서비스가 다르다. 만약 서버 시작시 아무것도 지정하지 않으면 default가 실행된다.
minimal 최소 설정 - JBoss 시작에 필요한 최소한만 포함되어 있음. 로깅, JNDI서버, URL 디플로이먼트 스캐너만 포함됨. 웹 컨테이너나 EJB, JMS지원은 포함되지 않음.
default 기본 Java EE 5 서버 프로파일. Java EE 어플리케이션 디플로이시 자주 사용되는 기본적인 구성요소를 포함함. JAXR서비스, IIOP서비스, 클러스터링 관련 서비스는 미포함
all 모든 사용 가능한 서비스가 포함되어 있음. RMI/IIOP와 클러스터링 등을 포함함
standard JavaEE 5 인증을 받은 JBoss 구성
web 경량 웹컨테이너 기반의 서비스(Java EE 6 웹 프로파일을 미리 맛볼 수 있음)
각각의 인스턴스에 어떤 서비스들이 들어갔는지 보려면, <jboss_home>/server/<instance-name>/deployers/ 디렉터리의 차이를 1차로 살펴보고, <jboss_home>/server/<instance-name>/deploy 디렉터리를 살펴보라.
서버 설정 디렉터리 구조
앞에서 설명한 각 <jboss_home>/server/<instance-name> 설정디렉터리 안은 다음과 같이 구성된다.
디렉터리
설명
conf
bootstrap.xml 부트스트랩 디스크립터를 포함하고 있음. 서버가 살아있는 동안 계속 존재할 핵심 마이크로컨테이너 빈을 정의함.
data
파일시스템에 내용을 저장하고 싶은 서비스가 사용할 디렉터리. 서버 재시작시에 다시 복구해야 할 영속성이 있는 데이터들을 저장함. 예를 들어 Hypersonic 데이터베이스 인스턴스와 같은 서비스들이 데이터를 여기 저장함
deploy
핫 디플로이(서버 실행 도중 추가/삭제 되는 것을 말함) 가능한 서비스들을 저장함. 현재 서버 설정에서 사용되는 어플리케이션을 포함함. 사용자는 이 디렉터리에 어플리케이션 패키지를 복사해서 자동으로 디플로이할 수 있음
lib
이 서버 설정에 필요한 JAR 파일을 포함함. JDBC 드라이버 등의 필요한 라이브러리 파일이 여기 저장되며, 서버 시작시 공유된 클래스패스에 이 디렉터리에 있는 JAR파일들이 포함됨. 다만, 이 디렉터리에는 특정 서버 설정에서 사용할 라이브러리만 저장하며, 여러 설정에서 공유되는 JAR들은 <JBoss_Home>/common/lib에 들어가게 됨.
log
로그파일이 저장되는 디렉터리. Jakarta log4j 패키지를 사용해 로깅을 함. 로깅 관련 설정은 conf/jboss-log4j.xml 설정파일로 변경 가능함
tmp
서비스에서 사용하는 임시파일이 저장됨. 예를 들어 디플로이어들은 압축된 파일을 이 디렉터리에 풀어서 처리한다.
work
Tomcat이 JSP파일을 컴파일한 자바파일과 클래스파일이 이 디렉터리에 들어감
"default" 서버 설정 파일들
다음은 "default" 설정의 파일 목록이다. 이 디렉터리 트리 구조는 ≶JBoss_Home>/server/default디렉터리에서 나온 것이다.
부트스트랩시나 서비스 디플로이시 아직 사용되야 하는 jboss-service.xml 레거시 핵심 mbeans. 장래에 제거될 예정
jbossjta-properties.xml
jbossjta-properties.xml. JBossTS 트랜잭션 관리자 프로퍼티 설정
jndi.properties
jndi.properties 파일. 인자없는 생성자로 JNDI InitialContext 생성시 JBoss에서 사용되는 프로퍼티 파일
java.policy
모든 권한을 허용하는 자바 보안 정책 파일
jboss-log4j.xml
아파치 log4j 프레임워크 프로퍼티. JBoss 서버에서 사용되는 우선순위와 어팬더가 정의됨
login-config.xml
샘플 서버사이드 인증 설정 파일(JAAS 기반 보안 예제)
props/*
jmx-console에서 사용하는 사용자와 권한 설정
standardjboss.xml
기본 컨테이너 설정
standardjbosscmp-jdbc.xml
JBoss CMP엔진 기본 설정
xmdesc/*-mbean.xml
jboss-service.xml 파일에 설정된 서비스들 중 일부가 사용하는 XMBean 디스크립터
"deployers"디렉터리
파일
설명
alias-deployers-jboss-beans.xml
<deployment>내에서 <alias>를 어떻게 처리해야 할지를 아는 디플로이어.
bsh.deployer
빈 셀 디플로이어. 빈 셀 스크립트를 JBoss mbean서비스로 디플로이함
clustering-deployer-jboss-beans.xml
클러스터링 관련 디플로리어. 클러스터화된 EJB3,EJB2빈과 분산 웹 어플리케이션 클러스터링 서비스에 필요한 의존성 추가
dependency-deployers-jboss-beans.xml
aliases.txt, jboss-dependency.xml에 대한 디플로이어. jboss-depedency.xml는 일반적인 의존성을 추가하기 위해 사용되며, aliases.txt는 디플로이먼트에 대해 사람이 읽기 쉬운 이름을 부여한다. 예: vfszip://home/blah/.../jboss-5.0.0.GA/server/default/deploy/some-long-name.ear는 ales-app.ear로 별명이 붙여짐.
directory-deployer-jboss-beans.xml
디렉터리에 레거시 행동양식을 부여하고, 그 디렉터리의 자식들을 디플로이 가능한 것으로 다룬다. 예: sar의 lib 디렉터리 내의 .jar 파일을 디플로이먼트로 다루게 함.
ear-deployer-jboss-beans.xml
JavaEE 5 엔터프라이즈 어플리케이션 관련 디플로이어들
ejb-deployer-jboss-beans.xml
레거사 JavaEE 1.4 ejb jar 관련 디플로이어들
ejb3.deployer
JavaEE 5 ejb3, JPA, 어플리케이션 클라이언트 디플로이를 지원하는 디플로이어
hibernate-deployer-jboss-beans.xml
하이버네이트(Hibernate)의 .cfg.xml파일과 유사한 하이버네이트 hibernate.xml 디스크립터 디플로이어.
jboss-aop-jboss5.deployer
JBossAspectLibrary와 기본 어스펙트들
jboss-jca.deployer
jboss-jca.deployer
jbossweb.deployer
JavaEE 5 서블릿, JSF, JSP 디플로이어
jbossws.deployer
JavaEE 5 웹서비스 엔드포인트 디플로이어
jsr77-deployers-jboss-beans.xml
JSR77 MBeans를 JavaEE 콤포넌트로부터 생성하기 위한 디플로이어
metadata-deployer-jboss-beans.xml
JavaEE 메타데이터를 xml과 어노테이션에서 처리하기 위한 디플로이어
seam.deployer
JBoss Seam 어플리케이션 지원을 위한 디플로이어
security-deployer-jboss-beans.xml
JavaEE 콤포넌트의 보안 레이어를 설정하기 위한 디플로이어
"deploy" 디렉터리의 내용
파일
설명
ROOT.war
'/' 웹 어플리케이션을 제공하는 웹 어플리케이션 압축파일
cache-invalidation-service.xml
JMS 통지를 통해 EJB 캐시를 무효화하도록 지원하는 서비스. 디폴트로 미사용상태
ejb2-container-jboss-beans.xml
EJB2 컨테이너를 위한 UserTransaction 통합 빈
ejb2-timer-service.xml
ejb 타이머 서비스 빈 포함
ejb3-connectors-jboss-beans.xml
EJB3 원격 트랜스포트 빈
ejb3-container-jboss-beans.xml
EJB3 컨테이너를 위한 UserTransaction 통합 빈
ejb3-interceptors-aop.xml
EJB3 컨테이너 어스팩트 정의
ejb3-timer-service.xml
별도의 쿼츠 기반 타이머 서비스
hdscanner-jboss-beans.xml
deploy 디렉터리에 대한 핫 디플로이 스캔 빈
hsqldb-ds.xml
하이퍼소닉(Hypersonic) 내장 데이터베이스 서비스 설정 파일. 내장 데이터베이스와 그와 관련된 연결 팩터리를 지정.
http-invoker.sar
HTTP상 RMI를 지원하는 인보커(invoker). HTTP상 JNDI 억세스를 위한 프락시 바인딩도 포함함. (디폴트는 연결되어 있지 않음)
jboss-local-jdbc.rar
JDBC드라이버를 위한 JCA ManagedConnectionFactory 인터페이스를 구현하는 JCA리소스 아답터(JDBC는 DataSource는 구현하지만, JCA는 아님)
jboss-xa-jdbc.rar
XA 데이터 소스를 위한 JCA 리소스 아답터
jbossweb.sar
TomcatDeployer 웹 어플리케이션 디플로이먼트 서비스 관리를 제공하는 mbean 서비스
jbossws.sar
JEE 웹 서비스 지원 제공
jca-jboss-beans.xml
JCA 규격에 대한 어플리케이션 서버 구현. 리소스 어답터를 JBoss 서버에 통합하기 위한 연결 관리 기능을 제공
jms-ra.rar
JBoss JMS 리소스 아답터
messaging/connection-factories-service.xml
DLQ 설정(ExpiryQueue JMS 연결 팩터리)
messaging/destinations-service.xml
메시지 영속성 저장소 서비스
messaging/destinations-service.xml
DLQ설정(ExpiryQueue JMS 목적지)
messaging/jms-ds.xml
JMSProviderLoader와 JmsXA 인플로우 리소스 아답터 연결 팩터리 바인딩을 설정
messaging/legacy-service.xml
JMSProviderLoader와 JmsXA 인플로우 리소스 아답터 연결 팩터리 바인딩을 설정
messaging/messaging-jboss-beans.xml
JMS 보안과 관리 빈을 설정
messaging/messaging-service.xml
핵심 JBoss 메시징 서비스 설정
messaging/remoting-bisocket-service.xml
JMS 원격 서비스 레이어 설정
jmx-console.war
JMX 콘솔 제공. JMX 콘솔은 MBean서버를 관리하는 간단한 웹 인터페이스를 제공함
jmx-invoker-service.xml
JMX 핵심 기능에 대한 원격 억세스를 가능하도록 하기 위하여 JMX MBeanServer 인터페이스 메소드의 일부를 RMI 인터페이스로 노출시켜주는 MBean 서비스 아카이브
jmx-remoting.sar
JMX서버에 대한 억세스를 제공하는 javax.management.remote 구현
legacy-invokers-service.xml
연결되지 않은 레거시 jmx 인보커 원격 서비스
jsr-88-service.xml
JSR 88 원격 디플로이먼트 서비스 제공
mail-ra.rar
JavaMail 커넥터를 제공하는 리소스 어답터
mail-service.xml
JBoss서버 내부에서 사용되는 JavaMail 세션을 제공하는 MBean 서비스 디스크립터
monitoring-service.xml
JMX 통지에 사용되는 콘솔 리스너와 이메일 리스너와 같은 경고 모니터를 설정하는 파일
profileservice-jboss-beans.xml
설정파일
properties-service.xml
JavaBean의 PropertyEditor와 시스템 프로퍼티의 사용자 정의를 가능하도록 해주는 MBean 서비스
quartz-ra.rar
인플로우 쿼츠 이벤트에 대한 리소스 어답터
remoting-jboss-beans.xml
JBoss 리모팅(Remoting)에 기반한 통합 인보커
scheduler-service.xml
스케줄링 유형의 서비스를 제공하는 MBean 서비스 디스크립터
security/security-jboss-beans.xml
보안 도메인 관련 빈들
security/security-policies-jboss-beans.xml
ejb와 웹 권한승인을 위한 보안 권한승인 관련 빈들
sqlexception-service.xml
벤더별 SQLException들을 처리하기 위한 MBean서비스
transaction-jboss-beans.xml
JTA 트랜잭션 관리자 관련 빈들
transaction-service.xml
ClientUserTransaction 프락시 서비스 설정
uuid-key-generator.sar
UUID기반 키 생성 기능 제공
"all"설정에 추가된 서비스
파일
설명
cluster-service.xml
JBoss의 대부분의 클러스터화된 서비스의 클러스터링 통신을 설정
deploy-hasingleton-service.xml
HA 싱글턴 서비스 제공. JBoss가 클러스터 내에서 한 노드에서만 활성화되어야 하는 서비스들을 관리할 수 있도록 함
서버 시작은 /bin/에 있는 run.sh나 run.bat을 실행하면 된다.(각각 Linux와 windows용)
* 주의 : JBoss AS 원격 접속
기본적으로 JBoss AS는 모든 주소(0.0.0.0)가 아니라 로컬호스트(127.0.0.1)에 바인딩된다(보안 설정 없이 프로적션 환경으로 가는 것을 방지하기 위해). 따라서 원격 억세스를 활성화하려면 실행시 -b옵션을 줘서 바인딩할 주소를 선택하면 된다. 0.0.0.0으로 하면 모든 기능을 외부에서 사용 가능하지만, 서버의 보안을 적절히 설정해 주어야 한다.
별도 설정으로 서버 시작하려면 -c를 사용한다. 예를 들어 minimal로 실행하려면 ./run.sh -c minimal
다음은 run.sh가 제공하는 옵션들이다.
usage: run.sh [options] -h, --help Show help message -V, --version Show version information -- Stop processing options -D<name>[=<value>] Set a system property -d, --bootdir=<dir> Set the boot patch directory; Must be absolute or url -p, --patchdir=<dir> Set the patch directory; Must be absolute or url -n, --netboot=<url> Boot from net with the given url as base -c, --configuration=<name> Set the server configuration name -B, --bootlib=<filename> Add an extra library to the front bootclasspath -L, --library=<filename> Add an extra library to the loaders classpath -C, --classpath=<url> Add an extra url to the loaders classpath -P, --properties=<url> Load system properties from the given url -b, --host=<host or ip> Bind address for all JBoss services. -g, --partition=<name> HA Partition name (default=DefaultDomain) -u, --udp=<ip> UDP multicast address -l, --log=<log4j|jdk> Specify the logger plugin type
서버 종료하기
서버 종료는 run.sh가 실행중인 콘솔에서 ctrl-C를 누르거나, shutdown.sh를 실행한다. 다음은 shutdown.sh의 옵션이다.
usage: shutdown [options] <operation>
options: -h, --help Show this help message (default) -D<name>[=<value>] Set a system property -- Stop processing options -s, --server=<url> Specify the JNDI URL of the remote server -n, --serverName=<url> Specify the JMX name of the ServerImpl -a, --adapter=<name> Specify JNDI name of the MBeanServerConnection to use -u, --user=<name> Specify the username for authentication -p, --password=<name> Specify the password for authentication
operations: -S, --shutdown Shutdown the server -e, --exit=<code> Force the VM to exit with a status code -H, --halt=<code> Force the VM to halt with a status code
단, shutdown.sh를 서버 종료를 위해 사용하기 위해서는 jmx-invoker-service.xml 서비스가 필요하므로, minimal에서는 이를 사용해 셧다운을 할 수 없다.
