virt-xml - 클라우드의 온라인

프로그램:

이름

virt-xml - 명령줄 옵션을 사용하여 libvirt XML을 편집합니다.

개요

가상 XML DOMAIN XML-ACTION XML-OPTION [OUTPUT-OPTION] [MISC-OPTIONS] ...

기술

가상 XML 명시적 명령줄을 사용하여 libvirt XML을 편집하기 위한 명령줄 도구입니다.
옵션. 바로 시작하려면 이 문서의 끝에 있는 예 섹션을 참조하십시오.

각각의 가상 XML 호출에는 3가지가 필요합니다. 변경할 기존 도메인의 이름(또는 XML
stdin에 전달됨), XML에 대한 작업 및 수행할 XML 변경. 조치는 다음 중 하나입니다.

--add-device: XML에 새 장치 정의 추가 --remove-device: 제거
기존 장치 정의 --edit: 기존 XML 블록 편집 --build-xml: 그냥 빌드
요청된 XML 블록 및 인쇄(여기에는 도메인 또는 입력 XML이 필요하지 않음).

XML 변경은 virt-xml에서 제공하는 XML 옵션의 한 인스턴스입니다. 예를 들면
--disk 또는 --boot.

가상 XML 호출당 하나의 작업과 XML 쌍만 허용합니다. 여러 개 만들어야 하는 경우
편집하려면 명령을 여러 번 호출하십시오.

옵션

-c URI
--연결하다=우리
기본이 아닌 하이퍼바이저에 연결합니다. 보다 가상 설치(1) 자세한 내용

도메인
domain은 기존 VM의 이름, UUID 또는 ID입니다. 다음을 사용하는 경우 생략할 수 있습니다.
--build-xml, 또는 XML이 stdin으로 전달되는 경우.

도메인이 지정되면 VM이 다음과 같은 경우에도 기본 출력 작업은 --define입니다.
달리기. 실행 중인 VM 구성을 업데이트하려면 --update 옵션을 추가하십시오.
옵션/장치는 실행 중인 VM 구성 업데이트를 지원합니다.

XML이 stdin으로 전달되면 기본 출력은 --print-xml입니다.

XML ACTIONS

--편집하다 [편집 옵션]
지정된 XML 블록을 편집합니다. 편집 옵션 가상 XML 편집할 블록. 유형
우리가 편집하고 있는 XML의 양은 다음으로 전달되는 XML 옵션에 의해 결정 가상 XML. 그래서 만약
--disk가 전달되면 EDIT-OPTIONS 선택 편집을 차단합니다.

특정 XML 옵션은 --cpu, --security,
--boot, --clock 및 기타 몇 가지. 그러한 경우, 가상 XML 경우에 불평하지 않을 것입니다
해당 XML 블록이 이미 존재하지 않으면 자동으로 생성됩니다.

대부분의 XML 옵션은 특수 값 'clearxml=yes'를 지원합니다. --edit와 함께 사용하면
요청한 내용을 적용하기 전에 편집 중인 XML 블록을 완전히 비웁니다.
변경. 이를 통해 XML 블록을 완전히 재구축할 수 있습니다. 일부 사용법은 예를 참조하십시오.

EDIT-OPTIONS 예:

--편집하다
--edit 옵션이 없으면 '첫 번째 블록 편집'을 의미합니다. 그래서 '--edit --disk
DISK-OPTIONS'는 '첫 번째 편집 '.

위에서 언급한 단일 XML 블록 옵션의 경우 아무 것도 없는 일반 '--edit'
옵션은 항상 사용하고 싶은 것입니다.

--편집하다 #
지정된 XML 블록 번호를 선택합니다. 따라서 '--edit 2 --disk DISK-OPTS'는 '편집
두번째 '. 이 옵션은 실제로 장치 XML에만 적용됩니다.

--편집하다 모든
XML 옵션 유형의 모든 XML 블록을 수정합니다. 그래서 '--모든 --disk DISK-OPTS 편집'
'편집하다'를 의미합니다. 블록'. 이 옵션은 실제로 장치 XML에만 적용됩니다.

