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

## 1. 기동

### 1.1. SysMaster DB 환경 변수 설정

```
export SYSMASTERDB_HOME={SysMasterDB_Home_Path}
```

| 인자                          | 설명                                 |
| --------------------------- | ---------------------------------- |
| {*SysMasterDB\_Home\_Path*} | docker-compose.yml 파일이 위치한 디렉터리 경로 |

### 1.2. SYSMASTERDB\_HOME을 PATH에 추가

```
export PATH=$PATH:$SYSMASTERDB_HOME
```

### 1.3. 라이선스 파일 세팅

지정된 경로 하위에 발급받은 라이선스 파일을 배치한다. 라이선스 파일명과 경로는 아래와 같으며, **변경 불가능**하다.

* 라이선스 파일명
  * `sysmaster-db-license.xml`
* 라이선스 경로
  * `$SYSMASTERDB_HOME/license`

`$SYSMASTERDB_HOME` 경로 하위에 `license` 디렉토리가 존재하지 않는 경우, 해당 디렉토리를 직접 생성해준 후 라이선스 파일(`sysmaster-db-license.xml`)을 넣어주면 된다.

{% hint style="info" %}
**참고**

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

### 1.4. 실행

#### 1.4.1. Docker-compose 환경

```
sysmaster-db up
```

#### 1.4.2. Podman-compose 환경

```
podman compose -f podman-compose.yml up -d
```

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

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

***

## 2. 로그 확인

**.env** 파일의 로그 관련 파라미터 설정을 통해 로그가 저장될 경로를 지정할 수 있다. default 로그 경로는 **./logs**이므로 docker-compose.yml 파일이 있는 디렉터리에 logs 폴더가 자동으로 생성되며, 여기서 로그 파일을 확인할 수 있다.

{% hint style="info" %}
**참고**

Client 모듈의 경우 따로 로그를 파일로 남기고 있지 않고 있으므로, `docker compose logs` 와 같은 명령어로 출력되는 로그를 확인해야한다.
{% endhint %}

###

***

## 3. 종료

**SysMaster DB 8.3 기동**을 위한 **환경 변수** 및 **PATH**가 설정된 상태에서 아래의 명령을 수행하면 모든 서비스가 제거되고, SysMaster DB 8.3가 종료된다. 이때 SysMaster DB 8.3를 종료해도 METADB\_PATH와 REPODB\_PATH에 생성된 파일은 유지되므로, SysMaster DB 8.3를 다시 기동하면 종료 전과 동일하게 사용할 수 있다.

```
sysmaster-db down
```

###

***

## 4. 초기화

METADB\_PATH와 REPODB\_PATH 디렉터리를 삭제한 후 SysMaster DB 8를 다시 기동하면 최초 설치 상태와 동일하게 동작한다. 단, 이전에 저장한 데이터는 사용할 수 없다.

###


---

# 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/docker-compose-podman-compose-environment/up-down.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
