3.9. 유틸리티

3.9.1. oVirt 엔진 이름 바꾸기 도구

3.9.1.1. oVirt 엔진 이름 바꾸기 도구

engine-setup 명령이 클린 환경에서 실행되면 명령은 설정 프로세스 중에 제공된 Manager의 정규화된 도메인 이름을 사용하는 여러 인증서와 키를 생성합니다. 관리자가 다른 도메인으로 호스팅하는 시스템의 마이그레이션으로 인해 관리자의 정규화된 도메인 이름을 나중에 변경해야 하는 경우 새 이름을 반영하도록 정규화된 도메인 이름의 레코드를 업데이트해야 합니다. ovirt-engine-rename 명령은 이 작업을 자동화합니다.

ovirt-engine-rename 명령은 다음 위치에서 관리자의 정규화된 도메인 이름에 대한 레코드를 업데이트합니다.

  • /etc/ovirt-engine/engine.conf.d/10-setup-protocols.conf
  • /etc/ovirt-engine/isouploader.conf.d/10-engine-setup.conf
  • /etc/ovirt-engine/logcollector.conf.d/10-engine-setup.conf
  • /etc/pki/ovirt-engine/cert.conf
  • /etc/pki/ovirt-engine/cert.template
  • /etc/pki/ovirt-engine/certs/apache.cer
  • /etc/pki/ovirt-engine/keys/apache.key.nopass
  • /etc/pki/ovirt-engine/keys/apache.p12
참고

이 작업을 수행할 필요가 있는지 확신합니까?

버전 4.0.4부터 Manager 웹 인터페이스에 액세스하려면 더 많은 이름을 추가할 수 있습니다.

  1. 선택한 이름이 DNS 서버 또는 /etc/hosts 에 레코드를 추가하여 Manager 시스템의 IP 주소로 확인할 수 있는지 확인합니다( ping 엔진 이름 또는 getent 호스트 엔진 이름을 사용하여 점검).
  2. 다음을 실행합니다.

      ----
      # echo 'SSO_ALTERNATE_ENGINE_FQDNS="alias1.example.com alias2.example.com"' \
      > /etc/ovirt-engine/engine.conf.d/99-custom-sso-setup.conf
      # systemctl restart ovirt-engine.service
      ----
    . List the alternate names separated by spaces.

Manager 시스템의 IP 주소를 추가할 수도 있습니다. 그러나 DNS 이름 대신 IP 주소를 사용하는 것은 좋지 않습니다.

주의

ovirt-engine-rename 명령은 Manager가 실행하는 웹 서버에 대한 새 인증서를 생성하지만 관리자 또는 인증 기관의 인증서에는 영향을 미치지 않습니다. 이로 인해 ovirt-engine-rename 명령을 사용하는 경우 특히 Red Hat Enterprise Virtualization 3.2 및 이전 버전에서 업그레이드된 환경에서 약간의 위험이 있습니다. 따라서 engine -cleanup 및 engine- setup 을 실행하여 Manager의 정규화된 도메인 이름을 변경하는 것이 좋습니다.

주의

업그레이드 프로세스 중에 이전 호스트 이름을 확인할 수 있어야 합니다. oVirt Engine Rename 툴이 실패하고 [ERROR ] 호스트 이름이 유효하지 않습니다. <OLD FQDN>이 IP 주소가 확인되지 않은 경우 이전 호스트 이름을 /etc/hosts 파일에 추가하고 oVirt Engine Rename 도구를 사용한 다음 /etc/hosts 파일에서 이전 호스트 이름을 제거합니다.

3.9.1.2. oVirt Engine Rename 명령 구문

ovirt-engine-rename 명령의 기본 구문은 다음과 같습니다.

# /usr/share/ovirt-engine/setup/bin/ovirt-engine-rename

명령은 다음 옵션도 허용합니다.

--newname=[새 이름]
사용자 상호 작용 없이 Manager에 대해 정규화된 새 도메인 이름을 지정할 수 있습니다.
--log=[file]
파일 이름 바꾸기 작업의 로그를 작성할 파일의 경로와 이름을 지정할 수 있습니다.
--config=[file]
파일 이름 변경 작업에 로드할 구성 파일의 경로와 파일 이름을 지정할 수 있습니다.
--config-append=[file]
파일 이름 작업에 추가할 구성 파일의 경로와 파일 이름을 지정할 수 있습니다. 이 옵션을 사용하여 기존 응답 파일의 경로와 파일 이름을 지정하여 이름 변경 작업을 자동화할 수 있습니다.
--generate-answer=[file]
ovirt-engine-rename 명령으로 변경된 값과 응답이 기록되는 파일의 경로와 파일 이름을 지정할 수 있습니다.

