Troubleshooting
INNORIX 설치 및 운영 과정에서 발생할 수 있는 문제를 신속하게 확인하고 해결하기 위해 주요 장애 유형별 점검 방법을 제공합니다.
본 장에서는 Docker 설치, Container 배포, 서비스 실행, 네트워크 연결, 라이선스 활성화 및 로그 분석 방법을 안내합니다.
Docker 설치 문제
Docker 설치 과정에서 패키지 충돌, Repository 설정 오류 또는 Docker 서비스 실행 문제로 인해 설치가 정상적으로 완료되지 않을 수 있습니다.
주요 증상 및 원인
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| Docker 설치 실패 | 기존 Docker 관련 패키지 충돌 | 기존 Docker 패키지 제거 후 재설치 |
| Repository 추가 실패 | Repository 설정 오류 | 운영 체제 환경에 맞는 Repository 확인 |
| Docker 명령 실행 불가 | Docker 미설치 또는 서비스 중지 | Docker 설치 상태 및 서비스 상태 확인 |
| Docker 권한 오류 | 사용자 권한 부족 | 관리자 권한으로 실행 |
Docker 상태 확인
Docker 서비스 상태를 확인합니다.
Docker 버전을 확인합니다.
Docker Compose 버전을 확인합니다.
조치 사항
문제가 지속되는 경우 다음 항목을 확인합니다.
- 지원 운영 체제 버전 확인
- Docker Engine 요구 버전 확인
- 기존 Container Runtime 충돌 여부 확인
- 서버 인터넷 연결 상태 확인
컨테이너 배포 문제
INNORIX Container 배포 과정에서 Docker Compose 설정 오류 또는 Image 다운로드 문제로 인해 Container가 정상적으로 생성되지 않을 수 있습니다.
주요 증상 및 원인
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| Container 생성 실패 | Docker Compose 설정 오류 | docker-compose.yml 설정 확인 |
| Image 다운로드 실패 | 네트워크 또는 인증 문제 | Docker Repository 접근 확인 |
| Container 즉시 종료 | 환경 설정 오류 | Container 로그 확인 |
| Storage 연결 실패 | Volume 설정 오류 | Storage 경로 및 권한 확인 |
Container 상태 확인
배포된 서비스의 상태를 확인합니다.
각 서비스의 REPLICAS 값이 정상적으로 표시되는지 확인합니다.
개별 Container(태스크) 단위의 상태를 확인합니다.
각 태스크의 CURRENT STATE가 Running 상태인지 확인합니다.
확인 사항
Container 배포 문제가 발생하면 다음 항목을 확인합니다.
- Docker 서비스 실행 여부
- docker-compose.yml 설정 값
- Server IP 설정 여부
- Storage Mount 상태
- Container Image 정상 다운로드 여부
서비스 실행 문제
Container가 정상적으로 실행되었지만 INNORIX 서비스 접근 또는 기능 동작에 문제가 발생할 수 있습니다.
주요 증상 및 원인
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| Web Console 접속 불가 | 서비스 미실행 | Container 및 서비스 상태 확인 |
| 서비스 초기화 실패 | 환경 설정 오류 | 설정 파일 확인 |
| Agent 실행 오류 | Hyperlink Agent 문제 | Agent 상태 확인 |
| 기능 동작 오류 | 서비스 내부 오류 | 로그 확인 |
서비스 확인 항목
| 항목 | 확인 내용 |
|---|---|
| Deployment Status | 신규 서비스·컨테이너 정상 배포 여부 |
| Service Status | INNORIX 서비스 상태 |
| Agent Status | Hyperlink Agent 실행 상태 |
| Configuration | 서비스 설정 정상 적용 여부 |
Hyperlink Agent 확인
Agent 상태 확인이 필요한 경우 아래 명령을 통해 실행 상태를 확인합니다.
시작:
중지:
네트워크 연결 문제
INNORIX는 Web Console 접근 및 시스템 간 파일 전송을 위해 정상적인 네트워크 연결이 필요합니다.
주요 증상 및 원인
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| Web Console 접속 불가 | Port 차단 | Firewall 설정 확인 |
| 서버 접근 실패 | IP 또는 DNS 오류 | 네트워크 설정 확인 |
| 파일 전송 실패 | 대상 시스템 연결 문제 | 통신 상태 확인 |
| 외부 연결 실패 | 보안 정책 차단 | 네트워크 정책 확인 |
네트워크 점검 항목
| 항목 | 확인 내용 |
|---|---|
| Server IP | 서버 IP 정상 설정 여부 |
| DNS | 도메인 연결 상태 |
| Firewall | Port 허용 여부 |
| Network Route | 통신 경로 정상 여부 |
조치 사항
네트워크 문제가 발생하면 다음 순서로 확인합니다.
- 서버 네트워크 연결 확인
- IP 및 DNS 설정 확인
- Firewall 정책 확인
- 서비스 Port 접근 확인
- 대상 시스템 연결 상태 확인
라이선스 활성화 문제
INNORIX의 모든 기능을 사용하기 위해서는 정상적인 라이선스 활성화가 필요합니다.
주요 증상 및 원인
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| License 등록 실패 | License Key 오류 | 발급된 Key 확인 |
| 인증 실패 | Authentication Key 오류 | 인증 키 재확인 |
| 기능 제한 발생 | License 미적용 | License 활성화 상태 확인 |
| 서버 활성화 실패 | 환경 정보 불일치 | 서버 정보 확인 |
라이선스 확인 항목
| 항목 | 설명 |
|---|---|
| Workspace | Workspace 생성 여부 |
| Authentication Key | 인증 키 정상 생성 여부 |
| License Key | 발급된 라이선스 정보 |
| Server Information | 설치 서버 정보 |
조치 절차
- Workspace 생성 상태 확인
- Authentication Key 확인
- License Key 재입력
- 서버 활성화 상태 확인
로그 확인 및 장애 분석
문제 발생 시 로그를 통해 정확한 원인을 분석합니다.
로그 분석은 서비스 오류, Container 문제 및 네트워크 장애 원인 파악에 활용됩니다.
로그 확인 대상
| 로그 유형 | 설명 |
|---|---|
| Docker Log | Container 실행 및 오류 정보 |
| Service Log | INNORIX 서비스 동작 기록 |
| System Log | 서버 운영 환경 정보 |
| Network Log | 연결 및 통신 관련 정보 |
Docker 로그 확인
서비스 로그를 확인합니다.
장애 분석 절차
- 장애 발생 시간 확인
- 서비스 상태 확인
- Container 상태 확인
- 관련 로그 확인
- 원인 분석 및 조치 수행
- 서비스 정상 여부 확인
문제 해결 완료 확인
| 확인 항목 | 상태 |
|---|---|
| Docker 설치 문제 해결 | ✓ |
| 컨테이너 배포 문제 해결 | ✓ |
| 서비스 실행 문제 해결 | ✓ |
| 네트워크 연결 문제 해결 | ✓ |
| 라이선스 활성화 문제 해결 | ✓ |
| 로그 확인 및 장애 분석 완료 | ✓ |