GATEWAY V2.2 설치 가이드

사 용 권 한

본 문서에 대한 서명은 ㈜유라클 내부에서 본 문서에 대하여 수행 및 유지관리의 책임이 있음을 인정하는 것임.

제.개정 이력

버전

변경일자

제.개정 내용

작성자

1.0

2014.03.18

서버팀

개요

Mobile Server를 설치 전 시스템의 H/W, S/W 요구 사항 및 시스템 환경에 필요한 S/W 설치 및 구성에 대해서 설명한다.

  1. 시스템 요구사항

Mobile Server를 설치하기 위한 시스템의(하드웨어, 소프트웨어) 요구사항이다.

  1. 설치 환경 시스템 요구 사항

  • Mobile Server설치를 위해서 필요한 H/W, S/W는 다음과 같다.

OS

설치 환경

Windows 계열

JDK 1.5 이상

OS 파일 인코딩 UTF-8 권장

설치 환경 하드웨어 요구 사항 및 Mobile Server 지원 환경 참고

Linux, Unix 계열

  1. 설치 환경 하드웨어 요구사항

  • Mobile Server 설치를 위해서 필요한 H/W 다음과 같다.

OS

CPU

RAM Memory

Hard Disc Space

Windows 계열

Pentium 2GHz 이상

2G bytes 이상

100Gbyte 이상 권장 (최소 30Gbyte 이상)

Linux, Unix 계열

Pentium 2GHz 이상

2G bytes 이상

100Gbyte 이상 권장 (최소 30Gbyte 이상)

  1. Mobile Server 지원 환경

  • Mobile Server 설치를 위한 S/W는 다음과 같다.

OS

지원환경

환경

Windows 계열

Windows NT 2003 Server

Windows NT 2008 Server

JDK 1.5, JDK1.6

OS 파일 인코딩 UTF-8 권장

설치 환경 하드웨어 요구 사항 및 Mobile Server 지원 환경 참고

Linux 계열

Redhat Enterprise Linux 3

Redhat Enterprise Linux 4

Redhat Enterprise Linux 5

Unix 계열

Solaris 8, 9, 10

IBM AIX V5.x

OS

HTTP Web Server

WAS

DB

-Windows NT 2003 Server

-Windows NT 2008 Server

-Redhat Enterprise Linux 3

-Redhat Enterprise Linux 4

-Redhat Enterprise Linux 5

-Solaris 8, 9, 10

-IBM AIX V5.x

-Apache 2.2

-Apache 2.4

-IIS 6.0

-IIS 7.0

-WebtoB 4.1

-Tomcat 6.0

-Tomcat 7.0

-Jboss 4.0

-Jboss 5.0

-Jboss 6.0

-Jboss 7.0

-JEUS 5.0

-JEUS 6.0

-WebLogic 10g

-WebLogic 11g

-WebSphere 7.0

-WebSphere 8.0

-Oracle 10g

-Oracle 11g

-MySql

-MS-SQL

  1. 디스크 용량 산정

  • 디스크 용량 산정시 데이터 백업정책에 따라 디스크 요구량이 큰 차이를 가지므로 데이터 백업에 대한 적절한 정책 수립이 필요하다. 다음은 H/W 디스크 용량 산정 근거 내용 이다.

영역

구분

산정근거

비고

DB

데이터량/년

일일평균접속건수 * 평균데이터 사이즈 * 30(일) * 12(개월) + 보정율30%

여유율

성능향상을 위한 여유공간 50%

WAS

시스템S/W 사용량

OS + 어플리케이션(응용 프로그램)

여유율

성능향상을 위한 여유공간 50%

로그 파일 크기/월

일일평균접속건수 * 데이터 사이즈 * 30(일)

-개발 서비스의 사용자수 및 엑세스 빈도를 감안하여 측정

File

리소스 원본 파일 크기/월

월평균 리소스 원본 파일 개수 * 평균 리소스 원본 파일 크기

-서버 이중화 서비스 구성시 파일 동기화를 위해 NAS 또는 SAN 사용 권장

-백업 영역, 파일 시스템 오버헤드, RAID 여유율등 대입하여 추가 산정

리소스 배포 파일 크기/월

평균 리소스 배포 파일 크기 * 월평균 배포 횟수

여유율

성능향상을 위한 여유공간 50%

  • OS 및 기타 유틸리티(응용), SWAP 및 백업 영역에 대한 디스크 용량은 별도로 산정

  1. 라이선스 정책

