ADMIN 설치가이드

1. 개요

1-1. 목적

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

1-2. 고려 사항

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

1-3. 참조 문서

  • Google C2DM, GCM 개발 가이드

  • Apple APNS 개발 가이드

2. 설치 준비

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

항목

설명

비고

Database

Oracle 9i 이상, MS-SQL, MySql

Java

Java version 1.6.0_45

WAS

Tomcat 6.0 or better

3. Admin설치

3-1. 설치 전 준비

  • Java를 실행할 수 있는 Unix(Linux)서버에 설치

  • Provider를 실행하기 위한 Unix 계정이 필요

  • 설치 파일(admin.jar의 형태로 제공)

3-2. 설정 파일 편집

3-2-1. database driver 설정(context.xml)

  • Context.xml 파일은 src/main/webapp/META-INF/context.xml 에 위치한다.

  • context.xml

## #################################

# ORACLE 9i R2

## #################################

# admin datebase 설정

<Resource name=”jdbc/msp_oracle9i” auth=”Container” type=”javax.sql.DataSource” driverClassName=”oracle.jdbc.OracleDriver”

url=”jdbc:oracle:thin:@0.0.0.0:1521:DBNAME” username=”id” password=”pw” maxActive=”20” maxIdle=”10” minIdle=”5” maxWait=”-1” />

# push datebase 설정

<Resource name=”jdbc/msp_oracle9i_push” auth=”Container” type=”javax.sql.DataSource” driverClassName=”oracle.jdbc.OracleDriver”

url=”jdbc:oracle:thin:@0.0.0.0:1521:DBNAME” username=”id” password=”pw” maxActive=”20” maxIdle=”10” minIdle=”5” maxWait=”-1” />

## #################################

# MSSQL

## #################################

# admin datebase 설정

<Resource name=”jdbc/msp_mssql” auth=”Container”type=”javax.sql.DataSource” driverClassName=”com.microsoft.sqlserver.jdbc.SQLServerDriver” url=”jdbc:sqlserver://0.0.0.0:1433;DatabaseName=DBNAME;selectMethod=cursor;” username=”id” password=”pw” maxActive=”500” minIdle=”100” maxIdle=”500”

maxWait=”-1” />

# push datebase 설정

<Resource name=”jdbc/msp_mssql_push” auth=”Container” type=”javax.sql.DataSource” driverClassName=”com.microsoft.sqlserver.jdbc.SQLServerDriver” url=”jdbc:sqlserver://0.0.0.0:1433;DatabaseName=DBNAME;selectMethod=cursor;” username=”id” password=”pw” maxActive=”500” minIdle=”100” maxIdle=”500”

maxWait=”-1” />

## #################################

# MYSQL

## #################################

# admin datebase 설정

<Resource name=”jdbc/msp_mysql” auth=”Container”type=”javax.sql.DataSource” driverClassName=”com.mysql.jdbc.Driver” url=”jdbc:mysql://0.0.0.0:3306/DBNAME?characterEncoding=UTF-8”

username=”id” password=”pw” maxActive=”500” minIdle=”100” maxIdle=”500”

maxWait=”-1” />

# push datebase 설정

<Resource name=”jdbc/msp_mysql_push” auth=”Container” type=”javax.sql.DataSource” driverClassName=”com.mysql.jdbc.Driver”

url=”jdbc:mysql://0.0.0.0:3306/DBNAME?characterEncoding=UTF-8”

username=”id” password=”pw” maxActive=”500” minIdle=”100” maxIdle=”500”

maxWait=”-1” />

## #################################

# DB2

## #################################

# admin datebase 설정

<Resource name=”jdbc/msp_db2” auth=”Container” type=”javax.sql.DataSource”

username=”id” password=”pw” driverClassName=”com.ibm.db2.jcc.DB2Driver”

url=”jdbc:db2://0.0.0.0:60006/DBNAME” maxActive=”8” maxIdle=”4” />

# push datebase 설정

<Resource name=”jdbc/msp_db2_push” auth=”Container”

type=”javax.sql.DataSource” sername=”id” password=”pw”

driverClassName=”com.ibm.db2.jcc.DB2Driver” url=”jdbc:db2://0.0.0.0:60006/DBNAME” maxActive=”8” maxIdle=”4” />

3-2-2. 환경 설정(msp.xml)

  • msp.xml

# multi db 설정

# typename : mysql, mssql, oracle, oracle9i, db2

<dbtype>typename</dbtype>

# Receiver 설정

<receiver>

<host>http://reveicer_ip: reveicer_port/msp-push-receiver</host>

</receiver>

3-3. Admin 설치

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

    • Admin 빌드

    • Admin 배포

    2.3.3.1 Admin 빌드

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

    • Spring Tool Suite(eclipse)에서 Admin프로젝트에 우측클릭하여

      표시되는 메뉴에서 “Export…”를 선택한다.

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

      클릭한다.

image1

  • Export 팝업 다이얼로그에서 Destination 항목을 지정한다. Destination

    파일명은 admin.war로 지정한다. 파일명 지정 후 “Finish” 버튼을 클릭한다.

image2

  • 지정한 위치에 admin.war 파일이 생성된다. 배포시 생성된 admin.war를

    사용한다.

    2.3.2.2 Admin 배포

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

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

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

4. 설치 확인

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

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

    image3