virt-xml - Online w chmurze

PROGRAM:

IMIĘ

virt-xml - Edytuj XML libvirt za pomocą opcji wiersza poleceń.

STRESZCZENIE

wirt-xml DOMENA AKCJA XML OPCJA XML [OPCJA WYJŚCIA] [OPCJE RÓŻNYCH] ...

OPIS

wirt-xml to narzędzie wiersza poleceń służące do edycji XML libvirt przy użyciu jawnego wiersza poleceń
opcje. Aby od razu przejść do tematu, zobacz sekcję PRZYKŁADY na końcu tego dokumentu.

Każdy wirt-xml wywołanie wymaga 3 rzeczy: nazwy istniejącej domeny do zmiany (lub pliku XML
przekazany na stdin), akcję na XML i zmianę XML do wykonania. działania są jednym z:

--add-device: Dołącz nową definicję urządzenia do pliku XML --remove-device: Usuń
istniejąca definicja urządzenia --edit: Edytuj istniejący blok XML --build-xml: Po prostu zbuduj
żądany blok XML i wydrukuj go (tutaj nie jest wymagana żadna domena ani wejściowy kod XML).

Zmiana XML to jedno wystąpienie dowolnej opcji XML udostępnianej na przykład przez virt-xml
--disk lub --boot.

wirt-xml pozwala tylko na jedną akcję i parę XML na wywołanie. Jeśli chcesz zrobić wiele
edycji, wywołaj polecenie wiele razy.

OPCJE

-c URI
--łączyć=URI
Połącz się z hiperwizorem innym niż domyślny. Widzieć wirtualna instalacja(1) po szczegóły

domena
domena to nazwa, UUID lub identyfikator istniejącej maszyny wirtualnej. Można to pominąć, jeśli używasz
--build-xml lub jeśli XML jest przekazywany na standardowe wejście.

Po określeniu domeny domyślną akcją wyjściową jest --define, nawet jeśli jest to maszyna wirtualna
działanie. Aby zaktualizować działającą konfigurację maszyny wirtualnej, dodaj opcję --update (ale nie wszystkie
opcje/urządzenia obsługują aktualizację działającej konfiguracji maszyny wirtualnej).

Jeśli XML jest przekazywany na standardowe wejście, domyślnym wyjściem jest --print-xml.

XML DZIAŁANIA

--edytować [OPCJE EDYCJI]
Edytuj określony blok XML. OPCJE EDYCJI powiedz wirt-xml który blok edytować. Typ
XML, który edytujemy, zależy od opcji XML, do której jest przekazywana wirt-xml, Więc jeśli
--disk został przekazany, OPCJE EDYCJI wybierz które blok do edycji.

Niektóre opcje XML zawsze są odwzorowywane tylko na pojedynczy blok XML, np. --cpu, --security,
--boot, --clock i kilka innych. W takich przypadkach wirt-xml nie będę narzekał, jeśli a
odpowiedni blok XML jeszcze nie istnieje, utworzy go za Ciebie.

Większość opcji XML obsługuje specjalną wartość „clearxml=yes”. W połączeniu z --edit, it
całkowicie wyczyści edytowany blok XML przed zastosowaniem żądanego
zmiany. Pozwala to na całkowite przebudowanie bloku XML. Zobacz PRZYKŁADY, aby zapoznać się z niektórymi zastosowaniami.

Przykłady EDYCJI-OPCJI:

--edytować
--edit bez żadnych opcji oznacza „edycję pierwszego bloku”. Zatem „--edytuj --disk
OPCJE DYSKU” oznacza „edytuj pierwszy '.

W przypadku wspomnianych powyżej opcji pojedynczego bloku XML wystarczy zwykłe „--edit” bez żadnych bloków
Opcje są tym, czego zawsze chcesz używać.

--edytować #
Wybierz określony numer bloku XML. Zatem „--edit 2 --disk DISK-OPTS” oznacza „edytuj
drugi '. Ta opcja naprawdę dotyczy tylko XML urządzenia.

--edytować cała kolekcja
Zmodyfikuj każdy blok XML typu opcji XML. Zatem „--edytuj wszystko --disk DISK-OPTS”
oznacza „edytuj kiedykolwiek”. blok'. Ta opcja naprawdę dotyczy tylko XML urządzenia.

