ONTAP 도구 배포 오류 해결
변경 제안
PDF
배포 문제가 발생하는 경우 로그 및 오류 코드를 검토하여 문제를 진단하고 해결하십시오. ONTAP tools for VMware vSphere 10.5부터 Pod에서 수집되는 로그 번들에는 MongoDB, RabbitMQ 및 Vault의 로그와 모든 Pod의 상태 및 설명이 포함됩니다. 이러한 로그는 기존 ONTAP tools 서비스 로그에 추가로 제공되어 지원 및 문제 해결 기능을 향상시킵니다.
로그 파일 수집
ONTAP tools Manager 사용자 인터페이스에서 사용 가능한 옵션을 통해 ONTAP tools for VMware vSphere의 로그 파일을 수집할 수 있습니다. 기술 지원 담당자가 문제 해결을 위해 로그 파일 수집을 요청할 수 있습니다.
|
ONTAP tools Manager에서 로그를 생성하면 모든 vCenter Server 인스턴스의 모든 로그가 포함됩니다. vCenter 클라이언트 사용자 인터페이스에서 로그를 생성하면 선택한 vCenter Server에 대해서만 로그가 생성됩니다. |
-
웹 브라우저에서 ONTAP tools Manager를 실행합니다.
https://<ONTAPtoolsIP>:8443/virtualization/ui/ -
배포 중에 제공한 ONTAP tools for VMware vSphere 관리자 자격 증명으로 로그인하십시오.
-
사이드바에서 *로그 번들*을 선택합니다.
이 작업은 몇 분 정도 소요될 수 있습니다.
-
로그 파일을 생성하려면 *생성*을 선택하십시오.
-
로그 번들의 레이블을 입력하고 *생성*을 선택합니다.
tar.gz 파일을 다운로드하여 기술 지원 팀에 보내십시오.
vCenter 클라이언트 사용자 인터페이스를 사용하여 로그 번들을 생성하려면 아래 단계를 따르십시오:
-
vSphere 클라이언트에 로그인합니다.
-
vSphere Client 홈 페이지에서 지원 > 로그 번들 > *생성*으로 이동합니다.
-
로그 번들 레이블을 입력하고 로그 번들을 생성합니다. 파일이 생성되면 다운로드 옵션이 표시됩니다. 다운로드에는 다소 시간이 걸릴 수 있습니다.
|
|
새로 생성된 로그 번들은 지난 3일(72시간) 이내에 생성된 로그 번들을 대체합니다. |
배포 오류 코드
ONTAP tools for VMware vSphere 배포, 재부팅 및 복구 작업 중에 오류 코드가 발생할 수 있습니다. 오류 코드는 5자리 숫자로 구성되며, 앞의 두 자리는 문제가 발생한 스크립트를 나타내고, 뒤의 세 자리는 해당 스크립트 내의 특정 워크플로를 나타냅니다.
모든 오류 로그는 문제 추적 및 해결을 용이하게 하기 위해 /var/log 디렉터리의 ansible-perl-errors.log 파일에 기록됩니다. 이 로그 파일에는 오류 코드와 실패한 Ansible 작업이 포함됩니다.
|
|
이 페이지에 제공된 오류 코드는 참고용일 뿐입니다. 오류가 계속 발생하거나 해결 방법이 제시되지 않은 경우 지원팀에 문의하십시오. |
다음 표에는 오류 코드와 해당 파일 이름이 나열되어 있습니다.
오류 코드 |
스크립트 이름 |
00 |
firstboot-network-config.pl, mode deploy |
01 |
firstboot-network-config.pl, 업그레이드 모드 |
02 |
firstboot-inputs-validation.pl |
03 |
firstboot-deploy-otv-ng.pl, 배포, HA |
04 |
firstboot-deploy-otv-ng.pl, 배포, 비HA |
05 |
firstboot-deploy-otv-ng.pl, 재부팅 |
06 |
firstboot-deploy-otv-ng.pl, 업그레이드, HA |
07 |
firstboot-deploy-otv-ng.pl, 업그레이드, 비HA |
08 |
firstboot-otv-recovery.pl |
09 |
post-deploy-upgrade.pl |
오류 코드의 마지막 세 자리는 스크립트 내의 특정 워크플로 오류를 나타냅니다.
배포 오류 코드 |
워크플로우 |
해결 방법 |
049 |
네트워크 및 유효성 검사를 위한 Perl 스크립트도 곧 할당될 예정입니다. |
- |
050 |
SSH 키 생성 실패 |
기본 가상 머신(VM)을 재시작합니다. |
053 |
RKE2 설치에 실패했습니다 |
다음 명령을 실행하고 기본 VM을 다시 시작하거나 다시 배포하십시오. sudo rke2-killall.sh (모든 VM) sudo rke2-uninstall.sh (모든 VM). |
054 |
kubeconfig 설정에 실패했습니다. |
재배포 |
055 |
레지스트리 배포에 실패했습니다 |
레지스트리 Pod가 있는 경우 Pod가 준비될 때까지 기다린 후 기본 VM을 다시 시작하거나 재배포하십시오. |
059 |
KubeVip 배포에 실패했습니다. |
Kubernetes 컨트롤 플레인용 가상 IP 주소와 배포 중에 제공된 ONTAP tools IP 주소가 동일한 VLAN에 속하고 사용 가능한 IP 주소인지 확인하십시오. 이전의 모든 사항이 올바르면 재시작하십시오. 그렇지 않으면 재배포하십시오. |
060 |
운영자 배포에 실패했습니다 |
재시작 |
061 |
서비스 배포에 실패했습니다 |
ntv-system 네임스페이스에서 get pods, get rs, get svc 등의 기본적인 Kubernetes 디버깅을 수행하여 자세한 내용과 오류 로그를 /var/log/ansible-perl-errors.log 및 /var/log/ansible-run.log에서 확인한 후 재배포하십시오. |
062 |
ONTAP tools 서비스 배포에 실패했습니다. |
자세한 내용을 확인하고 다시 배포하려면 /var/log/ansible-perl-errors.log에 있는 오류 로그를 참조하십시오. |
065 |
Swagger 페이지 URL에 연결할 수 없습니다 |
재배포 |
066 |
게이트웨이 인증서 배포 후 단계에 실패했습니다. |
업그레이드를 복구/완료하려면 다음을 수행하십시오.
|
088 |
journald에 대한 로그 로테이션 구성에 실패했습니다. |
가상 머신이 호스팅되는 호스트와 호환되는 가상 머신 네트워크 설정을 확인하십시오. 다른 호스트로 마이그레이션한 후 가상 머신을 다시 시작해 볼 수 있습니다. |
089 |
요약 로그 순환 설정 파일의 소유권 변경에 실패했습니다. |
기본 VM을 재시작합니다. |
096 |
동적 스토리지 프로비저너 설치 |
- |
108 |
시딩 스크립트 실패 |
- |
114 |
MongoDB 컬렉션의 내부 인증서 업데이트가 실패했습니다 |
배포가 오류 코드 114와 함께 실패하면 다음 단계를 완료하십시오.
|
재부팅 오류 코드 |
워크플로우 |
해결 방법 |
067 |
rke2-server 대기 시간이 초과되었습니다. |
- |
101 |
유지 관리/콘솔 사용자 암호를 재설정하는 데 실패했습니다. |
- |
102 |
유지 관리/콘솔 사용자 암호 재설정 중 암호 파일 삭제에 실패했습니다. |
- |
103 |
금고에서 새 유지 관리/콘솔 사용자 암호를 업데이트하는 데 실패했습니다. |
- |
088 |
journald에 대한 로그 로테이션 구성에 실패했습니다. |
가상 머신이 호스팅되는 호스트와 호환되는 가상 머신 네트워크 설정을 확인하십시오. 다른 호스트로 마이그레이션한 후 가상 머신을 다시 시작해 볼 수 있습니다. |
089 |
요약 로그 순환 설정 파일의 소유권 변경에 실패했습니다. |
가상 머신을 재시작합니다. |