UPMC 설치가이드¶

1. 개요¶

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

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

2. 설치 준비¶

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

항목

설명

비고

Database

Oracle 9i 이상, MS-SQL, MySql

Java

Java version 1.8

WAS

Tomcat 8.0 or better

3. 설치 절차¶

다음 각 설치 항목 순으로 설치한다.

3-1. UPMC¶

UPMC는 기간계/Mobile Client와 Push DB간의 인터페이스를 담당한다. UPMC는 Spring framework에서 동작하는 Spring Controller, DAO, Quartz scheduler로 구성되어 웹서비스 형태의 외부 인터페이스를 제공한다.

UPMC 설치는 UPMC 항목 하나만 설치한다.

4. UPMC 설치¶

4-1. 설치 전 준비¶

UPMC를 설치 하기 전 다음 각 항목을 준비한다.

Java가 설치되어 있는 리눅스/유닉스 시스템

version 1.6 이상의 Java 실행환경

로그인 가능한 리눅스/유닉스 계정

WAS (Tomcat, Jeus, …), 본 문서는 Tomcat 기준으로 작성되었습니다.

설치 파일(upmc-5.xx.xx-ee.war의 형태로 제공)

4-2. 설정 파일 편집¶

설치에 앞서 UPMC 설정 파일을 편집한다. war 파일로 배포할 경우는 war파일을 만들기에 앞서 설정 파일을 편집한 후 war파일을 묶어 WAS에 배포하며 이미 묶여져 있는 war 파일을 WAS의 배포 디렉토리에 풀어서 배포할 경우는 war내의 설정 파일들을 직접 수정하여 배포한다. WAS의 배포 디렉토리에 풀어서 배포할 경우는 “4-3 UPMC 설치” 중 UPMC 빌드 항목은 실행하지 않는다.

UPMC는 daemon.properties, receiver.properties, logback.xml을 수정하여 설정을 변경한다.

4-2-1. daemon.properties¶

daemon.properties는 src/main/resources/spring에서 찾을 수 있다.

daemon.properties (수정 필요한 부분만 예시한다.)

PUBLIC.PROVIDER.IP = 211.241.199.139

PUBLIC.PROVIDER.PORT =10420

##주의! 이중화 되어 있을경우 예약발송 메세지 발송 서버를 하나만 true로 해 준다.

RESERVEMSG.SEND = true

####이부분 부터 Daemon이 사용. 길이가 18자 이상은 안됨.

MQTT.AGENTID = UPMC_139

# 보내지 못한 큐에 담긴 메세지 종료시 Disk에 저장

QUEUE.SAVE.SRC = /Users/mium2/project/push/push-5.0-EE/UPMC/trunk/data

# 예약발송 메세지 정보 Disk에 저장

RESERVE.SAVE.SRC = /Users/mium2/project/push/push-5.0-EE/UPMC/trunk/data/

## ContextRoot가 있으면 ContextRoot까지 적어주세요.마지막 /빼세요

ADMIN_RESPONSE_HOSTURL = http://211.241.199.139:8080/upmc

FORCE_KILL_LOG_DIR = /Users/mium2/project/push/push-5.0-EE/UPMC/trunk/data/queueData/

4-2-2. receiver.properties¶

receiver.properties는 src/main/resources/spring에서 찾을 수 있다.

receiver.properties (수정 필요한 부분만 예시한다.)

DBTYPE=oracle

PUSH.database.jndiname=jdbc/msp_oracle

# REDIS 설정

redis.master.hostName=211.241.199.215

redis.master.port=6379

redis.master.database=5

#REDIS-SENTINEL 설정

sentinel.ip1=211.241.199.58

sentinel.port1=26379

sentinel.ip2=211.241.199.59

sentinel.port2=26379

sentinel.ip3=211.241.199.69

sentinel.port3=26379

tempDirectory=/service/test/logs/data/temp

baseDirectory=/service/test/logs/data/base

workDirectory=/service/test/logs/data/work

doneDirectory=/service/test/logs/data/done

4-2-3. logback.xml¶

<fileNamePattern></fileNamePattern> 에 정의 되어 있는 로그 경로를 원하는 경로로 수정

4-2-4. application-context.xml¶

application-context.xml (수정 필요한 부분만 예시한다.)

<!–REDIS Sentinel을 사용할때–>

<!–

<import resource=”sentinel_redis.xml”/>

–>

<!–REDIS Sentinel을 사용하지 않고 마스터 한대만 있을 때–>

<import resource=”none_sentinel_redis.xml”/>

<!–REDIS Cluster를 사용할 때–>

<!–<import resource=”cluster_redis.xml”/>–>

4-3. UPMC 설치¶

UPMC 설치를 위해서는 WAS 환경이 사전 구축되어 있어야 한다. 이 문서에서는 Tomcat을 대상으로 설치 순서를 기술한다. UPMC를 설치하기 위해 다음 각 항목을 순서대로 실행한다.

UPMC 빌드

UPMC 배포

4-3-1. UPMC 빌드¶

UPMC 빌드는 아래 순서를 따른다.

Spring Tool Suite(eclipse)에서 UPMC 프로젝트에 우측클릭하여
표시되는 메뉴에서 “Export…”를 선택한다.

팝업 다이얼로그에서 Web->WAR file을 선택한 후 Next > 버튼을
클릭한다.

Export 팝업 다이얼로그에서 Destination 항목을 지정한다. Destination
파일명은 upmc-5.xx.xx-ee.war로 지정한다. 파일명 지정 후 “Finish” 버튼을 클릭한다.

지정한 위치에 upmc-5.xx.xx-ee.war 파일이 생성된다. 배포시 생성된
upmc-5.xx.xx-ee.war를 사용한다.

4-3-2. UPMC 배포¶

배포 가능한 형태의 .war파일을 UPMC가 설치될 WAS에 배포한다. 각 WAS에 따른 배포 방법은 WAS 마다 정의된 배포 방식을 따르도록 한다.

ex1) Apache Tomcat의 경우 Tomcat의 manager web app을 사용하거나 배포 디렉토리에 .war 파일을 업로드한다.

ex2) WebLogic의 경우 WebLogic에서 제공되는 관리 인터페이스를 통해 .war 파일을 배포한다.

5. 설치 확인¶

배포된 UPMC 웹 어플리케이션은 배포 즉시 WAS의 관리 화면을 통해 설치 여부를 확인할 수 있다.

또는 배포 완료 후 브라우저를 열어 *http://0.0.0.0:8080/upmc/asking_authorization.ctl* 화면을 연다. * 여기서 0.0.0.0:8080은 WAS가 실행되는 IP와 포트이다. 브라우저에 아래와 같은 결과가 표시되는지 확인한다.