 |
가이드 / 연동하기
기업용 문자 메시지 발송 서비스 KShotAgent 연동 가이드입니다.
간단하게 모듈을 세팅하고 서버 OS에 따라 프로세스를 기동하세요.
입력한 메시지 데이터는 모듈을 통해 KShotAgent 발송 서버에 전달되어 문자 메시지가 발송됩니다.
ShotAgent를 설치(사용)하기 위해 먼저 설치되어야 할 SW로는 DBMS, JDK 등이 있습니다.
본 가이드에서는 JDK 설치 과정부터 설명 합니다.
KShotAgent는 Java 언어로 작성되어 리눅스, 윈도우 등의 운영체제에서 구동이 가능합니다.
모듈을 실행하기 위해서는 JDK(Java Development Kit) 1.7 버전 이상의 설치가 필요합니다.
아래 URL에서 OS 환경에 맞는 파일을 다운로드하여 설치하실 수 있습니다.
다운로드한 압축파일 (KShotAgent.zip)을 임의의 디렉토리에 압축 해제합니다.
KShotAgent 정상 작동을 위해 ./info.ini 파일과 KShotAgent.sh 또는 bat 파일 내 다음의 내용을 수정합니다.
info.ini 파일의 파라미터 정보입니다.
일반적으로 강조된 색상의 파라미터만 설정하시면 됩니다
나머지 파라미터는 기본 값을 사용해도 무방합니다.
OS 환경에 따라 KShotAgent.sh 또는 KShotAgent.bat 파일을 사용합니다.
모듈 실행에 필요한 JDK 경로를 설정합니다.
윈도우 OS에서는 쉘에서 c:\> echo %JAVA_HOME%를 입력하여 조회할 수 있습니다.
리눅스 OS에서는 whick java 명령어 등으로 조회할 수 있습니다.
아래의 부분을 설정합니다
아래와 같이 운영체제에 따라 모듈을 실행합니다.
모듈 실행 시 데이터베이스의 테이블은 자동 생성됩니다.
모듈이 설치된 디렉토리로 이동하여 KShotAgent.sh 파일을 실행합니다.
./KShotAgent.sh start - 실행
./KShotAgent.sh stop - 종료
경우에 따라 chmod +x KShotAgent.sh로 실행 권한을 부여해야 합니다.
모듈이 설치된 디렉토리로 이동하여 KShotAgent.bat 파일을 실행합니다.
KShotAgent 폴더 아래 bin 폴더 내 파일들로 윈도우 서비스 등록 및 해제할 수 있습니다.
- Installservice64.bat : 64 bit Windows 용 서비스 등록 배치 파일
- Uninstallservice64.bat : 64 bit Windows 용 서비스 등록 해제를 위한 배치 파일
실행 후 생성된 테이블 중 agent_msgqueue 와 agent_msgresult 두 개의 테이블을 이용합니다
info.ini 에서 테이블명을 임의 수정하실 수 있습니다
agent_msgqueue 는 발송 대기 테이블이며, 모듈은 이 테이블을 주기적으로 검사하여 새로운 row (state = 0 인 row) 발견 시 발송 처리합니다.
또한 결과를 수신하면, 결과 처리된 row 는 agent_msglog 테이블로 이동합니다.
agent_msgqueue 테이블에 데이터를 인입하기 위해 INSERT 쿼리문이 필요합니다.
문자 메시지 발송 버튼 등의 태그를 작성합니다.
환경에 따라 INSERT 쿼리문을 작동하기 위한 이벤트 핸들러 코드를 작성합니다.
#################### KSHOT AGENT settings ###########################
##################################################################
## KSHOT
##################################################################
# id : KSHOT client ID(s) - separated by comma(,) for multi-connection (multi-IDs)
# ex) pid,pid_lms,pid_mms
# multiuser_column : kind (parallel tx by kind(msgtype)), etc? (sub_uid of pid for separate billing, etc)
#multiuser_column = etc1
#multiuser_colval = A,B,C
# mode_dup : 0 (standalone), 1 (duplcation moe)
# mode_active : A (active), S (standby)
##################################################################
## KSHOT GW Setting
##################################################################
###########################################################
## KSHOT MMS file Upload server
###########################################################
##################################################################
## agent_tps : message tx speed (TPS)
##################################################################
##################################################################
## Agent DB pameters
## db_type - 0:mysql, 1: mssql, 2: oracle
##################################################################
## mysql
## mssql
#db_type = 1
#db_ip = 127.0.0.1
#db_port = 3306
#db_name = kshotagent
#db_id = dbuser
#db_pwd = dbpwd
## oracle(db_name : sid)
#db_type = 2
#db_ip = 127.0.0.1
#db_port = 1521
#db_name = ORACLE
#db_id = dbuser
#db_pwd = dbpwd
#oracle_sequence = MSGQUEUE_SEQ
##################################################################
## report timeout expiration (0~24 hr)
##################################################################
##################################################################
## update_auto= 0(not used)
## update_time=
##################################################################
###########################################################
# log table split policy
# unuse : log table disabled
# one : one log table
# day : daily log table created
# month : monthly log table created
###########################################################
###########################################################
# log table name(prefix)
###########################################################
###########################################################
# index columns
###########################################################
###########################################################
# etc column count and sizes
###########################################################
###########################################################
# KisaOrigCode : KISA Original company Code
###########################################################
###########################################################
# RCS Service use
###########################################################
#RcsUseYN = Y
###########################################################
# ReBind & ReSend MSG (Y/N)
###########################################################
#!/bin/bash
# java 경로 지정
#JAVA=/usr/lib/jvm/jre-1.7.0-openjdk.x86_64/bin/java
# csh일 경우 setenv LANG ko_KR.eucKR, AIX의 경우 ko_KR.IBM-eucKR
export LANG=ko_KR.euckr
#JAVA_OPTS=$JAVA_OPTS -Xms128m -Xmx256m
# ./lib/밑의 jar파일을 모두 classpath로 설정한다.
CLASSPATH=.
for i in `ls $APP_HOME/libs/*.jar`
do
CLASSPATH=${CLASSPATH}:${i}
done
# $#는 파이미터 인수(갯수), 1이면 (start, stop, kill)로 해석
if [ $# -eq 1 ]
then
echo $1
else
echo "usage: kshotagent.sh start/stop/kill"
echo " start : START KShotAgent"
echo " stop : STOP KShotAgent"
echo " kill : KILL KShotAgent immediately."
exit
fi
#### 아래와 같은 샘플 쿼리를 통해서 테스트 발송을 시험할 수 있습니다(Mysql 기준)
- SMS (ORACLE)
INSERT INTO agent_msgqueue- SMS (MySQL, MSSQL)
INSERT INTO agent_msgqueue- LMS (id - sequence 값 지정)
INSERT INTO agent_msgqueue- MMS (id - sequence 값 지정)
INSERT INTO agent_msgqueue