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

공식적으로 MySQL 8.0 버전부터 지원합니다. MySQL을 사용하면 해당 데이터베이스 백업 기능으로 데이터를 백업해야 합니다.

이모지 같은 4바이트 문자까지 저장하려면 데이터베이스를 utf8mb4 문자셋으로 만들어야 합니다. utf8(utf8mb3) 문자셋으로 만들면 이런 문자를 저장할 수 없습니다. 다음은 rabbitz 데이터베이스를 만드는 예입니다.

CREATE DATABASE rabbitz CHARACTER SET utf8mb4;

MySQL JDBC 드라이버 추가

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

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

MySQL JDBC 드라이버는 MySQL 사이트에서 내려받습니다. MySQL 8.0.32 버전을 사용한다면 mysql-connector-j-8.0.32.jar 드라이버를 사용합니다.

환경 설정 파일 변경

다음 순서로 매뉴얼웍스에 MySQL을 설정합니다.

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 MySQL -->
  <!--
  <Resource name="jdbc/Base" auth="Container" type="javax.sql.DataSource"
    maxTotal="100" maxIdle="30" maxWaitMillis="10000"
    username="username" password="password"
    driverClassName="com.mysql.cj.jdbc.Driver"
    url="jdbc:mysql://localhost:3306/rabbitz" />
  -->
</Context>

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

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

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