모바일메시지서비스 안내(문자발송 누리)

NURI / JAVA

※ Nuri 설치가이드는 RDBMS에 관한 기본적 지식을 가진 사람은 누구나 설치 가능하도록 작성되었
습니다. 문서내용을 순서대로 확인하면서 Nuri를 설치하시기를 당부드립니다.
 

문자발송

RDBMS란?

행과 열로 된 2차원의 표로 데이터를 표현하는 데이터베이스 관리 시스템. 대규모 컴퓨터 시스템을
대상으로 많은 이용자가 대량의 데이터를 다룰 때 데이터베이스를 관리하는 시스템으로서, PC용 데이
터베이스에 비해 대량의 데이터를 취급할 수 있고 신뢰성 측면에서도 뛰어난 업무 시스템을 구축할
수 있다. 구조화 조회 언어(SQL)로 작성된 데이터 조작용 명령에 따라 서버상의 데이터를 조작하며, 
수정 등의 명령을 서버로 보낼 수 있는 것이면 어떤 클라이언트에서도 서버의 데이터를 조작할 수 있
다.

Nuri for JAVA 란?

Nuri for JAVA는 모바일메시지서비스의 SMS/MMS G/W 서비스를 사용하기 위한 고객이 고객의
시스템과 쉽게 연동할 수 있도록 도와주는 SMS/MMS G/W 도우미로서, 고객사의 DB 서버 및
JDBC연결이 가능한 시스템에 설치된다.

 

 

 

설치 가능 OS는?

Nuri for JAVA는 JDK 6.0 이상이 운영 가능한 시스템에서 설치하실 수 있으며 JDK는 ORACLE 
( SUN )사 JDK 시스템에서 사용하실 수 있습니다.

설치 가능 RDBMS는?

지원 RDBMS 지원버전 비고
MYSQL 3.23.xx 이상 MYSQL 4.xx.xx이상 최신버전 권장
MSSQL 6.5, 7.0, 2000, 2005, 2008 SP3 설치권장
ORACLE 7i 이상 (8i , 9i, 10g)
반드시 서버버전과 클라이언트 버전이 동일해야 함
INFORMIX 9.x 이상 최신버전 권장
DB2 9.xx 이상 최신버전 권장
SYBASE 15 이상 최신버전 권장
CUBRID 7.3, 2008 R1.0, 2008 R2.0 최신버전 권장
TIBERO 4 SP1 이상 최신버전 권장

ALTIBASE 5.3.3 이상 최신버전 권장
ALTIBASE는 지원 버전 별 JDBC 가 호환이 안되어 해당 설치된 ALTIBASE에
서 JDBC를 찾아서 nuri.jar 에 포함하여 사용해야 합니다.
각 버전 별 JDBC는 ALTIBASE 서버 담당자한테 확인하시기 바랍니다.

 

 

 

[참고] 
1.1. RDBMS 서버의 위치는 리모트인 경우는 RDBMS가 설치된 운영체제(OS)와는 상관이 없습니다. 
1.2. Nuri 설치서버에 각 RDBMS 클라이언트 설치 및 설정이 필요합니다. (JDBC 포함)
1.3. RDBMS가 Nuri와 같은 시스템에 설치, 운영이 된다면 별도의 클라이언트 프로그램이 필요하지
않을 수도 있습니다. 단, 서버 설치 시 JDBC 드라이브 부분이 설치가 되어 있어야 합니다.
 
설치 전 확인사항
1.4.1. DB 설정 및 RDBMS Client 설치 확인
Nuri는 고객사의 DB에 접속하여 전송, 결과 및 MMS 테이블을 생성합니다.
Nuri를 설치하기 전 Database, DB User를 우선 생성하셔야 합니다. (각 DBMS 매뉴얼 및 책자 참조)

 

 

 

RDBMS Nuri for JAVA – Installation

