CUBRID Windows 설치 또는 재설치 후 큐브리드 서비스 문제 해결 가이드
1. 서비스 권한 문제
중요 : CUBRID Windows 설치는 관리자 계정과 권한으로 설치합니다.
CUBRID 서비스가 실행되는 데 필요한 권한이 부족하거나 적절하지 않을 수 있습니다.
- 서비스 계정 확인
- Windows 서비스 관리 도구 (`services.msc`)를 열고, `CUBRID` 및 `CUBRID Admin` 서비스가 올바른 계정(로컬 시스템 계정 등)으로 실행되고 있는지 확인합니다.
- 관리자 권한으로 실행
- 윈도우 명령어 프롬프트를 관리자 권한으로 열고 cubrid service start 명령어를 실행하고 cubrid service status 수행 결과 프로세스 구동을 점검합니다.
2. 방화벽 및 네트워크 설정
Windows 방화벽이나 네트워크 설정이 CUBRID의 통신을 차단할 가능성이 있습니다.
- 방화벽 규칙 확인
- 제어판 → 시스템 및 보안 → Windows Defender 방화벽 → "고급 설정"에서 CUBRID 관련 포트(기본 포트 기준으로 30000, 33000, 8001 등)가 차단되지 않았는지 확인합니다.
- 예외 규칙 추가
- CUBRID의 실행 파일(`cub_master`, `cub_broker`, `cubrid manager`)과 사용 포트를 허용하는 규칙을 추가합니다.
- 네트워크 어댑터 확인
- 네트워크 어댑터가 비활성화 상태이거나, VPN, Proxy 설정 등이 활성화되어 CUBRID와 충돌할 가능성을 점검합니다.
3. 사용 중인 포트 충돌
다른 프로그램이 CUBRID와 동일한 포트를 사용하고 있을 수 있습니다.
- 포트 상태 확인
- 명령 프롬프트에서 `netstat -aon | find "30000"` 또는 `netstat -aon | find "8001"`을 실행하여 포트 점유 상태를 확인합니다.
- 포트 변경
- CUBRID 설정 파일(`cubrid.conf`, `cubrid_broker.conf`)에서 다른 포트로 변경 후 서비스를 재시작합니다.
- 충돌 프로그램 종료
- 포트를 사용하는 다른 프로그램이 있다면 종료하거나, 해당 프로그램의 포트를 변경합니다.
4. Windows 서비스 상태 및 레지스트리 검토
일부 Windows 서비스가 비활성화되어 있거나, CUBRID 관련 설정이 손상될 수 있습니다.
- 의존 서비스 확인
- `TCP/IP NetBIOS Helper`, `Workstation`, `Server` 등 네트워크 및 파일 공유와 관련된 서비스가 실행 중인지 확인합니다.
- 레지스트리 복구
- CUBRID 제거 후에도 관련 레지스트리 키가 남아있을 수 있으므로 수동으로 제거한 뒤, 새로 설치합니다:
- `HKEY_LOCAL_MACHINE\SOFTWARE 아래에서 `CUBRID` 또는 관련 항목을 삭제합니다. (상황에 따라 CUBRID가 다른 위치로 있을 수 있음)
5. CUBRID 설치 폴더 경로 및 권한
설치 폴더 경로나 권한 문제로 인해 서비스가 정상적으로 동작하지 않을 수 있습니다.
- 폴더 경로 검토
- CUBRID 설치 폴더가 기본 경로(`C:\CUBRID`)가 아닌 다른 드라이브나 네트워크 드라이브에 설치된 경우, 경로를 변경하여 재설치합니다.
- 폴더 권한 확인
- CUBRID 설치 폴더와 하위 폴더의 권한을 확인하고, `Everyone` 및 `SYSTEM` 계정에 대한 읽기/쓰기 권한을 부여합니다.
6. Windows 로그 및 디버깅 정보 확인
문제의 원인을 파악하기 위해 Windows 이벤트 로그를 확인합니다.
- 로그 확인 방법
- Windows + R → `eventvwr` 입력 → Windows 로그 → "시스템" 및 "응용 프로그램"에서 관련 오류 메시지를 확인합니다.
- 오류 메시지 분석
- CUBRID 서비스와 관련된 이벤트를 필터링하여 문제의 원인을 분석합니다.
참조 : 윈도우 기본 설정 상태에서는 대부분 CUBRID 설치 후 사용에 문제가 없지만 윈도우 관리자/사용자 환경설정 의해 사용에 문제가 발생될 수 있는 경우 확인(검토)할 내용을 정리 하였습니다.