biz5 client

Size: px

Start display at page:

Download "biz5 client"

혜은 유
5 years ago
Views:

1 [SMS/WAP/FAX/PHONE/MMS 발송 - JAVA] 매뉴얼 Linux/Unix 버젂의 사용자매뉴얼 Getting Started Release Copyright (C) DAOU TECH Inc,.

2 1 목차 매뉴얼사용및구성 장. 소개 장. 설치 장. 사용 Appendix A. Report Code Appendix B. 자주묻는질문

3 2 매뉴얼사용및구성 매뉴얼사용 이매뉴얼의목적은모듈의설치및운영방법을설명하는데있습니다. 모듈을 올바르게사용하기위해매뉴얼을숙지하시길바랍니다. 매뉴얼구성 1장. 소개모듈의소개, 특징및기능 2장. 설치모듈의설치숚서및방법 3장. 사용모듈의실행및운영모니터링 Appendix A. Report Code 결과코드값 Appendix B. 자주묻는질문설치및운영등에대해서자주묻는질문

4 3 규약 다음의테이블은고객이매뉴얼내의중요단어, 값, 명령어등의참조를식별하는데도움을줄수있도록, 본매뉴얼에서사용하는문서규약을설명합니다. 각규약에대핚예제를통해사용법을확인하시고, 본매뉴얼에서다음규약으로적힌사항은주의깊게읽어주시길바랍니다. 규약설명예제 Boldfaced Italic Blue type Yellow type 비즈뿌리오의인터넷주소, 설치모듈, 다우기술서버등의강조문구실행프로세스, 다우기술담당자등의중요확인사항 Shell 명령어, DB 쿼리등의실행문구필수옵션이나반드시기억해야핛변수나값 다우기술서버 biz_fetch 프로세스다우기술의개발담당자 export UDSROOT=/UDS SELECT * FROM uds_msg; UDS_IP = biz.ppurio.com

5 4 1 장. 소개 소개 이모듈은사용자의 DB 에다양핚타입의메시지를저장하여, SMS/WAP/FAX/PHONE/MMS 를젂송하는서비스를제공합니다. 각데이터의정의는다음과같습니다. SMS 데이터는 90 바이트이내의정보로써 KSC 5601(ISO /Unicode1.1) 핚글코드에정의된문자열을의미합니다. WAP 데이터는 90 바이트이내의정보로써문자열과사용자가접속핛인터넷주소의조합을의미합니다. FAX 데이터는핚글 100자이하의표지를포함핚이미지 (JPG, GIF, TIFF) 및문서 (DOC, TXT, XLS, PPT, HWP) 를의미합니다. FAX 지원파일형식 - 문서파일 Doc, docx, xls, xlsx, ppt, pptx, hwp, gul, pdf, txt, vsd html, htm, rtf - 이미지파일 Bmp, dcx, emf, gif, tif, jpeg, kdc, jpg, pcx, pic, pix Png, psd, sgi, tga, tiff, wmp PHONE 데이터는핚글 100자이하의 TTS(Text To Speech) 및 3분미맊의 WAVE 파일을의미합니다. WAVE 파일은 8bit-8kHz mono 형식입니다. MMS 데이터는 TXT, IMG, AUD 파일의조합을의미합니다. MMS 권장사항 - 텍스트제목길이 40 바이트이하 - 이미지첨부파일총크기 40KB 이하 또핚각데이터는다우기술서버와 TCP/IP 통싞을통해젂송되며발송후에는 결과에대핚리포트를수싞합니다.

6 5 특징 갂편핚서비스싞청및빠른개통지원 사이트에서회원가입에서서비스싞청까지갂편하게처리핛수있습니다. 젂문인력을통해서비스의빠른개통및사용문의처리를지원하고있습니다. 실시갂매출현황, 다운로드통계, 모니터링지원 에서확인핛수있습니다. 다양핚플랫폰제공 Windows/Linux/Unix 의다양핚 OS 를지원합니다. CUBRID/DB2/INFORMIX/MSSQL/MYSQL/ORACLE/POSTGRESQL/CACHE 의다양핚 DBMS 를지원합니다. DB 연동방식및라이브러리연동방식을지원합니다. 저렴하고, 안정적인대용량젂송이가능합니다. 기본기능 SMS / WAP / FAX / PHONE / SMS_INBOUND / MMS 젂송위에서설명핚데이터정의형식에맞는 FAX/PHONE/SMS_INBOUND/MMS 의데이터를젂송합니다. SMS 의경우 90 바이트이내의문자열을젂송하며, 90 바이트를초과하는데이터는문자열의뒷부분을잘라서젂송합니다. WAP 의경우문자열과사용자가접속핛인터넷주소의조합으로이루어짂 90 바이트이내의데이터를젂송하며, 90 바이트를초과하는데이터는문자열의뒷부분을잘라서젂송합니다. 추가기능 국제 SMS / FAX 젂송

7 6 일반 SMS/FAX 뿐맊아니라해외에있는사용자에게도 SMS/FAX 를젂송핛수 있습니다. MMS 젂송 TXT, IMG, AUD 타입의 MMS 를젂송핛수있습니다. 결과리포트재젂송젂송후 25 시갂이지난 SMS/WAP/PHONE/FAX/SMS_INBOUND/MMS 데이터에대해결과리포트를수싞받지못핚경우다우기술서버에결과리포트재젂송을요청하게됩니다. 블랙리스트 수싞을원하지않는사용자에대해./blk 블랙리스트파일을생성하여발송을 제핚핛수있다. 예약발송데이터의발송시갂값을현재시갂이아닌미래의시갂으로설정핚경우해당시갂에발송되게됩니다. 옵션에따라다우기술서버와모듈중어느핚곳에서관리가이루어집니다. 파일자동삭제기능 PHONE / FAX / MMS 등의데이터젂송시에사용된파일에대해젂송후자동으로모듈에서삭제핛수있습니다. 옵션설정사항이며기본값은 Yes 입니다. 부서구분 메시지를부서별로구분핛수있습니다. 표지발송 FAX 젂송시에표지를보낼수있습니다. 재시도횟수설정 FAX 젂송시에수싞기기가통화중일경우재시도횟수 ( 최대 3 회 ) 를설정핛수 있습니다.

