1virt-p2v-make-kiwi(1) Virtualization Support virt-p2v-make-kiwi(1)
2
6 virt-p2v-make-kiwi - Build the virt-p2v kiwi configuration
7
9 virt-p2v-make-kiwi [--inject-ssh-identity path] [-o kiwi-folder]
10
12 virt-p2v(1) converts a physical machine to run virtualized on KVM,
13 managed by libvirt, OpenStack, oVirt, Red Hat Enterprise Virtualisation
14 (RHEV), or one of the other targets supported by virt-v2v(1).
15 Kiwi is a tool used mainly by SUSE Linux Enterprise and openSUSE to
17 build live CDs, make appliances and so on. It is driven by a few files
18 including an xml description of the machine.
19 virt-p2v-make-kiwi builds a folder containing all the pieces needed for
21 kiwi to build a bootable P2V live CD ISO, USB key, or PXE image. This
22 tool only builds the kiwi configuration, but this manual page describes
23 some of the ways you can use the kiwi configuration.
24
26 Using virt-p2v-make-kiwi is very simple:
27 virt-p2v-make-kiwi
29 will build a kiwi configuration based on the current machine’s
31 distribution.
32 To control the name of the output folder, use the -o parameter.
34
36 Once you have the kiwi configuration folder, you can use kiwi(1) to
37 make a live CD:
38 sudo kiwi --build p2v.kiwi -d build --type iso
40 Before running this, you may have to tweak the "config.xml" file to
42 change the locale and keyboard mapping to the one you need.
43 If running on a SUSE Linux Entreprise Server, add the path to your
45 packages repositories using the "--ignore-repos" and "--add-repo" kiwi
46 parameters.
47 The generated ISO image will be placed in the "build" folder.
49
51 Use the dd(1) program to write the ISO created above to a USB key:
52 sudo dd if=path/to/p2v.iso of=/dev/sdX
54
56 To create a PXE boot image, run kiwi in such a way:
57 sudo kiwi --build $PWD/p2v.kiwi -d build --add-profile netboot --type pxe
59 For more details on how to use the generated image, report to the kiwi
61 documentation on PXE images:
62 https://doc.opensuse.org/projects/kiwi/doc/#chap.pxe
63
65 You can inject an SSH identity (private key) file to the kiwi config
66 and hence into the ISO using the --inject-ssh-identity option. Note
67 that you cannot inject a key once the ISO has been built.
68 First create a key pair. It must have an empty passphrase:
70 ssh-keygen -t rsa -N '' -f id_rsa
72 This creates a private key ("id_rsa") and a public key ("id_rsa.pub")
74 pair. The public key should be appended to the "authorized_keys" file
75 on the virt-v2v conversion server (usually to
76 "/root/.ssh/authorized_keys").
77 The private key should be added to the kiwi config and then discarded:
79 virt-p2v-make-kiwi [...] --inject-ssh-identity id_rsa
81 rm id_rsa
82 The ISO can then be built from the kickstart in the usual way (see
84 above), and it will contain the embedded SSH identity
85 (/var/tmp/id_rsa).
86 When booting virt-p2v, specify the URL of the injected file like this:
88 │ User name: [root_____________________________] │
90 │ │
91 │ Password: [ <leave this field blank> ] │
92 │ │
93 │ SSH Identity URL: [file:///var/tmp/id_rsa___________] │
94 or if using the kernel command line, add:
96 p2v.identity=file:///var/tmp/id_rsa
98 For more information, see "SSH IDENTITIES" in virt-p2v(1).
100
102 --help
103 Display help.
104 --inject-ssh-identity id_rsa
106 Add an SSH identity (private key) file into the kickstart. See
107 "ADDING AN SSH IDENTITY" above.
108 -o OUTPUT
110 --output OUTPUT
111 Write kiwi configuration to the "OUTPUT" folder. If not specified,
112 the default is p2v.kiwi in the current directory.
113 -V
115 --version
116 Display version number and exit.
117
119 $libdir/virt-p2v/virt-p2v.xz
120 The virt-p2v(1) binary which is copied into the kiwi configuration.
121 The location of the binary can be changed by setting the
123 "VIRT_P2V_DATA_DIR" environment variable.
124 $datadir/virt-p2v/issue
126 $datadir/virt-p2v/launch-virt-p2v.in
127 $datadir/virt-p2v/kiwi
128 $datadir/virt-p2v/p2v.service
129 Various data files that are used to make the kiwi appliance.
130 The location of these files can be changed by setting the
132 "VIRT_P2V_DATA_DIR" environment variable.
133
135 "VIRT_P2V_DATA_DIR"
136 The directory where virt-p2v-make-kiwi looks for data files and the
137 virt-p2v binary (see "FILES" above). If not set, a compiled-in
138 location is used.
139
141 virt-p2v(1), virt-p2v-make-disk(1), virt-v2v(1), kiwi(1),
142 http://libguestfs.org/.
143
145 Cédric Bosdonnat
146
148 Copyright (C) 2016 SUSE Ltd.
149
151 This program is free software; you can redistribute it and/or modify it
152 under the terms of the GNU General Public License as published by the
153 Free Software Foundation; either version 2 of the License, or (at your
154 option) any later version.
155 This program is distributed in the hope that it will be useful, but
157 WITHOUT ANY WARRANTY; without even the implied warranty of
158 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
159 General Public License for more details.
160 You should have received a copy of the GNU General Public License along
162 with this program; if not, write to the Free Software Foundation, Inc.,
163 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
164
166 To get a list of bugs against libguestfs, use this link:
167 https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
168 To report a new bug against libguestfs, use this link:
170 https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
171 When reporting a bug, please supply:
173 · The version of libguestfs.
175 · Where you got libguestfs (eg. which Linux distro, compiled from
177 source, etc)
178 · Describe the bug accurately and give a way to reproduce it.
180 · Run libguestfs-test-tool(1) and paste the complete, unedited output
182 into the bug report.
183libguestfs-1.40.1 2019-01-17 virt-p2v-make-kiwi(1)