9.4. 로그 및 사용자 정의 리소스

문제 해결을 위해 로그 및 CR(사용자 정의 리소스) 정보를 다운로드할 수 있습니다. 자세한 내용은 마이그레이션 워크플로 를 참조하십시오.

9.4.1. 수집된 로그 및 사용자 정의 리소스 정보

MTV 웹 콘솔 또는 CLI(명령줄 인터페이스)를 사용하여 다음 대상에 대한 로그 및 CR(사용자 정의 리소스) yaml 파일을 다운로드할 수 있습니다.

  • 마이그레이션 계획: 웹 콘솔 또는 CLI.
  • 가상 머신: 웹 콘솔 또는 CLI.
  • namespace: CLI만 해당.

must-gather 툴은 아카이브 파일에서 다음 로그 및 CR 파일을 수집합니다.

  • CRs:

    • DataVolume CR: 마이그레이션된 VM에 마운트된 디스크를 나타냅니다.
    • VirtualMachine CR: 마이그레이션된 VM을 나타냅니다.
    • plan CR: VM 및 스토리지 및 네트워크 매핑을 정의합니다.
    • Job CR: 선택 사항: 사전 마이그레이션 후크, 마이그레이션 후 후크 또는 둘 다를 나타냅니다.

  • 로그:

    • 가져오기 Pod: Disk-to-data-volume 변환 로그입니다. 가져오기 Pod 이름 지정 규칙은 importer-<migration_plan>-<vm_id><5_char_id >입니다. 예를 들어 importer-mig-plan-ed90dfc6-9a8btnfh. 여기서 ed90dfc6-9a17-4a8 은 잘린 RHV VM ID이고 btnfh 는 생성된 5자 ID입니다.
    • 변환 Pod: VM 변환 로그. 변환 Pod는 virt-v2v 를 실행하여 VM의 PVC에 장치 드라이버를 설치하고 구성합니다. 변환 Pod 이름 지정 규칙은 < migration_plan>-<vm_id><5_char_id >입니다.
    • virt-launcher Pod: VM 시작 관리자 로그. 마이그레이션된 VM이 켜지면 virt-launcher Pod는 VM 디스크로 연결된 PVC와 함께 QEMU-KVM 을 실행합니다.
    • Forklift-controller pod: 마이그레이션 계획, 가상 머신 또는 must-gather 명령으로 지정된 네임스페이스에 대해 로그가 필터링됩니다.
    • Forklift-must-gather-api Pod: 마이그레이션 계획, 가상 머신 또는 must-gather 명령에 지정된 네임스페이스에 대해 로그가 필터링됩니다.

    • hook-job pod: 후크 작업에 대해 로그가 필터링됩니다. hook-job 이름 지정 규칙은'<migration_plan>-<vm_id><5_char_id> 입니다. 예를 들어 'plan2j-vm-3696-posthook-4mx85 또는 plan2j-vm-3696-prehook-mwqnl.

      참고

      빈 로그 파일 또는 제외된 로그 파일은 must-gather 아카이브 파일에 포함되어 있지 않습니다.

VMware 마이그레이션 계획의 must-gather 아카이브 구조의 예

must-gather
└── namespaces
    ├── target-vm-ns
    │   ├── crs
    │   │   ├── datavolume
    │   │   │   ├── mig-plan-vm-7595-tkhdz.yaml
    │   │   │   ├── mig-plan-vm-7595-5qvqp.yaml
    │   │   │   └── mig-plan-vm-8325-xccfw.yaml
    │   │   └── virtualmachine
    │   │       ├── test-test-rhel8-2disks2nics.yaml
    │   │       └── test-x2019.yaml
    │   └── logs
    │       ├── importer-mig-plan-vm-7595-tkhdz
    │       │   └── current.log
    │       ├── importer-mig-plan-vm-7595-5qvqp
    │       │   └── current.log
    │       ├── importer-mig-plan-vm-8325-xccfw
    │       │   └── current.log
    │       ├── mig-plan-vm-7595-4glzd
    │       │   └── current.log
    │       └── mig-plan-vm-8325-4zw49
    │           └── current.log
    └── openshift-mtv
        ├── crs
        │   └── plan
        │       └── mig-plan-cold.yaml
        └── logs
            ├── forklift-controller-67656d574-w74md
            │   └── current.log
            └── forklift-must-gather-api-89fc7f4b6-hlwb6
                └── current.log

9.4.2. 웹 콘솔에서 로그 및 사용자 정의 리소스 정보 다운로드

완료된 마이그레이션 계획 또는 MTV 웹 콘솔을 사용하여 마이그레이션된 가상 머신(VM)에 대한 로그 및 CR(사용자 정의 리소스)에 대한 정보를 다운로드할 수 있습니다.

절차

  1. 웹 콘솔에서 마이그레이션 계획을 클릭합니다.
  2. 마이그레이션 계획 이름 옆에 있는 로그 가져오기 를 클릭합니다.

  3. 로그 가져오기 창에서 로그 가져오기 를 클릭합니다.

    로그가 수집됩니다. 로그 수집 완료 메시지가 표시됩니다.

  4. 로그 다운로드를 클릭하여 아카이브 파일을 다운로드합니다.
  5. 마이그레이션된 VM의 로그를 다운로드하려면 마이그레이션 계획 이름을 클릭한 다음 VM 옆에 있는 로그 가져오기 를 클릭합니다.

9.4.3. 명령줄 인터페이스에서 로그 및 사용자 정의 리소스 정보에 액세스

must-gather 툴을 사용하여 명령줄 인터페이스에서 CR(사용자 정의 리소스)에 대한 로그 및 정보에 액세스할 수 있습니다. 모든 고객 사례에 must-gather 데이터 파일을 첨부해야 합니다.

필터링 옵션을 사용하여 특정 네임스페이스, 완료, 실패 또는 취소됨 마이그레이션 계획 또는 마이그레이션된 가상 머신(VM)에 대한 데이터를 수집할 수 있습니다.

참고

필터링된 must-gather 명령에서 존재하지 않는 리소스를 지정하는 경우 아카이브 파일이 생성되지 않습니다.

사전 요구 사항

  • cluster-admin 역할의 사용자로 OpenShift Virtualization 클러스터에 로그인해야 합니다.
  • OpenShift Container Platform CLI(oc) 가 설치되어 있어야 합니다.

절차

  1. must-gather 데이터를 저장하려는 디렉터리로 이동합니다.

  2. oc adm must-gather 명령을 실행합니다. 

    $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.3.0

    데이터는 /must-gather/must-gather.tar.gz로 저장됩니다. Red Hat 고객 포털에서 해당 지원 사례에 이 파일을 업로드할 수 있습니다.

  3. 선택 사항: 다음 옵션을 사용하여 oc adm must-gather 명령을 실행하여 필터링된 데이터를 수집합니다.

    • 네임스페이스: 

      $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.3.0 \
  -- NS=<namespace> /usr/bin/targeted

    • 마이그레이션 계획: 

      $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.3.0 \
  -- PLAN=<migration_plan> /usr/bin/targeted

    • 가상 머신: 

      $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.3.0 \
  -- VM=<vm_name> NS=<namespace> /usr/bin/targeted 1
      1
      Plan CR에 표시된 대로 VM ID가 아닌 VM 이름을 지정해야 합니다.