(UNIX, LINUX)
2.1. 필요 S/W: Nuri for JAVA용 Package, DATABASES
2.2. 다운로드한 Nuri 파일 확인 후, 적당한 위치에 압축을 해제합니다.
Nuri 파일형식 예: nuri_for_java_yyyymmdd.tgz 또는 nuri_for_java_yyyymmdd.zip
로그 폴더와 MMS콘텐츠 폴더는 자동으로 생성이 됩니다.
위치를 변경하고자 하는 경우에는 nuri.conf를 수정하여 주십시오.
설치된 파일들의 사이즈는 Nuri파일의 버전에 따라 다를 수 있습니다.
2.3. JDBC 드라이버 설치 및 DB 설정
Nuri는 Java의 JDBC를 사용합니다.
자바 프로그램 내에서 데이터베이스 질의문 즉, SQL을 실행하기 위한 자바 API(application programming interface)입니다. Java database connectivity의 약자로 생각하기도 하지만 실제로는 상표 이름입니다. JDBC는 데이터베이스 및 애플리케이션 개발자들을 위한 표준 API를 제공하고 순수 자바 API만으로도 데이터베이스 응용업무를 만들게 해 줍니다.
JDBC를 사용하면, 어떠한 관계 데이터베이스(relational database)에서도 SQL문을 사용하기 쉽습니다. 즉, JDBC API를 사용하면 데이터베이스에 접근하는 프로그램을 따로 만들 필요가 없습니다. 단지 하나의 프로그램을 작성하고 그 프로그램에서 SQL문을 적당한 데이터베이스에 전송할 수 있습니다
또한 응용업무를 자바로 작성한다면 보유한 기종이나 소프트웨어에 따라 다르게 작성하지 않아도 되기 때문에 자바와 JDBC의 결합은 하나의 프로그램이 어디에서나 동작할 수 있게 해 줍니다. 자바는 사용하기에 견고하고 안전하고 쉽고 이해하기 쉬우며 데이터베이스 응용업무를 만드는 데 있어서 최적의 언어라 할 수 있습니다. 단지 필요한 것은 다양한 데이터베이스에 연결하는 방법일 것이라고 할 수 있으며, JDBC는 이러한 것을 위한 도구입니다.
2.4.. JDBC 드라이버 설치
사용자 설명서를 참조합니다.
2.5. 2번과 같이 다운로드한 Nuri파일의 압축을 풀었다면, nuri.conf.sample 파일을 nuri.conf 
로 변경 혹은 copy 하여, 내용을 수정합니다.

2.6. Nuri Log 파일 확인
- Nuri Log 파일은 동작 내용 및 에러 로그 수집을 위해 일자 별로 지정된 디렉터리에 생성됩니다.
생성되는 위치는 nuri.conf 파일의 log_path에서 설정하실 수 있습니다.
- SMS Gateway접속 오류 및 DB오류가 연속적으로 발생할 경우 Nuri 정상 설치 여부를 확인하셔
야 합니다.
2.7. DB Table 생성 확인
- Nuri 프로그램이 4개의 테이블을 자동 생성합니다.
MSG_DATA, MMS_CONTENTS_INFO, MSG_LOG_YYYYMM, MSG_SPAM
실제 메시지 전송을 하면 이동 통신사로부터 전송 결과를 받아 MSG_DATA와
같은 형식으로 Log Table을 월별 생성합니다.
2.8. DB Table이 정상적으로 생성되었다면 사용자설명서를 참고하여 전송 테스트를 하시면 됩니
다.

 

 

 

RDBMS Nuri for JAVA – Installation

(Windows / NT)
3.1. 필요 S/W: Nuri for JAVA용 Package, DATABASES
3.2. 다운로드한 Nuri 파일 확인 후, 적당한 위치에 압축을 해제합니다.
Nuri 파일형식 예: nuri_for_java_yyyymmdd.tgz 또는 nuri_for_java_yyyymmdd.zip 
로그 폴더와 MMS콘텐츠 폴더는 자동으로 생성이 됩니다.
위치를 변경하고자 하는 경우에는 nuri.conf를 수정하여 주십시오.
설치된 파일들의 사이즈는 Nuri파일의 버전에 따라 다를 수 있습니다.
(설치가이드에서는 D:\NURI\ 를 예로 설명하겠습니다.)
3.3. JDBC 드라이버 설치 및 DB 설정
Nuri는 Java의 JDBC를 사용합니다.
자바 프로그램 내에서 데이터베이스 질의문 즉, SQL을 실행하기 위한 자바 API(application programming interface)입니다. Java database connectivity의 약자로 생각하기도 하지만 실제로는 상표 이름입니다. JDBC는 데이터베이스 및 애플리케이션 개발자들을 위한 표준 API를 제공하고 순수 자바 API만으로도 데이터베이스 응용업무를 만들게 해 줍니다.
JDBC를 사용하면, 어떠한 관계 데이터베이스(relational database)에서도 SQL문을 사용하기 쉽습니다. 즉, JDBC API를 사용하면 데이터베이스에 접근하는 프로그램을 따로 만들 필요가 없습니다. 단지 하나의 프로그램을 작성하고 그 프로그램에서 SQL문을 적당한 데이터베이스에 전송할 수 있습니다
또한 응용업무를 자바로 작성한다면 보유한 기종이나 소프트웨어에 따라 다르게 작성하지 않아도 되기 때문에 자바와 JDBC의 결합은 하나의 프로그램이 어디에서나 동작할 수 있게 해 줍니다. 자바는 사용하기에 견고하고 안전하고 쉽고 이해하기 쉬우며 데이터베이스 응용업무를 만드는 데 있어서 최적의 언어라 할 수 있습니다. 단지 필요한 것은 다양한 데이터베이스에 연결하는 방법일 것이라고 할 수 있으며, JDBC는 이러한 것을 위한 도구입니다.

