1virt-p2v-make-kiwi(1)       Virtualization Support       virt-p2v-make-kiwi(1)
2
3
4

NAME

6       virt-p2v-make-kiwi - Build the virt-p2v kiwi configuration
7

SYNOPSIS

9        virt-p2v-make-kiwi [--inject-ssh-identity path] [-o kiwi-folder]
10

DESCRIPTION

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
16       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
20       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

BUILDING THE KIWI CONFIGURATION

26       Using virt-p2v-make-kiwi is very simple:
27
28        virt-p2v-make-kiwi
29
30       will build a kiwi configuration based on the current machine’s
31       distribution.
32
33       To control the name of the output folder, use the -o parameter.
34

BUILDING A LIVE CD / ISO

36       Once you have the kiwi configuration folder, you can use kiwi(1) to
37       make a live CD:
38
39        sudo kiwi --build p2v.kiwi -d build --type iso
40
41       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
44       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
48       The generated ISO image will be placed in the "build" folder.
49

BUILDING A BOOTABLE USB KEY

51       Use the dd(1) program to write the ISO created above to a USB key:
52
53        sudo dd if=path/to/p2v.iso of=/dev/sdX
54

BUILDING A PXE BOOT IMAGE

56       To create a PXE boot image, run kiwi in such a way:
57
58        sudo kiwi --build $PWD/p2v.kiwi -d build --add-profile netboot --type pxe
59
60       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

ADDING AN SSH IDENTITY

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
69       First create a key pair.  It must have an empty passphrase:
70
71        ssh-keygen -t rsa -N '' -f id_rsa
72
73       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
78       The private key should be added to the kiwi config and then discarded:
79
80        virt-p2v-make-kiwi [...] --inject-ssh-identity id_rsa
81        rm id_rsa
82
83       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
87       When booting virt-p2v, specify the URL of the injected file like this:
88
89        │         User name: [root_____________________________] │
90        │                                                        │
91        │          Password: [    <leave this field blank>     ] │
92        │                                                        │
93        │  SSH Identity URL: [file:///var/tmp/id_rsa___________] │
94
95       or if using the kernel command line, add:
96
97        p2v.identity=file:///var/tmp/id_rsa
98
99       For more information, see "SSH IDENTITIES" in virt-p2v(1).
100

OPTIONS

102       --help
103           Display help.
104
105       --inject-ssh-identity id_rsa
106           Add an SSH identity (private key) file into the kickstart.  See
107           "ADDING AN SSH IDENTITY" above.
108
109       -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
114       -V
115       --version
116           Display version number and exit.
117

FILES

119       $libdir/virt-p2v/virt-p2v.xz
120           The virt-p2v(1) binary which is copied into the kiwi configuration.
121
122           The location of the binary can be changed by setting the
123           "VIRT_P2V_DATA_DIR" environment variable.
124
125       $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
131           The location of these files can be changed by setting the
132           "VIRT_P2V_DATA_DIR" environment variable.
133

ENVIRONMENT VARIABLES

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

SEE ALSO

141       virt-p2v(1), virt-p2v-make-disk(1), virt-v2v(1), kiwi(1),
142       http://libguestfs.org/.
143

AUTHORS

145       Cédric Bosdonnat
146
148       Copyright (C) 2016 SUSE Ltd.
149

LICENSE

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
156       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
161       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

BUGS

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
169       To report a new bug against libguestfs, use this link:
170       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
171
172       When reporting a bug, please supply:
173
174       ·   The version of libguestfs.
175
176       ·   Where you got libguestfs (eg. which Linux distro, compiled from
177           source, etc)
178
179       ·   Describe the bug accurately and give a way to reproduce it.
180
181       ·   Run libguestfs-test-tool(1) and paste the complete, unedited output
182           into the bug report.
183
184
185
186libguestfs-1.40.1                 2019-01-17             virt-p2v-make-kiwi(1)
Impressum