Skip to main content
Upgrade Health Checker
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

업그레이드 상태 점검 도구 문제 해결

기여자 netapp-yvonneo
PDF

일반적인 업그레이드 상태 점검 문제를 해결하고 ONTAP 업그레이드 계획을 차단할 수 있는 오류를 해결하는 방법을 알아보십시오.

문제 해결

+

문제: 인증 또는 자격 증명 오류

증상:

Failed to fetch cluster details for <cluster-ip>
Error connecting to ONTAP cluster: 401 Unauthorized
Missing cluster credentials

이러한 오류는 업그레이드 상태 검사기가 제공된 자격 증명을 사용하여 ONTAP 클러스터에 인증할 수 없음을 나타냅니다. 이는 잘못된 사용자 이름 또는 암호, 사용자 계정에 대한 권한 부족, 또는 계정이 잠겨 있거나 비활성화된 경우 발생할 수 있습니다.

솔루션:

  • 사용자 이름과 비밀번호가 올바른지 확인하십시오.

  • 사용자에게 충분한 ONTAP REST API 권한이 있는지 확인하십시오

  • 계정이 잠겨 있거나 비활성화되었는지 확인하십시오

./uhc --test-connectivity cluster

+

문제: 자동 업데이트 실패

증상:

Auto-update failed: ...
Failed to download update

이 오류는 Upgrade Health Checker가 인터넷에 연결하여 업데이트를 확인하거나 다운로드할 수 없음을 나타냅니다. 이는 네트워크 연결 문제, 방화벽 규칙으로 인한 액세스 차단 또는 프록시 설정이 올바르게 구성되지 않은 경우 발생할 수 있습니다.

솔루션:

  • 인터넷 연결 확인:

./uhc --test-connectivity autoupdate

  • 디스크 공간 확인(1GB 필요):

df -h <location of uhc>

문제: 바이너리를 시작하는 데 시간이 오래 걸립니다

원인: 바이너리는 자체 포함되어 있으며 실행 전에 압축을 풀어야 합니다.

예상되는 동작: 처음 실행 시 로딩에 몇 초 정도 소요될 수 있습니다. 이는 정상적인 현상입니다. + +

문제: /tmp에서 "Permission denied" 또는 "Cannot execute binary"

증상:

[Errno 13] Permission denied
OSError: [Errno 13] Permission denied: '/tmp/_MEI...'
Cannot execute binary file

이 오류는 도구의 구성 요소를 추출하고 실행하는 데 사용되는 /tmp 디렉터리의 파일을 도구가 실행할 수 없을 때 발생할 수 있습니다. 이는 /tmp 디렉터리에 대한 권한이 제한적이거나 해당 위치에서의 실행을 차단하는 보안 정책으로 인해 발생할 수 있습니다.

솔루션:

  1. `/tmp`에 `noexec`이(가) 활성화되어 있는지 확인하세요:

mount | grep /tmp
# If you see noexec in the output, this is the issue.

  1. /tmp`을(를) `exec(으)로 다시 마운트합니다(시스템 관리자 루트 권한 필요):

# Temporary fix
sudo mount -o remount,exec /tmp
# Permanent fix - edit /etc/fstab
# Change "noexec" to "exec" for /tmp mount point

  1. 제약 조건으로 인해 이전 단계를 수행할 수 없는 경우, 적절한 권한이 있는 대체 임시 디렉터리를 사용하도록 도구를 구성할 수 있습니다.

mkdir -p /custom-tmp-path
# This only needs to be done one time.
TMPDIR=/custom-tmp-path ./uhc
# The TMPDIR prefix has to be added every time.
참고 이 해결 방법을 사용하려면 사용자 지정 경로가 먼저 존재해야 합니다. 경로가 존재하지 않으면 생성되지 않고 `/tmp`을(를) 사용합니다.

  1. 권한을 조정하거나 임시 디렉터리를 변경한 후 도구를 다시 실행하여 문제가 해결되었는지 확인하십시오. +

문제: 연결 시간 초과

증상:

Connection timeout
Request timeout

솔루션:

  • 클러스터에 대한 네트워크 연결을 확인합니다

  • 방화벽이 HTTPS(443) 트래픽을 차단하지 않는지 확인하십시오.

  • 클러스터가 응답하고 과부하 상태가 아닌지 확인하십시오 +

문제: 디스크 공간 부족

증상:

Not enough disk space available
OSError: [Errno 28] No space left on device

솔루션:

  • 디스크 공간 확인:

df -h /tmp
df -h .

  • 이전 실행 정리:

# Remove old run directories
rm -rf runs/<old_run_directories>

  • 임시 파일 정리:

# Remove temporary files
rm -rf /tmp/_MEI*

+

문제: 잘못된 실행 경로

증상:

Invalid basepath_runs: <error>
RUNS path is not set
Cannot create tarball: basepath_runs '<path>' does not exist

솔루션:

  • 실행 출력 디렉터리가 존재하고 쓰기 가능한지 확인하십시오

  • CLI를 통해 유효한 경로를 지정하십시오. --runs-path /valid/path

  • config.yaml에서 구성: APP.RUNS_PATH: "/valid/path" +

문제: 잘못된 대상 ONTAP 버전

증상:

Invalid ONTAP version: '<version>' does not exist
Invalid ONTAP version: '<version>' is not a recognized ONTAP version
Downgrade is not supported. Target version must be greater than or equal to the current version.

솔루션:

  • 대상 버전 문자열 형식(예: "9.16.1")을 확인하십시오.

  • 대상 버전이 현재 클러스터 버전보다 최신이거나 동일한지 확인하십시오.

  • 기존 ONTAP 버전을 유지하려면 "current"를 사용하십시오. --target-ontap-version=current +

문제: 서명 확인에 실패합니다

증상:

Signature verification failed
Invalid code signature

원인: 다운로드한 업데이트 파일이 손상되었거나 변조되었을 수 있습니다.

해결 방법:

  • 수동 업데이트 - NetApp Support 사이트에서 다운로드

  • 서명을 수동으로 확인하십시오.

    openssl dgst -sha256 -verify UHC-Linux-public.pub -signature uhc.sig uhc

    +

문제: 원격 측정 업로드 실패

증상:

body.7z upload failed
Telemetry endpoint is not reachable

솔루션:

  • 원격 측정 엔드포인트에 대한 연결을 확인합니다.

./uhc --test-connectivity telemetry

+

문제: "UPDATE IN PROGRESS" 잠금 파일

증상:

업데이트 진행 중

현재 UHC 자동 업데이트의 다른 인스턴스가 실행 중입니다. 다시 실행하기 전에 업데이트가 완료될 때까지 기다려 주십시오.

  • 원인: * 이전 업데이트 프로세스의 잠금 파일이 있습니다.

솔루션:

  1. 대기: 업데이트는 일반적으로 1~2분 내에 완료됩니다.

  2. 부실 여부 확인: (1시간 후 자동 정리):

ls -la uhc_update.lock
# If older than 1 hour, it will be auto-cleaned

  1. 필요한 경우 수동 정리:

rm uhc_update.lock