설치 및 파라미터 설정

Docker-compose 및 Podman-compose 환경에서 SysMaster DB 8.2를 설치하는 과정이다.

참고

Podman-compose는 Docker-compose 스타일의 yml 파일을 지원하기 때문에 동일한 yml 파일을 가지고 docker / podman 환경에서 모두 구동할 수 있다.

1. Docker / Podman 이미지 로드

설치 파일이 준비된 디렉터리에서 아래의 명령을 수행하여 Docker / Podman 이미지를 로드한다.
- Docker:
  docker load -i sysmaster-db-{version}.tar
- Podman:
  podman load -i sysmaster-db-{version}.tar
이때 로드된 컨테이너 이미지 목록은 다음과 같다.
- sysmaster-db-client:{version}
- sysmaster-db-sdm:{version}
- sysmaster-db-tibero-master:{version}
- sysmaster-db-collector:{version}
- sysmaster-db-analyzer:{version}
- sysmaster-db-tmaxopensql-postgres:{version}
- sysmaster-db-schema-registry:{version}
- sysmaster-db-kafka-loggable:{version}
- sysmaster-db-zookeeper-loggable:{version}

참고

docker images | grep sysmaster 명령어를 통해 컨테이너 이미지 목록을 확인할 수 있다.

2. Docker / Podman 서비스 정의

설치 디렉터리에서 docker-compose.yml 파일을 열어 Docker-compose / Podman-compose 환경에 생성하는 10개의 서비스들에 대해 정의한다. 각 서비스에 대한 설명은 다음과 같다.

서비스

설명

client

사용자가 브라우저를 통해 접속하게 될 웹 서버

sdm

수집 정보를 조회하고 클라이언트와 통신하는 API 서버

tibero-master

관제 데이터베이스에 대한 상태 확인과 Admin 기능을 수행하는 서버

collector

관제 데이터베이스로부터 데이터를 수집하는 서버

analyzer

수집한 정보를 가공해 분석 및 저장하는 서버

metadb

UI 관련 설정 정보를 저장하는 DB 서버

repodb

관제 데이터베이스 수집 데이터를 저장하는 DB 서버

zookeeper

Kafka Broker 서버의 상태 관리

broker

Kafka Broker 서버

schema-registry

Kafka 메시지 프로토콜 관리

3. 설치 파라미터 설정

설치 디렉터리에서 .env 파일을 열어 SysMaster DB 8.2의 설치에 필요한 파라미터 값을 설정한다.

참고

.env 파일이 없다면 vim .env 명령어를 이용해 생성한다.

이때 각 파라미터들은 개행으로 구분하며, 파라미터 이름과 값 사이에는 공백 없이 등호를 하나 입력한다.

CLIENT_PORT=80
ADMIN_USERNAME=admin
ADMIN_PASSWORD=admin
COLLECTOR_PORT=8292
METADB_PORT=25432
METADB_USER=sysmaster
METADB_PASSWORD=sysmaster
METADB_PATH=./meta
METADB_CONF_PATH=./meta.conf
REPODB_PORT=15432
REPODB_USER=sysmaster
REPODB_PASSWORD=sysmaster
REPODB_PATH=./repo
REPODB_CONF_PATH=./repo.conf
RETENTION_DAY=7
LOG_PATH=./logs
LOG_RETENTION_DAY=1
LOG_FILE_SIZE=100MB
LOG_TOTAL_SIZE=1000MB
LOG_LEVEL=info
CONTAINER_LOG_PATH=/sysmaster/logs
KAFKA_MESSAGE_MAX_BYTES=20971520
TIME_ZONE=Asia/Seoul
SQL_FLUSH_THRESHOLD=100
SQL_RS_FETCH_SIZE=1000
# SKIP_DB_USER_COUNT_MIGRATION_PATCH=true
# SKIP_DAILY_SEGMENT_MIGRATION_PATCH=true
SDM_HEAP_SIZE_MAX=
SDM_HEAP_SIZE_MIN=
ANALYZER_HEAP_SIZE_MAX=
ANALYZER_HEAP_SIZE_MIN=
COLLECTOR_HEAP_SIZE_MAX=
COLLECTOR_HEAP_SIZE_MIN=
TBM_HEAP_SIZE_MAX=
TBM_HEAP_SIZE_MIN=
PERFORMANCE_LOGGING=