--edytować OPCJE URZĄDZENIA
Zmodyfikuj każdy blok XML pasujący do przekazanych opcji urządzenia. Opcje urządzenia
są w tym samym formacie, jaki zostałby przekazany do opcji XML.

Zatem „--edit path=/tmp/foo --disk DISK-OPTS” oznacza „edytuj co ze ścieżką
/tmp/foo”. Ta opcja naprawdę dotyczy tylko XML urządzenia.

--Dodaj urządzenie
Dołącz określone opcje XML do pliku XML lista. Przykład: '--add-device
--disk DISK-OPTIONS' utworzy nowy zablokować i dodać go do pliku XML.

Ta opcja spowoduje błąd, jeśli zostanie określona z opcją XML inną niż urządzenie (zobacz sekcję --edit
dla częściowej listy).

--odłącz urządzenie
Usuń określone urządzenie z pliku XML. Urządzenie do usunięcia jest wybierane przez XML
opcja, która przyjmuje argumenty w tym samym formacie co --edit. Przykłady

--odłącz urządzenie --dysk 2
Usuń drugie urządzenie dyskowe

--odłącz urządzenie --sieć wszystko
Usuń wszystkie urządzenia sieciowe

--odłącz urządzenie --dźwięk sztpk
Usuń wszystkie urządzenia dźwiękowe z modelem='pcspk'

Ta opcja spowoduje błąd, jeśli zostanie określona z opcją XML inną niż urządzenie (zobacz sekcję --edit
dla częściowej listy).

--build-xml
Po prostu zbuduj określony XML i wydrukuj go na standardowe wyjście. Nie ma domeny wejściowej ani wejściowego XML-a
wymagany. Przykład: „--build-xml --disk DISK-OPTIONS” po prostu wydrukuje nowy
urządzeń.

Ta opcja spowoduje błąd, jeśli zostanie określona z opcją XML, która nie jest dokładnie odwzorowana na plik a
określony blok XML, taki jak --vcpus lub --memory.

WYDAJNOŚĆ OPCJE

Opcje te decydują, jakie działania należy podjąć po zmianie pliku XML. W powszechnym przypadku te
nie trzeba podawać, ponieważ „akcje XML” będą oznaczać domyślną akcję wyjściową,
szczegółowo opisano powyżej. Są one potrzebne tylko wtedy, gdy chcesz zmodyfikować domyślne wyjście.

--aktualizacja
Jeśli określona domena jest uruchomiona, spróbuj zmienić działającą konfigurację maszyny wirtualnej. Jeśli
w połączeniu z --edit jest to operacja aktualizacji. W połączeniu z --add-device spowoduje to
jest urządzeniem typu hotplug. W połączeniu z opcją --remove-device jest to urządzenie typu hot-plug.

Należy pamiętać, że większość właściwości i urządzeń XML nie obsługuje operacji aktualizacji na żywo,
więc nie oczekuj, że odniesie sukces we wszystkich przypadkach.

--definiować
Zdefiniuj żądaną zmianę XML. Jest to zazwyczaj ustawienie domyślne, jeśli nie ma takiej opcji wyjściowej
określony, ale jeśli określono opcję --print, wymagane jest --define, aby wymusić
zmienić.

--print-różnica
Wydrukuj wygenerowaną zmianę XML w ujednoliconym formacie różnicowym. Jeśli tylko ta opcja wyjściowa jest
określony, wszystkie inne opcje wyjściowe są wyłączone i nie są wprowadzane żadne trwałe zmiany.

--print-xml
Wydrukuj w całości wygenerowany plik XML. Jeśli określono tylko tę opcję wyjściową, all
inne opcje wyjściowe są wyłączone i nie wprowadza się żadnych trwałych zmian.

--potwierdzać
Przed zdefiniowaniem lub aktualizacją domeny pokaż wygenerowaną różnicę XML w sposób interaktywny
żądanie potwierdzenia.

XML OPCJE

--dysk
--sieć
--grafika
--metadane
--pamięć
--vcpus
--procesor
--bezpieczeństwo
--numatune
--cechy
--zegar
--po południu
--uruchomić
--system plików
--kontroler
--Wejście
--seryjny
--równoległy
--kanał
--konsola
--hostdev
--dźwięk
--pies podwórzowy
--wideo
--karta inteligentna
--redirdev
--pambalon
--tpm
-- rng
--panika
Opcje te zmieniają kod XML dla pojedynczej klasy elementów XML. Bardziej kompletny
dokumentacja znajduje się w wirtualna instalacja(1).