--편집하다 장치 옵션
전달된 장치 옵션과 일치하는 모든 XML 블록을 수정합니다. 장치 옵션
XML 옵션에 전달되는 것과 동일한 형식입니다.

따라서 '--edit path=/tmp/foo --disk DISK-OPTS'는 '모든 편집 경로와
/tmp/foo'. 이 옵션은 실제로 장치 XML에만 적용됩니다.

--기기 추가
지정된 XML 옵션을 XML에 추가 목록. 예: '--장치 추가
--disk DISK-OPTIONS'는 새 차단하고 XML에 추가합니다.

이 옵션은 장치가 아닌 XML 옵션과 함께 지정된 경우 오류가 발생합니다( --edit 섹션 참조
부분 목록의 경우).

--장치를 제거
XML에서 지정된 장치를 제거합니다. 제거할 장치는 XML에 의해 선택됩니다.
--edit와 동일한 형식의 인수를 사용하는 옵션입니다. 예

--장치를 제거 --디스크 2
두 번째 디스크 장치 제거

--장치를 제거 --네트워크 모두
모든 네트워크 장치 제거

--장치를 제거 --사운드 pcspk
model='pcspk'인 모든 사운드 장치 제거

이 옵션은 장치가 아닌 XML 옵션과 함께 지정된 경우 오류가 발생합니다( --edit 섹션 참조
부분 목록의 경우).

--빌드-xml
지정된 XML을 빌드하고 stdout에 인쇄하기만 하면 됩니다. 입력 도메인 또는 입력 XML이 없습니다.
필수의. 예: '--build-xml --disk DISK-OPTIONS'는 새
장치.

이 옵션은 명확하게 매핑되지 않는 XML 옵션과 함께 지정된 경우 오류가 발생합니다.
--vcpus 또는 --memory와 같은 특정 XML 블록.

출력 옵션

이러한 옵션은 XML을 변경한 후 수행할 작업을 결정합니다. 일반적인 경우 이러한
'XML 작업'은 기본 출력 작업을 의미하므로 지정할 필요가 없습니다.
위에서 자세히 설명했습니다. 기본 출력을 수정하려는 경우에만 필요합니다.

--최신 정보
지정된 도메인이 실행 중인 경우 실행 중인 VM 구성을 변경해 보십시오. 만약에
--edit와 함께 사용하면 업데이트 작업입니다. --add-device와 결합하면 이
장치 핫플러그입니다. --remove-device와 결합하면 장치 핫 언플러그입니다.

대부분의 XML 속성 및 장치는 라이브 업데이트 작업을 지원하지 않으며,
따라서 모든 경우에 성공할 것으로 기대하지 마십시오.

--정의하다
요청된 XML 변경을 정의합니다. 출력 옵션이 없는 경우 일반적으로 기본값입니다.
지정되지만 --print 옵션이 지정되면 --define이 강제 실행에 필요합니다.
변경합니다.

--인쇄 차이
생성된 XML 변경 사항을 통합된 diff 형식으로 인쇄합니다. 이 출력 옵션만 있는 경우
지정되면 다른 모든 출력 옵션이 비활성화되고 영구적으로 변경되지 않습니다.

--print-xml
생성된 XML 전체를 인쇄합니다. 이 출력 옵션만 지정하면 모든
다른 출력 옵션은 비활성화되고 영구적으로 변경되지 않습니다.

--확인하다
도메인을 정의하거나 업데이트하기 전에 생성된 XML diff를 표시하고 대화식으로
확인을 요청합니다.

XML 옵션

--디스크
--회로망
--제도법
--메타데이터
--메모리
--vcpus
--cpu
--보안
--누마튠
--특징
--시계
--오후
--신병
--파일 시스템
--제어 장치
--입력
--연속물
--평행 한
--채널
--콘솔
--호스트 데브
--소리
--지키는 개
--동영상
--스마트 카드
--redirdev
--멤벌룬
--tpm
--rng
--공황
이러한 옵션은 XML 요소의 단일 클래스에 대한 XML을 변경합니다. 더 완전한
문서는 에서 찾을 수 있습니다 가상 설치(1).

일반적으로 이러한 옵션은 libvirt XML에 매우 간단하게 매핑됩니다.
<http://libvirt.org/formatdomain.html>

