본 문서는 Morpheus Server Platform의 Morpheus GW(Spring Boot)와 Morpues Admin을 Linux 환경 서버에 설치하는 과정을 단계별로 안내합니다.
Morpheus GW (Spring Framework 버전)은 Morpheus GW 설치가이드 참고 부탁드립니다.
설치 전 시스템 요구사항을 충족하는지 확인이 필요합니다. 아래는 기본 요구사항입니다.
Windows, Linux, Unix, Mac OS 등
Cubrid, DB2, Informix, MS-SQL, MySQL, MariaDB, Oracle, PostgreSQL
먼저, 아래의 항목들을 준비합니다
license.key, license.cer)본 설치 가이드에서는
Linux환경에Apache Tomcat,MySQL DB를 기준으로 설명합니다. 다른 WAS나, DBMS를 사용하는 경우, 해당 환경에 맞는 설정이 필요할 수 있습니다.
war 파일 배포다음 방법은 Apache Tomcat의 webapps 디렉토리에 배포하여, Tomcat이 자동으로 애플리케이션을 인식하고 실행하는 과정입니다.
/usr/local/tomcat 또는 /opt/tomcat 등, 실제 Tomcat이 설치된 경로를 뜻합니다.gw.war 및 admin.war는 msp-gw-boot-web-3.x.x.jdk8.war, msp-admin-web-JDK18-4.5.x.war를 말합니다.{Tomcat설치경로}/webapps 밑에 준비한 WAR 파일을 복사합니다.cp gw.war {Tomcat설치경로}/webapps/
cp admin.war {Tomcat설치경로}/webapps/
unzip -d {Tomcat설치경로}/webapps/gw.war
unzip -d {Tomcat설치경로}/webapps/admin.war
WEB-INF/config 디렉토리로 복사합니다.cp license.* {Tomcat설치경로}/webapps/gw/WEB-INF/classes/WEB-INF/config
cp license.* {Tomcat설치경로}/webapps/admin/WEB-INF/config
{Tomcat설치경로}/conf/context.xml을 이용하여 JNDI DB 설정방법 입니다.<?xml version='1.0' encoding='utf-8'?>
<Context>
<!-- msp-admin에서 사용할 JNDI DataSource 설정 -->
<Resource name="jdbc/msp_mysql"
auth="Container"
type="javax.sql.DataSource"
driverClassName="com.mysql.jdbc.Driver"
url="jdbc:mysql://localhost:3306/[Database]?characterEncoding=UTF-8"
username="[DB 사용자]"
password="[DB 비밀번호]"
testOnBorrow="true"
minIdle="5"
maxActive="100"
maxIdle="10"
maxWait="-1"
/>
</Context>
{Tomcat설치경로}/webapps/gw/WEB-INF/classes/application.yml 파일에서 필요한 항목을 수정합니다. 아래는 주요 설정 항목입니다.server:
port: 8080
servlet:
...<중략>...
context-path: /
database: mysql
msp:
gateway:
datasource:
...<선택1>...
jndi-name: jdbc/msp_mysql
...<선택2>...
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mariadb://{사용할 DB URL}:{사용할 DB Port}/{사용할 DB 이름}
username: root
password: 0000
mybatis:
platform: mysql
resource-update:
use-force-https: true
https-port: 443
download-url:
download-type: filename
event-log:
path: /Users/uracle/temp/log/msp-gw/eventlogs/
enabled: true
cron: 0 0/30 * * * ?
app-store:
service-path: http://127.0.0.1/msp-admin/
bin-path: apk
upload-path: /apps/msp-admin/
| 변수명 | 값(예시) | 내용 |
|---|---|---|
| server.port | 8080 | 외부 톰캣을 사용하지 않을 떄, 내장 Tomcat을 사용하는 경우 사용할 서버 포트 설정 필요 |
| server.servlet.context-path | / | 외부 톰캣을 사용하지 않을 떄, 내장 Tomcat을 사용하는 경우 사용할 Context Path 설정 필요 |
| database | oracle,mysql,mssql,db2,informix,oracle9i,postgresql | DBMS |
| msp.gateway.datasource.jndi-name | jdbc/msp_mysql | JNDI 데이터 소스 이름 (선택1) |
| msp.gateway.datasource.driver-class-name | com.mysql.jdbc.Driver | 데이터베이스 연결에 필요한 JDBC 드라이버 클래스를 지정 (선택2) |
| msp.gateway.datasource.url | jdbc:mariadb://localhost:3306/msp_db | 애플리케이션이 연결할 데이터베이스의 URL (선택2) |
| msp.gateway.datasource.username | root | 데이터베이스 접속에 사용할 사용자 이름 (선택2) |
| msp.gateway.datasource.password | 0000 | 데이터베이스 접속에 사용할 패스워드 (선택2) |
| msp.gateway.mybatis.platform | mysql | 사용할 데이터베이스 플랫폼 |
| msp.gateway.resource-update.use-force-https | true | 리소스 업데이트 시 HTTPS 강제 사용 여부를 설정 |
| msp.gateway.resource-update.https-port | 443 | HTTPS 연결을 위한 포트 |
| msp.gateway.resource-update.download_url | yourserver/resources | 리소스 배포 시 파일을 별도의 웹 서버를 통해 서비스 하는 경우 해당 URL을 입력 |
| msp.gateway.resource-update.download-type | filename 또는 file_id | 리소스 배포 방식 |
| msp.gateay.event-log.path | /app/log/msp-gw/eventlogs/ | 모바일 통계 이벤트 로그 저장 경로 |
| msp.gateay.event-log.enabled | true | 모바일 통계 사용유무 |
| msp.gateway.event-log.cron | 0 0/30 * * * ? | 이벤트 로그 저장 주기를 Cron 표현식으로 설정 |
| msp.gateway.app-store.service-path | http://127.0.0.1:18080/msp-admin | 앱스토어를 통해 설치할 앱의 설치 파일을 내려 받을 URL |
| msp.gateway.app-store.upload-path | /app/data/store/ | 앱스토어에 등록된 앱의 설치 파일 저장 경로 |
각 설정항목은 애플리케이션이 배포될 환경에 맞게 수정해야합니다.
JNDI DB 설정의 경우 JNDI 설정 참고 부탁드립니다.
기타 설정은 application.yml 참고 부탁드립니다.
{Tomcat설치경로}/conf/server.xml을 수정하여 'gw' 애플리케이션을 Context 경로 / 으로 실행되도록 설정합니다.WEB-INF/classes/config/msp.xml 내 항목을 아래 설명을 참고하여 설정합니다.| 환경 설정 변수명 | 값(예시) | 내용 |
|---|---|---|
| datasource.dbtype | oracle, oracle9i, mssql, mysql 등 | Admin 서비스에 사용할 DBMS 종류 설정 |
| datasource.dbtype_mobile | oracle, oracle9i, mssql, mysql 등 | 모바일 서비스에 사용할 DBMS 종류 설정 |
| datasource.dbtype_push | oracle, oracle9i, mssql, mysql 등 | PUSH 서비스에 사용할 DBMS 종류 설정 |
| common.dir.root | /app/data/files | msp-admin 데이터 저장 루트 경로 설정 |
| resource.download_url | 리소스 배포 시 파일을 별도의 웹 서버를 통해 서비스 하는 경우 해당 URL을 입력 | 리소스 배포 시 파일을 별도의 웹 서버를 통해 서비스 하는 경우 해당 URL을 입력 |
| store.service.url | http://127.0.0.1:18080/msp-admin | 스토어에서 배포한 앱을 다운받을 수 있는 웹어드민 URL 주소. 이 주소는 Admin 페이지 주소 + ContextRoot로 하면 됨 |
| store.path.img | img | 스토어 앱의 이미지 정보 저장 경로 |
| store.path.bin | apk | 스토어 설치 바이너리 저장 경로 |
| store.upload.absolute_path | /home/uracle/msp-server/tomcat6/webapps/msp-admin/ | 스토어에서 배포되는 앱이 저장될 물리적인 경로 |
{Tomcat설치경로}/conf/server.xml을 수정하여 'admin' 애플리케이션을 Context 경로 /admin 으로 실행되도록 설정합니다.
DB Client를 이용하여, DB에 접속 후 제공받은 Database DDL, DML을 실행, 테이블 및 기초 데이터를 생성 합니다.
Apache Tomcat 서비스를 기동하여, Container 구동을 확인 합니다.{Tomcat설치경로}/bin/shutdown.sh
{Tomcat설치경로}/bin/startup.sh
log/catalina.out)을 확인하여 배포가 정상적으로 이루어졌는지 확인합니다.tail -f {Tomcat설치경로}/logs/catalina.out
msp-gw (/), msp-admin (/admin) 애플리케이션의 정상 동작을 확인 합니다.