VxRail: VxRail 업그레이드 이전의 VxVerify 문제 해결

이 KB 문서는 VxVerify를 성공적으로 실행하지 못하게 하는 문제를 해결하는 데 사용됩니다.

이 기술 자료 문서는 관련 응답(예: 경고, 실패 및 위험)을 대상으로 하는 문서가 없는 테스트에서 참조됩니다. 예를 들어 쿼리에서 예기치 않은 응답을 반환하는 쿼리가 있습니다.

VxVerify는 VxRail 업그레이드 중에 복잡성이나 장애를 일으킬 수 있는 문제를 탐지하도록 설계되었습니다. VxVerify는 미니언이라고 하는 Python 프로그램을 생성하여 VxRail 노드로 전송합니다. 다음은 예상되는 일반적인 테스트 결과입니다. vxverify_tests.json:

거짓 양성 테스트 결과가 발견되면 VxVerify 로그를 수집하고 Dell 지원 부서에 문의하여 VxRail 엔지니어링과 함께 Jira VXV 티켓을 엽니다.

VxVerify가 성공적으로 실행되지 않는 데는 여러 가지 원인이 있습니다.

• 실패의 가장 일반적인 원인은 Python 스크립트가 만료되었기 때문입니다. 각 VxVerify 버전은 게시된 날짜로부터 2주 동안만 지속되도록 설정됩니다. VxVerify가 VxRail 상태 점검 프레임워크에 대한 플러그인으로 실행되는 경우(VxVerify 기능을 변경) 적용되지 않습니다.
• VxRail Manager의 사용 권한 문제 나 호스트와의 통신 문제 도 이유가 될 수 있습니다.
• 이벤트의 원인이 명확하지 않은 경우 Dell 지원 부서에 문의하여 VxRail 엔지니어링 팀과 함께 VXV 티켓을 개설하십시오.

아래 섹션에서는 로그를 수집하고 VxVerify가 제대로 실행되지 않는 경우 문제를 해결하는 방법에 대한 지침을 제공합니다.

지원 참여를 위한 로그 수집

VxVerify 관련 문제로 지원을 요청할 때 아카이브된 전체 vxv 분석할 폴더 , 또는 vxverify 로그 .zip file 현재 독립 실행형 VxVerify 버전은 아카이브된 파일을 /tmp, 분석에 필요한 모든 결과와 로그가 있습니다.

예: /tmp/vxverify-c9.zip

이 외에도 .zip 가장 최근에 VxVerify를 실행한 파일의 경우 최대 5개의 이전 로그 세트가 /tmp 폴더. 이름에는 파일 속성에서 실행된 날짜-시간이 있습니다. 

vxv_previous_01.zip

또는 아래 명령을 실행하여 모든 관련 파일을 아카이브합니다.

tar cvzf vxverify-2020-12-31.tgz /tmp/vxv/

문제 해결

VxVerify 2 실행을 위한 일반적인 문제 해결 단계(VxRail 4.5, 4.7 및 7.0.000의 경우)

• VxVerify를 실행하려면 Python이 필요하며, 실행하기 위한 명령줄은 다음과 같습니다.

python /tmp/vxv/vxverify.pyc

• 매직 넘버 오류가 발생하는 경우 대개 VxRM의 Python 버전에 잘못된 버전의 VxVerify가 사용되고 있음을 의미합니다. 예를 들어 7.0.320에서 VxVerify 2를 실행하면 아래 오류가 발생합니다.

RuntimeError: Bad magic number in .pyc file

• 올바른 버전의 VxVerify를 사용하고 있는지 확인하려면 다음 문서를 참조하십시오(아래 링크에서 Dell 지원 포털에 대한 인증 필요).
  • VxRail: VxRail Verify 툴을 실행하는 방법(VxVerify 릴리스 섹션) 