옵션 문자열의 형식은 다음과 같습니다. --option opt=val,opt2=val2,... 예: --disk
경로=/tmp/foo, 공유 가능=on. 속성은 '--option opt=,'와 함께 사용할 수 있으므로
'--disk cache='를 사용할 수 있는 디스크 캐시 설정

모든 옵션에 --option=?을 사용하십시오. 사용 가능한 모든 하위 옵션 목록을 보려면 다음과 같이 하십시오.
--디스크=? 또는 --boot=?

--help 출력에는 몇 가지 일반적인 예도 나와 있습니다. 아래의 예 섹션을 참조하십시오.
몇 가지 일반적인 예.

기타 사항 옵션

-h
--도움
도움말 메시지를 표시하고 종료

--번역
프로그램의 버전 번호를 표시하고 종료

-q
--조용한
장황한 출력을 피하십시오.

-d
-디버그
디버깅 정보 인쇄

사용 예

--disk 및 --network가 사용하는 모든 하위 옵션 목록 보기

# virt-xml --disk=? --네트워크=?

변경 도메인 'EXAMPLE':

# virt-xml 예 --edit --metadata description="내 새 설명"

# 도메인 'EXAMPLE'에 대한 부팅 장치 메뉴 활성화:

# virt-xml 예 --edit --boot 메뉴=on

이전 지우기 도메인 'winxp'의 정의를 'host-model'로 변경하지만,
저장하기 전에 대화식으로 diff를 확인하십시오.

# virt-xml winxp --edit --cpu 호스트 모델, clearxml=yes --confirm

'fedora6'에서 두 번째 사운드 카드를 model=ich19으로 변경하되 diff만 출력합니다.

# virt-xml fedora19 --edit 2 --sound model=ich6 --print-diff

모든 그래픽 장치 암호를 실행 중인 VM 'rhel6'의 'foo'로 업데이트합니다.

# virt-xml rhel6 --편집 모두 --그래픽 암호=foo --업데이트

디스크 장치 hdc에서 디스크 경로를 제거합니다.

# virt-xml rhel6 --edit 대상=hdc --디스크 경로=

stdin의 XML을 사용하여 cache=none을 사용하도록 'disk' 유형의 모든 디스크 장치를 변경하고 인쇄합니다.
stdout에 대한 새 XML.

# 고양이 | virt-xml --편집 장치=디스크 --디스크 캐시=없음

디스크 'hda' IO를 기본으로 변경하고 시작 정책을 '선택 사항'으로 사용합니다.

# virt-xml fedora20 --edit 대상=hda \
--disk io=네이티브,startup_policy=옵션

원격 연결에서 VM 'fedora20'에 대해 driver_name=vfio를 사용하도록 모든 호스트 장치를 변경합니다.

# virt-xml --connect qemu+ssh://remotehost/system \
fedora20 --모두 편집 --hostdev driver_name=vfio

실행 중인 도메인 'fedora001.003'에 대한 호스트 USB 장치 19 핫플러그:

# virt-xml fedora19 --update --add-device --hostdev 001.003

다음 VM 이후에 사용할 수 있는 'winxp' 도메인에 spicevmc 채널을 추가합니다.
종료.

# virt-xml winxp --add-device --channel 스파이스vmc

10G qcow2 디스크 이미지를 만들고 다음 VM 시작을 위해 'fedora18'에 연결합니다.

# virt-xml fedora18 --추가 장치 \
--disk /var/lib/libvirt/images/newimage.qcow2, 형식=qcow2, 크기=10

실행 중인 도메인 'rhel7'에서 디스크 vdb를 핫 언플러그합니다.

# virt-xml rhel7 --update --remove-device --disk 대상=vdb

다음 종료 후 VM 'rhel7'에서 모든 그래픽 장치를 제거합니다.

# virt-xml rhel7 --remove-device --graphics 모두

virtio 콘솔 장치용 XML을 생성하고 stdout에 인쇄합니다.

# virt-xml --build-xml --console pty, target_type=virtio

onworks.net 서비스를 사용하여 온라인으로 virt-xml 사용