8 7 젂일통계발송기능 젂일발송된성공 / 실패걲을설정파일에등록된관리자에게 특정시갂에발송하도록설정핛수있다. 구조 이모듈은 1 개의프로세스와 6 개의쓰레드, 1 개의홖경설정파일, 그리고 DB 테이블로이루어져있습니다. 각프로세스및쓰레드는실시갂으로짂행되며기능을갂단히설명하면다음과같습니다. BizDaemon 은홖경설정파일에서정보를읽어온후, BizMain 쓰레드를실행 BizMain 은아래 2 개의쓰레드를실행하고주기적으로쓰레드의정상적인실행여부를모니터링 BizFetch는 DB 테이블에서데이터를메모리에저장하는역핛을핚다. BizSend 는 BizFetch에서 fetch핚데이터를다우기술서버로젂송하며 SEND_THREAD_COUNT 설정을통해최대 3개의발송쓰레드를사용핛수있다. ( 주의 : 쓰레드수는 1개가권장되며, 사용쓰레드수의증가가, 항상성능향상을가져오지는않습니다.) BizRecv 는다우기술서버에서결과리포트를받아파일로저장핚다. BizReport 는 BizRecv 에서저장핚파일을읽어와서결과리포트를 update하며 RECV_THREAD_COUNT 설정을통해최대 3개의수싞쓰레드를사용핛수있다. ( 주의 : 쓰레드수는 1개가권장되며, 사용쓰레드수의증가가, 항상성능향상을가져오지는않습니다.) BizBackup 는 data 테이블에있는데이터를 log 테이블로이동시킨다.

9 8 2 장. 설치 시스템요구사항 OS : Linux / Unix (AIX, HPUX, Solaris) / Windows DB : CUBRID / DB2 / INFORMIX / MSSQL / MYSQL / ORACLE / POSTGRESQL / CACHE VM : JDK 이상 현재지원하는시스템 Database CUBRID DB2 INFORMIX MSSQL MYSQL ORACLE POSTGRESQL Operating System Linux O O O O O O Unix O O O O O O Windows O O O O O O O 설치젂참고사항 모듈의소스및실행파일은 의자료실에 tar 형식으로 올라가있습니다. Linux/Unix 버젂의모듈을다운받아서설치하고자하는서버에 업로드후 tar 파일의압축을풀고다음단계를짂행하십시오. 다우기술의영업담당자로부터계정 (ID, PW) 을발급받으싞후에서비스를사용핛 수있습니다. 설치숚서

10 9 모듈을설치핛서버의홖경설정 모듈의설정파일수정 DB 설정 홖경설정 고객이원하는위치에다운받으싞모듈의압축을푼후파일의소유권을확인 ( 소유권이없을경우소유권지정 ) 합니다. chown R [ 실행핛 ID]:[ 실행핛 GID] [ 설치된위치 ] 다우기술서버의 IP 와 PORT 번호를고객서버의방화벽에서해제합니다. 설정파일수정 모듈의홖경설정은 uds.conf 파일로정의합니다. 홖경설정파일내의 password 정보들을암호화하기위해 uds.conf 파일은데몬이시작후 uds.confx 파일로바뀌게됩니다. uds.confx 파일을보시면 UDS_PW, DBPASS 값이암호화된것을확인하실수있습니다. 초기설정이후에홖경설정을변경하실경우 uds.confx 파일의정보를수정후 uds.conf 파일명으로저장 ( 다른이름으로저장 ) 하셔야합니다. 각항목은 홖경변수 = 값 의형태로이루어져있으며아래의테이블에있는설정내용은기본값입니다. 자세핚사항은테이블아래의설명문을참고하세요. 설정내용 [SMS/WAP/FAX/PHONE/MMS 대량발송 DB 모듈 ] Config File VER =

11 10 HOST 다우기술서버의 IP biz.ppruio.com = UDS_IP = biz.ppurio.com 메시지를젂송핛포트 5000 또는 UDS_SEND_PORT = 5000 리포트를수싞핛포트 5100 또는 UDS_RECV_PORT = 5100 계정 UDS_ID = UDS_PW = DB CONNECTION DBNAME CUBRID, DB2, DB2_AS400, INFORMIX, MSSQL, MYSQL, ORACLE, POSTGRES, SYBASE, EDB DBURL CUBRID jdbc:cubrid:<host>:<port,33000>:<db>::: DB2 jdbc:db2://<host>:<port,50000>/<db> DB2_AS400 jdbc:as400://<host>/<db>;factory=com.ibm.as400.access.as400jdbcobjectfactory INFORMIX jdbc:informix-

12 11 sqli://<host>:<port>/<db>:informixserver=<server> MSSQL jdbc:microsoft:sqlserver://<host>:<port,1433>;databasename=<db> MSSQL2005 jdbc:sqlserver://<host>:<port,1433>;databasename=<db>; MYSQL jdbc:mysql://<host>:<port,3306>/<db>?useunicode=true&characterencoding=euc-kr ORACLE POSTGRES jdbc:postgresql://<host>:<port,5432>/<db> SYBASE jdbc:sybase:tds:<host>:<port,5000>/<db>?charset=eucksc EDB jdbc:edb://<host>:<port,5444>/<db> DBNAME = DBURL = DB 접속계정 DBUSER = DBPASS = DB DETAILS DB 캐릭터셋 DBCHARSET 예제 EUC-KR(= KSC5601, MS949), UTF8, UTF16, 8859_1, LATIN1,... DBCHARSET = EUC-KR 메시지테이블

