설치

X-PUSH 설치는 다음 3단계로 이루어집니다.

구동 환경

X-PUSH가 구동되기 위한 환경은 다음과 같습니다.

Minimum System Requirements

JDK(Java Development Kit)

JDK 8

Memory

1 GB RAM

Free disk space

HDD 500 MB

Processor

400MHz CPU

Supported Operating Systems

JVM (Java Virtual Machine)을 실행할 수 있는 대부분의 운영 체제

OS

Linux , Windows , UNIX , macOS

Databases

Oracle

10g, 11g, 12c, 18c, 19c

SQL Server

2008, 2012, 2014, 2016

PostgreSQL

11, 15

Db2

10.5

Tibero

6, 7

firewall

외부에서 X-PUSH 로 접근하기 위해서 방화벽 정책이 필요 (inbound 정책)

50000

웹 브라우저 접속 포트(클라이언트)

50001

전용 브라우저 접속 포트(클라이언트)

50002

provider 접속 포트(메시지 공급)

Java와 환경변수 확인

X-PUSH 서버가 동작하기 위해서는 JDK 1.8.x 이 설치되어 있어야 합니다.

X-PUSH가 HotSpot Server로 실행되기 위하여 JRE가 아닌 JDK를 설치해야 합니다.

java 설치여부와 환경변수 설정은 다음과 같은 방법으로 확인할 수 있습니다.

윈도우 환경에서는 커맨드 창에서 "java –version"을 실행합니다.

java –version

유닉스/리눅스 환경에서는 쉘에서 "java –version"을 실행합니다.

java –version

위와 같이 출력되지 않을 경우 Java를 설치 하여야 합니다.

Java 설치는 https://www.oracle.com/technetwork/java/javase/overview/index.html을 참조합니다.

네트워크 설정

X-PUSH 서버는 하나의 클라이언트 접속에 대해 1개의 네트워크를 사용합니다. 여러 클라이언트가 동시 접속할 수 있도록 하려면 메시지 공급자와 모니터링 접속 등의 소켓이 동시에 연결할 수 있도록 운영체제의 네트워크 관련 속성이 설정되어야 합니다. 윈도우나 리눅스 운영체제의 기본설정 값은 일반적으로 1,000개 정도입니다. 따라서 1,000개 이상의 클라이언트 접속을 지원하려면 반드시 원하는 값으로 설정해주어야 합니다.

네트워크 관련 파라미터 설정방법은 운영체제별로 다르며, 구체적인 설정 방법은 서버관리자에게 문의합니다.

X-PUSH 설치

아래 내용에서는 X-PUSH 서버가 설치된 위치를 운영체제에 상관없이 $XPUSH_HOME으로 표기합니다.

윈도우 환경에서 설치

X-PUSH를 설치할 경로에 xpush-2.8.x.zip 파일 압축을 풉니다.

$xpush-2.8.x/bin/set_xpush.bat 파일을 열어 JAVA_HOME과 XPUSH_HOME을 설정합니다.

set JAVA_HOME=C:\Program Files\Java\jdk1.8.0_XX
set XPUSH_HOME=I:\xpush-2.8.x

환경변수 XPUSH_HOME에 설정되는 값이 C:\xpush-2.8.0\와 같이 “\”로 끝나지 않도록 합니다.

유닉스/리눅스 환경에서 설치

X-PUSH를 설치할 경로에 xpush-2.8.x.tar.gz 파일 압축을 풉니다.

tar zxvf xpush-2.8.x.tar.gz
or
gzip -d xpush-2.8.x.tar.gz
tar xvf xpush-2.8.x.tar.gz

$xpush-2.8.x/bin/set_xpush.sh 파일을 열어 JAVA_HOME과 XPUSH_HOME을 설정합니다.

JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk.x86_64
XPUSH_HOME=/home/xpush/xpush-2.8.0

환경변수 XPUSH_HOME에 설정되는 값이 C:\xpush-2.8.0\와 같이 “\”로 끝나지 않도록 합니다.

X-PUSH 라이선스

X-PUSH 를 구동하기 위해서는 X-PUSH 라이선스가 필요합니다.

X-PUSH 라이선스 파일(X-PUSH_Server_License.xml) 을 $XPUSH_HOME/conf 디렉터리에 복사합니다.

운영체제와 관계없이 conf 디렉터리에 복사합니다.

디렉터리 구성

XPUSH_HOME에 포함된 디렉터리는 아래와 같습니다.

디렉터리

포함된 파일

api

X-PUSH API 관련 라이브러리 파일이 위치합니다.

bin

실행/종료 스크립트 파일이 위치합니다.

conf

X-PUSH 환경설정 파일, 라이센스 파일이 위치합니다.

doc

문서들이 위치합니다.

lib

X-PUSH 실행에 필요한 라이브러리 파일이 위치합니다.

log

X-PUSH 로그 파일이 생성되는 위치입니다.

sample

샘플 코드가 위치합니다.

데이터베이스 테이블 생성

신뢰성 메시지와 Mobile Notification 기능을 사용하기 위해서는 데이터베이스가 필요합니다.

현재 X-PUSH가 지원하는 데이터베이스는 아래와 같습니다.

기본적으로 생성해야 하는 데이터베이스 테이블은 5개입니다. 테이블 생성 쿼리는 아래 파일에서 확인할 수 있습니다.

$XPUSH_HOME\sample\sql\xpush-2.8.x.sql

Database Table

설명

T_TOPIC

사용자의 topic 정보

T_MESSAGE

신뢰성 메시지 정보

T_USER_MESSAGE

사용자의 메시지 상태 관리

T_MOBILE

사용자의 Device Token 정보

T_NOTIFICATION

Mobile notification 이력관리

데이터베이스의 Character Set은 UTF-8 로 설정되어야 합니다.