¶ 1. PUSH 시스템
¶ 1.1 시스템 구성도
본 구성도는 일반적인 PUSH 주요 시스템에 대한 구성도를 작성한 것이며, 해당 구성도에 시스템 운영관리, PUSH등 업무지원을 위한 영역은 본 구성도에서는 별도로 표시하지 않았습니다.
| 약어 | 설명 |
|---|---|
| UPMC | Uracle Push Message Center |
| APNS | Apple Push Notification Service |
| FCM | Firebase Cloud Messaging |
¶ 1.2 서비스 기동/종료 순서
- 서비스 기동 순서 DB ☞ Redis & Redis-sentinal ☞ Provider ☞ UPMC ☞ Admin
- 서비스 종료 순서 Admin ☞ UPMC ☞ Provider ☞ Redis & Redis-sentinal ☞ DB
Redis sentinal 구조에서 Redis kill 순서: sentinal -> slave -> master
¶ 1.3 시스템 체크 리스트
¶ 1.3.1 ADMIN 서버 상태 및 구동 확인
- Tomcat 컨테이너가 정상 구동되는 중인지 확인합니다.
- 웹 브라우저에서 {Admin접속URL}를 호출하여 아래와 같은 결과가 표시되는지 확인합니다.
¶ 1.3.2 UPMC 서버 상태 및 구동확인
- Tomcat 컨테이너가 정상 구동되는 중인지 확인합니다.
- 웹브라우저에서 {UPMC접속URL} 호출 시 “접근이 허용되지 않는 접근입니다.” 로 표기 되는지 확인합니다.
¶ 1.3.3 Redis 프로세스 확인
- 아래 명령어를 입력하여 구동 여부를 확인합니다.
ps -ef | grep "redis-server" | grep -v grep
- 아래 명령어를 입력하여 해당 PORT가 LISTEN 상태인지 확인합니다.
netstat -an | grep ":6379" | grep LISTEN
¶ 1.3.4 Provider 프로세스 확인
- 아래 명령어를 입력하여 구동 여부를 확인합니다.
- 예시) provider-5.1.8-R6.jar 버전을 사용하는 경우 해당되는 명령어입니다. 사용하시는 버전의 Provider 실행 파일명을 입력하셔야 합니다.
ps -ef | grep "provider-5.1.8-R6.jar" | grep -v grep
- 아래 명령어를 입력하여 해당 PORT가 LISTEN 상태인지 확인합니다.
netstat -an | grep ":10420" | grep LISTEN
Provider 실행 PORT가 10420이 아닐 수 있으므로 PORT 확인이 필요합니다.
¶ 2. 서버 별 상세설명
¶ 2.1 Admin (PUSH 관리자 서버)
- Admin 서비스 운영자가 고객들에게 Push 메시지를 전송하기 위해 메시지를 작성, 발송 요청 등의 작업을 수행하는 Push 발송 관리 시스템입니다.
- Admin에 접속 하기 위해서는 Web Browser를 통해 주소를 직접 입력하여 접속할 수 있습니다.
- 단, Admin의 관리자 계정을 신규로 등록하기 위해서는 계정 생성권한이 있는 관리자계정으로 접속하여 신규로 접속하려는 계정을 추가해야 합니다.
Admin 서비스가 운영되는 서버의 주요 모듈은 다음과 같습니다.
| 구분 | |
|---|---|
| DB | Oracle/MySQL/MariaDB/PostgreSQL/MSSQL 등 |
| Admin Service | |
| Morpheus Framework (Spring 기반) | |
| Tomcat 9.0 |
¶ 2.2 UPMC (PUSH 메시지 센터)
- UPMC 는 기간계 시스템 / Mobile Client와 Push Db 간의 인터페이스를 담당합니다.
- UPMC은 Spring framework에서 동작하는 Spring Controller, DAO, Quartz scheduler로 구성되어 웹 서비스 형태의 외부 인터페이스를 제공합니다.
- PUSH 유저 등록/삭제, PUSH 발송, 수신확인, 읽음확인 등 API형태의 인터페이스를 제공합니다.
UPMC 서비스가 운영되는 서버의 주요 모듈은 다음과 같습니다.
| 구분 | |
|---|---|
| DB | Oracle/MySQL/MariaDB/PostgreSQL/MSSQL 등 |
| UPMC Service | |
| Morpheus Framework (Spring 기반) | |
| Tomcat 9.0 |
¶ 2.3 Redis (PUSH 메모리 서버)
- Redis는 PUSH 사용자 정보 등을 메모리에 올려 DB access를 최소화하여 발송 퍼포먼스를 올리는 역할을 합니다.
Redis서비스의 서버 기본 디렉토리는 {Redis설치경로}이며 해당 디렉토리와 주요 하위 디렉토리의 내용은 다음과 같습니다.
| 디렉토리 | 설명 |
|---|---|
| src | Redis소스 |
| logs | Redis 로그 |
¶ 2.4 Provider (Public PUSH 발송 전용 데몬)
-
Provider는 Receiver가 보낸 Push 메시지를 APNS, FCM을 통해 전송하는 발송 전용 시스템입니다.
-
Provider는 WAS가 아닌 단독JAVA application으로 JVM위에 실행됩니다.
-
Provider서비스가 운영되는 서버의 주요 모듈은 다음과 같습니다.
| 구분 |
|---|
| Provider Service |
| Morpheus Framework (Netty 기반) |
| JAVA 1.8 버전 이상 |
Provider서비스의 서버 기본 디렉토리는 {Provider설치경로}이며 해당 디렉토리와 주요 하위 디렉토리의 내용은 다음과 같습니다.
| 디렉토리 | 설명 |
|---|---|
| conf | Provider 설정 파일, 라이선스 저장 |
| logs | Provider 로그 |
| target | Provider 실행파일 및 라이브러리 |
¶ 3. 설정파일
¶ 3.1 Admin (PUSH 관리자 서버)
Admin서비스에 사용되는 설정 파일은 다음과 같습니다.
- 로그 설정 파일: {Admin설치경로}/WEB-INF/config/log4j.xml
- 서비스 설정 파일: {Admin설치경로}/WEB-INF/classes/config/msp.xml
¶ 3.2 UPMC (PUSH 메시지 센터)
UPMC 서비스에 사용되는 설정 파일은 다음과 같습니다.
- 로그 설정 파일: {UPMC설치경로}/WEB-INF/classes/logback.xml
- 서비스 초기 설정 파일: {UPMC설치경로}/WEB-INF/classes/config/receiver.properties
- 서비스 기능 설정 파일: {UPMC설치경로}/WEB-INF/classes/config/daemon.properties
¶ 3.3 Redis (PUSH 메모리 서비)
Redis서비스에 사용되는 설정 파일은 다음과 같습니다.
- 설정 파일: {Redis설치경로}/redis.conf
¶ 3.4 Provider (Public PUSH 발송 전용 데몬)
Provider서비스에 사용되는 설정 파일은 다음과 같습니다.
- 설정 파일: {Provider설치경로}/conf/config.properties
- 로그 설정 파일: {Provider설치경로}/conf/logback.xml
¶ 4. Redis 정보 확인 가이드
¶ 4.1 Master / Slave 정보 확인
Redis Console 접속을 위하여 아래의 명령어를 입력합니다.
cd {Redis설치경로}
./redis-cli.sh
Redis Console 접속 후 아래의 명령을 입력하여 정보를 확인합니다.
info
| 접속 및 조회 예. Was #1) | 접속 및 조회 예. Was #2) |
|---|---|
| [service@was1 redis]$ ./redis-cli.sh 127.0.0.1:6379> info … (중략) # Replication role:master connected_slaves:1 slave0:ip=222.107.91.59,port=6379,state=online,offset=560516525,lag=1 master_repl_offset:560516948 repl_backlog_active:1 repl_backlog_size:1048576 repl_backlog_first_byte_offset:559468373 repl_backlog_histlen:1048576 … (중략) 127.0.0.1:6379> exit |
[service@was2 redis]$ ./redis-cli.sh 127.0.0.1:6379> info … (중략) # Replication role:slave master_host:222.107.91.58 master_port:6379 master_link_status:up master_last_io_seconds_ago:0 master_sync_in_progress:0 slave_repl_offset:560516384 slave_priority:100 slave_read_only:1 connected_slaves:0 master_repl_offset:0 repl_backlog_active:0 repl_backlog_size:1048576 repl_backlog_first_byte_offset:0 repl_backlog_histlen:0 … (중략) 127.0.0.1:6379> exit |
※ 한쪽은 role 값이 master이고, 나머지 다른 쪽은 role값이 slave이다. ※ role 값이 master인 경우 접속된 slave 정보를 확인 할 수 있다.
¶ 5. 서비스 장애 처리 절차
¶ 5.1 Admin 페이지가 열리지 않는 경우
- 1.3.1 Tomcat 컨테이너 구동 여부 및 URL 접속 여부 확인이 필요합니다.
- 로그상에 Exception 오류가 있는지 확인이 필요합니다.
¶ 5.2 PUSH 발송 실패가 발생되는 경우
- 1.3.2 참고하여 Tomcat 컨테이너 구동 여부 및 URL 접속 여부 확인이 필요합니다.
- 로그상에 Exception 오류가 있는지 확인이 필요합니다.
- 아래와 같은 로그가 발생하는 경우 UPMC가 Redis에 접속을 하지 못하는 경우를 말합니다. 1.3.3을 참고하여 Redis가 정상 구동되어 있는지 확인이 필요합니다.
Cannot get Jedis connection; nested exception is redis.clients.jedis.exceptions.JedisConnectionException: Could not get a resource from the pool
- 레거시 시스템에서 PUSH 발송 오류가 나는 경우 레거시 시스템 <-> UPMC간 정상적으로 네트워크 연결이 되는지 확인합니다.
- 모든 프로세스가 정상 구동 중임에도 PUSH 발송이 실패하거나 오류가 있는 경우에는 RDB에 접속하여 T_PUSH_FAIL 테이블을 조회 하여 실패 사유에 대한 내용을 6.을 참고하여 유라클에 문의 합니다.
¶ 6. 유라클 기술지원 게시판 이용 안내
자사는 기술지원 게시판을 운영하고 있사오니, 문의사항이 있는 경우 유라클 기술지원 게시판 을 통해 요청 부탁드립니다. 이렇게 게시판 이용을 안내 드리는 이유는 각 담당자들이 외근 또는 프로젝트 수행 중일 경우 연락이 되지 않는 경우가 있기 때문입니다. 기술지원 게시판을 통해 요청을 주시면, 사내 공유가 되므로 더 빠른 지원이 가능합니다.
¶ 6.1 회원가입
상기 회원가입 링크를 통해 가입하시면서 담당하시는 프로젝트 정보를 기입해주시면, 유라클 기술지원 담당자가 요청하신 프로젝트로 매핑 해드립니다.
회원 승인이 완료되면, 사용하시는 이메일로 안내 메일이 전달됩니다.
¶ 6.2 게시글 작성
기술지원 -> 사용하시는 제품에 따라 모피어스 또는 헤카테를 선택하신 후 맨 아래의 글쓰기 버튼을 클릭하시면 됩니다.
게시물 작성시, 문의하시는 프로젝트를 선택 및 필수 정보 작성 후 게시물을 남겨주시면 담당자가 확인 후 답변드립니다.