=====================================
UPNS SENTMSG LISTENER 설치가이드
=====================================

1. 문서 개요
================

1-1. 목적
----------------

	본 문서는 (주)유라클에서 제공하는 모피어스 제품군 중 “MSP Server
	Platform - Push”의 원활한 설치를 할 수 있도록 제품 설치에 관련한
	설명과 수행 절차를 나타내는 것을 목적으로 한다. 본 문서는 Push 기능
	중 UPNS 설치에 관한 내용을 기술하고 있다.

1-2. 고려 사항
-----------------

	본 문서는 성능 개선, 기능 추가 등의 사항으로 내용이 변경 될 수 있다.


2. UPNS SENTMSG LISTENGER
=========================

2-1. UPNS SENTMSG LISTENGER 설명
--------------------------------

	-  UPNS 가 전송한 PUSH 메시지의 수신확인 정보를 PUSH DB 에 저장한다.

3. 설치 준비
=========================

3-1. 설치 전 필요한 프로그램
--------------------------------

	설치를 하기 전 다음 사항이 준비 되어야 한다.

	+----------------+------------------+--------+
	| 항목           | 설명             | 비고   |
	+----------------+------------------+--------+
	| 개발툴및유틸   | JAVA 1.6.0\_26   |        |
	+----------------+------------------+--------+

4. UPNS SENTMSG LISTENGER 설치
==================================

4-1. UPNS SENTMSG LISTENGER 설치
----------------------------------

	4-1-1. 설치를 할 서버에 로그인

	4-1-2. 설치 파일을 설치할 디렉토리에업로드한다.

		ex) upns-sent-listener-5.xx.xx.tar.gz

	4-1-3. 압축을 해제한다.

		ex) tar xvzf upns-sentmsg-listener-5.xx.xx.tar.gz

4-2. UPNS SENTMSG LISTENGER 파일 목록
------------------------------------------------

	+--------------------+--------------------+
	| **파일 경로**      | **설명**           |
	+====================+====================+
	| conf/config.xml    | Upns SL 설정파일   |
	+--------------------+--------------------+
	| conf/logback.xml   | Upns SL 설정파일   |
	+--------------------+--------------------+

5. UPNS SENTMSG LISTENGER의 실행
================================

