본문으로 건너뛰기

사용법

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

BXI Tool은 fat jar방식이므로 간단한 명령어를 통하여 실행가능하다.

java -jar bxi.tool-{version}.jar logging                        # 로그파일 -> DB
java -jar bxi.tool-{version}.jar omm                            # BXM OMM -> BXI 전문
java -jar bxi.tool-{version}.jar genKey [plain-text]            # 키 생성
java -jar bxi.tool-{version}.jar encrypt [plain-text]           # 암호화
java -jar bxi.tool-{version}.jar decrypt [encrypted-text]       # 복호화

☑ 로그파일 업로드​

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

업로드 대상 파일​

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

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

설정​

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

1. application.yml 설정​

${BXITOOLHOME}/bin/logupload.sh
...
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3314/fep?autoReconnect=true&serverTimezone=UTC
    username: bxi
    password: bxi

tool:
  logging:
    dir: /home/bxi/tool/logging
...

2. Log dir에 BXI LOG파일 위치​

tool.logging.dir에 DB에 insert할 파일들을 위치시킨다. 해당 디렉토리에 있는 파일들중 BXI로그 형식과 일치한 파일들만 로깅된다.

실행​

java -jar bxi.tool-{version}.jar logging

출력 로그​

  • 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. application.yml 설정​

${BXITOOLHOME}/bin/logupload.sh
...
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3314/fep?autoReconnect=true&serverTimezone=UTC
    username: bxi
    password: bxi

tool:
  omm:
    tenant-id: 000
    dir: /home/bxi/tool/omm
...

2. Log dir에 omm파일 위치​

tool.omm.dir에 DB에 insert할 파일들을 위치시킨다. 해당 디렉토리에 있는 파일들을 중 omm형식과 일치한 파일들만 읽는다.

실행​

java -jar bxi.tool-{version}.jar omm

☑ 암복호화​

실행​

java -jar bxi.tool-{version}.jar encrypt  [평문]
java -jar bxi.tool-{version}.jar decrypt  [암호문]

☑ 보안키 생성​

Tool에서 제공하는 키 이외에 다른 키를 사용하고 싶은 경우, 직접 키를 생성할 수 있다.

실행​

java -jar bxi.tool-{version}.jar genKey [평문]

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

주의

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