3.9.1.3. oVirt Engine 이름 바꾸기 도구로 관리자 이름 변경

ovirt-engine-rename 명령을 사용하여 관리자의 FQDN(정규화된 도메인 이름) 레코드를 업데이트할 수 있습니다.

툴은 관리자가 로컬 ISO 또는 데이터 스토리지 도메인을 제공하는지 확인합니다. 이 도구가 있는 경우 작업을 계속하기 전에 스토리지에 연결된 가상 시스템 또는 스토리지 도메인을 유지 관리 모드로 제거, 종료 또는 배치하라는 메시지를 사용자에게 표시합니다. 이렇게 하면 가상 시스템이 가상 디스크와의 연결이 끊어지지 않으며 이름 변경 프로세스 중에 ISO 스토리지 도메인이 연결이 손실되지 않도록 합니다.

절차

  1. 새 FQDN에 대해 모든 DNS 및 기타 관련 레코드를 준비합니다.
  2. DHCP를 사용하는 경우 DHCP 서버 구성을 업데이트합니다.
  3. Manager에서 호스트 이름을 업데이트합니다.
  4. 다음 명령을 실행합니다.

    # /usr/share/ovirt-engine/setup/bin/ovirt-engine-rename
  5. 메시지가 표시되면 Enter 키를 눌러 엔진 서비스를 중지합니다.

    During execution engine service will be stopped (OK, Cancel) [OK]:
  6. 메시지가 표시되면 Manager에 새 FQDN을 입력합니다.

    New fully qualified server name:new_engine_fqdn

ovirt-engine-rename 명령은 Manager의 FQDN 레코드를 업데이트합니다.

자체 호스팅 엔진의 경우 다음 추가 단계를 완료합니다.

  1. 기존의 모든 자체 호스팅 엔진 노드에서 다음 명령을 실행합니다.

    # hosted-engine --set-shared-config fqdn new_engine_fqdn --type=he_local

    이 명령은 각 자체 호스팅 엔진 노드의 로컬 /etc/ovirt-hosted-engine-ha/hosted-engine.conf에서 FQDN을 수정합니다.

  2. 자체 호스팅 엔진 노드 중 하나에서 다음 명령을 실행합니다.

    # hosted-engine --set-shared-config fqdn new_engine_fqdn --type=he_shared

    이 명령은 공유 스토리지 도메인의 /etc/ovirt-hosted-engine-ha/hosted-engine.conf 의 기본 사본에 있는 FQDN을 수정합니다.

이제 모든 신규 및 기존 자체 호스팅 엔진 노드에서 새 FQDN을 사용합니다.

참고

oVirt Engine Rename 도구는 로컬 머신에서만 작동하도록 설계되었습니다. 관리자 이름을 변경해도 원격 데이터ECDHE 시스템에서 이름이 자동으로 업데이트되지 않습니다. 원격 DWH 머신에서 이름 변경은 수동으로 수행해야 합니다.

