설치 및 실행

설치

에이전트 설치 사양

항목	사양	비고
설치 환경	리눅스, 윈도우, OSX JDK 17 이상	java 구동 환경과 동일
설치 권장 사양	CPU - 4Core Memory – 512M Hard Disk – 50G
접속 도메인	https://bizmsgapi.fingerpush.com/	SSL 사용
사용 포트	443	SSL 포트 사용

Java SDK 설치

1) 에이전트는 JDK 17 이상 설치가 필요합니다.

2) JDK 다운로드 및 설치 방법은 아래 링크를 참조해 주세요.

AdoptiumAdoptium

에이전트 설치

1) 설치는 압축된 파일을 풀면 완료됩니다.

2) 설치 경로 예시

OS	Path
Windows	D:/BizMsgCampAgent
Linux	/home/BizMsgCampAgent

3) 설치 폴더는 아래와 같은 구조를 가집니다. 실행 파일은 cmd 폴더 내에 위치합니다.

OS	Command
Windows	startup.bat, bizAgent.bat
Linux	시작 bizAgent.sh start 종료 bizAgent.sh stop

1depth	2depth	Description
bin	cmd	에이전트 실행 경로
bin	com	프로그램 class 경로
database	edb mariadb mssql mysql oracle postgresql tibero	데이터베이스 종류별 테이블 생성 스크립트
JavaService	​	자바용 윈도우 서비스 등록 프로그램
lib	​	라이브러리 폴더
logs	​	실행, 에러 로그

에이전트 및 데이터 베이스 환경 설정

1. 설정파일은 메인 설정파일 agentDistServerConfig.xml, 데이터베이스 설정파일 agentDistServerConfig_.xml 두개로 구분됩니다.

2. 메인 설정파일의 database 항목에 사용할 db의 종류를 입력하고, server.user 태그의 id(핑거푸시계정) 및 customerKey(커스터머키)가 정확히 입력되어있는지 확인해야 합니다.

3. 발신사업자라면 발급받은 발신사업자 식별코드를 originCid 항목에 입력해야 합니다. 발신사업자가 아니라면 생략합니다.

agentDistServerConfig.xml

<?xml version="1.0" encoding="UTF-8"?>
<config>
	...
	<database>mysql</database> 
	…
	<server>
		…
		<user id="fingerpush" customerKey="커스터머키" originCid=''/>
	<server>
	   ...

위 샘플처럼 mysql을 태그에 입력하면 agentDistServerConfig_mysql.xml 파일이 로딩됩니다.

1. 데이터베이스 설정 정보를 입력합니다.

Mysql - agentDistServerConfig_mysql.xml

<resource>
     <driver>com.mysql.cj.jdbc.Driver</driver>
     <url>jdbc:mysql://아이피:포트/디비명?autoReconnect=true</url>
     <minidle>5</minidle>
     <maxactive>30</maxactive>
     <username>디비사용자</username>
     <password>디비암호</password>
</resource>
...
<table autoCreate="true">
	...
	<option>
		<queue isEviction="true" evictLimitTime="72" evictStartTime="1" evictEndTime="5"/>
		<result monthlyBackup="true" retainMonth="6" bufferMonth="2"/>
	</option>
</table>

• autoCreate: 테이블 자동생성 옵션. false일 경우 database 폴더의 테이블 생성 스크립트를 사용하여 테이블을 직접 생성할 필요가 있습니다.

• monthlyBackup: RESULT 테이블 월별 생성 옵션. true일 경우 RESULT 테이블명이 TBL_KKA_RESULT_YYYYMM 형태가 됩니다.

• retainMonth: 백업 테이블 보관 기한. 6일 경우 6개월 지난 테이블을 삭제. -1일 경우 삭제 비활성

• bufferMonth: 테이블 사전 생성 옵션. 2일 경우 테이블 생성 시 다음 두 달의 테이블을 추가 생성. 0일 경우 비활성

• isEviction: 테이블 자동정리 옵션 on/off 설정 true일 경우 QUEUE 테이블의 지정 조건을 만족하는 데이터를 정리합니다.

• evict-deadline: queue 테이블 데이터 정리하는 기준 시간.(senddate 컬럼값이 현재시간으로부터 evict-deadline시간 이상 지난 데이터 삭제)

• evict-starttime: 자동정리 프로세스 시작시간.

• evict-endtime: 자동정리 프로세스 종료시간.자동정리는 1일 1회 동작합니다.

에이전트 로그 환경 설정

1. 설치경로/bin/log4j2.properties 파일을 메모장으로 로드합니다.

2. 설치경로의 logs 폴더로 경로를 설정합니다.(변경 가능)

log4j2.properties

################################################################################
# Log4j2 Properties  
# Web Service Log  
################################################################################