Mobile Server Platform을 사용하기 위해서는 ㈜유라클 에서 발급하는 라이선스키 파일이 반드시 존재해야 한다. 라이선스키 파일은 클라이언트, 서버 모두 필요하므로 개발용 또는 정식 라이선스를 발급 받기 위해서는 기술지원팀에 문의해야 한다.

  1. 설치

    1. JDK 설치

  1. 자바 공식 홈페이지에서 JDK 설치 파일을 다운로드 받는다.

  1. 다운로드 받은 JDK 설치파일을 실행시켜 해당 디렉토리에 설치를 진행 한다.

    (C:\Java\jdk1.5 폴더 생성 권장)

  1. 환경변수 설정

    1. 내컴퓨터 오른쪽 클릭 > 고급탭 > 환경변수를 클릭한다.

    2. 새로만들기 버튼을 클릭하여 변수값을 입력한다.(예: 변수-JAVA_HOME, 값-C:\Java\jdk1.5\)

    image1

  1. Path 변수 > 편집 > 변수값 > %JAVA_HOME%\bin

    image2

  1. | 이클립스 설치
    1. 이클립스 다운로드

  1. 이클립스 공식 홈페이지에서 이클립스를 다운로드 받는다.(링크:

    *http://www.eclipse.org/downloads/*) - Eclipse IDE for Java EE Developers - Juno Packages

    1. 이클립스에 svn 설치

  1. 이클립스를 실행 하여 상단 메뉴에서 Hello -> Eclipse MarKetplace를 선택한다.

    image3

  1. Eclipse MarKetplace에서 svn을 검색해 나온 subversive – SVN Team

    Provider의 install 버튼을 선택한다.

    image4

  1. 모두 체크하고 Next 버튼을 선택한다.

    image5

  1. 동의 버튼을 선택하고 설치한다. 설치완료 후 재 시작 한다.

    image6

  1. 이클립스 좌측 상단의 Open Perspective 버튼을 선택해서 SVN Repository

    Exploring를 추가한다.

    image7

    image8

  1. 추가와 동시에 install connectors출력되면 svn kit 1.3.8 과 svn kit

    1.7.11 을 선택하고 finish 버튼을 선택한다.

    image9

  1. 모두 체크하고 Next 버튼을 선택한다.

    image10

  1. 동의 버튼을 선택하고 설치한다. 설치완료 후 재 시작 한다.

    image11

  1. 이클립스에 Spring Tool Suite 설치

  1. Eclipse MarKetplace에서 sts을 검색해서 나온 Spring Tool Suite (STS) for Eelipse Juno (3.8 + 4.2)의 install 버튼을 선택한다.

    image12

  1. 모두 체크하고 next 버튼을 선택한다.

    image13

  1. 동의 하고 Finish 버튼을 선택한다.

    image14

  1. 이클립스에 maven 설치

  1. Eclipse MarKetplace에서 maven을 검색해서 나온 Maven Integration for Eclipse( Juno and newer )의 install 버튼을 선택한다.

    image15

  1. 모두 체크하고 install 버튼을 선택한다.

    image16

  1. 동의하고 finish버튼을 선택한다.

    image17

  1. 이클립스에 m2e-subclipse 설치

  1. 이클립스 좌측 상단의 file -> import를 선택한다.

    image18

  1. import화면 에서 Maven -> Check out Maven Projects from SCM을 선택한다.

    image19

  1. Check out Maven Projects from SCM 화면에서 m2e MarKetplace 를 선택한다.

    image20

  1. m2e MarKetplace 화면에서 m2e subversive를 선택하고 Finish버튼을 선택한다.

    image21

  1. 모두 체크하고 Next버튼을 선택한다.

    image22

  1. 동의 하고 Finish버튼을 선택한다.

    image23

  1. Mobile Server 설치

    1. SVN에서 프로젝트 다운로드

  1. 화면 우측상단의 SVN Repofitory Exploring 버튼을 서택한다.

    image24

  1. SVN Repofitory Exploring 화면에서 new Repository location을 선택한다.

    image25

  1. New Repository location화면에 정보를 입력 후 finish 버튼을 선택한다.

    입력 1 : 기술지원팀에 문의하여 svn 주소를 입력한다.

    입력 2 : 기술지원팀에 문의하여 user 정보를 입력한다.

    입력 3 : 기술지원팀에 문의하여 password 정보를 입력한다.

    image26

  1. 새로 추가된 Repository 에서 Check Out 할 프로젝트를 찾아 Check Out Maven project 를 선택한다.

    image27

    image28

  1. 설치 환경 설정

    • 사용할 DB datasource 정보를 Java Resources > src > config > msp.xml 에 적용한다.

    image29

image30

  • 라이선스 키 파일은 모피어스 기술지원팀 에서 받은 서버용 라이센스 키 파일을 WEB-INF/config 디렉토리에 license.key 파일 이름으로 아래와 같이 저장한다.

image31

  1. DB 설치 – 예시) Oracle 설치

    1. 다운로드 및 설치