• VxVerify는 다음을 사용하여 전송, 실행 및 검색되는 미니언이라고 하는 프로그램을 생성합니다 SSH. 만약 SSH 아직 활성화되지 않은 경우에도 사용할 수 있으며 VxVerify가 활성화됩니다. SSH 명령을 실행할 각 호스트에 대해 호스트가 잠겨 있는 경우 SSH cannot run, 미니언을 실행할 수 없으며 호스트 테스트에서 결과 코드 2(실패) 또는 3(위험)을 반환합니다. 이 경우 SSH 권한이 있어야 합니다.
• VxVerify2는 VxRM VM에 있어야 하며 일반적으로 사용 가능한 유일한 Python 버전인 Python 2.7에서 실행되도록 설계되었습니다. 더 많은 Python 버전이 있는 경우 다음을 실행하여 테스트합니다( -h 옵션, 즉 --help명령 사용):

python2.7 vxverify.pyc -h

VxVerify가 로그 및 출력 파일을 /tmp/vxv/. 충분한 권한이 없으면 실행할 수 없습니다. 다음 명령을 사용하여 폴더 권한을 확인합니다. 모든 사용자에 대한 읽기/쓰기 권한이 없는 경우 chmod (루트 권한이 필요할 수 있음):

$ ls -lad /tmp/vxv

drwxrwxrwx  3 mystic   users      4096 Oct  1 07:42 vxv

• VxVerify에서 사용 권한 오류가 지속되면(예: '이전 로그 삭제 권한이 거부됨') vxv 다음 명령을 사용하는 폴더( 루트 암호는 sudo 액세스). 이 삭제 명령을 실행한 후에는 mystic 권한만 사용하여 VxVerify를 다시 설치해야 합니다.

sudo rm -r -d /tmp/vxv

• 다른 옵션은 VxVerify 출력 파일을 새 폴더에 저장하는 것입니다. 트리가 없는 경우 VxVerify에서 -l 또는 --log 옵션 다음에 로그를 저장해야 하는 경로가 옵니다. 예:

python vxverify.pyc -l /tmp/vx1

VxVerify2와 VxVerify 3의 문제 해결 차이점(VxRail 7.0.010+의 경우)

VxRail 7.0.010 이상의 경우 VxRM의 근본적인 변화로 인해 VxVerify 3을 사용해야 합니다.

다음을 제외하고 VxVerify2에 대한 동일한 문제 해결 단계가 VxVerify3에도 적용됩니다.

• Python for VxVerify3의 버전은 3.6입니다.
• VxVerify에서 변경이 필요한 사이트 패키지의 위치는 아래 위치 중 하나에 있습니다.
  • /mystic/telemetry/DCManager/venv/lib/python3.6/site-packages
  • /mystic/radar/venv/lib/python3.6/site-packages
• 이 두 폴더를 모두 신비한 사용자가 액세스할 수 없는 경우 VxVerify 프로그램에서 사이트 패키지에 대한 오류 메시지를 제공하고 종료합니다.
  • 해결 방법은 루트 사용자를 사용하는 것입니다.

시간 초과

미니언을 완료하는 데 20분 이상 걸리는 경우 VxVerify는 요약 표에 시간 초과 이벤트를 제공해야 합니다.

| Node-name  |Critical 66460| minion: Maximum run time for minion exceeded

• 해당 vxv.log 이에 대한 항목은 다음과 같습니다.

2022-10-06 06:42:51-WARNING  Creating a fault json for missing minion

2022-10-06 06:42:51-WARNING  [fail_minion] Producing result file for lab-esx22, due to: Maximum run time for minion exceeded. See minion logs in /tmp/vxv

• 해당 호스트의 미니언 로그에서 미니언을 중지하게 만든 오류가 발생했는지 또는 테스트가 느리게 계속되고 완료할 시간이 부족한지 확인하여 이를 확인해야 합니다.
• 미니언이 올바르게 완료되면 로그의 마지막 줄은 다음과 같아야 합니다.