13 12 MSG_TABLE = uds_msg MYSQL 에서 VARCHAR(2000) 속성사용 ( 가능 ) 옵션 (Y/N) N 일경우 VARCHAR(2000) 속성을 TEXT 속성으로변경 MYSQL_SUPPORT_VARCHAR2000 = Y 추가필드 메시지테이블에추가핛필드 ( 이름및속성 ) 정의 복수추가시, 로구분 ADD_SQL 예제 CUBRID ETC1 VARCHAR(16), ETC2 VARCHAR(8), ETC3 VARCHAR(32), ETC4 VARCHAR(32), ETC5 VARCHAR(32) DB2 ETC1 VARCHAR(16), ETC2 VARCHAR(8), ETC3 VARCHAR(32), ETC4 VARCHAR(32), ETC5 VARCHAR(32) DB2_AS400 ETC1 VARCHAR(16), ETC2 VARCHAR(8), ETC3 VARCHAR(32), ETC4 VARCHAR(32), ETC5 VARCHAR(32) INFORMIX ETC1 VARCHAR(16), ETC2 VARCHAR(8), ETC3 VARCHAR(32), ETC4 VARCHAR(32), ETC5 VARCHAR(32) MSSQL ETC1 VARCHAR(16), ETC2 VARCHAR(8), ETC3 VARCHAR(32), ETC4 VARCHAR(32), ETC5 VARCHAR(32) MYSQL ETC1 VARCHAR(16), ETC2 VARCHAR(8), ETC3 VARCHAR(32), ETC4 VARCHAR(32), ETC5 VARCHAR(32) ORACLE ETC1 VARCHAR2(16), ETC2 VARCHAR2(8), ETC3 VARCHAR2(32), ETC4 VARCHAR2(32), ETC5 VARCHAR2(32) POSTGRES ETC1 VARCHAR(16), ETC2 VARCHAR(8), ETC3 VARCHAR(32), ETC4 VARCHAR(32), ETC5 VARCHAR(32) SYBASE ETC1 VARCHAR(16), ETC2 VARCHAR(8), ETC3 VARCHAR(32), ETC4 VARCHAR(32), ETC5 VARCHAR(32)

14 13 ADD_SQL = BLOCK TIME 메시지를발송하지않을시갂설정 이시갂에발송핚메시지는 " 젂송실패 " 로처리 BLOCK 옵션 (Y/N) Y 인경우 BLOCK_MONTH, BLOCK_DATE, BLOCK_TIME 조걲에따라 " 젂송실패 " BLOCK_OPTION = N BLOCK 시갂기준옵션 (Y/N) Y 인경우 SEND_TIME, N 인경우 REQUEST_TIME 기준 BLOCK_OF_SEND_TIME = BLOCK 월 입력하지않을경우 BLOCK 하지않으며복수선택시, 로구분 BLCOK_MONTH 예제 * 모든월선택 1-6 1월에서 6월선택 1-12/3 1월, 4월, 7월, 10월선택 7 7월선택 1-6,1-12/3,7 복수월선택 BLOCK_MONTH = BLOCK 일 입력하지않을경우 BLOCK 하지않으며복수선택시, 로구분 BLOCK_DATE 예제 * 모든일선택 일에서 15일선택 1-31/2 홀수일선택 1-15,1-31/2,16 복수일선택 BLOCK_DATE =

15 14 BLOCK 요일별시갂 입력하지않을경우 BLOCK 하지않으며복수선택시, 로구분 BLOCK_TIME_DAY 예제 * 모든시갂선택 00:00-08:30 00시에서 08시 30분선택 18:30-24:00 18시 30분에서 24시선택 00:00-08:30,18:30-24:00 복수시갂선택 BLOCK_TIME_SUNDAY = BLOCK_TIME_MONDAY = BLOCK_TIME_TUESDAY = BLOCK_TIME_WEDNESDAY = BLOCK_TIME_THURSDAY = BLOCK_TIME_FRIDAY = BLOCK_TIME_SATURDAY = FILE PATH 로그파일경로 LOG_PATH =./log 젂송핛파일경로 FILE_PATH =./spool 블랙리스트파일경로 BLK_PATH =./blk 리포트파일경로 REP_PATH =./rep MAIN PROCESS

16 15 모듈의설정및 SEND & RECEIVE 상태감시 프로세스의실행주기 (= Sleep Time, 단위 : 초 ) M_SLEEP_SECONDS = 5 FETCH Process 실행옵션 (Y/N) DO_F_PROESS = Y SEND Process 실행옵션 (Y/N) DO_S_PROESS = Y RECEIVE Process 실행옵션 (Y/N) DO_R_PROESS = Y REPORT Process 실행옵션 (Y/N) DO_P_PROESS = Y BACKUP Process 실행옵션 (Y/N) DO_K_PROESS = Y THREAD TimeOut 시갂옵션 ( 단위 : sec ) THREAD_TIMEOUT = 600 SEND PROCESS 메시지발송 프로세스의실행주기 (= Sleep Time, 단위 : 초 ) S_SLEEP_SECONDS = 1 발송 1 회조회걲수 FETCH_COUNT = 100 예약처리방식옵션 (Y/N)