Oracle 공식 홈페이지에서 다운로드 받는다.(Microsoft Windows(32-bit))

*http://www.oracle.com/technetwork/database/enterprise-edition/downloads/index.html*

  1. Server Platform 용 Database(Oracle) 스크립트 실행

  1. Oracle 설치 후 Tablespace와 계정을 생성한다.

  2. 기본 Table Schema 를 설치한다. - msp-r2-2.0.x_ddl_oracle.sql 실행

  3. 초기 데이터 설정을 위해 DML 문을 실행한다 – msp-r2-2.0.x_dml_oracle.sql 실행

    1. Tomcat 설치

  1. Tomcat 다운로드 *http://tomcat.apache.org/download-60.cgi* 주소로 이동하여 해당 설치 파일을 다운로드 한다.(32-bit Windows zip)

    image32

  1. 해당 디렉토리에 압축 파일을 푼다.(예: C:\apache-tomcat\)

    image33

  1. C:\apache-tomcat\conf\Catalina\localhost\ROOT.xml 파일을 생성해서 웹 루트 디렉토리를 서버 소스 파일의 WebContent 로 설정한다.

    1. 기동 확인

  1. C:\apache-tomcat\bin\startup.bat 실행

  2. 브라우저(Webkit 기반 브라우저 크롬 또는 IE9 이상)에서 *http://localhost:8080/* 접속 하여 아래와 같이 확인한다.

image34

  1. 기타 개발환경 설정

    1. Mobile Server 환경 설정

Mobile Server는 추가적으로 설정 파일 (WEB-INF/classes/config/ msp.xml) 이 필요하다.

환경 설정 변수명

내용

datasource. dbtype

Orcle, oracle9i, mssql, mysql,

연결할 DB 종료 셋팅

mybatis.msp.mobile.mapperLocation

classpath:kr/msp/sqlmap/${datasource.dbtype}/**/*.xml

(수정불가)msp Mybatis mapper 경로

mybatis.msp.mobile. mapperLocation2

WEB-INF/sqlmap /**/*.xml

Nagacy DB Mybatis mapper 경로

server.eventlog.use

true

모바일 통계

server.eventlog .save_path

/home/uracle/msp-server/eventlogs/

모바일 통계 사용유무

resource. download_url

리소스 배포할 서버가 따로 존재할경우 해당 리소스배포서버 URL정보를 넣어준다. 만약, 리소스배포파일서버가 따로 없다면 빈값으로 넣어야함

store. Service.url

http://211.241.199.217:18080/msp-admin/

스토어에서 배포한 앱을 다운받을수 웹어드민 URL 주소 이주소는 Admin페이지 주소 + ContextRoot로 하면됨

store.path.apk

apk

스토어 설치 바이너리가 들어가 폴더명

store. upload.. absolute_path

/home/uracle/msp-server/tomcat6/webapps/msp-admin/

스토어에서 배포할 앱이 저장될 물리적인 디렉토리 경로인데 해당 웹서버의 루트디렉토리로 설정 즉 웹서버 WEB-INF가 있는 부모디렉토리 풀경로적으면됨

  1. 배포

  1. 이클립스에서 WAR 파일로 배포하여 다음과 같이 로컬에서 확인할 수 있다.

  2. 프로젝트에서 Export > WAR file 을 선택하여 배포본을 생성한다.

    image35

  1. WAR 파일이 생성될 경로를 입력 또는 선택 하여 ROOT.war 파일을 생성한다.

    image36

  1. Tomcat Manager(http://localhost:8080/manager/) 로 접속 하여 해당 ROOT.war 파일을 배포 한다. (WAS 배포 웹 관리자의 사용법은 해당 제품 홈페이지를 참고하도록 한다.)

    image37

  1. 다시 WAS(Tomcat) 을 기동 한다.

    image38

  1. 웹 어드민에 접속하여 확인한다.