2022-10-06 06:39:30 INFO    Writing to JSON: /tmp/xc882-61f1f3b9-7cb2-130a-35b0-minion.json

2022-10-06 06:39:30 INFO    JSON save: os.stat_result(st_mode=33206, st_ino=47144, st_dev=1, st_nlink=1, st_uid=0, st_gid=0, st_size=499562, st_atime=1665038370, st_mtime=1665038370, st_ctime=1665038370)

2022-10-06 06:39:30 DEBUG   ESXi minion's work is done.

JSON 파일 전송이 작동하지 않음

SCP 또는 SFTP를 사용하여 호스트 미니언 결과를 VxRM으로 다시 전송할 수 없는 경우 출력 테이블에 다음이 표시될 수 있습니다.

| Node-name  |Critical 66460| minion: No JSON downloaded from node via SSH

• 해당 vxv.log 이에 대한 항목은 다음과 같습니다.

2022-10-06 06:42:51-WARNING  Creating a fault json for missing minion

2022-10-06 06:42:51-WARNING  [fail_minion] Producing result file for lab-esx22, due to: No JSON downloaded from node via SSH. See minion logs in /tmp/vxv

• 해당 호스트의 미니언 로그에서 미니언이 중지되는 오류가 발생했는지 또는 JSON 파일이 생성되었지만 다음을 사용하여 액세스할 수 없는지 확인하여 확인해야 합니다 SSH.
• 미니언이 올바르게 완료되면 JSON이 성공적으로 저장되었음을 보여주는 로그의 마지막 줄이 다음과 같아야 합니다. /tmp 노드의 폴더:

2022-10-06 06:39:30 INFO    Writing to JSON: /tmp/xc882-61f1f3b9-7cb2-130a-35b0-minion.json

2022-10-06 06:39:30 INFO    JSON save: os.stat_result(st_mode=33206, st_ino=47144, st_dev=1, st_nlink=1, st_uid=0, st_gid=0, st_size=499562, st_atime=1665038370, st_mtime=1665038370, st_ctime=1665038370)

2022-10-06 06:39:30 DEBUG   ESXi minion's work is done.

위의 문제를 해결하기 위해 권장되는 단계는 다음과 같습니다.

• VxVerify3를 사용하는 경우 --fix 플래그 - 대안을 사용합니다. SSH 메커니즘. 이것은 일부를 피할 수 있습니다 SSH 권한 문제.
• 를 사용하여 새 경로 지정 -1 (폴더를 먼저 생성할 필요가 없음) VxRM 사용 권한 오류로 인해 파일이 전송되지 않는 경우 다음과 같은 도움이 될 수 있습니다.
• 예를 들면, 다음과 같습니다. > python vxv2.pyc -l \tmp\vxv0
• 위의 방법으로도 문제가 해결되지 않으면 에서 불필요한 파일과 폴더를 정리하기 전에 VxRM의 스냅샷을 생성하십시오. /tmp 및 /home/mystic이전에 VxVerify에서 사용한 것과 같은.
• VxRM(VxRail Manager)을 다시 시작합니다.

VxVerify에서 위의 단계로 해결할 수 없는 오류가 발생하는 경우 위에 설명된 대로 vxv 로그 번들을 저장하고 Dell 지원 팀에 문제를 에스컬레이션하십시오.

VxVerify2 및 VxVerify3의 로그인 및 자격 증명 오류

• VxRM(VxRail Manager) 및 VxRail 노드에서 테스트를 실행하는 경우 VxVerify에 자격 증명이 필요하지 않습니다. VxVerify는 VxRM 데이터베이스에서 직접 암호화된 자격 증명에 액세스하고 이를 사용하기 전에 해독합니다. VC 관리 자격 증명에 액세스할 수 없는 경우가 있으며, 이 경우 VxVerify 명령줄에서 이러한 자격 증명을 지정할 수 있습니다.

python vxverify.py --verbose -u vxrailmgmt@localos -p ChangeMe1!