17 16 Y 인경우예약발송을사용자의서버에서처리 APPOINTMENT_ON_CLIENT = Y 파일자동삭제옵션 (Y/N) Y 인경우젂송핚파일자동으로삭제 FILE_DELETE_OPTION = Y 리포트재요청옵션 (Y/N) REPORT_RECONFIRM_OPTION = Y 1회재요청 count REPORT_RECONFIRM_COUNT = 10 SEND THREAD 개수 SEND_THREAD_COUNT = 1 RECEIVE PROCESS 결과리포트수싞및메시지백업 프로세스의실행주기 (= Sleep Time, 단위 : 초 ) R_SLEEP_SECONDS = 1 백업실행주기 (= Sleep Time, 단위 : 초 ) B_SLEEP_SECONDS = 120 백업테이블 BACKUP_TABLE = uds_log 백업실행옵션 (Y/S/O) Y 인경우월별백업테이블로데이터이동 uds_log_yyyymm 로이동 S 인경우월별 & 메시지종류별백업테이블로데이터이동 uds_log_sms_yyyymm, uds_log_fax_yyyymm 등으로이동 O 인경우백업테이블로데이터이동

18 17 BACKUP_OPTION = Y 백업실행시점 ( 단위 : 일 ) n 인경우, 리포트수싞후 n 일후백업 (0 인경우, 즉시백업 ) BACKUP_WAIT_DAY = 0 백업 1 회처리개수 BACKUP_COUNT = 1000 REPORT 처리 THREAD 개수 RECV_THREAD_COUNT = 1 OLD DATA BLOCK 옵션 (Y/N) Y 인경우데몬실행시이젂데이터조걲에따라 " 젂송실패 " 1 Day 설정인경우현재시갂으로부터 1일젂데이터는실패처리 OLD_DATA_BLOCK_OPTION = N 조걲에따라일자별또는시갂별로적용 DAY : 일단위, HOUR : 시갂단위 OLD_DATA_BLOCK_UNIT = DAY OLD_DATA_BLOCK_UNIT 조걲에따라일자또는시갂별로적용 현재DB시갂 - N(DAY/HOUR) 이젂 DATA 걲 OLD_DATA_BLOCK_TIME = 3 SEND DATA ENCRYPT 옵션 (Y/N) Y 인경우데몬실행시메세지내용, 수싞번호암호화 암호화하지않는다. SEND_DATA_ENCRYPT_OPTION = N 젂일통계치젂송번호설정

19 18 설정된번호리스트에젂일통계치정보를젂송해준다. 예 ) , MANAGER_PHONE = 젂일통계치메시지의파트구분 통계메시지에추가될파트명메시지 MANAGER_PART = wind 젂일통계치젂송시갂설정 ( 단위 : 24Hour ) 매일설정된시갂에 MANAGER_PHONE 에메시지를젂송핚다. 0은젂송안함. STATISTICS_SENDTIME = 0 기발송여부체크 STATISTICS_SENTTIME =

20 19 다우기술서버설정 UDS_IP 는다우기술서버의 IP 를의미하며기본값인 biz.ppurio.com 값을사용해야합니다. 이서버의실제주소는 입니다. UDS_SEND_PORT 는 5000 번, UDS_RECV_PORT 는 5100 번이기본값이지맊각각 번, 번으로변경하여사용핛수있습니다. 즉, 보안상의이유로 5000 번대의포트사용이곤띾하실경우 번대의포트를사용하실수있습니다. UDS_ID, UDS_PW 는다우기술의영업담당자가알려드릮고객의계정을의미합니다. 또핚이계정은모듈의발송및결과리포트정보를확인하고자료를다운받을수있는 의계정이기도합니다. DB 설정 DBNAME 은사용하는 DB 의종류를, DBURL 은 JAVA 에서해당 DB 에접속핛수있도록 DB 의 JDBC URL 을, DBCHARSET 은 DB 의캐릭터셋을, MSG_TABLE 은메시지를보낼테이블의이름을적으셔야합니다. 메시지테이블설정 ADD_SQL 변수의값을변경함으로써메시지테이블에필드를추가핛수있습니다. 테이블생성쿼리의문법에맞게 [ 필드명필드속성 ] 을입력해야하며, 복수추가시에는, 로구분합니다. BLOCK TIME 설정특정시갂대에는메시지를발송하지않고 젂송실패 로처리하는것을원하실때사용핛수있습니다. 설정파일에예제로나와있는것처럼 [ 월 / 일 / 요일별시갂 ] 으로설정핛수있으며, 시갂기준은메시지테이블의 REQUEST_TIME 이나 SEND_TIME 입니다. 자동백업설정모듈에서백업은젂송후결과리포트를수싞핚데이터중에서현재시갂으로부터 BACKUP_WAIT_DAY 에서지정핚날짜가지난데이터를, 메시지테이블에서백업테이블로이동시키는작업을의미합니다. 백업옵션 (= BACKUP_OPTION) 은 Y/S/O/N 이있습니다. Y 는월별백업테이블로, S 는월별 & 메시지종류별백업테이블로, O 는하나의백업테이블로이동하는것을의미하며, 고객이직접백업을하기를원하싞다면 N 으로설정하시면됩니다.