3.4. JDBC 드라이버 설치
RDBMS Nuri for JAVA - Installation (UNIX, LINUX) 4번 설명 동일함.
3.5. 2번과 같이 다운로드한 Nuri파일의 압축을 풀었다면, nuri.conf.sample 파일을 nuri.conf로 변경 혹은 copy 하여, 아래내용을 수정합니다.
RDBMS Nuri for JAVA - Installation (UNIX, LINUX) 5번 설명 동일함.
3.6. nuri.conf 정상 수정여부를 CMD(Command Mode)에서 확인합니다.
D:\NURI> java -jar nuri.jar nuri.conf를 실행하여 Exception이 나오지 않으면 정상적으로 nuri.conf 정보를 수정한 것이고 Exception이 나오면 해당 에러의 로그 부분은 수정하시면 됩니다.

 

3.7. Nuri 실행 파일(jar)을 서비스에 등록 및 시작

- 명령 프롬프트(CMD)를 실행(꼭 관리자 권한으로 실행) 하여 Nuri 파일이 위치한 디렉터리로 이동한 후, 다음을 실행합니다.
- 아래 Nuri 파일이 D:\NURI\ 에 있는 경우에 대한 예시입니다.
서비스 등록 방법 (서비스 이름을 Nuri라고 한 경우)
윈도 32bit 시스템의 경우 serviceinstall32.bat를
윈도우 64bit 시스템의 경우 serviceinstall64.bat를 사용하며 아래 설명은 32bit의 시스템으로 설명합니다.
 
serviceinstall32.bat을 notepad로 열고 수정합니다. 
   
1번째 줄 : set JAVA_HOME=자바 JDK를 설치한 폴더의 절대 패스를 기입합니다.
 3번째 줄 : set NURI_HOME=Nuri를 압축 해제한 폴더의 절대 패스를 기입합니다.
 4번째 줄 : set NURI_SERVICE_NAME=서비스에서 사용할 Nuri 명을 기입합니다.
 6번째 줄 : set NURI_NAME=Nuri 실행 jar 모듈을 기입합니다.
 7번째 줄 : set NURI_CONFIG=Nuri의 nuri.conf 명을 기입합니다.
 
위 사항 중에 기본 적으로 1번째 줄과 3번째 줄을 수정하여 서비스에 등록하면 됩니다.
D:\NURI> serviceinstall32.bat

 

서비스 등록 확인 방법

D:\NURI> sc query “Nuri”
서비스 시작 방법 (서비스 시작은 임의 경로에서 실행하셔도 됩니다)
D:\NURI> net start “Nuri”
서비스 중지 방법
D:\NURI>net stop “Nuri”
서비스 삭제 방법 (서비스 등록 방법에서 서비스 이름을 Nuri라고 한 경우)
serviceuninstall32.bat을 notepad로 열고 아래 처럼를 수정합니다. 
1번째 줄 : set NURI_HOME=Nuri를 압축 해제한 폴더의 절대 패스를 기입합니다.
2번째 줄 : set NURI_SERVICE_NAME=서비스에 등록한 Nuri명을 기입합니다.

 

서비스 등록 현황은 [제어판] -> [관리도구] -> [서비스]에서 확인할 수 있습니다.

 

 

3.8. Nuri 서비스를 시작하였다면 작업관리자에서 프로세스를 확인합니다.
 JavaService32.exe가 실행되어야 합니다.
(윈도 64Bit의 경우는 JavaService64.exe가 실행)

 

3.9. Nuri Log 파일 확인
RDBMS Nuri for JAVA - Installation (UNIX, LINUX) 6번 설명 동일함.
3.10. DB Table 생성 확인
RDBMS Nuri for JAVA - Installation (UNIX, LINUX) 7번 설명 동일함.
3.11. DB Table이 정상적으로 생성되었다면 사용자설명서를 참고하여 전송 테스트를 하시면 됩니다.
3.12. 개별 실행이 이상 없이 완료가 되었다면
 
NURI_QUE 폴더가 생성이 되며
해당 폴더에는 3가지 파일이 아래와 같이 생성이 됩니다.
msgkey.que : 메시지 발송 고유키값 저장 파일
nuri.chk : nuri 모듈 중복 실행 여부 확인 파일
phonecount.que : 하루 수신번호 전송 개수 확인 파일 ( 기본값 하루 10개 )