상태 저장과 복구

TASTEGEO 는 데이터 디렉터리를 읽기만 합니다. 관리 화면이나 REST API 로 바꾼 카탈로그(워크스페이스 · 저장소 · 레이어 · 스타일 · 서비스 설정 등)는 데이터 디렉터리가 아니라 따로 둔 상태 파일에 남습니다.

상태 파일

설정은 native.json 의 state_path(또는 서버 환경 GEOSERVER_RS_STATE_PATH)입니다. 설치 패키지는 이미 켜 두었습니다. state_path 를 비우면 REST 로 바꾼 내용은 다시 시작하면 사라집니다.

• 상태 파일은 데이터 디렉터리 밖에 있어야 합니다.
• 상태를 쓸 때마다 바로 앞의 정상본을 같은 자리의 .bak 파일로 남깁니다.
• 상태 파일이 망가지면 .bak 으로 시작합니다. 둘 다 망가졌으면 잘못된 카탈로그를 내지 않도록 시작하지 않습니다.
• 둘 다 없으면(처음 설치) 데이터 디렉터리의 GeoServer 설정을 읽어 시작합니다.
• 데이터 디렉터리 감시(watch_data_dir)는 상태 파일과 함께 쓸 수 없습니다.
• 서버 하나가 상태 파일 하나를 씁니다. 여러 서버가 같은 상태 파일을 나눠 쓰지 마세요.

WFS 판 기록을 다시 시작한 뒤에도 남기려면 GEOSERVER_RS_FEATURE_HISTORY_PATH 에 기록 파일을 정합니다(이것도 데이터 디렉터리 밖).

백업

1. 관리 화면 · REST 로 바꾸는 작업을 멈춥니다(가장 확실한 것은 서버 서비스를 멈추는 것).
2. 상태 파일, 그 .bak, (쓰는 경우) WFS 기록 파일을 함께 복사해 접근이 막힌 곳에 둡니다.
3. 각 파일의 체크섬(예: SHA-256)을 따로 적어 둡니다.
4. 서비스를 다시 켭니다.

함께 백업할 것:

• 설정 폴더(Windows config\, Linux /etc/tastegeo/) — 토큰 · 비밀번호 해시 · 세션 비밀이 들어 있으니 안전한 곳에
• 관리 화면 파일 — 화면에서 바꾼 비밀번호와 연결 목록(Windows state\admin-credentials · state\admin-servers.json, Linux /var/lib/tastegeo/admin/). 연결 목록의 비밀번호 · 토큰은 admin.env 의 세션 비밀로 잠겨 있으므로 admin.env 와 함께 백업 · 복원해야 풀립니다
• 데이터 디렉터리
• PostGIS 데이터베이스(데이터베이스 백업 도구로 따로)

상태 파일을 손으로 고치지 마세요. 상태 파일과 .bak 은 늘 한 쌍으로 다룹니다.

되살리기

1. 서버 서비스를 멈춥니다.
2. 같은 때 백업한 상태 파일과 .bak(그리고 WFS 기록 파일)을 제자리에 되돌립니다. Linux 는 파일 주인을 서비스 계정 (tastegeo)으로 맞춥니다.
3. 서버를 시작하고 /health/ready 가 준비됨인지, 관리 화면 대시보드와 지도 미리보기가 정상인지 확인합니다.

되살리기는 원래 GeoServer 데이터 디렉터리를 바꾸지 않으며, PostGIS 데이터베이스를 되돌리지도 않습니다. 데이터베이스는 같은 때의 백업으로 따로 되돌리세요.

처음 상태로

관리 화면 시스템 › 운영 작업에 두 가지가 있습니다. 둘 다 확인 칸에 작업 이름(RELOAD · RESET)을 입력해야 실행됩니다.

• 카탈로그 Reload — 저장된 설정을 다시 읽어 지금 카탈로그에 한꺼번에 적용합니다.
• 카탈로그 Reset — 실행 중인 카탈로그 상태를 초기 기준으로 되돌립니다. 진행 중인 요청에 영향을 줄 수 있으니 조용한 때에 하세요.

REST 로 바꾼 카탈로그를 모두 버리고 데이터 디렉터리 상태로 돌아가려면 서버를 멈추고 상태 파일과 .bak 을 다른 곳으로 옮긴 뒤 시작합니다(먼저 백업하세요).