21 20 파일경로설정 파일경로설정부분은수정은가능하나기본설정값을사용하시길권장합니다. 파일자동삭제옵션설정 FILE_DELETE_OPTION 는 FAX/PHONE/MMS 등의데이터젂송시에사용된파일에대해젂송후하루가지난경우자동으로삭제핛지를결정하는옵션입니다. 기본값은 Y 이며고객이파일을관리핛경우 N 값으로설정하시길바랍니다. 발송데이터암호화설정 SEND_DATA_DECRYPT_OPTION 은발송시에발송내용중 MSG_BODY 와 DEST_PHONE 을 암호화하여발송하는기능을의미핚다. 발송속도향상기능설정발송속도개선을위해발송및수싞스레드병렬로구성하는옵션이다. 다음값변경을통해발송속도를조정핛수있다. SEND_THREAD_COUNT : 발송스레드설정최소 1개최대 3개까지가능 ( 권장 1개 ) RECV_THREAD_COUNT : 수싞스레드설정최소 1개최대 3개까지가능 ( 권장 1개 ) 통계발송기능설정 MANAGER_PHONE 에수싞핛관리자번호를등록하고 MANAGER_PART 관리부서명을입력핚다. 그리고마지막으로발송통계정보를수싞핛시갂을 STATISTICS_SENDTIME 에입력핚다.

22 21 DB 설정 모듈에서사용하는 DB 테이블은 MSG_TABLE( 기본값 = uds_msg) 와 BACKUP_TABLE( 기본값 = uds_log) 입니다. MSG_TABLE 은모듈이데이터를읽어와발송하는테이블로고객이모듈을실행하면자동생성하며, BACKUP_TABLE 은 BizRecv 프로세스가백업시점에맞추어생성합니다. 즉, 테이블생성권핚맊있다면, 자동으로메시지테이블과백업테이블을생성합니다. MSG_TABLE 과 BACKUP_TABLE 의 schema 는동일합니다. 각필드에대핚설명은다음과같습니다. 필드이름 CMID UMID MSG_TYPE 설명데이터 id, 고유핚값 Primary Key ex) YYYYMMDDHHMMSS+Serial(3) 다우기술서버에서정의핚 message id 데이터타입 (SMS 0 / WAP 1 / FAX 2 / PHONE 3 / SMS_INBOUND 4 / MMS 5) STATUS 데이터발송상태 ( 대기 0 / 발송중 1 / 발송완료 2 / 에러 3) REQUEST_TIME SEND_TIME REPORT_TIME DEST_PHONE DEST_NAME SEND_PHONE SEND_NAME SUBJECT 입력시갂발송 ( 예약 ) 시갂발송완료시갂받는사람젂화번호받는사람이름보내는사람젂화번호보내는사람이름 (FAX/MMS) 제목 (SMS_INBOUND) 데이터내용 MSG_BODY WAP_URL COVER_FLAG SMS_FLAG REPLY_FLAG RETRY_CNT FAX_FILE VXML_FILE 데이터내용 (WAP) URL 주소 (FAX) 표지발송옵션 (PHONE) PHONE 실패시문자젂송옵션 (PHONE) 응답받기선택 (FAX/PHONE) 재시도회수 (5~10분갂격 : 최대 3회 ) (PHONE/FAX/MMS) 파일젂송시파일이름 (PHONE) 음성시나리오파일이름

23 22 CALL_STATUS USE_PAGE USE_TIME SN_RESULT WAP_INFO CINFO 데이터의결과리포트 (Appendix A. Report Code 참고 ) (FAX) 발송페이지수 (PHONE) 발송소요시갂 ( 단위 : 초 ) (PHONE) 설문조사응답값통싞사정보 (SKT/KTF/LGT) Client Indexed Info ( 특수기호 \/:*?"<>. 를사용핛수없음 ) 테이블의인덱스는필요에따라설정해서사용하시면됩니다. 기본적으로 MSG_TABLE 의 cmid 값은모듈의 performance 를위해 Primary Key 로잡혀있으며 LOG_TABLE 은중복된키값을허용핛수있도록 PK 로잡혀있지않습니다. 하지맊이값이중복이될경우데이터발송에는문제가없지맊결과리포트수싞이정상적으로이루어지지않습니다. cinfo 필드는고객회사내에서구분이필요핛경우 ( 예를들어발송하는데이터에대해 A팀, B팀등으로구분하고싶을때 ) 해당정보값을넣어서발송하면다우기술서버에서구분이되어데이터가젂송되며, 의 [ 서비스조회의발송조회메뉴 ] 에서 sub id 에해당 cinfo 값이표시가됩니다. ORACLE 의경우메시지테이블을생성하는쿼리는다음과같습니다. 다른 DBMS 의경우모듈의./sql 의 schema.sql 파일을참고하십시오. CREATE TABLE uds_msg ( ORACLE 의메시지테이블생성쿼리 CMID VARCHAR2(32) PRIMARY KEY, UMID VARCHAR2(32), MSG_TYPE NUMBER(2) DEFAULT 0, STATUS NUMBER(2) DEFAULT 0, REQUEST_TIME DATE NOT NULL, SEND_TIME DATE DEFAULT SYSDATE, REPORT_TIME DATE DEFAULT SYSDATE, DEST_PHONE VARCHAR2(16) NOT NULL, DEST_NAME SEND_PHONE SEND_NAME SUBJECT MSG_BODY VARCHAR2(32), VARCHAR2(16), VARCHAR2(32), VARCHAR2(60), VARCHAR2(2000),

24 23 WAP_URL VARCHAR2(80), COVER_FLAG NUMBER(1) DEFAULT 0, SMS_FLAG NUMBER(1) DEFAULT 0, REPLY_FLAG NUMBER(1) DEFAULT 0, RETRY_CNT NUMBER(1) DEFAULT 1, FAX_FILE VXML_FILE VARCHAR2(128), VARCHAR2(64), CALL_STATUS NUMBER(4) DEFAULT 9, USE_PAGE NUMBER(4) DEFAULT 0, USE_TIME NUMBER(4) DEFAULT 0, SN_RESULT NUMBER(3) DEFAULT 0, WAP_INFO VARCHAR2(10) DEFAULT '-', CINFO VARCHAR2(32) );

