"DID ADMIN" 서버 설치를 위해 수행하는 제반 업무에 대한 기술 문서
권장 이외의 환경에서 설치 할 경우에는 반드시 사전 확인이 필요
설치 서버에 DB가 사전 설치되어있어야 하며, 해당 DB에 맞는 HECATE DID DB작업 지원파일 - Database ddl, dml script을 이용하여 테이블 생성 및 기초 데이터를 셋팅
설치 서버의 DB에 맞는 지원파일이 존재하지 않을 경우, 반드시 사전 협의 필요
설치 예시 가이드로
Linux
환경에Apache Tomcat
,Maria DB
를 기준으로 설명
아래의 톰캣 설치, 설정, 배포 경로 등 사용된 정보는 설치 가이드를 위한 예시로써 실제 설치 환경에 맞는 정보로 대체 필요
cd /home/sysadm/tomcat/
tar -zxvf apache-tomcat-8.5.34.tar.gz
mv apache-tomcat-8.5.34 tomcatDID_ADMIN_9602
tomcatDID_ADMIN_9602
으로 변경cd tomcatDID_ADMIN_9602/conf/
vi server.xml
server.xml
파일 수정을 위해 해당 경로로 이동 후 파일 open <Server port="10101" shutdown="SHUTDOWN">
<Connector port="9602" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="10102" />
<Host name="localhost" appBase="/home/sysadm/tomcat/tomcatDID_ADMIN_9602/webapps/ADMIN-V1.1.10"
unpackWARs="true" autoDeploy="true">
<Context path="/" docBase="" reloadable="true" />
....
</Host>
cd /home/sysadm/tomcat/tomcatDID_ADMIN_9602/webapps
mkdir ADMIN-V1.1.10
unzip HECATE_DID_ADMIN-V1.1.10.war
rm -rf HECATE_DID_ADMIN-V1.1.10.war
파일 경로 : (생략)/webapps/ADMIN-V1.1.10/WEB-INF/classes/application.yml
편의성을 위해 배포 소스의 설정 파일을 설정 영역별로 구분하여 하나로 관리하는 형태
1. 권장값을 그대로 사용하는 "공통 설정 영역" & 제품 배포 서버의 "고유 정보 설정 영역" 으로 구분
2. 고유 정보 설정 영역의 경우 "운영서버" & "개발서버" & "로컬서버" 각 서버별로 구분
# 공통 설정 영역 (권장 설정)
spring:
profiles:
### (필수) 서버 설정 구분자 - 설정값 중 선택 : [ local | dev | real ]
active: local
# 서버별 정보 설정 영역 [local:로컬, dev:개발, real:운영]
## * Spring profiles 구분으로 해당 영역 수정 금지 [Start]
---
spring:
profiles: local
## * Spring profiles 구분으로 해당 영역 수정 금지 [End]
(생략)
## * Spring profiles 구분으로 해당 영역 수정 금지 [Start]
---
spring:
profiles: dev
## * Spring profiles 구분으로 해당 영역 수정 금지 [End]
(생략)
## * Spring profiles 구분으로 해당 영역 수정 금지 [Start]
---
spring:
profiles: real
## * Spring profiles 구분으로 해당 영역 수정 금지 [End]
spring:
(생략)
# 파일업로드 제한 설정
servlet:
multipart:
### (필수) 파일업로드 제한 설정 사용 여부 - 설정값 중 선택 : [ true | false ]
enabled: true
### (파일업로드 제한 설정 사용 시 필수)
max-file-size: 5MB
### (파일업로드 제한 설정 사용 시 필수)
max-request-size: 5MB
### (파일업로드 제한 설정 사용 시 필수 & 입력 경로 서버에 사전 생성 필수)
location: /home/sysadm/fileupload
spring:
datasource:
### (중요) JNDIName 설정시 HikariCP는 설정은 무시됨, HikariCP 사용시 주석처리 필수!
jndi-name: jdbc/msp_oracle
hikari:
### (필수) 설정값 중 선택 : [ org.mariadb.jdbc.Driver | com.mysql.cj.jdbc.Driver | oracle.jdbc.OracleDriver]
#driver-class-name: oracle.jdbc.OracleDriver
#jdbc-url: jdbc:oracle:thin:@localhost:1521:ORCL
#username: diduser
#password: did2022
hecate:
# DB Mode maria, oracle, post, mysql
database-mode : oracle
hecate:
(생략)
# 파일업로드 설정
file:
bsnesWeb:
### (필수) 파일업로드 설정 방식 - 설정값 중 선택 : [ targetServer ] (* Rsync, NAS 사용 시 사전 협의 필요)
uploadType: targetServer
### (필수) 파일업로드 경로
path: /home/sysadm/fileupload/bsnesWeb/
### (필수) 서버 IP (* 다중화 서버 시 ","로 구분)
targetServerInfo: 192.168.122.1:9602
### (필수) * 제품 배포 시 DML Script에서 입력되어지는 정보로, DML 우선 작업 필수
accessToken: example1234
hecate:
(생략)
# 연동 서버 설정
serverInfo:
management:
### (필수) Hecate DID Management Service (HDMS)
domain: http://localhost:9601
visitation:
### (선택) 방문증 관리
domain:
issueIns:
### (선택) 방문증 관리(발급기관 데모)
domain:
hecate:
(생략)
# 블록체인 - HYPERLEDGER 사용 시 설정
explorer:
### (선택) * 사용 시 사전 협의 필요
able: false
domain:
hecate:
(생략)
# Elasticsearch 설정
elastic:
### (선택) * 사용 시 사전 협의 필요
able: false
domain:
port: 0000
instanceId1:
instanceId2:
파일 경로 : (생략)/webapps/ADMIN-V1.1.10/WEB-INF/classes/logback.xml
<property name="logMode" value="${localMode}" /> <!-- 로컬 모드 설정 -->
<property name="localLogDir" value="/Users/uracle/log/Hecate_DID_Admin" /> <!-- 로컬 설정 경로 -->
<property name="devLogDir" value="/home/sysadm/logs/Hecate_DID_Admin" /> <!-- 개발 설정 경로 -->
<property name="realLogDir" value="/data/hecatedid-admin/logs/Hecate_DID_Admin" /> <!-- 운영 설정 경로 -->
<property name="defaultLogFileName" value="/Hecate_DID_Admin.log" /> <!-- 로그 파일명 -->
<property name="defaultRollingLogFileName" value="/%d{yyyy-MM-dd}_Hecate_DID_Admin.log" /> <!-- 롤링 로그 파일명 -->
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
(생략)
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
(생략)
<maxHistory>30</maxHistory> <!-- 백업 파일 수 -->
</rollingPolicy>
</appender>
cd /home/sysadm/tomcat/tomcatDID_ADMIN_9602/bin/
./startup.sh
./shutdown.sh
정상 배포 확인 : 로그 확인 및 웹페이지 접근 후 기능 정상 작동 여부 확인