원격 데이터ECDHE 배포의 경우 원격 시스템에서 다음 단계를 수행합니다(관리자 머신에서 아님).

  1. 다음 PKI 파일을 제거합니다.

    /etc/pki/ovirt-engine/apache-ca.pem/etc/pki/ovirt-engine/apache-grafana-ca.pem/etc/pki/ovirt-engine/certs/*/etc/pki/ovirt-engine/keys/*

  2. 다음 파일에서 Manager fqdn;을 새 이름으로 업데이트합니다(예: vm-new-name.local_lab_server.redhat.com).

    /etc/grafana/grafana.ini/etc/ovirt-engine-dwhh/ovirt-engine-dwhd.conf.d/10-setup-database.conf/etc/ovirt-engine-setup.conf.d/20-setup-ovirt-post.conf

  3. 현재 업데이트를 방지하려면 --offline 스위치를 사용하여 engine-setup을 실행합니다.

    # engine-setup --offline

3.9.2. 엔진 설정 도구

3.9.2.1. 엔진 설정 도구

엔진 구성 도구는 Red Hat Virtualization 환경에 대한 글로벌 설정을 구성하는 명령줄 유틸리티입니다. 툴은 엔진 데이터베이스에 저장된 키-값 매핑 목록과 상호 작용하며 개별 키의 값을 검색 및 설정하고 사용 가능한 모든 구성 키와 값 목록을 검색할 수 있습니다. 또한 Red Hat Virtualization 환경의 각 구성 수준에 대해 다양한 값을 저장할 수 있습니다.

참고

구성 키의 값을 검색하거나 설정하기 위해 Red Hat Virtualization Manager와 Red Hat JBoss Enterprise Application Platform을 실행하지 않아도 됩니다. 구성 키 값 키 매핑은 엔진 데이터베이스에 저장되므로 postgresql 서비스가 실행되는 동안 업데이트할 수 있습니다. 그런 다음 ovirt-engine 서비스를 다시 시작할 때 변경 사항이 적용됩니다.

3.9.2.2. engine-config 명령의 구문

Red Hat Virtualization Manager가 설치된 시스템에서 엔진 구성 도구를 실행할 수 있습니다. 사용법에 대한 자세한 정보를 보려면 명령의 도움말 출력을 출력합니다.

# engine-config --help

일반적인 작업:

  • 사용 가능한 구성 키 나열

    # engine-config --list
  • 사용 가능한 구성 값 나열

    # engine-config --all
  • 구성 키 검색 값

    # engine-config --get KEY_NAME

    KEY_NAME 을 지정된 버전의 키에 대한 값을 검색하도록 기본 키의 이름으로 교체합니다. c ver 매개 변수를 사용하여 검색할 값의 구성 버전을 지정합니다. 버전을 제공하지 않으면 기존 버전의 값이 모두 반환됩니다.

  • 구성 키의 값 설정

    # engine-config --set KEY_NAME=KEY_VALUE --cver=VERSION

    KEY_NAME 을 설정할 특정 키의 이름으로 바꾸고 KEY_VALUE 를 설정할 값으로 바꿉니다. 둘 이상의 구성 버전이 있는 환경에서 VERSION 을 지정해야 합니다.

  • ovirt-engine 서비스를 다시 시작하여 변경 사항을 로드합니다.

    변경 사항을 적용하려면 ovirt-engine 서비스를 다시 시작해야 합니다.

    # systemctl restart ovirt-engine.service

3.9.3. USB 필터 편집기

3.9.3.1. USB 필터 편집기 설치

USB 필터 편집기는 usbfilter.txt 정책 파일을 구성하는 데 사용되는 Windows 도구입니다. 이 파일에 정의된 정책 규칙은 Red Hat Virtualization Manager를 사용하여 관리되는 가상 시스템으로 클라이언트 시스템에서 특정 USB 장치의 자동 패스스루를 허용하거나 거부합니다. 정책 파일은 Red Hat Virtualization Manager에 있는 /etc/ovirt-engine/usbfilter.txt 에서 Red Hat Virtualization Manager의 ovirt-engine 서비스를 다시 시작하지 않는 한 적용되지 않습니다.

이 "Red Hat Virtualization Manager용 설치 프로그램 및 이미지" 항목에서 USB 필터 편집기 설치 프로그램을 다운로드합니다.

절차

  1. Windows 시스템에서. zip 파일에서 .msi intaller를 추출하고. msi 설치 프로그램을 실행합니다.
  2. 설치 마법사의 단계를 따릅니다. 별도로 명시하지 않는 한, 기본적으로 USB 필터 편집기는 Windows 버전에 따라 C:\Program Files\RedHat\ Filter Editor 또는 C:\Program Files(x86)\RedHat\jpg Filter Editor 에 설치됩니다.
  3. 바탕 화면에 USB 필터 편집기 바로 가기 아이콘이 생성됩니다.
중요

WinSCP 와 같은 SCP(Secure Copy) 클라이언트를 사용하여 Red Hat Virtualization Manager에서 필터 정책을 가져오고 내보냅니다.

기본 USB 장치 정책에서는 가상 시스템에 USB 장치에 대한 기본 액세스 권한을 제공합니다. 추가 USB 장치를 사용하도록 정책을 업데이트합니다.

3.9.3.2. USB 필터 편집기 인터페이스

바탕 화면에서 USB 필터 편집기 바로 가기 아이콘을 두 번 클릭합니다.

Red Hat USB 필터 편집기 인터페이스는 각 USB 장치에 대한 클래스,벤더 , 제품, 버전 및 작업을 표시합니다. 허용되는 USB 장치는 Action 열에서 Allow 로 설정됩니다. 금지된 장치는 Block 으로 설정됩니다.

표 3.7. USB 편집기 필드

이름설명

클래스

USB 장치 유형(예: 프린터, 대용량 스토리지 컨트롤러).

벤더

선택한 장치 유형의 제조업체입니다.

제품

특정 USB 장치 모델.

버전

제품의 버전입니다.

동작

지정된 장치를 허용하거나 차단합니다.

USB 장치 정책 규칙은 나열된 순서대로 처리됩니다. UpDown 버튼을 사용하여 목록에서 규칙을 더 높이거나 아래로 이동합니다. 범용 블록 규칙은 USB 필터 편집기에서 명시적으로 허용되지 않는 한 모든 USB 장치가 거부되도록 하려면 가장 낮은 항목으로 유지해야 합니다.

3.9.3.3. USB 정책 추가

바탕 화면에서 USB 필터 편집기 바로 가기 아이콘을 두 번 클릭합니다. 그러면 편집기가 열립니다.

절차

  1. 추가를 클릭합니다.
  2. USB 클래스,벤더 ID,제품 ID버전 확인란을 사용하고 목록을 사용하여 장치를 지정합니다.

    USB 장치의 가상 시스템 사용을 허용하려면 Allow (허용) 버튼을 클릭합니다. Block (블록) 버튼을 클릭하여 USB 장치가 가상 시스템의 사용을 금지합니다.

    OK(확인 )를 클릭하여 선택한 필터 규칙을 목록에 추가하고 창을 닫습니다.

    예 3.17. 장치 추가

    다음은 제조업체 Acer Communications & Multimedia 에서 허용되는 장치 목록에 USB 클래스 스마트 카드, 장치 EP-1427X-2 이더넷 어댑터 를 추가하는 방법의 예입니다.

    장치 추가
  3. FileSave (저장) 를 클릭하여 변경 사항을 저장합니다.

USB 필터 편집기에 USB 정책을 추가했습니다. USB 필터 정책을 Red Hat Virtualization Manager로 내보내야 적용됩니다.

추가 리소스

3.9.3.4. USB 정책 제거

바탕 화면에서 USB 필터 편집기 바로 가기 아이콘을 두 번 클릭합니다. 그러면 편집기가 열립니다.

절차

  1. 제거할 정책을 선택합니다.
  2. Remove(제거)를 클릭합니다. 정책을 제거할지 확인하라는 메시지가 메시지가 표시됩니다.
  3. Yes (예)를 클릭하여 정책을 제거할지 확인합니다.
  4. FileSave (저장) 를 클릭하여 변경 사항을 저장합니다.

USB 필터 편집기에서 USB 정책을 제거했습니다. USB 필터 정책을 Red Hat Virtualization Manager로 내보내야 적용됩니다.

추가 리소스

3.9.3.5. USB 장치 정책 검색

연결된 USB 장치를 검색하여 USB 필터 편집기에서 허용하거나 차단합니다.

바탕 화면에서 USB 필터 편집기 바로 가기 아이콘을 두 번 클릭합니다. 그러면 편집기가 열립니다.

절차

  1. Search를 클릭합니다 연결된 USB 장치 창에 연결된 모든 장치 목록이 표시됩니다.
  2. 장치를 선택하고 필요에 따라 Allow or Block(허용 또는 차단 )을 클릭합니다. 선택한 장치를 두 번 클릭하여 창을 닫습니다. 장치의 정책 규칙이 목록에 추가됩니다.
  3. UpDown 버튼을 사용하여 목록에서 새 정책 규칙의 위치를 변경합니다.
  4. FileSave (저장) 를 클릭하여 변경 사항을 저장합니다.

연결된 USB 장치를 검색했습니다. 적용하려면 USB 필터 정책을 Red Hat Virtualization Manager에 내보내야 합니다.

3.9.3.6. USB 정책 내보내기

업데이트된 정책을 적용하려면 USB 장치 정책 변경 사항을 내보내고 Red Hat Virtualization Manager에 업로드해야 합니다. 정책을 업로드하고 ovirt-engine 서비스를 다시 시작합니다.

바탕 화면에서 USB 필터 편집기 바로 가기 아이콘을 두 번 클릭합니다. 그러면 편집기가 열립니다.

절차

  1. Export(내보내기 )를 클릭합니다. Save As (다른 이름으로 저장) 창이 열립니다.
  2. 파일 이름이 usbfilter.txt 인 파일을 저장합니다.
  3. WinSCP와 같은 보안 복사 클라이언트를 사용하여 usbfilter.txt 파일을 Red Hat Virtualization Manager를 실행하는 서버에 업로드합니다. 파일은 서버의 다음 디렉토리에 위치해야 합니다. /etc/ovirt-engine/
  4. Red Hat Virtualization Manager를 실행하는 서버에서 root 사용자로 ovirt-engine 서비스를 다시 시작합니다.

    # systemctl restart ovirt-engine.service

3.9.3.7. USB 정책 가져오기

기존 USB 장치 정책을 다운로드하여 USB 필터 편집기로 가져와야 편집할 수 있습니다.

절차

  1. WinSCP와 같은 보안 복사 클라이언트를 사용하여 Red Hat Virtualization Manager를 실행하는 서버에서 usbfilter.txt 파일을 다운로드합니다. 파일은 서버의 다음 디렉토리에 있습니다. /etc/ovirt-engine/
  2. 바탕 화면에서 USB 필터 편집기 바로 가기 아이콘을 두 번 클릭합니다. 그러면 편집기가 열립니다.
  3. Import(가져오기)를 클릭합니다. 그러면 Open 창이 열립니다.
  4. 서버에서 다운로드한 usbfilter.txt 파일을 엽니다.

3.9.4. 이미지 불일치 툴

3.9.4.1. 이미지 불일치 툴을 사용하여 스냅샷 상태 모니터링

RHV 이미지 논의 툴은 스토리지 도메인 및 RHV 데이터베이스의 이미지 데이터를 분석합니다. 볼륨 및 볼륨 속성에서 불일치를 발견하더라도 이러한 불일치를 수정하지 않는 경우 경고합니다. 다음과 같은 다양한 시나리오에서 이 도구를 사용합니다.

  • 버전을 업그레이드하기 전에 손상된 볼륨 또는 체인을 새 버전으로 전달하지 않도록 합니다.
  • 실패한 스토리지 작업을 수행한 후 상태가 잘못된 상태에서 볼륨 또는 속성을 감지합니다.
  • 백업에서 RHV 데이터베이스 또는 스토리지를 복원한 후 다음을 수행합니다.
  • 정기적으로 잠재적인 문제를 보다 먼저 감지합니다.
  • 스냅샷 또는 실시간 스토리지 마이그레이션 관련 문제를 분석하고 이러한 유형의 문제를 해결한 후 시스템 상태를 확인하려면 다음을 수행합니다.

사전 요구 사항

  • 필수 버전: 이 도구는 rhv-log-collector-analyzer-0.2.15-0.el7ev 와 함께 RHV 버전 4.3.8에서 도입되었습니다.
  • 데이터 컬렉션은 서로 다른 위치에서 동시에 실행되며 원자성이 아니므로 스토리지 도메인을 수정할 수 있는 환경의 모든 활동을 중지합니다. 즉, 스냅샷을 생성하거나 제거하거나, 디스크를 편집, 이동, 생성 또는 제거하지 마십시오. 그렇지 않으면 불일치에 대한 잘못된 탐지가 발생할 수 있습니다. 가상 머신은 프로세스 중에 정상적으로 실행되도록 유지할 수 있습니다.

절차

  1. 툴을 실행하려면 RHV Manager에 다음 명령을 입력합니다.

    # rhv-image-discrepancies
  2. 툴에서 불일치를 발견하는 경우, 특히 도구를 실행하는 동안 일부 작업을 수행할 가능성이 있는 경우 결과를 확인하기 위해 다시 실행합니다.
참고

이 툴에는 모든 내보내기 및 ISO 스토리지 도메인이 포함되어 있으며 불일치를 보고할 수 있습니다. 이러한 스토리지 도메인에는 RHV 데이터베이스의 이미지에 대한 항목이 없으므로 해당 스토리지 도메인은 무시할 수 있습니다.

결과 이해

도구는 다음을 보고합니다.

  • 스토리지에 표시되지만 데이터베이스에 표시되지 않거나 데이터베이스에 표시되지만 스토리지에 없는 볼륨이 있는 경우.
  • 스토리지와 데이터베이스 간에 일부 볼륨 특성이 다른 경우.

샘플 출력:

 Checking storage domain c277ad93-0973-43d9-a0ca-22199bc8e801
    Looking for missing images...
    No missing images found
    Checking discrepancies between SD/DB attributes...
    image ef325650-4b39-43cf-9e00-62b9f7659020 has a different attribute capacity on storage(2696984576) and on DB(2696986624)
    image 852613ce-79ee-4adc-a56a-ea650dcb4cfa has a different attribute capacity on storage(5424252928) and on DB(5424254976)

 Checking storage domain c64637b4-f0e8-408c-b8af-6a52946113e2
    Looking for missing images...
    No missing images found
    Checking discrepancies between SD/DB attributes...
    No discrepancies found

3.9.5. 로그 수집기 도구

3.9.5.1. Log Collector

로그 수집 툴은 Red Hat Virtualization Manager에 포함되어 있습니다. 이를 통해 지원을 요청할 때 Red Hat Virtualization 환경에서 관련 로그를 쉽게 수집할 수 있습니다.

로그 수집 명령은 ovirt-log-collector 입니다. root 사용자로 로그인하고 Red Hat Virtualization 환경에 대한 관리 자격 증명을 제공해야 합니다. ovirt-log-collector -h 명령은 ovirt-log-collector 명령에 유효한 모든 옵션 목록을 포함하여 사용 정보를 표시합니다.

3.9.5.2. ovirt-log-collector 명령의 구문

로그 수집기의 기본 구문은 다음과 같습니다.

# ovirt-log-collector options  list all|clusters|datacenters
# ovirt-log-collector options collect

지원되는 두 가지 작업 모드는 목록수집 입니다.

  • list 매개 변수는 Red Hat Virtualization Manager에 연결된 호스트, 클러스터 또는 데이터 센터를 나열합니다. 나열된 오브젝트를 기반으로 로그 컬렉션을 필터링할 수 있습니다.
  • collect 매개변수는 Red Hat Virtualization Manager에서 로그 수집을 수행합니다. 수집된 로그는 /tmp/logcollector 디렉토리 아래에 있는 아카이브 파일에 저장됩니다. ovirt-log-collector 명령은 각 로그에 특정 파일 이름을 할당합니다.

다른 매개 변수를 지정하지 않는 한 기본 작업은 사용 가능한 호스트를 보유한 데이터 센터 및 클러스터와 함께 나열하는 것입니다. 특정 로그를 검색하려면 사용자 이름과 암호를 입력하라는 메시지가 표시됩니다.

ovirt-log-collector 명령을 추가로 구체화하기 위한 여러 매개 변수가 있습니다.

일반 옵션

--version
사용 중인 명령의 버전 번호를 표시하고 프롬프트로 돌아갑니다.
-h, --help
명령 사용 정보를 표시하고 프롬프트로 돌아갑니다.
--conf-file=PATH
도구에서 사용할 구성 파일로 PATH 를 설정합니다.
--local-tmp=PATH
로그가 저장되는 디렉터리로 PATH 를 설정합니다. 기본 디렉토리는 /tmp/logcollector 입니다.
--ticket-number=TICKET
TICKET 을 티켓 또는 케이스 번호로 설정하여 SOS 보고서와 연결합니다.
--upload=FTP_SERVER

FTP를 사용하여 FTP_SERVER 를 검색된 로그의 대상으로 설정합니다.

Red Hat 지원 담당자에게 문의하지 않는 한 이 옵션을 사용하지 마십시오.

--log-file=PATH
명령이 로그 출력에 사용해야 하는 특정 파일 이름으로 PATH 를 설정합니다.
--quiet
자동 모드를 설정하여 콘솔 출력을 최소한으로 줄입니다. 자동 모드는 기본적으로 꺼져 있습니다.
-v, --verbose
더 많은 콘솔 출력을 제공하는 자세한 정보 표시 모드를 설정합니다. 자세한 정보 표시 모드는 기본적으로 꺼져 있습니다.
--time-only
전체 SOS 보고서를 생성하지 않고 호스트 간 시간 차이에 대한 정보만 표시합니다.

Red Hat Virtualization Manager 옵션

이러한 옵션은 로그 컬렉션을 필터링하고 Red Hat Virtualization Manager의 인증 세부 정보를 지정합니다.

이러한 매개 변수는 특정 명령에 결합할 수 있습니다. 예를 들어 ovirt-log-collector --user=admin@internal --cluster ClusterA,ClusterB --hosts "SalesHost"* 는 사용자를 admin@internal 로 지정하고 AB 클러스터의 SalesHost 호스트로만 로그 컬렉션을 제한합니다.

--no-hypervisors
로그 컬렉션에서 가상화 호스트를 생략합니다.
--one-hypervisor-per-cluster
각 클러스터에서 하나의 호스트(SPM)의 로그를 수집합니다.
-u USER, --user=USER
로그인에 사용할 사용자 이름을 설정합니다. USER 는 형식 user@domain 에서 지정됩니다. 여기서 user 는 사용자 이름이며 domain 사용 중인 디렉터리 서비스 도메인입니다. 사용자는 디렉터리 서비스에 있어야 하며 Red Hat Virtualization Manager에 알려야 합니다.
-r FQDN, --rhevm=FQDN
로그를 수집할 Red Hat Virtualization Manager의 정규화된 도메인 이름을 설정합니다. 여기서 FQDN 은 Manager의 정규화된 도메인 이름으로 대체됩니다. 로그 수집기가 Red Hat Virtualization Manager와 동일한 로컬 호스트에서 실행되고 있다고 가정합니다. 기본값은 localhost 입니다.
-c CLUSTER, --cluster=CLUSTER
Red Hat Virtualization Manager의 로그 외에도 nominated CLUSTER 의 가상화 호스트에서 로그를 수집합니다. 포함하기 위한 클러스터를 쉼표로 구분된 클러스터 이름 또는 일치 패턴 목록에 지정해야 합니다.
-d DATACENTER, --data-center=DATACENTER
Red Hat Virtualization Manager의 로그 외에도 지정된 DATACENTER 의 가상화 호스트에서 로그를 수집합니다. 포함을 위한 데이터 센터를 쉼표로 구분된 데이터 센터 이름 또는 일치 패턴 목록에 지정해야 합니다.
-H HOSTS_LIST, --hosts=HOSTS_LIST
Red Hat Virtualization Manager의 로그 외에도 후보가 지정된 HOSTS_LIST 의 가상화 호스트에서 로그를 수집합니다. 포함시킬 호스트는 쉼표로 구분된 호스트 이름, 정규화된 도메인 이름 또는 IP 주소 목록에 지정해야 합니다. 일치 패턴도 유효합니다.

SSH 설정

--ssh-port=PORT
가상화 호스트와 함께 SSH 연결에 사용할 포트로 PORT 를 설정합니다.
-k KEYFILE, --key-file=KEYFILE
KEYFILE 을 가상화 호스트에 액세스하는 데 사용할 공용 SSH 키로 설정합니다.
--max-connections=MAX_CONNECTIONS
MAX_CONNECTIONS 를 가상화 호스트의 로그에 대한 최대 동시 SSH 연결로 설정합니다. 기본값은 10입니다.

PostgreSQL 데이터베이스 옵션

pg-userdbname 매개 변수를 사용하여 데이터베이스 사용자 이름과 데이터베이스 이름을 기본값에서 변경된 경우 지정해야 합니다.

데이터베이스가 로컬 호스트에 없는 경우 pg-dbhost 매개 변수를 사용합니다. 선택적 pg-host-key 매개 변수를 사용하여 원격 로그를 수집합니다. 원격 로그 수집이 성공하려면 데이터베이스 서버에 PostgreSQL SOS 플러그인을 설치해야 합니다.

--no-postgresql
데이터베이스 컬렉션을 비활성화합니다. 로그 수집기는 Red Hat Virtualization Manager PostgreSQL 데이터베이스에 연결하고 --no-postgresql 매개변수를 지정하지 않는 한 로그 보고서에 데이터를 포함합니다.
--pg-user=USER
데이터베이스 서버와 연결에 사용할 사용자 이름으로 USER 를 설정합니다. 기본값은 postgres 입니다.
--pg-dbname=DBNAME
데이터베이스 서버와의 연결에 사용할 데이터베이스 이름으로 DBNAME 을 설정합니다. 기본값은 rhevm 입니다.
--pg-dbhost=DBHOST
DBHOST 를 데이터베이스 서버의 호스트 이름으로 설정합니다. 기본값은 localhost 입니다.
--pg-host-key=KEYFILE
KEYFILE 을 데이터베이스 서버에 대한 공용 ID 파일(개인 키)으로 설정합니다. 이 값은 기본적으로 설정되지 않습니다. 로컬 호스트에 데이터베이스가 없는 경우에만 필요합니다.

3.9.5.3. 기본 로그 수집기 사용

추가 매개 변수를 지정하지 않고 ovirt-log-collector 명령이 실행되면 기본 동작은 Red Hat Virtualization Manager 및 연결된 호스트에서 모든 로그를 수집하는 것입니다. no -postgresql 매개 변수를 추가하지 않는 한 데이터베이스 로그를 수집합니다. 다음 예에서 로그 수집기는 Red Hat Virtualization Manager 및 연결된 호스트 3개에서 모든 로그를 수집하기 위해 실행됩니다.

예 3.18. 로그 수집기 사용량

# ovirt-log-collector
INFO: Gathering oVirt Engine information...
INFO: Gathering PostgreSQL the oVirt Engine database and log files from localhost...
Please provide REST API password for the admin@internal oVirt Engine user (CTRL+D to abort):
About to collect information from 3 hypervisors. Continue? (Y/n):
INFO: Gathering information from selected hypervisors...
INFO: collecting information from 192.168.122.250
INFO: collecting information from 192.168.122.251
INFO: collecting information from 192.168.122.252
INFO: finished collecting information from 192.168.122.250
INFO: finished collecting information from 192.168.122.251
INFO: finished collecting information from 192.168.122.252
Creating compressed archive...
INFO Log files have been collected and placed in /tmp/logcollector/sosreport-rhn-account-20110804121320-ce2a.tar.xz.
The MD5 for this file is 6d741b78925998caff29020df2b2ce2a and its size is 26.7M

3.9.6. 엔진 툴

3.9.6.1. 엔진 툴

Engine HFScuum 툴은 테이블을 업데이트하고 배달된 행을 제거하여 PostgreSQL 데이터베이스를 유지 관리하므로 디스크 공간을 재사용할 수 있습니다. VACUUM 명령 및 해당 매개 변수에 대한 정보는 PostgreSQL 설명서 를 참조하십시오.

Engine HFScuum 명령은 engine-vacuum 입니다. root 사용자로 로그인하고 Red Hat Virtualization 환경에 대한 관리 자격 증명을 제공해야 합니다.

또는 engine-setup 명령을 사용하여 기존 설치를 사용자 지정하는 동안 Engine collectdcuum 도구를 실행할 수 있습니다.

$ engine-setup
...
[ INFO  ] Stage: Environment customization
...
Perform full vacuum on the engine database engine@localhost?
This operation may take a while depending on this setup health and the
configuration of the db vacuum process.
See https://www.postgresql.org/docs/12/static/sql-vacuum.html
(Yes, No) [No]:

Yes 옵션은 전체 세부 정보 표시 모드에서 Enginecuum 도구를 실행합니다.

3.9.6.2. 엔진 툴킷 모드

엔진 스케줄링에는 두 가지 모드가 있습니다.

표준 비우기

정규 표준 사용 권장.

표준 채우기는 테이블과 색인에서 데드라인 버전을 제거하고 향후 재사용에 사용할 수 있는 공간을 표시합니다. 자주 업데이트되는 테이블은 정기적으로 잠겨야 합니다. 그러나 표준 설비는 공간을 운영 체제로 반환하지 않습니다.

표준 밀도는 매개 변수 없이 현재 데이터베이스의 모든 테이블을 처리합니다.

전체 검색

일상적인 사용에는 전체 제약이 권장되지 않지만, 테이블 내에서 상당한 공간을 회수해야 하는 경우에만 실행해야 합니다.

전체 프레임은 잘못된 공간이 없는 테이블 파일의 새 사본을 작성하여 테이블을 압축하므로 운영 체제에서 공간을 회수할 수 있습니다. 전체 장애는 오랜 시간이 걸릴 수 있습니다.

전체 조작에는 새 테이블 복사본을 위해 추가 디스크 공간이 필요합니다. 작업이 완료되고 이전 복사본이 삭제될 때까지 추가 디스크 공간이 필요합니다. 전체 조작에는 테이블의 배타적 잠금이 필요하기 때문에 테이블의 다른 용도와 병렬로 실행할 수 없습니다.

3.9.6.3. engine-vacuum 명령 구문

engine-vacuum 명령의 기본 구문은 다음과 같습니다.

# engine-vacuum
# engine-vacuum option

옵션 없이 engine-vacuum 명령을 실행하면 표준 문제가 수행됩니다.

engine-vacuum 명령을 추가로 구체화하기 위한 몇 가지 매개 변수가 있습니다.

일반 옵션

-h --help
engine-vacuum 명령을 사용하는 방법에 대한 정보를 표시합니다.
-a
표준 제약을 실행하고, 데이터베이스를 분석하며, 최적화자 통계를 업데이트합니다.
-A
데이터베이스를 분석하고 최적화자 통계를 업데이트합니다.
-f
전체 화면 실행.
-v
더 많은 콘솔 출력을 제공하는 자세한 정보 표시 모드로 을 실행합니다.
-t table_name

특정 테이블 또는 테이블을 조작합니다.

# engine-vacuum -f -v -t vm_dynamic -t vds_dynamic

3.9.7. 네트워크 이름 매핑 도구에 대한 VDSM

3.9.7.1. VDSM 이름을 논리적 네트워크 이름에 매핑

논리적 네트워크의 이름이 15자를 초과하거나 ASCII가 아닌 문자를 포함하는 경우 시스템은 자동으로 호스트 ID(vdsm_name) 이름을 생성합니다. 이는 의 문자 네트워크 고유 식별자의 처음 13자(예: ona1b2c3d4e5f6g )로 구성됩니다. 호스트의 로그 파일에 표시되는 이 이름입니다. 논리적 네트워크 이름 목록과 자동 생성된 네트워크 이름 목록을 보려면 /usr/share/ovirt-engine/bin/에 있는 VDSM-to-Network- Name 매핑 도구를 사용합니다.

절차

  1. 도구를 처음 실행하는 경우 Manager 데이터베이스에 대한 읽기 액세스 권한이 있는 데이터베이스 사용자의 암호인 PASSWORD 환경 변수를 정의합니다. 예를 들어 다음을 실행합니다.

    # export PASSWORD=DatabaseUserPassword
  2. VDSM-to-Network-Name 매핑 도구를 실행합니다.

    # vdsm_to_network_name_map  --user USER

    여기서 USER 는 Manager 데이터베이스에 대한 읽기 액세스 권한이 있는 데이터베이스 사용자이며, 해당 암호는 PASSWORD 환경 변수에 할당됩니다.

툴에는 동일한 호스트 식별자에 매핑되는 논리적 네트워크 이름 목록이 표시됩니다.

추가 플래그

다음 플래그를 사용하여 툴을 실행할 수 있습니다.

--host 는 데이터베이스 서버의 호스트 이름/IP 주소입니다. 기본값은 localhost 입니다.

--port 는 데이터베이스 서버의 포트 번호입니다. 기본값은 5432 입니다.--database 는 데이터베이스의 이름입니다. 기본값은 Manager 데이터베이스인 engine 입니다.

--secure 는 데이터베이스와 보안 연결을 활성화합니다. 기본적으로 도구는 보안 연결 없이 실행됩니다.