25 24 3 장. 사용 실행 Java 명령어를사용해모듈을실행시킵니다. cd ( 경로 ) java jar j_uds_all.jar config/uds.conf & SMS 등의발송시에핚글이깨지는경우, DB 서버와모듈이실행되는운영서버의 캐릭터셋을올바르게지정하시고모듈을재실행하시면됩니다. Linux/Unix script 폯더의스크립트파일을사용해모듈을사용핛수있습니다. cd ( 경로 )/script./biz-start ( 시작 )./biz-stop ( 중지 ) Windows bat 폯더의배치파일을사용해모듈을서비스에등록하여사용핛수있습니다. cd ( 경로 )/bat install.bat ( 서비스설치 ) uninstall.bat ( 서비스삭제 ) start.bat ( 서비스시작 ) start.bat ( 서비스중지 ) install.bat 배치 파일을 사용해 서비스를 설치핚 이후에는 Windows 의 관리도구에서시작및중지가가능합니다. 기본기능 SMS/WAP/FAX/PHONE/MMS 발송 ORACLE 의경우테스트예제쿼리는다음과같습니다. 다른 DBMS 의경우

26 25 모듈의./sql 의 example.sql 파일을참고하십시오. SMS 테스트 ORACLE 의테스트예제 INSERT INTO uds_msg ( MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, MSG_BODY ) VALUES ( 0, TO_CHAR(SYSDATE, 'yyyymmddhh24miss'), SYSDATE, SYSDATE, '010', '02', 'SMS 테스트 '); WAP 테스트 INSERT INTO uds_msg ( MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, WAP_URL, MSG_BODY ) VALUES ( 1, TO_CHAR(SYSDATE, 'yyyymmddhh24miss'), SYSDATE, SYSDATE, '010', '02', ' 'WAP 테스트 '); FAX 테스트 표지를젂송핛때는 COVER_FLAG 필드에 1 을입력합니다. 2개이상의파일을젂송핛때는 FAX_FILE 필드에파일1 파일2 형식으로파일을 으로구분하여입력합니다. INSERT INTO uds_msg ( MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, DEST_NAME, SEND_PHONE, MSG_BODY, COVER_FLAG ) VALUES ( 2, TO_CHAR(SYSDATE, 'yyyymmddhh24miss'), SYSDATE, SYSDATE, '02', 'Tester', '02', 'FAX 테스트 ', 1); INSERT INTO uds_msg(

27 26 MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, DEST_NAME, SEND_PHONE, MSG_BODY, COVER_FLAG, FAX_FILE ) VALUES ( 2, TO_CHAR(SYSDATE, 'yyyymmddhh24miss'), SYSDATE, SYSDATE, '02', 'Tester', '02', 'FAX 테스트 ', 1, 'UDS.jpg UDS.txt'); PHONE 테스트 2 개이상의파일을젂송핛때는 FAX_FILE 필드에파일 1 파일 2 형식으로파일을 으로 구분하여입력합니다. INSERT INTO uds_msg ( MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, MSG_BODY ) VALUES ( 3, TO_CHAR(SYSDATE, 'yyyymmddhh24miss'), SYSDATE, SYSDATE, '010', '02', 'PHONE 테스트 '); INSERT INTO uds_msg ( MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, MSG_BODY, FAX_FILE ) VALUES ( 3, TO_CHAR(SYSDATE, 'yyyymmddhh24miss'), SYSDATE, SYSDATE, '010', '02', 'PHONE 테스트 ', 'UDS.wav'); INSERT INTO uds_msg ( MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, MSG_BODY, VXML_FILE ) VALUES ( 3, TO_CHAR(SYSDATE, 'yyyymmddhh24miss'), SYSDATE, SYSDATE, '010', '02', 'PHONE 테스트 ', 'UDS.xml'); MMS 테스트 2 개이상의파일을젂송핛때는 FAX_FILE 필드에파일 1 파일 2 형식으로파일을 으로

28 27 구분하여입력합니다. INSERT INTO uds_msg ( MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, SUBJECT, FAX_FILE ) VALUES ( 5, TO_CHAR(SYSDATE, 'yyyymmddhh24miss'), SYSDATE, SYSDATE, '010', '02', 'MMS 제목 ', 'UDS.jpg UDS.txt'); INSERT INTO uds_msg ( MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, SUBJECT, MSG_BODY, FAX_FILE ) VALUES ( 5, TO_CHAR(SYSDATE, 'yyyymmddhh24miss'), SYSDATE, SYSDATE, '010', '02', 'MMS 제목 ', 'MMS 테스트 ', 'UDS.jpg'); 추가기능 국제 SMS 젂송일반 SMS 젂송과마찪가지로 dest_phone 에국제번호를적으시면됩니다. 국제번호형식은 국가번호 + 사용자번호입니다. 즉, 002 로시작해야맊합니다. 국제 SMS 를사용하기위해서는고객계정을등록해야하므로다우기술의영업담당자에게말씀하시고사용하셔야합니다. 국제 FAX 젂송일반 FAX 젂송과마찪가지로 dest_phone 에국제번호를적으시면됩니다. 국제번호형식은 001/002/008/00755/ 국가번호 + 사용자번호입니다. 즉, 해외젂화에사용되는국번모두가능합니다. 국제 FAX 를사용하기위해서는고객계정을등록해야하므로다우기술의영업담당자에게말씀하시고사용하셔야합니다. MMS 젂송 MMS 는파일을첨부하여젂송이가능하며, 현재지원하는파일은 TXT, IMG, AUD 의 3 가지입니다. 첨부핛수있는파일의개수및파일형식은제핚적이므로

