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

Upgrade Health Checker의 입력 매개변수에 대해 알아보십시오

기여자 netapp-ivanad
PDF

Upgrade Health Checker의 입력 매개변수와 CLI 인수, 구성 파일 또는 대화형 프롬프트를 통해 이러한 매개변수를 제공하여 ONTAP 클러스터에 대한 업그레이드 보고서 생성을 지원하는 방법에 대해 자세히 알아볼 수 있습니다.

입력 방법 우선순위

업그레이드 상태 점검 도구는 모든 매개 변수에 대해 여러 입력 옵션을 제공합니다. 입력을 수락하는 우선 순위는 다음과 같습니다.

  1. CLI 인수(최우선 순위)

  2. 구성 파일 (config.yaml)

  3. 대화형 프롬프트(최하위 우선 순위)

매개 변수가 여러 방법을 통해 제공되는 경우 도구는 우선 순위가 가장 높은 소스의 값을 사용합니다.

입력 매개변수

클러스터 IP

`--cluster-ip` 매개변수는 연결할 ONTAP 클러스터의 IP 주소 또는 호스트 이름을 지정합니다.

이 매개변수를 제공하는 우선 순위는 다음과 같습니다.

  1. CLI 인수: --cluster-ip

  2. 구성 파일: CLUSTER.IP

  3. 대화형 프롬프트

예

  • CLI 인수:

    ./uhc --cluster-ip 192.168.1.100

  • Config.yaml:

    CLUSTER:
  IP: "192.168.1.100"

  • 대화형 모드(위에 제공되지 않은 경우):

    도구에서 다음과 같은 메시지가 표시됩니다. Enter cluster IP address:

클러스터 사용자 이름

`--cluster-username` 매개변수는 ONTAP 클러스터 인증에 사용할 사용자 이름을 지정합니다.

이 매개변수를 제공하는 우선 순위는 다음과 같습니다.

  1. CLI 인수: --cluster-username

  2. 구성 파일: CLUSTER.USERNAME

  3. 대화형 프롬프트

예

  • CLI 인수:

    ./uhc --cluster-username admin

  • Config.yaml:

    CLUSTER:
  USERNAME: "admin"

  • 대화형 모드(위에 제공되지 않은 경우):

    도구에서 다음과 같은 메시지가 표시됩니다. Enter cluster username:

클러스터 암호

`--cluster-password` 매개변수는 ONTAP 클러스터 인증에 사용할 암호를 지정합니다.

이 매개변수를 제공하는 우선 순위는 다음과 같습니다.

  1. CLI 인수: --cluster-password

  2. 구성 파일: CLUSTER.PASSWORD

  3. 대화형 프롬프트(보안 입력)

예

  • CLI 인수(보안상 권장하지 않음):

    ./uhc --cluster-password mypassword

  • Config.yaml(파일 권한이 제한되어 있는지 확인):

    CLUSTER:
  PASSWORD: "mypassword"

  • 대화형 모드(권장 - 암호 숨김):

    도구에서 다음과 같은 메시지가 표시됩니다. Enter cluster password:

타겟 ONTAP 버전

`--target-ontap-version` 매개변수는 분석을 위해 업그레이드할 ONTAP 버전을 지정합니다. 기존 클러스터 ONTAP 버전을 유지하려면 "current"를 사용합니다.

이 매개변수를 제공하는 우선 순위는 다음과 같습니다.

  1. CLI 인수: --target-ontap-version

  2. 구성 파일: CLUSTER.TARGET_ONTAP_VERSION

  3. 대화형 선택 메뉴

예

  • CLI 인수:

    업데이트된 ONTAP 버전: ./uhc --target-ontap-version 9.15.1

    현재 ONTAP 버전 유지: ./uhc --target-ontap-version current

  • Config.yaml:

    CLUSTER:
  TARGET_ONTAP_VERSION: "9.15.1"

  • 대화형 모드(위에 제공되지 않은 경우):

    도구에 사용 가능한 버전이 표시되고 선택하라는 메시지가 표시됩니다

EULA에 동의합니다

`--accept-eula` 매개변수는 최종 사용자 라이선스 계약을 수락할지 여부를 지정합니다. 계속하려면  `true`로 설정해야 합니다.

