> For the complete documentation index, see [llms.txt](https://docs.tibero.com/sysmasterdb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tibero.com/sysmasterdb/8.4_manual/installation-guide/installation/docker-compose-podman-compose-environment/up-down.md). # 기동 / 로그 확인 / 종료 / 초기화 Docker-compose 및 Podman-compose 환경에서 SysMasterDB 8.4를 기동, 로그 확인, 종료, 초기화하는 방법이다. ## 1. 기동 ### 1.1. SysMasterDB 환경 변수 설정 {% code collapsedlinecount="10" %} ``` export SYSMASTERDB_HOME={SysMasterDB_Home_Path} ``` {% endcode %} | 인자 | 설명 | | --------------------------- | ---------------------------------- | | {*SysMasterDB\_Home\_Path*} | docker-compose.yml 파일이 위치한 디렉터리 경로 | ### 1.2. SYSMASTERDB\_HOME을 PATH에 추가 {% code collapsedlinecount="10" %} ``` export PATH=$PATH:$SYSMASTERDB_HOME ``` {% endcode %} ### 1.3. 라이선스 파일 세팅 지정된 경로 하위에 발급받은 라이선스 파일을 배치한다. 라이선스 파일명과 경로는 아래와 같다. 파일명이 이 형식과 다르면 **라이선스로 인식하지 않는다**. * 라이선스 파일명 * `sysmaster-db-license.xml` * `sysmaster-db-license-{이름}.xml` (예: `sysmaster-db-license-30cores.xml`) * 라이선스 경로 * `$SYSMASTERDB_HOME/license` `$SYSMASTERDB_HOME` 경로 하위에 `license` 디렉토리가 존재하지 않는 경우, 해당 디렉토리를 직접 생성해준 후 라이선스 파일(`sysmaster-db-license.xml`)을 넣어주면 된다. Real 라이선스는 여러 파일을 함께 둘 수 있으며, 이때 관제할 수 있는 코어 수는 각 파일의 코어 수를 합한 값이다. Subscription·Demo·Trial 라이선스는 한 파일만 둘 수 있고, 타입이 다른 라이선스 파일을 함께 두면 라이선스가 적용되지 않는다. {% hint style="info" %} **참고** 라이선스(기간 만료 등의 이유로) 파일 교체가 필요한 경우, 해당 경로 내 기존 라이선스 파일을 신규 라이선스 파일로 바꿔준 후 아래 명령을 수행하면 재기동 없이 갱신된다. 응답의 expirationDate가 새 라이선스의 만료일이면 갱신이 완료된 것이다. SysMasterDB 서비스를 재기동해도 새 라이선스가 적용된다. `docker compose exec sdm refresh-license` Podman 환경: `podman compose exec sdm refresh-license` {% endhint %} ### 1.4. 실행 #### 1.4.1. Docker-compose 환경 {% code collapsedlinecount="10" %} ``` sysmaster-db up ``` {% endcode %} #### 1.4.2. Podman-compose 환경 {% code collapsedlinecount="10" %} ``` sysmaster-db up --podman ``` {% endcode %} `--podman` 옵션을 주면 `podman-compose.yml` 파일로 기동한다(파일이 없으면 `docker-compose.yml`을 사용한다). `podman compose`와 `podman-compose` 중 사용 가능한 명령을 자동으로 선택한다. {% hint style="warning" %} **주의** `--podman` 옵션을 생략하면 기본값인 Docker 환경(`docker compose`)으로 기동한다. Podman 환경에서는 기동(`sysmaster-db up --podman`)과 종료(`sysmaster-db down --podman`) 모두 `--podman` 옵션을 붙여 실행한다. {% endhint %} ### 1.5. 부팅 완료 확인 및 접속 부팅이 완료되면 브라우저에서 `https://{SysMasterDB 서버 IP 또는 호스트명}:{CLIENT_PORT}` 로 접속한다. CLIENT\_PORT의 기본값은 443이므로 기본 설정에서는 포트를 생략하고 접속할 수 있다. 자체 서명 인증서를 사용하는 경우 브라우저에 인증서 경고가 표시되며, 경고를 확인하고 진행하면 로그인 화면이 열린다. 사이트 인증서 적용 방법은 [설치 및 파라미터 설정](/sysmasterdb/8.4_manual/installation-guide/installation/docker-compose-podman-compose-environment/installation-parameters.md)의 3.3을 참고한다.
부팅이 완료된 이후에 로그인과 프로그램 사용이 가능하다.\ 부팅 완료는 SDM 로그에서 아래와 같은 로그를 통해 확인할 수 있다. {% code collapsedlinecount="10" %} ``` Started SdmApplication in ... seconds (process running for ...) ``` {% endcode %} 이 로그가 출력된 뒤에도 dbmanager와 collector가 SDM에 처음 연결될 때까지는 브라우저 접속 화면이 열리지 않는다. 접속되지 않으면 잠시 기다린 뒤 다시 접속한다. *** ## 2. 로그 확인 **.env** 파일의 로그 관련 파라미터 설정을 통해 로그가 저장될 경로를 지정할 수 있다. default 로그 경로는 **./logs**이므로 docker-compose.yml 파일이 있는 디렉터리에 logs 폴더가 자동으로 생성되며, 여기서 로그 파일을 확인할 수 있다. {% hint style="info" %} **참고** client-gateway는 접속 로그(`access.log`)와 오류 로그(`error.log`)를 로그 경로 아래 `client-gateway` 디렉터리에 남긴다. client-tibero는 로그를 파일로 남기지 않으므로 `docker compose logs client-tibero` 명령으로 확인한다. Podman 환경: `podman compose logs client-tibero` {% endhint %} *** ## 3. 종료 **SysMasterDB 8.4 기동**을 위한 **환경 변수** 및 **PATH**가 설정된 상태에서 아래의 명령을 수행하면 모든 서비스가 제거되고, SysMasterDB 8.4가 종료된다. 이때 SysMasterDB 8.4를 종료해도 METADB\_PATH와 REPODB\_PATH에 생성된 파일은 유지되므로, SysMasterDB 8.4를 다시 기동하면 종료 전과 동일하게 사용할 수 있다. Podman 환경에서는 `sysmaster-db down --podman`을 수행한다. {% code collapsedlinecount="10" %} ``` sysmaster-db down ``` {% endcode %} *** ## 4. 초기화 METADB\_PATH와 REPODB\_PATH 디렉터리를 삭제한 후 SysMasterDB 8.4를 다시 기동하면 최초 설치 상태와 동일하게 동작한다. 단, 이전에 저장한 데이터는 사용할 수 없다.