ArreoSMSPluse v3.2 설치 (Upgrade Version) 본문서는 ArreoNetworks SMSMT 2.6.X, Agent 3.0 버전을사용하는사용자에게 ArreoSMSPluse 3.2 로의버 전업그레이드작업진행시, 진행상에서반드시체크하셔야하는사항에대하여작성되었습니다. ArreoSMSPluse 3.2 의설치방법및자세한기능과설명은 ArreoSMSPlus3.2_UserManual 을참고하시기바 랍니다. 작업시주의사항 1. AGENT 2.6.X 또는 AGENT 3.0 기존에설치된디렉토리는삭제하지않는다. ArreoSMSPlus 3.2 으로의이전이원활하지않을경우 2.6.X 또는 3.0 으로원복할수있음. 2. 기존설정중 SMS Spam 시간설정 에유의한다. 기존 arreo.conf 의 SPAM 으로설정한시간대에대한설정을 ArreoSMSPlus 3.2 에해주지않으 면 SPAM 시간대의 SMS 가전송될수있음. 3. DB 인코딩설정을기존버전과동일하게설정한다. 작업전확인 CHECK LIST No 항 목 확인일시 확인자 1 방화벽설정 2 전송테이블컬럼추가 3 JDK 버전확인 4 Agent 2.6.X 또는 Agent 3.0 백업혹은그대로유지 5 ArreoSMSPluse 3.2 디렉토리새로생성 6 ArreoSMSPluse 3.2 환경설정 7 ArreoSMSPluse 3.2 실행 8 ArreoSMSPluse 3.2 정상동작확인 [ 서비스관련문의 : 고객지원실 02-6202-5800] 페이지 1 / 7
1. ArreoSMSPlus 3.2 Upgrade 작업전확인사항 가. 방화벽설정 1) Agent 2.6.X 사용자의경우 SMS 전송서버가변경됨에따라해당 IP, PORT에대한방화벽이 OPEN되어있어야함. Agent 3.2 사용자의경우기존과동일하게방화벽설정함. 대상 IP 210.219.174.189 ~ 210.219.174.190 (INFO 서버 ) 210.219.174.171 ~ 210.219.174.173 ( 리시버서버 ) 210.219.174.181 ~ 210.219.174.182 ( 레포트서버 ) 대상 PORT 20001 ~ 20005 2) LMS 추가사용자의경우, LMS 전송서버에대한방화벽이 OPEN되어있어야함. 대상 IP 218.233.240.11 대상 PORT 10004 3) 해당 IP, PORT 에대한방화벽 OPEN 이되어있지않으면 SMS, LMS 전송이불가능하니 Telnet 명 령으로 ArreoNetworks 서버로접속이가능한지반드시확인하시기바랍니다. 4) 해당 IP, PORT 의방화벽 OPEN 은 ArreoSMSPlus 3.2 의처리를위해반드시필요한설정입니다. 추후 SMS, LMS 서비스제공을위해시스템의추가에따라 IP, PORT 의추가 / 변동이있을수있습 니다. 나. 전송테이블 1) SMSPlus3.2 에서는기존 2.6.x 또는 3.0 에서사용하던전송테이블에칼럼을추가해야사용가 능함. 2),3) 항의 script 파일참조 2) 기존사용하던 Agent의버전이 2.6.X 일경우에는아래의칼럼이더추가되어야합니다. ( arreo.conf 파일상단에 Agent 버전확인가능, 또는아레오테이블레이아웃스크립트와현재 사용하고있는전송테이블레이아웃비교하여확인 ) Script : ALTER TABLE ARREO_SMS ADD( SND_GB CHAR(1) DEFAULT 'N', --이통사별전송기능 SND_SKT_FG CHAR(1) DEFAULT 'N', --SKT지정 SND_KTF_FG CHAR(1) DEFAULT 'N', --KTF지정 SND_LGT_FG CHAR(1) DEFAULT 'N', --LGT지정 MSG_ID VARCHAR(20), --서버에서생성하는고유ID 페이지 2 / 7
AUTH_SEQ VARCHAR(5), --AGENT인증코드 NAT_CD CHAR(3) DEFAULT '82' --국가코드 SUBJECT VARCHAR(20), --LMS메시지제목 READ_REPLY_VAL NUMBER(4) DEFAULT 99, --LMS핸드폰오픈유무 READ_REPLY_DTTM CHAR(14) --LMS핸드폰오픈시간 ); 3) 기존사용하던 Agent의버전이 3.0 일경우에는아래의칼럼이더추가되어야합니다. Script : ALTER TABLE ARREO_SMS ADD( SUBJECT VARCHAR(20), --LMS메시지제목 READ_REPLY_VAL NUMBER(4) DEFAULT 99, --LMS핸드폰오픈유무 READ_REPLY_DTTM CHAR(14) --LMS핸드폰오픈시간 ); 4) customer.arreo.com 에서 login 후 고객센터 Agent SMSPlus3.2 에서 SMSPlus3.2.zip 파일을 Download 후압축을풀면 script 파일에서 SMSPlus 3.2 테이블레이아웃확인가능함. 5) SMSPlus 3.2 기본테이블레이아웃의칼럼이모두전송테이블에존재해야함 6) 사용자의업무상칼럼추가가필요할경우아레오에서정의한칼럼명과중복되지않도록주의 7) SMSPlus3.2 에서추가되는칼럼은모두 default 값이설정되어있어사용자가 SMS 전송데이터 입력시추가된칼럼에값을입력하지않아도됨. (Agent3.2 의추가기능사용시사용자입력필요 사용자매뉴얼참조 ) 다. JDK 버전확인 JDK1.5.X 에서 SMSPlus 3.2 사용가능 JDK 버전이 1.5.0 이하일경우 1.5.X 버전으로 JDK 를설치 2. Agent3.0 Upgrade 작업절차 가. 기존사용하던 2.6.x, 3.0 버전의 Agent 백업후 3.2 디렉토리생성 SMSPlus3.2 설치후정상동작하지않을경우백업한 Agent 로복원하여 SMS 서비스를원활 히제공하기위함 버전별디렉토리를따로유지합니다. 나. Agent3.2 설치파일다운로드 customer.arreo.com에서 Agent3.2 설치파일을다운로드받음 ( 경로 : 로그인 -> 고객센타 > Agent -> SMSPlus3.2 -> SMSPlus3.2.zip 다운로드 ) 다운로드받은 SMSPlus3.2.zip파일의압축을푼후 Agent.jar 파일이존재하는지확인함 (Agent.jar : SMSPlus3.2 설치파일 ) 다. Agent.jar 설치 페이지 3 / 7
설치를하고자하는디렉토리를생성후해당경로에 Agent3.0 설치함 설치명령어 : java jar Agent.jar 설치명령어실행후 Agent3.0을설치할경로를입력함 정상설치시화면 [sms@apple ARREO]# pwd /svc/arreo [sms@apple ARREO]# [sms@apple ARREO]# java -version java version "1.5.0_02" Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_02-b05) Java HotSpot(TM) Client VM (build 1.5.0_02-b05, mixed mode) [sms@apple ARREO]# [sms@apple ARREO]# java -jar Agent.jar # # WELCOM TO ARREO SMS SERVICE # # EX ) # WINDOW NT : C:\ARREO_SMS_AGENT\ # UNIX, LINUX : /svc/arreo_sms_agent/ # INPUT INSTALL PATH ==> /svc/arreo/arreo_sms_plus/ OK /svc/arreo/smsmt_agt/bin/ Create Directory Now /svc/arreo/smsmt_agt/bin/dbcheck.sh Create File Now /svc/arreo/smsmt_agt/bin/dbcheck_win.bat Create File Now...ommited... /svc/arreo/smsmt_agt/webapp/web-inf/classes/html-status.xsl Create File Now /svc/arreo/smsmt_agt/webapp/web-inf/classes/html-status.xsl.bak Create File Now /svc/arreo/smsmt_agt/webapp/web-inf/classes/xalan-ext.xsl Create File Now /svc/arreo/smsmt_agt/webapp/web-inf/web.xml Create File Now Done... 라. 기존사용하던 Agent 의 conf/arreo.conf 파일을참고하여 SMSPlus3.2 의 conf/arreo.conf 파일에설 정값입력 마. Agent Server 와 DB Server 의변동이없을경우기존 Agent 의설정값을복사하여그대로사용함 반드시설정값만을복사하여사용하십시오 바. 필수입력사항 i. SMS 인증정보입력 (MEMBER_ID, AUTH_SEQ, SERVICE_CODE) MEMBER_ID, AUTH_SEQ : 아레오에서부여받음. 기존인증번호그대로사용가능 SERVICE_CODE : 정산구분용. 기존사용하던코드사용 ii. LMS 인증정보입력 (MMS_AUTH_SEQ) MMS_AUTH_SEQ : 아레오에서부여받음. MEMBER_ID 는 SMS 와동일한값을사용하며, LMS 서비스사용시추가인증코드를부여받아야함. 페이지 4 / 7
iii. JDBC 정보입력 기존 2.6.X, 3.0 에서사용하던설정을그대로사용 arreo.conf 파일수정시주의사항 1. AGENT 서비스타입설정 ( 설정값 : AGENT_TYPE ) ArreoSMSPlus 에서는 LMS 기능이탑재되어 SMS 또는 LMS 서비스타입을입력해야함. LMS 로사용시반드시아레오 MMS G/W 방화벽, DB테이블레이아웃확인및 MMS_AUTH_SEQ(MMS 아레오 G/W 인증정보 ) 를셋팅하여야함. 2. SMS Spam 시간설정 ( 설정값 : SMS_DONTSEND_FLAG ) 기존에전송금지시간을설정하여사용하던사용자는반드시전송금지시간을 설정하여서비스에차질이생기지않도록해야함 3. 알람메시지등록 ( 설정값 : ALARM_COUNT ) Agent3.0 이정상작동하지않을경우 SMS 관리자에게알람메세지를전송하여장애를인 식시켜주는기능사용시관리자핸드폰번호입력 4. 전송유효기간설정 ( 설정값 : IGNORE_DATA_HOUR) 현재시간으로부터설정값시간전의 SMS 까지전송. Default = 24 시간 5. SHUTDOWN_PORT 설정 ( 설정값 : SHUTDOWN_PORT) 하나의서버에서 2 개이상의 Agent 를사용할경우각 Agent 마다 SHUTDOWN_PORT 의값을다르게설정하여함 6. DB 인코딩설정 ( 설정값 : CONVERSION_TYPE) DB에서 SMS 전송데이터를 Fetch 할때 CONVERSION_TYPE 설정값에따라인코딩함. DB Server가변경되지않았을경우기존설정값과동일하게사용 3. SMSPlus 3.2 실행 가. SMSPlus3.2 설정값입력후 DB Connection 및 ArreoNetworks Server와 Connection확인 1) DB Connection 확인 i. DBCheck Utility를사용하여 DB Connection 확인 ii. DB Connectoin 확인전에기존 Agent에서사용하던 JDBC Driver와 SMSPlus3.2에서사용하는 JDBC Driver 비교하여사용자 DBMS에맞는 JDBC Driver 버전을선택하여사용 iii. JDBC Driver 버전이맞지않을경우 Error 로그 java.sql.sqlexception: No suitable driver iv. 경로 Windows 계열 : SMSPlus3.2설치 _HOME/bin/dbcheck_win.bat Unix 계열 : SMSPlus3.2설치 _HOME/bin/dbcheck.sh 페이지 5 / 7
DB Connection 이정상일때화면 [sms@apple bin]# [sms@apple bin]#../dbcheck.sh ArreoNetworks, ARREO_SMS_PLUS Version: V3.20.01, DB Check ARREO CONFIG LOAD ---------------------------------[ O K ] The DB_TYPE is ORACLE The DB_DRIVER is oracle.jdbc.driver.oracledriver The DB_CONNECTION_STRING is jdbc:oracle:thin:@127.0.0.1:1521:arreo The DB_USERNAME is arreo The DB_PASSWORD is 1234 The DB_TABLE_NAME is ARREO_SMS DB Connection Check -------------------------[ O K ] JDBC Driver is Registed!!! oracle.jdbc.driver.oracledriver DB CONNECTION SUCCESS!!! Press Enter key Continue [sms@apple bin]# 2) ArreoNetworks Server와의 Connection 확인 Telnet 명령어를통하여 ArreoNetworks Server에접속되는지확인 방화벽확인 SMS 서비스명령어예 ) telnet 210.219.174.189 20001~20005 LMS 서비스명령어예 ) telnet 218.233.240.11 10004 나. SMSPlus3.2 실행 SMSPlus3.2의실행전에는반드시 Agent 2.6.X 혹은 Agent 3.0 버전의 Agent를종료하여주십시오. SMSPlus3.2 의실행시간을반드시메모해두시기바랍니다. 1) SMSPlus3.2 실행파일 Windows 계열 : SMSPlus3.2_HOME/bin/start_win.bat Unix 계열 : SMSPlus3.2_HOME/start.sh 2) 로그파일확인 Windows 계열 : SMSPlus3.2_HOME/bin/view_win.bat Unix 계열 : SMSPlus3.2_HOME/view.sh 다. SMSPlus3.2 실행후정상작동확인 SQL 문 1) SMSPlus3.2 을기동한후에는아래의 SQL 문으로 Agent 가정상작동하는지확인하여주십시 오. -- 최근 10 분동안의 SMS/LMS 미전송건수확인 select count(cmp_msg_id) 페이지 6 / 7
where snd_dttm between ' 현재날짜 (yyyymmddhhmiss) - 10 분 ' and ' 현재날짜 (yyyymmddhhmiss)' and sms_st = '0'; 데이터건수가줄거나늘거나하지않고계속증가할경우아레오로연락 -- 최근 10분동안의 SMS/LMS 미전송데이터확인 select cmp_msg_id, sms_st, rslt_val, snd_dttm, cmp_snd_dttm, snd_msg where snd_dttm between ' 현재날짜 (yyyymmddhhmiss) - 10분 ' and ' 현재날짜 (yyyymmddhhmiss)' and sms_st = '0'; -- 최근 10분동안의 SMS/LMS 전송결과값미수신건수확인 select count(cmp_msg_id) where snd_dttm between ' 현재날짜 (yyyymmddhhmiss) - 10분 ' and ' 현재날짜 (yyyymmddhhmiss)' and sms_st <> '0' and rslt_val = 99; 데이터건수가줄거나늘거나하지않고계속증가할경우아레오로연락 -- 최근 10분동안의 SMS/LMS 전송결과값미수신데이터확인 select cmp_msg_id, sms_st, rslt_val, snd_msg where snd_dttm between ' 현재날짜 (yyyymmddhhmiss) - 10분 ' and ' 현재날짜 (yyyymmddhhmiss)' and sms_st <> '0' and rslt_val = 99; 페이지 7 / 7