Benutzerhandbuch

문제 해결

Dieses Kapitel gibt es vorerst nur auf Koreanisch.

먼저 볼 곳

로그

Windows: %ProgramData%\TASTEGEO\logs\ 의 server.stdout.log, server.stderr.log, admin.stdout.log, admin.stderr.log
Linux: journalctl -u tastegeo -u tastegeo-admin

상태 점검

주소	확인하는 것
`http://127.0.0.1:8081/health/live`	서버 프로세스가 살아 있는지
`http://127.0.0.1:8081/health/ready`	서버가 카탈로그를 읽고 준비되었는지
`http://127.0.0.1:6740/api/health/ready`	관리 화면이 서버까지 닿는지

서버 실행 파일로도 됩니다: tastegeo-server --health-check(준비되면 0 으로 끝남).

서버의 시작 오류는 일부러 짧게 나옵니다. 경로 · 값 · 비밀을 싣지 않으므로 아래 표에서 뜻을 찾으세요.

자주 나는 문제

증상 · 메시지	까닭	고치는 법
`GEOSERVER_DATA_DIR is required`	`data_dir` 가 정해지지 않음	`native.json` 의 `data_dir` 를 확인
`data directory unavailable`	데이터 디렉터리가 없거나 읽을 수 없음	폴더가 있는지, 서비스 계정이 읽을 수 있는지 확인(Linux 는 `tastegeo`)
`conflicting security configuration`	인증 방식이 둘 이상이거나 모자람	인증과 보안에서 방식 하나만 남기기(예: 익명 읽기와 토큰을 함께 적음)
서버가 시작하지 않고 상태 파일 오류	상태 파일과 `.bak` 이 모두 망가짐	백업에서 둘을 함께 되살리기(상태 저장과 복구)
설정을 바꿨는데 서버가 안 뜸	`native.json` 에 모르는 항목 · 잘못된 값	철자 확인(`schema_version` 은 1, 모르는 항목은 거절)
Windows 에서 관리 화면 서비스가 등록되지 않음	Node.js 24 가 없음	Node.js 24 를 설치하고 다시 설치(또는 `register-packaged-services.ps1 -Action Install`)
관리 화면이 열리지 않음	관리 화면 서비스가 멈춤	서비스 상태 · 로그 확인 후 다시 시작
관리 화면 대시보드가 "연결 안 됨"	서버 서비스가 멈췄거나 토큰이 맞지 않음	서버 서비스 확인. `server.env` 의 관리 토큰과 `admin.env` 의 `TASTEGEO_BEARER_TOKEN` 이 같은지 확인
로그인했는데 곧 로그인 화면으로	다른 컴퓨터에서 `http://` 로 엶(보안 쿠키)	`http://127.0.0.1:6740` 이나 HTTPS 프록시 주소로 열기
로그인이 막힘	15분에 다섯 번 넘게 틀림	잠시 뒤 다시
관리자 비밀번호를 잊음	—	화면에서 바꾼 비밀번호 파일을 지우고 관리 화면을 다시 시작 → 첫 비밀번호로(인증과 보안)
연결 트리의 노드가 흐리고 눌리지 않음	그 연결의 서버에 닿지 않음(빨간 점)	서버가 켜져 있는지, 주소 · 인증이 맞는지 연결 관리의 연결 시험으로 확인
GeoServer 연결이 401 · 403	계정이 틀리거나 REST 권한 없음	인증을 Basic 으로, GeoServer 관리자(REST 권한) 계정 사용
연결 관리에 "연결을 더할 수 없는 설치입니다"	연결 목록 파일 자리가 설정되지 않음	설치를 다시 실행하면 `admin.env` 에 자리가 더해집니다
다른 서버의 연결이 갑자기 인증 실패	`TASTEGEO_ADMIN_SESSION_SECRET` 이 바뀌어 저장된 비밀 값을 못 풂	그 연결을 수정해 비밀번호 · 토큰을 다시 넣기
카탈로그 화면이 느리거나 시간 초과	큰 카탈로그를 다시 만드는 중	`admin.env` 의 `TASTEGEO_REQUEST_TIMEOUT_MS`(설치 기본 60000)를 늘리기
REST 로 바꾼 것이 다시 시작하면 사라짐	`state_path` 가 비어 있음	`native.json` 에 `state_path` 정하기
`429 Too Many Requests`	한 주소에서 초당 120번 넘음	요청 간격을 늘리기
PostGIS 저장소가 안 열림	`POSTGIS_URL` 이 없거나 저장소에 연결 정보를 직접 적음	`server.env` 에 `POSTGIS_URL`, 저장소에는 변수 이름 `POSTGIS_URL`(저장소 연결)
저장소가 "지원하지 않는 저장소"	TASTEGEO 가 읽지 않는 종류	저장소 연결의 지원 목록 확인
지도 미리보기가 비어 있음	레이어 CRS · 스타일 문제 또는 서비스 오류	지도 아래 오류 글과 요청 주소 확인, WMS Capabilities 확인

판 올리기

새 판을 설치하면 설정 · 데이터 · 상태 파일은 그대로 두고 프로그램과 서비스만 바꿉니다. Windows 는 서비스 이름에 판 번호가 붙으므로(tastegeo_server_<판>) 판을 올린 뒤에는 새 이름으로 서비스를 찾으세요. 올리기 전에 백업을 해 두세요.

문의

해결되지 않으면 로그에서 비밀 값을 지운 뒤 TASTEDEV 사이트로 문의해 주세요. 관리 화면의 앱 안 공지는 tastedev.net 에서 공지를 받아 오는 기능이며, 끄려면 admin.env 에 TASTEGEO_ANNOUNCEMENTS=0 을 넣습니다.