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

엔진 디렉토리 구조

엔진 디렉토리 구조는 다음과 같다.

${BXIHOME}
|-- bin
|-- config
|-- generation
|-- kafka
|-- libs
└─- logs

1. bin​

엔진의 실행/종료 파일이 위치한 디렉토리이다. 디렉토리 내 포함된 파일은 다음과 같다.

파일명설명
startup.sh엔진을 실행하기 위한 스크립트
shutdown.sh엔진을 종료하기 위한 스크립트
container.sh엔진의 단위 모듈인 인스턴스를 실행하기 위한 스크립트. startup.sh을 통해 엔진이 기동된 후 내부적으로 해당 스크립트를 호출하므로, 관리자는 상황에 따라 해당 shell을 사용한다.

2. config​

엔진에서 사용하는 기본 환경 설정 파일 및 로그 설정 파일이 위치한 디렉토리이다. 디렉토리 내 포함된 파일은 다음과 같다.

파일명설명
ApplicationContext.xml기본 스프링 환경 설정 파일. DB 접속정보 등을 설정한다.
bxi.properties엔진이 실행될 때 필요한 기본 환경 설정 파일
infinispan-tcp.xmlMCI에서 사용하는 Embedded Infinispan의 TCP 방식 기본 환경 설정 파일
log4j2.node.xml노드가 로깅을 수행하는 환경 설정 파일
log4j2.instance.xml인스턴스가 로깅을 수행하는 환경 설정 파일
quartz.properties시스템 정보 모니터링 및 스케줄을 수행하는 환경 설정 파일
security.key엔진에서 암호화가 필요할 경우 사용하는 암호화 키를 설정하는 파일
specialword.properties사용자 프로그램을 이용한 특수한 전문변환이 필요한 경우 사용한다.

3. generation​

커스터마이징에 사용하는 사용자 프로그램이 위치한 디렉토리이다.

4. kafka​

Kafka 디렉토리이다. Kafka를 이용한 리모트 로깅이 필요한 경우에만 사용하며, 디렉토리 내 중요 파일은 다음과 같다.

파일명설명
config/server.propertiesKafka의 환경설정 파일
config/zookeeper.propertiesKafka 실행에 필요한 Zookeeper의 환경설정 파일
bin/zookeeper_start.shZookeeper의 실행 스크립트. Kafka를 실행하기 위해서 Zookeeper가 먼저 실행되어야 한다.
bin/kafka_start.shKafka의 실행 스크립트
bin/create_kafka_topic.sh엔진에서 사용하는 Kafka 토픽 생성 스크립트

5. libs​

엔진 실행 시 사용되는 라이브러리 디렉토리이다. 디렉토리의 파일은 다음과 같다.

파일명설명
bxi.api-{version}.jarBXI 서비스를 인터페이스로 제공하는 라이브러리 파일
bxi.batch-{version}.jarBXI 배치 인스턴스에서 사용되는 라이브러리 파일
bxi.common-{version}.jarBXI 서버에서 사용되는 공통 라이브러리 파일
bxi.connect-{version}.jarBXI 커넥션(통신) 작업을 수행하는 라이브러리 파일
bxi.eai-{version}.jarBXI EAI 작업을 수행하는 라이브러리 파일
bxi.extension-{version}.jarBXI 커스터마이징 라이브러리 파일
bxi.instance-{version}.jarBXI 서버 실행 및 노드에서 사용되는 라이브러리 파일
bxi.logging-{version}.jarBXI 로깅 작업을 수행하는 라이브러리 파일
bxi.online-{version}.jarBXI 온라인 인스턴스에서 사용되는 라이브러리 파일
bxi.parser-{version}.jarBXI 전문 Marshall/Unmarshall을 수행하는 라이브러리 파일
기타Apache Camel, Netty 등 BXI가 동작하기 위한 3rd Party 라이브러리 파일

6. logs​

엔진의 수행 로그 파일이 생성 및 저장되는 디렉토리이다. 생성되는 파일명은 다음과 같다.

노트
  • 노드 로그 파일명 : Bxi_{노드명}.log
  • 인스턴스 로그 파일명 : Bxi_{노드명}_{인스턴스명}.log
  • 로그 날짜에 따라 YYYYMMDD의 suffix 백업 파일 생성