virt-designer(1)

1VIRT-DESIGNER.C(1)          Virtualization Support          VIRT-DESIGNER.C(1)
2
3
4

NAME

6       virt-designer - Generate domain XML
7

SYNOPSIS

9       virt-designer [OPTION]...
10

DESCRIPTION

12       virt-designer is a command line tool for generating XML documents for
13       libvirt domains. However, it cooperates with libosinfo database to
14       guess the correct combination of attributes (e.g. disk driver, NIC
15       model).
16
17       virt-designer does not feed libvirt with generated XML though. For now,
18       it's a proof of concept.
19

OPTIONS

21       The basic structure of arguments passed to virt-designer is:
22
23         virt-designer [-c URI] [OPTION] [OPTION] ...
24
25       However, arguments have no pre-defined order so users can type them in
26       any order they like.
27
28   General Options
29       -c URI, --connect=URI
30         The libvirt connection URI which is used for querying capabilities of
31         the host.
32
33       --list-os
34         List IDs of operating systems known to libosinfo
35
36       --list-platform
37         List IDs of platforms known to libosinfo
38
39       -o OS, --os=OS
40         Specify operating system that will be run on the domain. OS is an ID
41         which can be obtained via --list-os.
42
43       -p PLATFORM, --platform=PLATFORM
44         Specify platform (hypervisor) under which the domain will run.
45         PLATFORM is and ID which can be obtained via --list-platform.
46
47       -a ARCH, --architecture=ARCH
48         Set domain's architecture
49
50       -C PATH[,FORMAT] --cdrom=PATH[,FORMAT]
51         Add PATH as a CDROM to the domain. To specify its format (e.g. raw,
52         qcow2, phy) use FORMAT.
53
54       -d PATH[,FORMAT] --disk=PATH[,FORMAT]
55         Add PATH as a disk to the domain. To specify its format (e.g. raw,
56         qcow2, phy) use FORMAT.
57
58       -i NETWORK[,ARG=VAL]
59         Add an interface of type network with NETWORK source. Moreover, some
60         other configuration knobs can be set (possible ARGs): mac,
61         link={up|down}
62
63       -g GRAPHICS
64         Add a graphics device of type GRAPHICS. Valid values are spice or
65         vnc.
66
67       -s
68         Add smartcard reader to the VM conifguration
69
70       -u
71         Add USB controllers and setup USB redirection in the VM
72         configuration.
73
74       -r RESOURCE, --resources=RESOURCES
75         Set minimal or recommended resources on the domain XML. By default,
76         the recommended is used.
77
78       Usually, both --os and --platform are required as they are needed to
79       make the right decision on driver, model, ...  when adding a new
80       device.  However, when adding a disk which is an installation medium
81       (e.g. a CD-ROM or DVD), virt-designer tries to guess the OS. Something
82       similar is done with platform. Usually, the platform is guessed from
83       the connection URI.
84

EXAMPLES

86       Domain with Fedora 17 from locally stored ISO and one NIC with mac
87       00:11:22:33:44:55 and link set down:
88
89         # virt-designer -C Fedora-17-x86_64-Live-KDE.iso \
90                         -i default,mac=00:11:22:33:44:55,link=down
91
92       To add multiple devices just use appropriate argument multiple times:
93
94         # virt-designer -d /tmp/home.img,qcow2 \
95                         -d /var/lib/libvirt/images/f17.img,qcow2 \
96                         -i default,mac=00:11:22:33:44:55,link=down \
97                         -i blue_network \
98                         -r minimal
99

AUTHORS

101       Written by Michal Privoznik, Daniel P. Berrange and team of other
102       contributors. See the AUTHORS file in the source distribution for the
103       complete list of credits.
104

BUGS

106       Report any bugs discovered to the libvirt community via the mailing
107       list "http://libvirt.org/contact.html" or bug tracker
108       "http://libvirt.org/bugs.html".  Alternatively report bugs to your
109       software distributor / vendor.
110

COPYRIGHT

112       Copyright (C) 2012 Red Hat, Inc. and various contributors.  This is
113       free software. You may redistribute copies of it under the terms of the
114       GNU General Public License "http://www.gnu.org/licenses/gpl.html".
115       There is NO WARRANTY, to the extent permitted by law.
116