##filepath는 마지막에 / 빼고 넣어야 합니다.
property.filepath = ~/logs
##filename 뒤에 .log 등의 확장자명 붙이지 않음
property.filename = bizCampAgent
property.filesize = 500MB
##filedeldate는 파일 삭제 기준입니다. d=날짜, M=달, y=년 ex)30d(30일) 
property.filedeldate = 30d

• 생성되는 로그파일명은 bizCampAgent.log

• 날짜/용량별로 롤오버 되는 로그파일은 bizCampAgent_2026-02-10_1.log.gz 형태

실행 환경 설정

1. 설치경로/bin/cmd/실행파일 윈도우의 경우 startup.bat, bizAgent.bat, 리눅스/유닉스의 경우 bizAgent.sh 파일을 메모장으로 로드합니다

Windows	Linux
bin\cmd\startup.bat bin\cmd\bizAgent.bat	bin/cmd/bizAgent.sh bin/cmd/stop.sh 위 두 파일은 실행 권한이 필요합니다.

1. JAVA_HOME에 JDK 경로를 입력합니다.

2. AGENT_HOME에 에이전트 폴더 경로를 입력합니다. ex) /home/BizCampAgent

3. JAVA_PROPERTY 옵션을 통해 에이전트가 사용할 JVM 메모리를 변경할 수 있습니다.(재기동 필요)

Windows – fpAgent.bat

@echo off
…
set JAVA_HOME=C:\Program Files\Java\jdk17(경로 설정)
set AGENT_HOME=C:\에이전트(경로 설정)
…
set DAEMONNAME=BizMsgCampAgent_Service
set SEARCHNAME=bizCampAgent

set JAVA_PNAME=-Dpn=%DAEMONNAME% -Dsn=%SEARCHNAME%
set JAVA_PROPERTY=-Xms512m -Xmx1024m
…

Windows – startup.bat

@echo off
setLocal EnableDelayedExpansion

set AGENT_HOME=C:\에이전트(경로 변경)
set SVC_NAME=BizMsgCampAgent_Service
set NSSM32=%AGENT_HOME%\JavaService\nssm32.exe
set NSSM64=%AGENT_HOME%\JavaService\nssm64.exe
…

Linux

#!/bin/sh

#empty

JAVA_HOME=/usr/lib/jvm/jdk17(경로 설정)
AGENT_HOME=/home/에이전트(경로 설정)
…
DAEMONNAME=BizMsgCampAgent_Service

…
JAVA_PROPERTY="-Xms512m -Xmx1024m"
…

실행 여부 확인:

Linux : $ps -ef | grep BizMsgCampAgent

Window : 서비스 등록시 서비스 목록에서, 명령 프롬프트창(cmd)으로 실행시 실행중인 프롬프트창 확인

실행

OS별 실행 명령어

1. 설치된 경로(D:에이전트)의 \bin\cmd에서 startup.bat, fpAgent.sh를 실행하면 프롬프트창이 생기면서 에이전트가 구동됩니다

Windows	Linux
bin\cmd\startup.bat	bin/cmd/fpAgent.sh start/stop

1. Windows의 경우 콘솔창에서 에이전트 실행메뉴를 확인할 수 있습니다.

• 에이전트의 윈도우 서비스를 사용하려면 1번, 3번 중 윈도우 환경에 맞게 선택하면 됩니다. 서비스 등록과 동시에 실행이 됩니다.

• 서비스 등록 전 5번을 선택하여 정상 동작하는 것을 확인 후 서비스에 등록합니다.

• 일반 콘솔창에서 사용하려면 5번을 선택하면 됩니다.

서비스 등록이 안되는 경우 CMD창을 관리자 권한으로 실행 바랍니다.

에이전트 실행

1. 에이전트가 실행되면서 에이전트에서 사용하는 테이블은 자동 생성됩니다.

• 수동으로 생성하려면 xml 설정 정보를 참고하여 autoCreate=”false”, monthlyBackup=”false”을 설정 후 스크립트를 참조하여 테이블을 생성해 주세요.

1. AGCAMP_KKA_MASTER(KKB_MASTER, MMS_MASTER)

• 캠페인 발송 시 캠페인 메시지의 주요 정보를 저장하는 테이블입니다.

• Master 테이블에 1개의 로우를 입력하고, QUEUE 테이블에 대상자를 입력하면 됩니다.

1. AGCAMP_KKA_QUEUE(KKB_QUEUE, MMS_QUEUE)

• KKA_MASTER에 입력한 캠페인의 발송 대상을 입력하는 테이블입니다.

• 데이터는 발송 후 KKA_RESULT_YYYYMM로 이관됩니다.

1. AGCAMP_KKA_RESULT(KKB_RESULT, MMS_RESULT)_YYYYMM

• QUEUE에 입력했던 대상별 발송결과가 업데이트되는 테이블입니다.

• 데이터는 월별로 백업됩니다.