• vCenter에서 허용되는 일부 특수 문자를 사용하면 VxRail Manager(특히 Linux 셸을 활용하는 명령)에 문제가 발생할 수 있습니다. vCenter 또는 ESXi 호스트의 암호에 다음 문자가 사용되지 않았는지 확인합니다.

` $ % / \

• 관리에 어떤 사용자 이름이 사용되고 있는지 확실하지 않은 경우 vxv.log. 예:

... - DEBUG Users from runtime & settings records:     vxrailmgmt@localos & vxrailmgmt@localos

• SSH를 사용하여 vCenter에 대한 테스트에는 루트 사용자 이름과 비밀번호가 필요합니다. -r 및 -w 옵션을 각각 선택합니다. vCenter 테스트는 지정된 경우에만 실행됩니다(루트 사용자가 root, 기본값인 경우 루트 암호만 지정해야 함). 예:

python vxverify.py --verbose -w R00tPassword!

중요한 테스트 실패 예

이는 추가 테스트가 실행되지 않는 심각한 오류의 결과일 수 있습니다. 예를 들어 VxRM에 저장된 vCenter 관리 사용자 이름과 암호가 최신이 아닌 경우 VC API에 대한 모든 쿼리가 실패하고 추가 테스트를 실행할 수 없습니다. 예를 들면 다음과 같습니다.

#========================#======#=========#====================================================================#==============#
|  Hostname / Category   |Status  Dell_KB |  Warnings or Failures, unless tests Passed                         | Product S.N. |
#========================#======#=========#====================================================================#==============#
| VxRM                   | Critical 66460 | vc_external: VC MOB API connection failed                                        .| <- Stored vCenter password rejected
| VxRail                 | Critical 66460 | vxtii_err: Internal DO host query failed. See vxv.log for details in /tmp/vxv    .| <- ESXi node data cannot be retrieved from the VxRM config service
| _cluster               | Critical 66460 | esx_vers: No valid ESXi test results found                                       .| <- No ESXi tests could be run

VxVerify 파일

VxVerify는 다음 파일을 /tmp/vxv/ 또는 /var/log/mystic/vxv/ (를 사용하여 다른 로깅 폴더를 지정하지 않는 한 -l 인수).  이러한 파일은 모두 단일 아카이브 파일에 저장됩니다. /tmp같은 /tmp/vxverify-569ae010.zip 또는 /tmp/vxv_previous_01.zip을 클릭합니다.
이러한 파일을 수동으로 확인하면 VxVerify 스크립트가 완전히 완료되지 않은 경우에도 클러스터의 문제를 찾는 데 도움이 될 수 있습니다.   

• vxv.log - (VxVerify 스크립트의 로그 파일)
• minion_hostname.log - (각 호스트에서 실행 중인 미니언 스크립트에 대한 원격 로그)
• minion_hostname.txt - (각 미니언에 대한 원격 텍스트 출력, 진행 중인 테스트 번호 표시)
• /json/host_uid.json - (각 미니언에서 테스트 결과와 함께 생성한 파일로, 나중에 다른 호스트 데이터와 병합된 후 삭제됨)
• vxverify_tests.json - (모든 테스트에 대한 결합된 출력, 모든 테스트 결과를 보기 위해 수동으로 확인할 수 있음)
• vxtii.json - (iDRAC 하드웨어 인벤토리 등의 쿼리에 대한 호스트의 응답 결합)
• vxtii.txt - (각 노드에 대한 iDRAC 및 ESXi 정보를 요약한 보고서)
• vxverify.txt - (VxVerify가 자동 모드로 실행되지 않는 경우 요약 테이블도 화면에 표시됨)
• vxverify.html - (HTML 형식의 VxVerify 및 VxTii 결합 보고서)(VxVerify를 직접 실행하는 경우에만 표시되며, VxRail Manager 상태 점검에 포함되지 않음)