JBoss EAP 6.x Global Module

JBoss Global Module은 전역적으로 사용되는 라이브러리를 모듈로 등록하여 사용하는 방법이다.
Standalone 및 Domain모드 에서 사용 가능하며 간편하게 등록하여 사용하는 Deployment방식과 modules에 드록하여 사용하는 방식이 있다.

여기서는 Oracle JBDC Driver를 global modules로 등록하여 사용하는 방법을 알아본다.

모듈 디렉토리 생성

ojdbc.jar파일을 모듈로 등록하기 위해 JBoss의 모듈 디렉토리를 생성한다.
기본적으로 JBoss EAP 6.x의 module 디렉토리는 modules/system/layers/base/ 를 기준으로 한다.
해당 디렉토리 아래에 com/oracle/jdbc 디렉토리를 생성한다.

[user@host ~]$ mkdir $JBOSS_HOME/modules/system/layers/base/com/oracle/jdbc

그리고 해당 디렉토리에 main 이라는 디렉토리를 또 생성한다. 이 디렉토리는 슬롯 이라는 개념의 디렉토리이다.
즉 전체 경로는 아래와 같이 생성된다.

[user@host ~]$ mkdir $JBOSS_HOME/modules/system/layers/base/com/oracle/jdbc/main

생성된 경로에 oracle.jar파일을 위치 시킨다. 해당 jar파일의 경로는 아래와 같다.

$JBOSS_HOME/modules/system/layers/base/com/oracle/jdbc/main/ojdbc.jar

module.xml 파일 생성

이제 해당 jar파일을 모듈로 선언하기 위해 아래 파일을 생성한다.

[user@host ~]$ vim $JBOSS_HOME/modules/system/layers/base/com/oracle/jdbc/main/module.xml

module.xml의 내용은 아래와 같이 작성한다.

<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.1" name="com.oracle.jdbc">
    <resources>
        <resource-root path="ojdbc.jar"/>
    </resources>
</module>

Global module 선언

위에서 추가한 모듈을 Global Module로 사용하기 위해서 JBoss EAP 6.x의 설정을 변경하여야 한다.
설정을 변경하는 방법은 두가지가 있는데 WEB GUI를 이용하여 등록하는 방법과 직접 Configuraion파일을 변경하는 방법이 있다.

1. WEB GUI에서 등록하는 방법

위 그림처럼 WEB GUI에서 Configuraion - Container - EE - Add 버튼을 클릭하여 해당 모듈을 등록하도록 한다.

Name : com.oracle.jdbc
Slot : main

으로 등록하여 주면 된다.

2. Configuration 등록 방법

standalone.xml 또는 domain.xml파일을 수정하여 등록하도록 한다.

        <subsystem xmlns="urn:jboss:domain:ee:1.2">
            <global-modules>
                <module name="com.oracle.jdbc" slot="main"/>
            </global-modules>
            ... 하단 생략 ...

참조링크

RedHat Document

목차