톰캣 8.5에서 MariaDB 리소스 설정

최근에 트러블슈팅을 한 운영 환경에서 톰캣(Tomcat) 8.5.27에 MariaDB 리소스(Resource) 설정이 된 것이 있었다. 최근에는 스프링 부트로 개발하니 이 위치에 설정할 일이 없었지만 정리해놓는 것이 운영유지보수(SM) 업무에 도움이 될 것 같아서 본 글에 기록한다.

MariaDB 리소스 설정

MariaDB 리소스 설정은 주로 '{톰캣설치경로}/conf/context.xml'에 입력되어 있다. 아래와 같이 리소스 설정 값을 입력하면 MariaDB 설정이 완료된다. 리소스 설정 값 중 {} 부분은 적절한 값으로 입력해야 한다.

 <Resource
      name="{name}"
      auth="Container"
      type="javax.sql.DataSource"
      driverClassName="org.mariadb.jdbc.Driver"
      url="jdbc:mariadb://{ip주소}/{DB명}"
      username="{username}"
      password="{password}"
      initialSize="10"
      maxWaitMillis="15000"
      maxTotal="100"
      maxIdle="20"
      maxConnLifetimeMillis="1800000"
      testOnBorrow="true"
      testWhileIdle="true"
      validationQuery="select 1"
      validationQueryTimeout="5"
      timeBetweenEvictionRunsMillis="60000"
      minEvictableIdleTimeMillis="300000"
/>

설정된 화면

리소스를 정상적으로 사용하기 위해서는 MariaDB JDBC Connector를 공식 홈페이지에서 다운로드 받은 후 '{톰캣설치경로}/lib'에 위치시켜야 하며 설정을 적용하기 위해서는 톰캣을 재시작해야 한다. 다른 DB를 사용하려면 DriverClassName과 url을 적절하게 수정해야한다.

• MariaDB JDBC Connector 다운로드 페이지 주소: https://mariadb.com/docs/connectors/mariadb-connector-j/about-mariadb-connector-j

MariaDB JDBC Connector 다운로드 페이지가 나타난 화면

MariaDB JDBC Connector는 자바 버전에 따라 호환되는 버전이 다르기 때문에 반드시 톰캣 8.5가 사용하는 자바 버전에 맞춰서 사용해야 한다.

자바 호환 정보가 나타난 화면

참고문서

1. "JNDI Resources How-To", 톰캣 8.5 공식 문서. @원문보기