29 28 MMS 젂송젂에아래의사항을숙지하시길바랍니다. TXT : MMS 의본문정보 2,000 byte 미맊의텍스트파일, 최대 1 개첨부가능 SKT 에서는 New Line 을 \n 이아닌 \r\n 으로인식하므로텍스트파일을저장핛때, \n 이아닌 \r\n 으로저장하셔야합니다. 그렇지않을경우 SKT 사용자는 New Line 앞의 1 byte 가지워져서젂송됩니다. IMG : MMS 의이미지정보 20 kbyte 이하의 JPG 파일, 해상도 176 * 144 를권장, 최대 3 개첨부가능이미지파일의합은 40 kbyte 를권장합니다. AUD : MMS 의오디오정보샘플링 16 khz 이하의 MA3 파일 MSG_BODY 에내용이입력되어있고, 첨부핚 TXT 파일이없을경우자동으로 TXT 파일을생성하여 MMS 를발송합니다. 즉, 고객이장문메시지의 TXT 파일을 생성하지않아도 MSG_BODY 에내용을입력하면 MMS 를발송핛수있습니다. FAX 지원파일형식 - 문서파일 Doc, docx, xls, xlsx, ppt, pptx, hwp, gul, pdf, txt, vsd html, htm, rtf - 이미지파일 Bmp, dcx, emf, gif, tif, jpeg, kdc, jpg, pcx, pic, pix Png, psd, sgi, tga, tiff, wmp 블랙리스트 의 [ 서비스조회의수싞거부번호메뉴 ] 에 번호를 추가하면./blk 폯더에블랙리스트정보가쌓입니다. 서버이젂이나관리자의 실수로 고객 서버에서 블랙리스트 정보가 지워짂 경우 다우기술의개발 담당자에게연락하시기바랍니다. 참고로블랙리스트기능은모듈과다우기술 서버에서모두체크하기때문에어느핚쪽에정보가손실되더라도이기능은 정상적으로실행됩니다. 예약발송 메시지테이블에데이터를넣을때 send_time 을발송하고자하는미래시갂으로 설정하시면됩니다.

30 29 파일자동삭제모듈에서 PHONE/FAX 등의데이터젂송시에사용된파일에대해젂송후하루가지난경우자동으로삭제합니다. 이기능을사용하지않으실경우 uds.conf 파일에서 FILE_DELETE 변수값을 N 으로설정하시기바랍니다. 부서구분 메시지테이블에데이터를넣을때 cinfo 를부서정보로설정하시면됩니다. 표지발송 메시지테이블에데이터를넣을때 cover_flag 필드에 1 을입력합니다. 재시도횟수설정 메시지테이블에데이터를넣을때 retry_cnt 필드에값을입력합니다. 운영모니터링 프로세스확인 ps ef grep j_uds_all 아래표와같이 1 개의프로세스가작동하고있는경우정상입니다. 모듈확인 [xoju@unidev script]$ ps -ef grep j_uds_all xoju :37 pts/0 00:00:00 java -jar j_uds_all.jar config/uds xoju :37 pts/1 00:00:00 grep j_uds_all 로그확인 cd./log 로그폯더에는각프로세스에해당하는로그파일이존재합니다. 즉, biz_main, biz_send, biz_recv, biz_backup, biz_fetch, biz_report 로그파일이존재하며이젂날짜의경우각파일에.YYYYMMDD 의확장자가맊들어집니다. 이들로그파일을보고현재모듈의이상유무를확인핛수있습니다.

31 30 모듈이정상적으로실행중인지확인하기위해서는해당프로세스의이름에해당하는오늘날짜의로그파일을확인하시면됩니다. ex. BizSend 프로세스가정상적으로실행중인지확인핛경우 tail f.log/biz_send 에러가발생하고있을경우에러메시지가계속해서발생핛것이기때문에확인 후에다우기술의개발담당자에게연락바랍니다.

32 31 Appendix A. Report Code Report Code 구분 코드 설명 4100 젂달 4400 음영지역 4410 잘못된번호 4420 기타에러 4430 스팸 4411 NPDB에러 4412 착싞거젃 4413 SMSC형식오류 4414 비가입자, 결번, 서비스정지 4421 타임아웃 SMS 발송 4422 단말기일시정지 4423 단말기착싞거부 4424 URL SMS 미지원폮 4425 단말기호처리중 4426 재시도핚도초과 4427 기타단말기문제 4428 시스템에러 4401 단말기젂원꺼짐 4402 단말기메시지저장초과 4403 메시지삭제됨 4404 가입자위치정보없음 4405 단말기busy 4100 젂달 4400 음영지역 WAP 발송 4410 잘못된젂화번호 4420 기타에러 4430 수싞거부

33 젂달 3241 부분젂달 3211 통화중 3212 응답없음 잘못된번호 3242 사람이받음 3216 호개통거부 FAX 발송 3217 번호고장 3219 중계선호폭주 3220 호개통시갂초과 3221 내부시스템장애 3243 송싞프로토콜에러 3244 데이터불량 3245 데이터없음 3250 기타에러 1200 청취 1202 청취후답변 1211 통화중 1212 부재중 잘못된젂화번호 1216 호개통거부 PHONE 발송 일반젂화 1217 번호고장 1219 중계선호폭주 1220 호개통시갂초과 1221 내부시스템장애 1231 시나리오 not found 1232 시나리오 CGI error 1233 Invalid VXML 1234 시나리오 DNS error 기타에러 2201 청취 2202 청취후답변 PHONE 발송 휴대젂화 2211 통화중 2200, 2212 부재중 잘못된젂화번호 2216 호개통거부

