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
25       The root user on the disk image uses "p2v" as its initial password.
26

BUILDING THE KIWI CONFIGURATION

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

BUILDING A LIVE CD / ISO

38       Once you have the kiwi configuration folder, you can use kiwi(1) to
39       make a live CD:
40
41        sudo kiwi --build p2v.kiwi -d build --type iso
42
43       Before running this, you may have to tweak the "config.xml" file to
44       change the locale and keyboard mapping to the one you need.
45
46       If running on a SUSE Linux Entreprise Server, add the path to your
47       packages repositories using the "--ignore-repos" and "--add-repo" kiwi
48       parameters.
49
50       The generated ISO image will be placed in the "build" folder.
51

BUILDING A BOOTABLE USB KEY

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

BUILDING A PXE BOOT IMAGE

58       To create a PXE boot image, run kiwi in such a way:
59
60        sudo kiwi --build $PWD/p2v.kiwi -d build --add-profile netboot --type pxe
61
62       For more details on how to use the generated image, report to the kiwi
63       documentation on PXE images:
64       https://doc.opensuse.org/projects/kiwi/doc/#chap.pxe
65

ADDING AN SSH IDENTITY

67       You can inject an SSH identity (private key) file to the kiwi config
68       and hence into the ISO using the --inject-ssh-identity option.  Note
69       that you cannot inject a key once the ISO has been built.
70
71       First create a key pair.  It must have an empty passphrase:
72
73        ssh-keygen -t rsa -N '' -f id_rsa
74
75       This creates a private key ("id_rsa") and a public key ("id_rsa.pub")
76       pair.  The public key should be appended to the "authorized_keys" file
77       on the virt-v2v conversion server (usually to
78       "/root/.ssh/authorized_keys").
79
80       The private key should be added to the kiwi config and then discarded:
81
82        virt-p2v-make-kiwi [...] --inject-ssh-identity id_rsa
83        rm id_rsa
84
85       The ISO can then be built from the kickstart in the usual way (see
86       above), and it will contain the embedded SSH identity
87       (/var/tmp/id_rsa).
88
89       When booting virt-p2v, specify the URL of the injected file like this:
90
91        │         User name: [root_____________________________] │
92        │                                                        │
93        │          Password: [    <leave this field blank>     ] │
94        │                                                        │
95        │  SSH Identity URL: [file:///var/tmp/id_rsa___________] │
96
97       or if using the kernel command line, add:
98
99        p2v.identity=file:///var/tmp/id_rsa
100
101       For more information, see "SSH IDENTITIES" in virt-p2v(1).
102

OPTIONS

104       --help
105           Display help.
106
107       --inject-ssh-identity id_rsa
108           Add an SSH identity (private key) file into the kickstart.  See
109           "ADDING AN SSH IDENTITY" above.
110
111       -o OUTPUT
112       --output OUTPUT
113           Write kiwi configuration to the "OUTPUT" folder.  If not specified,
114           the default is p2v.kiwi in the current directory.
115
116       -V
117       --version
118           Display version number and exit.
119

FILES

121       $libdir/virt-p2v/virt-p2v.xz
122           The virt-p2v(1) binary which is copied into the kiwi configuration.
123
124           The location of the binary can be changed by setting the
125           "VIRT_P2V_DATA_DIR" environment variable.
126
127       $datadir/virt-p2v/issue
128       $datadir/virt-p2v/launch-virt-p2v.in
129       $datadir/virt-p2v/kiwi
130       $datadir/virt-p2v/p2v.service
131           Various data files that are used to make the kiwi appliance.
132
133           The location of these files can be changed by setting the
134           "VIRT_P2V_DATA_DIR" environment variable.
135

ENVIRONMENT VARIABLES

137       "VIRT_P2V_DATA_DIR"
138           The directory where virt-p2v-make-kiwi looks for data files and the
139           virt-p2v binary (see "FILES" above).  If not set, a compiled-in
140           location is used.
141

SEE ALSO

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

AUTHORS

147       Cédric Bosdonnat
148
150       Copyright (C) 2016 SUSE Ltd.
151

LICENSE

153       This program is free software; you can redistribute it and/or modify it
154       under the terms of the GNU General Public License as published by the
155       Free Software Foundation; either version 2 of the License, or (at your
156       option) any later version.
157
158       This program is distributed in the hope that it will be useful, but
159       WITHOUT ANY WARRANTY; without even the implied warranty of
160       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
161       General Public License for more details.
162
163       You should have received a copy of the GNU General Public License along
164       with this program.  If not, see <https://www.gnu.org/licenses/>.
165

BUGS

167       To get a list of bugs against libguestfs (which include virt-p2v), use
168       this link:
169       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
170
171       To report a new bug against libguestfs, use this link:
172       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
173
174       When reporting a bug, please supply:
175
176       •   The version of virt-p2v.
177
178       •   Where you got virt-p2v (eg. which Linux distro, compiled from
179           source, etc)
180
181       •   Describe the bug accurately and give a way to reproduce it.
182
183
184
185virt-p2v-1.42.3                   2023-01-21             virt-p2v-make-kiwi(1)
Impressum