기동 / 로그 확인 / 종료 / 초기화

Kubernetes 환경에서 SysMaster DB 를 기동 / 로그 확인/ 종료 / 초기화하는 방법이다.

1. 기동

설치 파일이 위치한 디렉터리에서 아래와 같은 순서로 명령을 수행하여 쿠버네티스 오브젝트를 생성한다.

1.1. Namespace, ConfigMap, PVC, Service 생성

kubectl apply -f kubernetes/init

1.2. RepoDB, MetaDB 디플로이먼트 생성 (데이터베이스 생성이 완료된 상태에서 진행)

kubectl apply -f kubernetes/db

다음 단계로 진행하기 전 RepoDB, MetaDB가 정상적으로 부팅 완료되어야 한다. 이는 다음과 같은 로그를 통해 확인 가능하다.

먼저 각각 해당 pod의 터미널 출력 로그에서 아래와 같은 메세지가 출력되는 것을 확인한다.

[ENTRYPOINT LOG]: INFO: Attempting to start PostgreSQL server...

다음으로 각 데이터베이스의 로그파일에 아래와 같은 메세지가 출력되는 것을 확인한다.

LOG: database system is ready to accept connections

이때 각 데이터베이스의 로그 파일 확인 방법은 "2. 로그 확인"을 참고한다.

1.3. Kafka 디플로이먼트 생성 (Kafka 파드가 running 상태에서 진행)

kubectl apply -f kubernetes/kafka

1.4. SysMaster 디플로이먼트 생성 및 라이선스 파일 세팅

kubectl apply -f kubernetes/sysmaster

sysmasterdb8-sdm-container가 생성되면, 해당 컨테이너 내 sysmaster/license 경로 하위에 발급받은 라이선스 파일을 배치한다. 라이선스 파일명은sysmaster-db-license.xml 이며, 변경 불가능하다.

부팅이 완료된 이후에 로그인과 프로그램 사용이 가능하다. 부팅 완료는 SDM 로그에서 아래와 같은 로그를 통해 확인할 수 있다.

Started SdmApplication in ... seconds (JVM running for ...)

참고

라이선스(기간 만료 등의 이유로) 파일 교체가 필요한 경우, 해당 경로 내 기존라이선스 파일을 신규 라이선스파일로 바꿔준 후 SysMasterDB 서비스를 재기동하면 된다.

---

2. 로그 확인

기본적으로 각 모듈들의 pod 내 컨테이너에 접속하여 해당 모듈의 log 파일을 볼 수 있다. SysMaster DB 모듈들은 동일하게 각 컨테이너 내 아래 경로에 로그가 적재된다.

/sysmaster/logs

추가로, 사용자의 편의를 위하여 로그 확인 전용 컨테이너를 생성하여 활용할 수 있다.

배포 파일 구성에 포함된 client-deployment.yaml 파일에 정의된 sysmasterdb8-client-pod 내에, 로그 확인 전용 컨테이너인 sysmasterdb8-log-container가 정의되어 있다. 사용자는 해당 컨테이너 내 로그 디렉터리 경로(/sysmaster/logs)를 통해 모든 SysMaster DB 모듈의 로그를 확인할 수 있다.

---

3. 종료

설치 파일이 위치한 디렉터리에서 아래와 같은 순서로 명령을 수행하면 SysMaster DB 가 종료된다. 이때 SysMaster DB 를 종료해도 Repository DB와 Meta DB의 데이터 파일은 유지되므로, SysMaster DB 를 다시 기동하면 이전에 저장한 데이터를 사용할 수 있다.

1.1. SysMaster 디플로이먼트 삭제

kubectl delete -f kubernetes/sysmaster

1.2. Kafka 디플로이먼트 삭제

kubectl delete -f kubernetes/kafka

1.3. RepoDB, MetaDB 디플로이먼트 삭제

kubectl delete -f kubernetes/db

참고

1. SysMaster 디플로이먼트와 Kafka 디플로이먼트는 항상 같이 삭제한다.

2. RepoDB, MetaDB 디플로이먼트는 반드시 삭제할 필요는 없으며, SysMaster 종료 후에도 RepoDB와 MetaDB에 접속해 데이터를 확인할 수 있다.

---

4. 초기화

아래의 명령을 수행하면 모든 데이터가 삭제되고, 최초 설치 상태와 동일하게 동작한다. 단, 이전에 저장한 데이터는 사용할 수 없다.

kubectl delete -f kubernetes/init