카프카 메시지 사이즈 설정,
1MB \~ 2GB 범위로 설정 가능
현재 컨테이너 전체 메모리(free 명령어의 total mem 참고)의 1/4 이다.
\[참고] 현재 docker 기본 이미지는 openjdk:17-alpine 이다.
| | SDM\_HEAP\_SIZE\_MIN | SDM의 최소 힙 크기 |현재 컨테이너 전체 메모리(free 명령어의 total mem 참고)의 1/64 이다.
\[참고] 현재 docker 기본 이미지는 openjdk:17-alpine 이다.
| | ANALYZER\_HEAP\_SIZE\_MAX | Analyzer의 최대 힙 크기 |현재 컨테이너 전체 메모리(free 명령어의 total mem 참고)의 1/4 이다.
\[참고] 현재 docker 기본 이미지는 openjdk:17-alpine 이다.
| | ANALYZER\_HEAP\_SIZE\_MIN | Analyzer의 최소 힙 크기 |현재 컨테이너 전체 메모리(free 명령어의 total mem 참고)의 1/64 이다.
\[참고] 현재 docker 기본 이미지는 openjdk:17-alpine 이다.
| | COLLECTOR\_HEAP\_SIZE\_MAX | Collector의 최대 힙 크기 |현재 컨테이너 전체 메모리(free 명령어의 total mem 참고)의 1/4 이다.
\[참고] 현재 docker 기본 이미지는 openjdk:17-alpine 이다.
| | COLLECTOR\_HEAP\_SIZE\_MIN | Collector의 최소 힙 크기 |현재 컨테이너 전체 메모리(free 명령어의 total mem 참고)의 1/64 이다.
\[참고] 현재 docker 기본 이미지는 openjdk:17-alpine 이다.
| | TBM\_HEAP\_SIZE\_MAX | TBM의 최대 힙 크기 |현재 컨테이너 전체 메모리(free 명령어의 total mem 참고)의 1/4 이다.
\[참고] 현재 docker 기본 이미지는 openjdk:17-alpine 이다.
| | TBM\_HEAP\_SIZE\_MIN | TBM의 최소 힙 크기 |현재 컨테이너 전체 메모리(free 명령어의 total mem 참고)의 1/64 이다.
\[참고] 현재 docker 기본 이미지는 openjdk:17-alpine 이다.
| | PERFORMANCE\_LOGGING |성능 관련 로그 작성 여부
\[참고] 추가적인 CPU, Disk를 사용하는 것이기 때문에 Y로 설정 시 성능 저하가 발생할 수 있음.
100만개
\[참고] 총 약 300MB 메모리를 차지한다.
| {% hint style="info" %} **참고 1** **SKIP\_DB\_USER\_COUNT\_MIGRATION\_PATCH, SKIP\_DAILY\_SEGMENT\_MIGRATION\_PATCH** 파라미터는 신규 설치 시에는 필요하지 않고, **SysMaster DB v8.1.2 이하 기설치 환경**에서 **버전 업데이트를 수행하는 경우에만 적용**이 필요하다. 각 파라미터를 별도로 설정하지 않으면, 버전 업데이트 시 해당 패치가 자동으로 수행되면서 기수집 데이터를 기반으로 **DB\_USER\_COUNT**, **DAILY\_SEGMENT** 데이터를 생성한다. 이때, 기수집 데이터양에 따라 패치 수행에 **장시간 소요**될 수 있으므로, 해당 파라미터를 통해 사용자가 **선택적으로 해당 패치 수행 여부를 설정**할 수 있다. **v8.1.3 이상의 SysMaster DB** 서비스 이용 시, **DB\_USER\_COUNT**, **DAILY\_SEGMENT** 데이터는 각각 다음 메뉴에서 사용된다. 1\. **DB\_USER\_COUNT** 데이터 - **Analysis > All Session Flow 메뉴** 2\. **DAILY\_SEGMENT** 데이터 - **Analysis > Segment Usage 메뉴** 따라서 해당 패치를 생략하도록 설정(각 파라미터를 **true**로 설정하고 **주석 제거**)하는 경우, **위 1, 2의 메뉴**에서 **과거(해당 업데이트 이전에 수집된) 데이터가 조회되지 않는다**. 그러므로 기본적으로는 해당 파라미터를 **별도로 설정하지 않는 것을 권장**한다. 반면 다음과 같은 경우, 사용자는 해당 파라미터를 **true**로 설정(**주석 제거**)하여 앞서 설명한 패치를 생략할 수 있다. 1. **위 1, 2의 메뉴**에서 과거(**SysMaster DB v8.1.2 이하**에서 수집된) 데이터 조회가 불필요한 경우 2. (SysMaster DB 서버 자원 제한 등의 이유로) 해당 데이터 생성 패치 진행 시 **장시간 SysMaster DB 사용이 불가능**해지는 상황이 우려되고, 이를 방지해야만 하는 경우 사용자는 필요에 따라, 해당 두 파라미터 중 **원하는 파라미터만 선택적으로 설정**하는 것도 가능하다. {% endhint %} {% hint style="info" %} **참고 2** **SKIP\_V8\_2\_1\_TO\_V8\_3\_0\_MIGRATION\_PATCH**, **RETENTION\_DAY\_FOR\_V8\_2\_1\_TO\_V8\_3\_0\_MIGRATION\_PATCH** 파라미터는 신규 설치 시에는 필요하지 않고, **SysMaster DB v8.2.1 이하 기설치 환경**에서 **버전 업데이트를 수행하는 경우에만 적용**이 필요하다. 각 파라미터를 별도로 설정하지 않으면, v8.3.0에서 신규 스키마가 적용된 테이블을 대상으로 **v8.2.1 이하 버전에서의 기수집 데이터를 마이그레이션**하는 패치가 자동으로 수행된다. v8.3.0에서 신규 스키마가 적용된 테이블 목록은 다음과 같다. * SQL * SQL\_TEXT * SQL\_PLAN * DB\_SESSION * SESSION\_TEMP * SESSION\_UNDO * LOCK * SQL\_TRACE 위 테이블에 대한 마이그레이션 과정은 기수집 데이터양에 따라 **장시간 소요**될 수 있다. 사용자는 필요에 따라, 다음과 같이 **별도 파라미터 설정을 통해 사용자가 선택적으로 해당 패치 수행 여부를 설정**할 수 있다. * **SKIP\_V8\_2\_1\_TO\_V8\_3\_0\_MIGRATION\_PATCH** * v8.3.0에서 신규 스키마가 적용된 테이블에 대해 v8.2.1 이하 기수집 데이터를 마이그레이션하는 패치 수행 여부를 설정 * **SKIP\_V8\_2\_1\_TO\_V8\_3\_0\_MIGRATION\_PATCH** 파라미터를 **true**로 설정(**주석 제거**) 시, 패치 대상 테이블 전체에 대한 마이그레이션이 수행되지 않음. **SKIP\_V8\_2\_1\_TO\_V8\_3\_0\_MIGRATION\_PATCH** 설정을 통해 마이그레이션을 수행하지 않은 경우, v8.2.1 이하에서 수집된 데이터가 삭제되므로 더 이상 조회되지 않는다. 그러므로 기본적으로는 해당 파라미터를 별도로 설정하지 않는 것을 권장한다. 반면 다음과 같은 경우, 사용자는 해당 마이그레이션 생략을 고려할 수 있다. 1. **v8.3.0에서 신규 스키마 적용 대상 테이블**의 과거(**SysMaster DB v8.2.1 이하**에서 수집된) 데이터 조회가 **불필요**한 경우 2. (SysMaster DB 서버 자원 제한 등의 이유로) 해당 데이터 생성 패치 진행 시 **장시간 SysMaster DB 사용이 불가능**해지는 상황이 우려되고, 이를 방지해야만 하는 경우 이때, 사용자는 아래 파라미터 설정을 통해 (마이그레이션 패치를 수행하되,) 패치 수행 대상 데이터 범위(일 단위 기간)를 별도로 설정할 수도 있다. * **RETENTION\_DAY\_FOR\_V8\_2\_1\_TO\_V8\_3\_0\_MIGRATION\_PATCH** * v8.3.0에서 신규 스키마가 적용된 테이블에 대한 v8.2.1 이하 기수집 데이터 중 마이그레이션 대상 데이터 범위(일 단위 기간) 설정 * 예를 들어, **RETENTION\_DAY\_FOR\_V8\_2\_1\_TO\_V8\_3\_0\_MIGRATION\_PATCH** 파라미터를 **7**로 설정(**주석 제거**)하는 경우, v8.2.1 이하에서 수집된 데이터 중 **최근 7일 이내의 데이터에 대해서만 마이그레이션**이 수행됨. * **SKIP\_V8\_2\_1\_TO\_V8\_3\_0\_MIGRATION\_PATCH** 파라미터를 **true**로 설정(**주석 제거**)한 경우, 본 파라미터 설정은 무시됨. 상기 설명을 참고하여, 사용자는 운영 환경에 맞는 적절한 파라미터 설정을 선택, 적용할 수 있다. {% endhint %} ### *** ### 5. **설치 파라미터 설정 - 포트** 설치 디렉터리에서 **kubernetes/init/service.yaml** 파일을 열어 SysMaster DB의 설치에 필요한 포트 관련 파라미터 값을 설정한다. 해당 과정에서 설정하는 파라미터에 대한 설명은 다음과 같다. | 파라미터 이름 | 설명 | 초기값 | | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | | CLIENT\_PORT |UI 접속 URL의 포트 번호
\[수정 위치] metadata.name=client, name="client-port"인 ports의 nodePort 수정
| 80 | | COLLECTOR\_PORT |수집 모듈(TPM Agent)이 접속할 포트 번호
\[수정 위치] metadata.name=collector, name="collector-port"인 ports의 nodePort 수정
\[참고] 관제 DB에서 접속할 수 있도록 SysMaster 서버에서 열려 있어야 함.
| 8292 | | METADB\_PORT |Meta DB의 접속 포트 번호
\[수정 위치] metadata.name=metadb, name="metadb-port"인 ports의 nodePort 수정
| 25432 | | REPODB\_PORT |Repository DB의 접속 포트 번호
\[수정 위치] metadata.name=repodb, name="repodb-port"인 ports의 nodePort 수정
| 15432 | ### *** ### 6. **Meta DB 및 Repository DB 파라미터 설정** 설치 디렉터리에서 **kubernetes/init/configmap.yaml** 파일을 통해 Meta DB 및 Repository DB 파라미터 값을 확인할 수 있다. 다음은 Meta DB에 대한 파라미터 설정 예시이다. ```shell apiVersion: v1 kind: ConfigMap metadata: name: sysmasterdb8-metadb-configmap namespace: sysmasterdb data: meta.conf: | pg_superuser: "postgres" pg_superuser_password: "postgres" pg_data: "/pgdata" pg_log: "/sysmaster/logs" pg_users: - name: "sysmaster" pass: "sysmaster" role_attr_flags: LOGIN pg_databases: - name: metadb owner: sysmaster pg_max_connections: 20 pg_postgres_conf_params: - name: "log_filename" value: "metadb-%H%M.log" - name: "log_timezone" value: "Asia/Seoul" - name: "log_min_messages" value: "INFO" - name: "log_rotation_age" value: "60" - name: "log_rotation_size" value: "100MB" - name: "log_truncate_on_rotation" value: "on" ``` 해당 conf 파일은 기본적으로 제공되는 설정값을 사용하되, 다음에서 설명하는 파라미터는 필요 시 구동 환경에 맞게 사용자가 직접 설정해준다. | 파라미터 이름 | 설명 | | -------------------- | ------------------------------------------ | | pg\_max\_connections | Meta DB(또는 Repository DB)의 최대 커넥션 수 | | log\_timezone | Meta DB(또는 Repository DB)의 로그 시간 Time-Zone | {% hint style="info" %} **참고** Meta DB 및 Repository DB 파라미터 변경이 필요한 경우, 관련 파라미터 설정은 TmaxOpenSQL 사용 가이드를 참조할 수 있다. 그러나 관련 파라미터 설정을 임의 수정하는 경우, SysMasterDB 서버의 정상 동작이 보장되지 않는다. 따라서 위 표에 명시된 파라미터 외 다른 파라미터는, 기본 제공 설정값을 그대로 사용하는 것을 권장한다. {% endhint %} ### --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.tibero.com/sysmasterdb/8.3_manual/installation-guide/installation/kubernetes-environment/installation-parameters.md?ask=