¶ HECATE DID MANAGEMENT SERVICE 설치가이드
¶ 개요
"Hecate DID Managerment Service" 서버 설치를 위해 수행하는 제반 업무에 대한 기술 문서
"HDMS란?" Hecate DID Management Service의 약자로 HOLDER, ISSUER, VERIFIER, VIRIFIER EMP, 별 DID와 Credential 생성과 블록체인과의 연동 역할 수행
¶ 설치 환경
¶ 권장 사양
권장 이외의 환경에서 설치 할 경우에는 반드시 사전 확인이 필요
- 운영체제
- Windows, Linux, Unix, Mac OS 등
- 소프트웨어
- Java SDK 1.8 이상
- WAS (Web Application Server)
- Apache Tomcat, Tmax Jeus 등
- 데이터베이스
- MySQL, MariaDB, Oracle
¶ 설치 및 설정 파일 안내
¶ 설치 파일 안내
- HDMS-Vx.x.x.war
- Database ddl, dml script (HECATE DID 서비스 전체 영역)
¶ 사전 준비 확인 사항
1 - ISSUER Service와 연동될 Credential 사용자 서명원문 데이터 조회 API가 필요
2 - yml, propertice 파일에 있는 blockchain API Server 주소 체크
3 - ISSUER Service와 레거시 서버 간 포트 오픈 필요
¶ TABLE 생성 및 기초 데이터 셋팅
설치 서버에 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_HDMS_9601
- Tomcat 설치 경로로 이동 후 톰캣 8.5.34버전 설치, 디렉토리명
tomcatDID_HDMS_9601으로 변경
cd tomcatDID_HDMS_9601/conf/
vi server.xml
server.xml파일 수정을 위해 해당 경로로 이동 후 파일 open
<Server port="10000" shutdown="SHUTDOWN">
- Server shutdown 영역 설정
<Connector port="9601" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="10001" />
- Connector 영역 설정
<Host name="localhost" appBase="/home/sysadm/tomcat/tomcatDID_HDMS_9601/webapps/HDMS-V1.1.1"
unpackWARs="true" autoDeploy="true">
<Context path="/" docBase="" reloadable="true" />
....
</Host>
- 패키지(War파일) 배포 영역 설정
cd /home/sysadm/tomcat/tomcatDID_HDMS_9601/webapps
mkdir HDMS-V1.1.1
- appBase에 설정한 경로에 패키지 파일 배포를 위한 디렉토리를 생성 및 패키지 파일 이동
unzip HDMS-V1.1.1.war
rm -rf HDMS-V1.1.1.war
- 이동시킨 배포 패키지 파일 압축 해제 및 패키지 파일 삭제
¶ Tomcat 기동
cd /home/sysadm/tomcat/tomcatDID_HDMS_9601/bin/
- tomcat설치 경로로 이동하여 tomcat (재)기동
./startup.sh
- tomcat 시작 명령어
./shutdown.sh
- tomcat 종료 명령어
정상 배포 확인 : 로그 확인 및 swagger 정상 작동 여부 확인
- http://%IP_ADDRESS%:9601/swagger-ui.html
.png)
다음 설치 단계 : Hecate DID ISSUER 설치가이드 [installGuide_Issuer]