이 매개변수를 제공하는 우선 순위는 다음과 같습니다.

  1. CLI 인수: --accept-eula

  2. 구성 파일: CLUSTER.ACCEPT_EULA

  3. 대화형 프롬프트

예

  • CLI 인수:

    ./uhc --accept-eula true

  • Config.yaml:

    CLUSTER:
  ACCEPT_EULA: true

  • 대화형 모드(위에 제공되지 않은 경우):

    이 도구는 EULA를 표시하고 수락 여부를 묻는 메시지를 표시합니다

구성 파일 경로

`--config-path` 매개변수는 사용자 지정 구성 YAML 파일의 경로를 지정합니다.

이 매개변수를 제공하는 우선 순위는 다음과 같습니다.

  1. CLI 인수: --config-path

  2. 기본값: config.yaml

예

  • CLI 인수:

    ./uhc --config-path /path/to/custom_config.yaml

  • 기본값(제공되지 않은 경우):

    이 도구는 현재 디렉토리에서 config.yaml을 찾습니다

실행 출력 경로

`--runs-path` 매개변수는 실행 출력 및 보고서를 저장하기 위한 사용자 지정 디렉터리를 지정합니다.

이 매개변수를 제공하는 우선 순위는 다음과 같습니다.

  1. CLI 인수: --runs-path

  2. 구성 파일: APP.RUNS_PATH

  3. 기본값: ./runs

예

  • CLI 인수:

    ./uhc --runs-path /custom/output/path

  • Config.yaml:

    APP:
  RUNS_PATH: "/custom/output/path"

  • 기본값(제공되지 않은 경우):

    이 도구는 ./runs 디렉토리를 사용합니다.

호환성 검사 건너뛰기

`--skip-compatibility-check` 매개변수는 하드웨어 호환성 검사를 건너뛰고 업그레이드하려는 지정된 ONTAP 버전을 사용합니다.
주의 대상 ONTAP 버전이 하드웨어와 호환되는지 확실한 경우에만 이 옵션을 사용하십시오.

이 매개변수를 제공하는 우선 순위는 다음과 같습니다.

  1. CLI 인수: --skip-compatibility-check

  2. 구성 파일: CLUSTER.SKIP_COMPATIBILITY_CHECK

  3. 기본값: false

예

  • CLI 인수:

    ./uhc --skip-compatibility-check true

  • Config.yaml:

    CLUSTER:
  SKIP_COMPATIBILITY_CHECK: true

원격 측정을 비활성화합니다

원격 측정 기능을 비활성화하려면 다음 내용을 config.yaml 파일에 추가하세요.

TELEMETRY:
  ENABLED: false

자동 업데이트 비활성화

업그레이드 상태 검사기의 자동 업데이트를 비활성화하려면 다음 내용을 config.yaml 파일에 추가하십시오.

AUTO_UPDATE:
  ENABLED: false

각 입력 방법을 사용하는 예

결합된 CLI 인수

./uhc \
  --cluster-ip 192.168.1.100 \
  --cluster-username admin \
  --cluster-password mypassword \
  --target-ontap-version 9.15.1 \
  --accept-eula true \
  --config-path /path/to/custom_config.yaml \
  --runs-path /custom/output \
  --skip-compatibility-check false

Config.yaml 파일

CLUSTER:
  IP: "192.168.1.100"
  USERNAME: "admin"
  PASSWORD: "mypassword"
  TARGET_ONTAP_VERSION: "9.15.1"
  ACCEPT_EULA: true
  SKIP_COMPATIBILITY_CHECK: false

APP:
  RUNS_PATH: "/custom/output"

대화형 모드

필수 입력 매개변수를 대화형으로 표시하려면 인수 없이 Upgrade Health Checker를 실행하십시오.

./uhc

추가 명령

이러한 명령은 도구의 전체 실행 외에 몇 가지 추가 기능을 제공합니다.

  • 도움말 표시

    ./uhc --help

  • 버전 표시

    ./uhc --version

  • 클러스터 연결 테스트

    ./uhc --test-connectivity cluster

  • 원격 측정 연결 테스트

    ./uhc --test-connectivity telemetry

  • 자동 업데이트 연결 테스트

    ./uhc --test-connectivity autoupdate

  • 모든 테스트 실행

    ./uhc --test all