매뉴얼웍스 데이터베이스로 오라클 데이터베이스를 사용하는 방법을 설명합니다.

오라클 데이터베이스를 사용하면 해당 데이터베이스 백업 기능으로 데이터를 백업해야 합니다.

매뉴얼웍스는 유니코드가 필요한 문자열과 긴 텍스트를 NVARCHAR2와 NCLOB 칼럼에 저장하고, 나머지 문자열은 VARCHAR2 칼럼에 저장합니다. 따라서 데이터베이스를 만들 때 데이터베이스 문자셋은 AL32UTF8로, 국가별 문자셋(National Character Set)은 AL16UTF16으로 설정하는 것을 권장합니다.

오라클 데이터베이스 JDBC 드라이버 추가

3RABBITZ_HOME은 매뉴얼웍스를 설치한 디렉터리를 지칭합니다.

오라클 데이터베이스 버전에 맞는 JDBC 드라이버를 3RABBITZ_HOME/web/WEB-INF/lib 디렉터리에 추가합니다.

오라클 데이터베이스 JDBC 드라이버는 오라클 사이트에서 내려받습니다. 데이터베이스와 자바 버전에 맞는 드라이버를 고릅니다. 예를 들어 자바 8 이상에서는 ojdbc8.jar를, 자바 11 이상에서는 ojdbc11.jar를 사용합니다.

환경 설정 파일 변경

다음 순서로 매뉴얼웍스에 오라클 데이터베이스를 설정합니다.

3RABBITZ_HOME/tomcat/conf/server.xml 파일을 엽니다.

<Context docBase="${3rabbitz.home}/web" path=""
  reloadable="false" backgroundProcessorDelay="3">
  <CookieProcessor className="org.apache.tomcat.util.http.LegacyCookieProcessor" />
  <!-- H2 -->
  <Resource name="jdbc/Base" auth="Container" type="javax.sql.DataSource"
    driverClassName="org.h2.Driver" url="jdbc:h2:h2/database;"
    username="database" password="database"
    maxTotal="100" maxIdle="30" maxWaitMillis="10000"/>
  <!-- for Oracle -->
  <!--
  <Resource name="jdbc/Base" auth="Container" type="javax.sql.DataSource"
    maxTotal="100" maxIdle="30" maxWaitMillis="10000"
    username="username" password="password"
    driverClassName="oracle.jdbc.OracleDriver"
    url="jdbc:oracle:thin:@127.0.0.1:1521:rabbitz" />
  -->
</Context>

H2 설정 부분을 주석 처리합니다.
Oracle 설정 부분 주석을 제거합니다.
username, password, url 등을 변경합니다.
매뉴얼웍스를 시작합니다.

설치와 소프트웨어 업데이트를 할 때 자동으로 매뉴얼웍스 테이블을 만듭니다. username에 설정한 오라클 계정이 테이블 생성, 칼럼 변경, 인덱스 추가와 삭제 권한을 갖고 있어야 합니다.

server.xml 파일에는 데이터베이스 계정의 비밀번호가 평문으로 들어 있습니다. 매뉴얼웍스를 실행하는 계정만 이 파일을 읽을 수 있도록 파일 권한을 제한합니다. 연결 정보를 암호화하려면 데이터베이스 연결 정보 암호화를 참고합니다.