page no. 

Start Release No : 7.0.500.20241004-11 / Update Release No : 7.0.500.20241004-11

작성자 :  이동진  / 검수자 :  이경륜


  1. 기능 설명
    1. 제품 내 DB Connection Pool을 사용할 경우 java파일을 생성하지 않도록 개선했습니다.
        
  2. 사용 방법
    1. Repository DB 커넥션 풀 설정 및 해지는 matrix.properties 파일에서 matrix.pooluse="true" 혹은 matrix.pooluse="false" 로 설정한 후에 WAS를 재기동합니다.
    2. 타겟DB Connection Pool은 [ Admin >  자원관리 > 데이터베이스관리 ] 에서 DB Pool 사용에 체크 혹은 체크 해제로 설정할 수 있습니다


  • Repository DB, 타겟 DB 모두 같은 Connection Pool 옵션값을 사용합니다.
    단, DB최소 연결 수 DB최대 연결 수는 Admin에서 설정합니다.

  • 커넥션 풀 사용 옵션은 Dbcp 1.4버젼 기반으로 합니다.

    Dbcp1.4 옵션명옵션 설명matrix.properties 설정방법빈값일 경우 제품내 설정 기본값비고
    minIdle풀에서 유지할 최소 유휴 연결 수matrix.pool.minidle="숫자"10하위 호환성 값 10
    maxIdle풀에서 유지할 수 있는 최대 유휴 연결 수matrix.pool.maxidle="숫자"설정하지 않음설정하지 않을 경우 dbcp에서는 8로 설정
    maxActive풀에서 허용되는 최대 활성 연결 수matrix.pool.maxactive="숫자"50하위 호환성 값 50
    maxWait풀에서 연결을 가져오기 위해 대기할 최대 연결 시간matrix.pool.maxwait="숫자"-1하위 호환성 값이-1이며 무한정 대기한다.
    initialSize풀을 초기화할 때 생성할 연결 수설정 방법 없음설정하지 않음설정하지 않을 경우 dbcp에서는 0으로 설정
    validationQuery데이터베이스 연결이 유효한지 확인하기 위해 사용할 SQL설정 방법 없음 (자동으로 쿼리 생성)자동으로 쿼리 생성
    testOnBorrow데이터베이스 연결을 풀에서 빌릴때 유효성 검사를 할지 여부를 설정matrix.pool.testonborrow="true" or "false"false이 옵션은 확실한 커넥션을 보장하지만 DB부하를 주는 옵션이다.
    testWhileIdle주기적으로 유휴 연결을 검사할지 여부matrix.pool.testwhileidle="true" or "false"설정하지 않음설정하지 않을경우 dbcp에서는 false로 설정
    timeBetweenEvictionRunsMillis유휴 연결의 제거를 위한 검사 주기를 설정matrix.pool.timebetweenevictionrunsmillis="숫자(밀리초)"설정하지 않음설정하지 않을경우 dbcp에서는 -1로 설정됨.
    minEvictableIdleTimeMillis유휴 연결을 풀에서 제거하기 전에 허용되는 최소 유휴 시간을 설정matrix.pool.minevictableidletimemillis="숫자(밀리초)"설정하지 않음설정하지 않을경우 dbcp에서는 30분(1800000)으로 설정됨.


  • Db Connection Pool 생성시 커넥션 풀 생성이 Matrix.log 로그에 info레벨로 출력되며 설정정보가 포함되어 있습니다.



  • 사용시 matrix-service , maf , Admin 의존성 버전을 맞춰주세요.

    변경 전변경 후릴리즈 번호
    1. WEB-INF\classes\matrix\pools\에 Java파일을 생성합니다. 2. Db Connection Pool 사용시 "Connection (커넥션코드) : Before: NumActive = 사용중 커넥션 갯수, NumIdle = 유후 커넥션 갯수" 로그가 Matrix.log에 출력됩니다.
    예) Connection (DBF65901E94971452E89EE5A73EED50B79) : Before: NumActive = 1, NumIdle = 2

    1. WEB-INF\classes\matrix\pools\에 Java파일을 생성하지 않습니다.

    2. Db Connection Pool 사용시 " [AudDbPool][커넥션코드] Connection : Before: NumActive = 사용중 커넥션 갯수, NumIdle = 유후 커넥션 갯수" 로그가 Matrix.log에 출력됩니다.
     e.g) [AudDbPool][DBF65901E94971452E89EE5A73EED50B79] Connection : Before: NumActive = 1, NumIdle = 2

    3. DB Connection Pool 생성 시 아래 로그가 생성됩니다.

    4. DB Connection Pool 해제 시 아래 로그가 생성됩니다.


    5. DB Connection Pool에서 커넥션 유효성 검사시 Debug모드일경우 아래 로그가 생성됩니다.

    유효성 검사 예시
    1) matrix.pool. testonborrow ="true"
    - 커넥션 획득전에 유효성 쿼리 호출
    2) matrix.pool.testwhileidle="true"
    matrix.pool. timebetweenevictionrunsmillis="60000" #60 초마다 커넥션 검사

    		7.0.500.20241004-11



기능 정보
  • API Open
  • UI Open
  • Read Only
  • Not Use
  • Hidden
  • Not Recommend
  • 해당 없음
시작 버전 정보

  • matrix-service : 7.2.500.20240926

  • maf :7.0.500.18
  • Admin : 7.0.500.20240909

의존성이 설정되어 있으므로 반드시 해당 버전 이상으로 설치 바랍니다.

  • Release No : 7.0.500.20241004-11


  • 샘플 URL : https://rnd.bimatrix.co.kr/aud7/ 또는 https://aud.bimatrix.co.kr 등 외부 접근 위치에 샘플이 있을 경우 보고서 경로를 입력합니다.
  • 샘플 파일




(BCRM#E3200) 제품내 DB Pool을 사용할 경우 java파일을 생성하지 않고 배포되는 기능에 포함시키도록 개선
추가 이슈 처리가 있을 경우 표 뒤에 행 추가 한 다음 작성 합니다.