해당 과정에서 설정하는 파라미터에 대한 설명은 다음과 같다.

파라미터 이름

설명

초기값

CLIENT_PORT

UI 접속 URL의 포트 번호

ADMIN_USERNAME

Admin 계정의 사용자 이름

admin

ADMIN_PASSWORD

Admin 계정의 암호

admin

COLLECTOR_PORT

수집 모듈(TPM Agent)이 접속할 포트 번호

[참고] 관제 DB에서 접속할 수 있도록 SysMaster 서버에서 열려 있어야 함

8292

METADB_PORT

Meta DB의 접속 포트 번호

25432

METADB_USER

Meta DB의 슈퍼 사용자 이름

sysmaster

METADB_PASSWORD

Meta DB의 슈퍼 사용자 암호

sysmaster

METADB_PATH

Meta DB의 데이터 파일 경로

./meta

METADB_CONF_PATH

Meta DB의 설정 파일 경로

./meta.conf

REPODB_PORT

Repository DB의 접속 포트 번호

15432

REPODB_USER

Repository DB의 슈퍼 사용자 이름

sysmaster

REPODB_PASSWORD

Repository DB의 슈퍼 사용자 암호

sysmaster

REPODB_PATH

Repository DB의 데이터 파일 경로

./repo

REPODB_CONF_PATH

Repository DB의 설정 파일 경로

./repo.conf

RETENTION_DAY

수집 정보의 보관 주기

LOG_PATH

로그 생성 위치

./logs

LOG_RETENTION_DAY

로그 파일 보관 주기

LOG_FILE_SIZE

로그 파일 하나의 최대 크기

100MB

LOG_TOTAL_SIZE

모듈 별 최대 로그 저장 용량

1000MB

LOG_LEVEL

모듈 별 로그 레벨

info

CONTAINER_LOG_PATH

컨테이너 내부 로그 경로 설정

/sysmaster/logs

KAFKA_MESSAGE_MAX_BYTES

카프카 메시지 사이즈 설정, 1MB ~ 2GB 범위로 설정 가능

20971520 Byte

TIME_ZONE

SysMaster DB 서버 Time-Zone 설정

Asia/Seoul

SQL_FLUSH_THRESHOLD

SQL 관련 하나의 메시지가 담을 수 있는 정보 개수 제한. SQL Plan의 경우 해당 값의 10배로 제한한다.

관제 DB 당 100개

SQL_RS_FETCH_SIZE

한 번에 관제 DB 로부터 조회하는 SQL 관련 정보 row 개수

관제 DB 당 1000개

SKIP_DB_USER_COUNT_MIGRATION_PATCH

(기설치 환경 패치 시,) 기수집 데이터 기반 Repository DB의 DB_USER_COUNT 테이블 데이터 생성 패치 생략 여부. 필요 시 아래 [참고]를 확인하고 설정.

true (주석 처리를 통한 미적용)

SKIP_DAILY_SEGMENT_MIGRATION_PATCH

(기설치 환경 패치 시,) 기수집 데이터 기반 Repository DB의 DAILY_SEGMENT 테이블 데이터 생성 패치 생략 여부. 필요 시 아래 [참고]를 확인하고 설정.

true (주석 처리를 통한 미적용)

SDM_HEAP_SIZE_MAX

SDM의 최대 힙 크기

현재 컨테이너 전체 메모리(free 명령어의 total mem 참고)의 1/4 이다.