From 44a307e91997d16946f29b5fb8172b2a552296a2 Mon Sep 17 00:00:00 2001
From: happybell80 <happybell80@naver.com>
Date: Wed, 30 Jul 2025 23:44:31 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20PostgreSQL=20systemd=20=EC=84=9C?=
 =?UTF-8?q?=EB=B9=84=EC=8A=A4=20=EC=A0=95=EC=83=81=ED=99=94=20=ED=8A=B8?=
 =?UTF-8?q?=EB=9F=AC=EB=B8=94=EC=8A=88=ED=8C=85=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...50730_admin_PostgreSQL_systemd정상화.md | 54 +++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 troubleshooting/250730_admin_PostgreSQL_systemd정상화.md

diff --git a/troubleshooting/250730_admin_PostgreSQL_systemd정상화.md b/troubleshooting/250730_admin_PostgreSQL_systemd정상화.md
new file mode 100644
index 0000000..38f9212
--- /dev/null
+++ b/troubleshooting/250730_admin_PostgreSQL_systemd정상화.md
@@ -0,0 +1,54 @@
+# PostgreSQL systemd 서비스 정상화
+
+**날짜**: 2025-07-30  
+**작업자**: admin & Claude  
+**관련 서비스**: PostgreSQL, Gitea, auth-server
+
+## 오후 11시 30분
+
+### 문제 발견
+
+서버 상태 점검 중 PostgreSQL 서비스 상태 불일치 발견:
+- 실제 프로세스는 5432 포트에서 정상 실행 중
+- `systemctl status postgresql`은 inactive (dead) 표시
+- 기능상 문제없으나 관리 일관성 부족
+
+## 오후 11시 39분
+
+### 정상화 작업
+
+**1. PostgreSQL 클러스터 확인**:
+```bash
+pg_lsclusters
+# 결과: 14  main  5432 online
+```
+
+**2. systemd 서비스 재시작 및 활성화**:
+```bash
+sudo systemctl restart postgresql@14-main.service
+sudo systemctl enable postgresql@14-main.service
+sudo systemctl restart postgresql.service
+```
+
+**3. 연동 서비스 확인**:
+- auth-server: 정상 연결 확인
+- Gitea: 111개 테이블 정상, 최근 활동 확인
+
+## 결과
+
+### 해결된 문제
+- ✅ systemctl 명령으로 PostgreSQL 제어 가능
+- ✅ 서버 재부팅 시 자동 시작 보장
+- ✅ journalctl로 통합 로그 관리 가능
+
+### 확인 사항
+- PostgreSQL 14 버전 실행 중
+- auth-server, Gitea 모두 정상 작동
+- 서비스 상태: active (running)
+
+## 교훈
+
+서비스가 실제로 작동해도 systemd 상태가 불일치하면 장기적으로 문제가 될 수 있음. 정기 점검 시 systemd 서비스 상태도 함께 확인 필요.
+
+---
+**작성 완료**: 2025-07-30 23:45
\ No newline at end of file