본문으로 건너뛰기
버전: 3.4.4

사용법

본 장에서는 BXI Tool을 실행하고 실행된 상태를 확인하는 방법에 관해 설명한다.

☑ 로그파일 업로드​

거래 처리과정에서 생성된 파일로그를 DB에 업로드한다.

업로드 대상 파일​

  • errorLog : 온라인 거래 처리과정에서 발생한 에러로그
  • restErrorLog : 온라인 거래 처리과정에서 발생한 Rest에러로그
  • imageLog : 온라인 거래의 송수신 로그
  • restImageLog : 온라인 거래의 REST송수신 로그
  • txLog : 온라인 거래별 처리 상태정보가 저장되는 거래로그
  • restTxLog : 온라인 거래별 처리 상태정보가 저장되는 Rest거래로그
  • stctsLog : 온라인 거래 처리에 대한 통계로그
  • restStctsLog : 온라인 거래 처리에 대한 Rest통계로그
주의

모든 대상 로그 파일명은 *.log로 끝나야 한다. 디렉터리를 지정하여 실행 시, 해당 디렉터리 내의 *.log인 파일에 대해 업로드한다.

설정​

정상적인 실행을 위해 필요한 설정 작업은 다음과 같다.

1. Upload대상 파일 위치 설정​

Upload 대상 로그 파일들이 있는 디렉터리 위치를 지정한다.

${BXITOOLHOME}/bin/logupload.sh
...
LOG_HOME=$BXITOOLHOME/files
...

2. Tool로그 파일 생성위치 설정​

logupload.sh에 Tool로그 위치를 -DlogPath=${LOGGING_HOME}로 지정한다. 지정폴더에 Bxi_tool.log로 파일이 생성된다.

3. Application Context​

logupload.sh에 ApplicationContext를 -Dbxi.tool.context=file:${HOME}/config/ToolApplicationContext.xml로 지정한다.

실행​

별도 아규먼트 없이 실행하면 logupload.sh의 LOG_HOME의 로그를 업로드하고, 별도로 디렉터리를 지정할 수도 있다.

${BXITOOLHOME}/bin/logupload.sh
${BXITOOLHOME}/bin/logupload.sh [path]
팁

DB패스워드를 암호화하는 경우 ApplicationContext.xml은 SecureBasicDataSource를 사용해야 하며, logupload.sh에 -Dbxi.security.key.file=${HOME}/config/security.key를 추가해야 한다.

출력 로그​

  • process : 커밋단위로 한번에 처리되는 건수
  • success : 커밋단위로 한번에 처리되는 건수 중 성공 건수 다.(insert, update를 포함한다.)
  • ignore : 커밋단위로 한번에 처리되는 건수 중 무시된 건수
  • error : 커밋단위로 한번에 처리되는 건수 중 에러가 발생한 건수

디렉토리​

에러가 발생한 데이터는 ./{yyyyMMddHHmm}/fail에 저장되며, 업로드된 로그 파일은 처리 결과에 따라 success나 fail디렉터리에 이동된다.

  • success : 정상적으로 업로드된 파일이 저장된다.
  • fail : 처리 중 오류가 발생한 로그가 저장된다. 해당 데이터는 재처리 하기 전에 실제 데이터를 확인해야 한다.
주의

통계 로그를 처리하는 도중에 오류가 발생해 일부만 처리된 경우, 재처리 시 중복 처리되는 통계 데이터로 인하여 통계가 왜곡될 수 있으므로 유의한다.

☑ Omm임포트​

BXM의 전문 형식인 Omm을 BXI에서 사용하는 전문 형태로 변환하여 관련 테이블에 임포트한다.

Omm예시​

 OMM hi.generalinsurance.systeminterfaces.refine.entity.GIIR0100VO
 <description="공통VO">
 {
 String titmTranCd<length=9 description="트랜잭션코드">;
 String titmTgmCat<length=1 description="전문 구분">;
 String titmTgmTotLgth<length=5 description="전체전문길이">;
 String titmTgmClsfcnCd<length=4 description="전문종별코드">;
 String titmDlCat<length=6 description="거래구분코드">;
 String titmDataCat<length=1 description="자료구분">;
 String titmIspOrgCd<length=3 description="보험사기관ID">;
 String titmLnkBasCat<length=2 description="대외연계 구분">;
 String titmAfcrCd<length=3 description="제휴기관ID">;
 String titmTrrvCat<length=1 description="송수신FLAG">;
 String titmFinaOrgTgmTr<length=14 description="금융기관전문전송일시">;
 String titmIspTgmTrDtm<length=14 description="보험회사전문전송일시">;
 String titmFinaOrgTgmNo<length=8 description="금융기관 전문일련번호">;
 String titmIspTgmNo<length=8 description="보험사 전문일련번호">;
 String titmRspCd<length=4 description="응답코드">;
 String titmMsgCd<length=100 description="응답메시지">;
 String titmFiller<length=50 description="FILLER">;
 }

설정​

1. 테넌트 ID​

ommImport.sh에 Omm을 임포트할 테넌트ID를 -Dbxi.tenantId=FEP로 입력한다.

2. Omm파일 경로 설정​

ommImport.sh에 Omm파일이 존재하는 디렉터리 위치를 -Dbxi.omm.dir=${HOME}/files로 지정한다.

3. Application Context​

ommImport.sh에 ApplicationContext를 -Dbxi.tool.context=file:${HOME}/config/ToolApplicationContext.xml로 지정한다.

4. Tool로그 파일 생성위치 설정​

ommImport.sh에 Tool로그 위치를 -DlogPath=${LOGGING_HOME}로 지정한다. 지정폴더에 Bxi_tool.log로 파일이 생성된다.

실행​

아규먼트 없이 실행하면 ommImport.sh에서 정의한 설정값을 가지고 실행하며, omm디렉터리를 지정하거나 ApplicationContext파일을 지정해 실행할 수 있다.

${BXITOOLHOME}/bin/ommImport.sh
${BXITOOLHOME}/bin/ommImport.sh [path]
${BXITOOLHOME}/bin/ommImport.sh [omm path] [file: Application Context path]

☑ 암복호화​

실행​

별도 설정이 없을 시, 암복호화시 사용하는 키는 ./config/security.key로 지정된다.

${BXITOOLHOME}/bin/encrypt.sh [평문]
${BXITOOLHOME}/bin/decrypt.sh [암호문]
${BXITOOLHOME}/bin/encrypt.sh [평문] [키경로]
${BXITOOLHOME}/bin/decrypt.sh [암호문] [키경로]

☑ 보안키 생성​

실행​

${BXITOOLHOME}/bin/generate.sh [평문]

생성된 보안키를 사용하려면 config/security.key 엔진, 웹어드민에 일괄적용해야 한다.

주의

입력 평문 길이는 반드시 16, 24, 32 bytes중 하나여야 한다.