> For the complete documentation index, see [llms.txt](https://docs.tibero.com/tmaxopensql/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/tmaxopensql/administration/openproxy/undefined.md).

# 사용법

## 시작

`OpenSQL-Installer` 를 통해 설치한 경우 `OpenProxy`는 아래 명령어로 기동된 상태입니다.

```bash
bash $OPENSQL_HOME/scripts/start_openproxy.sh
```

* `$OPENSQL_HOME/etc/openproxy.toml` 설정 파일을 로드하여 백그라운드(`nohup`)로 프로세스를 실행합니다.
* 프로세스 기동 확인 후 PID를 `$OPENSQL_HOME/etc/openproxy.pid`에 저장합니다.
* 기동 대기 시간은 최대 10초이며, 이 안에 프로세스가 확인되지 않으면 오류와 함께 로그 마지막 20줄을 출력합니다.
* 로그 레벨은 `LOG_LEVEL` 환경변수로 지정하며, 기본값은 `info`입니다.

```
Starting OpenProxy with config: /opt/opensql/etc/openproxy.toml
OpenProxy started with PID 18472
```

## 종료

```bash
bash $OPENSQL_HOME/scripts/stop_openproxy.sh
```

* `$OPENSQL_HOME/etc/openproxy.pid`에서 PID를 읽어 `SIGTERM` 신호를 보냅니다.
* 프로세스가 완전히 종료될 때까지 대기한 후 PID 파일을 삭제합니다.
* PID 파일이 없거나 해당 PID의 프로세스가 실행 중이지 않으면 오류 메시지를 출력합니다.

```
Stopping OpenProxy (PID: 18472)
OpenProxy stopped
```

## 재시작

OpenProxy 프로세스를 재시작합니다.

```bash
bash $OPENSQL_HOME/scripts/restart_openproxy.sh
```

* `stop_openproxy.sh` → `start_openproxy.sh` 순서로 실행합니다.
* 프로세스가 실행 중이지 않아도 stop 단계의 오류를 무시하고 start를 진행합니다.

```
Restarting OpenProxy...
Stopping OpenProxy (PID: 18472)
OpenProxy stopped.
Starting OpenProxy with config: /opt/opensql/etc/openproxy.toml
OpenProxy started with PID 18531
```

## 리로딩

```bash
bash $OPENSQL_HOME/scripts/reload_openproxy.sh
```

* 실행 중인 OpenProxy 프로세스에 `SIGHUP` 신호를 보내 **프로세스를 재시작하지 않고** 설정 파일을 재로드합니다.
* `openproxy.toml` 수정 후 서비스 중단 없이 설정을 반영할 때 사용합니다.
* PID 파일이 없거나 프로세스가 실행 중이지 않으면 오류를 반환합니다.

```
Reloading OpenProxy configuration (PID: 18531)...
OpenProxy configuration reloaded successfully.
```