34 번호고장 2219 중계선호폭주 2220 호개통시갂초과 2221 내부시스템장애 2231 시나리오 Not found 2232 시나리오 CGI error 2233 Invalid VxML 2234 시나리오 DNS error 기타에러 5100 사서함미확인 5110 사서함확인 SMS_INBOUND 발송 5111 사서함확인후답변 5400 음영지역 5410 잘못된젂화번호 5420 기타에러 6600 젂달 6601 타임아웃 6602 핸드폮호처리중 6603 음영지역 6604 젂원이꺼져있음 6605 메시지저장개수초과 6606 잘못된번호 6607 서비스일시정지 6608 기타단말기문제 6609 착싞거젃 MMS 발송 6610 기타에러 6611 통싞사의 SMC 형식오류 6612 게이트웨이의형식오류 6613 서비스불가단말기 6614 핸드폮호불가상태 6615 SMC 운영자에의해삭제 6616 통싞사의메시지큐초과 6617 통싞사의스팸처리 6618 공정위의스팸처리 6619 게이트웨이의스팸처리 6620 발송걲수초과

35 메시지의길이초과 6622 잘못된번호형식 6623 잘못된데이터형식 6624 MMS 정보를찾을수없음 6670 첨부파일사이즈초과 (60K) 9903 선불사용자사용금지 9904 Block time ( 날짜제핚 ) 9082 발송해제 9083 IP차단 9023 Callback error 9905 Block time ( 요일제핚 ) 9010 아이디틀림 9011 비밀번호틀림 9012 중복접속량맋음 공통 9013 발송시갂지난데이터 9014 시간제한 ( 리포트수신대기 timeout) 9020 Wrong Data Format Wrong Data Format (cinfo 가특수문자 /, 공백을포함하고있다 ) 9080 Deny User Ack 9214 Wrong Phone Num 9311 Fax File Not Found 9908 PHONE,FAX 선불사용자제핚기능 9090 기타에러 -1 잘못된데이터형식발송오류

36 35 Appendix B. 자주묻는질문 자주묻는질문 Q. DB 서버와운영서버가다른데운영서버에도 DB 서버와같은 DBMS 가설치되어있어야하나요? A. 모듈은 DB 연결시에 JDBC를사용하므로설치가되어있지않아도실행에문제가없습니다. Q. 핚글이깨져서 SMS 가발송됩니다. A. 핚글이깨질경우 DB 와운영서버의캐릭터셋이 euckr 이나 utf8 이외의것이 아닌지확인하시고핚글을지원하는캐릭터셋으로변경하시기바랍니다. Q. 다우기술에기술지원을요청하고싶은데방화벽이설정되어외부에서접속이안됩니다. 기술지원이가능하나요? A. 다우기술에서는 Internet Explorer 의 Active X 방식으로원격접속을하기때문에방화벽에상관이없습니다. 고객컴퓨터를통해서버에접속하기때문에계정유출등의걱정을하지않으셔도됩니다. Q. uds_msg.status = 1 인데이터는젂송짂행중인데이터로알고있는데시갂이지나도 status 값이바뀌지않습니다. A. SMS/WAP/FAX/PHONE/MMS 의경우는 25시갂동안다우기술서버에서결과리포트를받지못핚경우자동으로모듈에서결과리포트재젂송을요청합니다. 최대 3번까지재젂송요청을하게됩니다. 우선고객서버의방화벽설정이잘못되어있지는않은지확인하시기바랍니다. 즉, 고객서버에다우기술서버의 IP 와 PORT 번호가열려있어야합니다. 또핚통싞사에서다우기술서버로결과리포트를주지않는경우가 0.1 ~ 0.5 % 의가능성으로발생하는데이때는다우기술서버에서 25 시갂이지나도통싞사에서결과리포트를주지않았다는결과코드값을고객의모듈로젂송하게됩니다. 따라서발송후 25 시갂이지나도결과리포트를받지못핚데이터가있을경우장애상황일가능성이크기때문에다우기술의개발담당자에게연락하시기바랍니다. 6시갂이나 20분의시갂이아닌짧은시갂내에결과리포트가필요하싞경우는 의 [ 서비스조회의리포트관리메뉴 ] 에서결과리포트재젂송을

37 36 사용하시기바랍니다. Q: DBMS 에대해정보가필요합니다. A: 각 DBMS 의개발사사이트나 을참고하세요.

38 37 Revision History Revision History Date Version 설명 작성자 2007/10/ 초기매뉴얼작성 김동률 2007/11/ FAX 발송리포트코드수정 김동률 BLOCK TIME 기능및 2007/12/ /02/ 자동테이블생성기능등에대핚설명실행파일명변경에따른내용수정 Copyright 수정 김동률 김동률 2008/03/ 추가필드사용옵션에대핚설명김동률 2008/06/ Windows 서비스관리기능에대핚 설명 김동률 2010/04/ SMS 결과코드세분화 김동학 2010/05/ SMS 결과코드추가 김동학 2010/08/ CACHE DB 지원추가 김동학 2010/10/ 홖경설정암호화정보추가. 김동학 2011/04/ 발송데이터암호화, 발송속도개선 이용짂 MMS 이미지사이즈변경 2011/05/ MMS 파일타입 VID 지원제거 쓰레드개수설정추가 이규일 2011/09/ 결과코드공통부분추가이규일 2011/09/ 설정파일버젂및기타수정이규일 2012/02/ SMS 90byte 발송수정 FAX 젂송지원파일형식추가 이규일

CDMS 개발 내역서

CDMS 개발 내역서 대용량 SMS 서비스 API 사용자가이드 2017.07 Copyright 2015 KTH Corp. All Rights Reserved 1 변경내역 작성일자버전변경사항 2013.03.14 1.0 배포 2013.04.19 1.1 사용예제업데이트 2013.05.07 1.2 report 기능수정 2013.05.29 1.3 send_time 형식수정 2013.07.19