Ogólnie rzecz biorąc, te opcje są dość łatwo mapowane na plik XML libvirt, udokumentowany pod adresem
<http://libvirt.org/formatdomain.html>

Ciągi opcji mają format: --option opt=val,opt2=val2,... przykład: --disk
ścieżka =/tmp/foo, udostępnianie = włączone. Właściwości można używać z opcją „--option opt=”, aby wyczyścić
ustawienie pamięci podręcznej dysków, którego możesz użyć „--disk cache=”,

Dla dowolnej opcji użyj --option=? aby wyświetlić listę wszystkich dostępnych opcji podrzędnych, na przykład:
--dysk=? lub --boot=?

Wynik --help zawiera również kilka ogólnych przykładów. Zobacz sekcję PRZYKŁADY poniżej
kilka typowych przykładów.

RÓŻNE OPCJE

-h
--help
Pokaż komunikat pomocy i wyjdź

--wersja
Pokaż numer wersji programu i wyjdź

-q
--cichy
Unikaj pełnych danych wyjściowych.

-d
--odpluskwić
Wydrukuj informacje debugowania

PRZYKŁADY

Zobacz listę wszystkich podopcji, które wykorzystują --disk i --network

# virt-xml --disk=? --sieć=?

Zmienić domeny „PRZYKŁAD”:

# virt-xml PRZYKŁAD --edit --metadata opis="mój nowy opis"

# Włącz menu urządzenia rozruchowego dla domeny „PRZYKŁAD”:

# virt-xml PRZYKŁAD --edit --boot menu=on

Wyczyść poprzednie definicję domeny „winxp”, zmień ją na „host-model”, ale
interaktywnie potwierdź różnicę przed zapisaniem:

# virt-xml winxp --edytuj --model hosta procesora,clearxml=yes --potwierdź

Zmień drugą kartę dźwiękową na model=ich6 w „fedora19”, ale wyprowadź tylko różnicę:

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

Zaktualizuj hasło każdego urządzenia graficznego do „foo” działającej maszyny wirtualnej „rhel6”:

# virt-xml rhel6 --edytuj wszystko --graphics hasło=foo --update

Usuń ścieżkę dysku z urządzenia dyskowego hdc:

# virt-xml rhel6 --edit target=hdc --ścieżka dysku=

Zmień wszystkie urządzenia dyskowe typu „dysk”, aby używały pamięci podręcznej=none, używając XML ze standardowego wejścia, drukowanie
nowy XML na standardowe wyjście.

# kot | virt-xml --edit urządzenie=dysk --dysk podręczny=brak

Zmień dyskowe wejście/wyjście „hda” na natywne i użyj zasad uruchamiania jako „opcjonalnych”.

# virt-xml fedora20 --edit target=hda \
--disk io=native,startup_policy=opcjonalne

Zmień wszystkie urządzenia hosta, aby używały nazwy_sterownika=vfio dla maszyny wirtualnej „fedora20” w połączeniu zdalnym

# virt-xml --connect qemu+ssh://remotehost/system \
fedora20 --edytuj wszystko --hostdev nazwa_sterownika=vfio

Podłącz urządzenie USB hosta 001.003 podczas pracy do działającej domeny „fedora19”:

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

Dodaj kanał spicevmc do domeny „winxp”, który będzie dostępny po następnej maszynie wirtualnej
zamknięcie.

# virt-xml winxp --add-device --channel spicevmc

Utwórz obraz dysku 10G qcow2 i dołącz go do „fedora18” przy następnym uruchomieniu maszyny wirtualnej:

# virt-xml fedora18 --add-device \
--disk /var/lib/libvirt/images/newimage.qcow2,format=qcow2,rozmiar=10

Podłącz na gorąco dysk vdb z działającej domeny „rhel7”:

# virt-xml rhel7 --update --remove-device --disk target=vdb

Usuń wszystkie urządzenia graficzne z maszyny wirtualnej „rhel7” po następnym wyłączeniu:

# virt-xml rhel7 --remove-device --grafika wszystko

Wygeneruj kod XML dla urządzenia konsoli virtio i wydrukuj go na standardowe wyjście:

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

Użyj virt-xml online, korzystając z usług onworks.net