5-1. 서버 Config파일 설정
--------------------------------

	5-1-1. 서버 기본 설정
	    $ vi conf/config.xml

	+-----------------------------------------------------------------------------------+
	| <?xml version=\ *"1.0"* encoding=\ *"UTF-8"*?>                                    |
	|                                                                                   |
	| <configuration>                                                                   |
	|                                                                                   |
	| <!— upns 서버 정보 -->                                                            |
	|                                                                                   |
	| <upns>                                                                            |
	|                                                                                   |
	| <ip>upns\_ip</ip>                                                                 |
	|                                                                                   |
	| <port> upns\_port</port>                                                          |
	|                                                                                   |
	| <pingterm>5</pingterm>                                                            |
	|                                                                                   |
	| </upns>                                                                           |
	|                                                                                   |
	| <!--                                                                              |
	|                                                                                   |
	| *<dbtype>*\ oracle\ *</dbtype>*                                                   |
	|                                                                                   |
	| *<jdbc>*                                                                          |
	|                                                                                   |
	| <driverClassName>oracle.jdbc.OracleDriver</driverClassName>                       |
	|                                                                                   |
	| *<url>*\ jdbc:oracle:thin:@oracle\_ip:oracle\_port:oracle\_db\ *</url>*           |
	|                                                                                   |
	| *<username>oracle\_id</username>*                                                 |
	|                                                                                   |
	| <password> *oracle\_pw*\ </password>                                              |
	|                                                                                   |
	| *</jdbc>*                                                                         |
	|                                                                                   |
	| -->                                                                               |
	|                                                                                   |
	| <dbtype>*mysql*\ </dbtype>                                                        |
	|                                                                                   |
	| <jdbc>                                                                            |
	|                                                                                   |
	| <driverClassName>com.mysql.jdbc.Driver</driverClassName>                          |
	|                                                                                   |
	| <url>jdbc:mysql://mysql\_ip:mysql\_port/mysql\_db?characterEncoding=UTF-8</url>   |
	|                                                                                   |
	| <username>mysql\_id</username>                                                    |
	|                                                                                   |
	| <password>mysql\_pw</password>                                                    |
	|                                                                                   |
	| </jdbc>                                                                           |
	|                                                                                   |
	| <!--변경하지 마세요-->                                                            |
	|                                                                                   |
	| <listener>                                                                        |
	|                                                                                   |
	| <id>SYS\_SENT\_LISTENER1</id>                                                     |
	|                                                                                   |
	| <subscribe>UPNS-SENT</subscribe>                                                  |
	|                                                                                   |
	| <dbUpSleeptime>30</dbUpSleeptime>                                                 |
	|                                                                                   |
	| </listener>                                                                       |
	|                                                                                   |
	| </configuration>                                                                  |
	+===================================================================================+
	+-----------------------------------------------------------------------------------+


	5-1-2. Logback 설정
		
	$ vi conf/logback.xml

	+--------------------------------------------------------------------------------------------+
	| <?xml version=\ *"1.0"* encoding=\ *"UTF-8"*?>                                             |
	|                                                                                            |
	| <configuration scan=\ *"true"* scanPeriod=\ *"60 seconds"*>                                |
	|                                                                                            |
	| <appender name=\ *"SERVER"* class=\ *"ch.qos.logback.core.rolling.RollingFileAppender"*>   |
	|                                                                                            |
	| <prudent>true</prudent>                                                                    |
	|                                                                                            |
	| <rollingPolicy class=\ *"ch.qos.logback.core.rolling.TimeBasedRollingPolicy"*>             |
	|                                                                                            |
	| <fileNamePattern>./log/logFile.%d{*yyyy*-MM-*dd*-HH}.log</fileNamePattern>                 |
	|                                                                                            |
	| <maxHistory>3</maxHistory>                                                                 |
	|                                                                                            |
	| </rollingPolicy>                                                                           |
	|                                                                                            |
	| <encoder>                                                                                  |
	|                                                                                            |
	| <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %class - %\ *msg*\ %n</pattern>               |
	|                                                                                            |
	| </encoder>                                                                                 |
	|                                                                                            |
	| </appender>                                                                                |
	|                                                                                            |
	| <appender name=\ *"STDOUT"* class=\ *"ch.qos.logback.core.ConsoleAppender"*>               |
	|                                                                                            |
	| <layout class=\ *"ch.qos.logback.classic.PatternLayout"*>                                  |
	|                                                                                            |
	| <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %class - %\ *msg*\ %n</pattern>               |
	|                                                                                            |
	| </layout>                                                                                  |
	|                                                                                            |
	| </appender>                                                                                |
	|                                                                                            |
	| <!--<logger name="java.sql.Connection">-->                                                 |
	|                                                                                            |
	| <!--<level value="DEBUG" />-->                                                             |
	|                                                                                            |
	| <!--<appender-*ref* *ref*\ ="STDOUT" />-->                                                 |
	|                                                                                            |
	| <!--</logger>-->                                                                           |
	|                                                                                            |
	| <!--<logger name="java.sql.Statement">-->                                                  |
	|                                                                                            |
	| <!--<level value="DEBUG" />-->                                                             |
	|                                                                                            |
	| <!--<appender-*ref* *ref*\ ="STDOUT" />-->                                                 |
	|                                                                                            |
	| <!--</logger>-->                                                                           |
	|                                                                                            |
	| <!--<logger name="java.sql.PreparedStatement">-->                                          |
	|                                                                                            |
	| <!--<level value="DEBUG" />-->                                                             |
	|                                                                                            |
	| <!--<appender-*ref* *ref*\ ="STDOUT" />-->                                                 |
	|                                                                                            |
	| <!--</logger>-->                                                                           |
	|                                                                                            |
	| <!--<logger name="java.sql.ResultSet">-->                                                  |
	|                                                                                            |
	| <!--<level value="TRACE" />-->                                                             |
	|                                                                                            |
	| <!--<appender-*ref* *ref*\ ="STDOUT" />-->                                                 |
	|                                                                                            |
	| <!--</logger>-->                                                                           |
	|                                                                                            |
	| <logger name=\ *"server"* level=\ *"INFO"*>                                                |
	|                                                                                            |
	| <appender-ref ref=\ *"STDOUT"* />                                                          |
	|                                                                                            |
	| </logger>                                                                                  |
	|                                                                                            |
	| <!--<root level="DEBUG">-->                                                                |
	|                                                                                            |
	| <!--<appender-*ref* *ref*\ ="STDOUT" />-->                                                 |
	|                                                                                            |
	| <!--</root>-->                                                                             |
	|                                                                                            |
	| </configuration>                                                                           |
	+============================================================================================+
	+--------------------------------------------------------------------------------------------+

6. UPNS SENTMSG LISTENGER 실행
==============================

	    start.sh 스크립트 파일을 실행하여
	    upns-sentmsg-listener-5.xx.xx-ee.jar 를 실행한다.

	    $./start.sh

7. UPNS SENTMSG LISTENGER 중지
==============================

	stop.sh 스크립트 파일을 실행하여 upns-sentmsg-listener-5.xx.xx-ee.jar 를
	중지한다. 

	$./stop.sh

8. UPNS SENTMSG LISTENGER 실행 확인
===================================

	ps–ef \| grep upns 으로 upns-sentmsg-listener-5.xx.xx-ee.jar 가 실행 중인지 확인 할
	수 있다