1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
|
=head1 名前
virt-p2v-make-kiwi - Build the virt-p2v kiwi configuration
=head1 書式
virt-p2v-make-kiwi [--inject-ssh-identity path] [-o kiwi-folder]
=head1 説明
L<virt-p2v(1)> converts a physical machine to run virtualized on KVM,
managed by libvirt, OpenStack, oVirt, Red Hat Enterprise Virtualisation
(RHEV), or one of the other targets supported by L<virt-v2v(1)>.
Kiwi is a tool used mainly by SUSE Linux Enterprise and openSUSE to build
live CDs, make appliances and so on. It is driven by a few files including
an xml description of the machine.
virt-p2v-make-kiwi builds a folder containing all the pieces needed for kiwi
to build a bootable P2V live CD ISO, USB key, or PXE image. This tool only
builds the kiwi configuration, but this manual page describes some of the
ways you can use the kiwi configuration.
=head1 BUILDING THE KIWI CONFIGURATION
Using virt-p2v-make-kiwi is very simple:
virt-p2v-make-kiwi
will build a kiwi configuration based on the current machine’s distribution.
To control the name of the output folder, use the I<-o> parameter.
=head1 BUILDING A LIVE CD / ISO
Once you have the kiwi configuration folder, you can use L<kiwi(1)> to make
a live CD:
sudo kiwi --build p2v.kiwi -d build --type iso
Before running this, you may have to tweak the C<config.xml> file to change
the locale and keyboard mapping to the one you need.
If running on a SUSE Linux Entreprise Server, add the path to your packages
repositories using the C<--ignore-repos> and C<--add-repo> kiwi parameters.
The generated ISO image will be placed in the C<build> folder.
=head1 BUILDING A BOOTABLE USB KEY
Use the L<dd(1)> program to write the ISO created above to a USB key:
sudo dd if=path/to/p2v.iso of=/dev/sdX
=head1 BUILDING A PXE BOOT IMAGE
To create a PXE boot image, run kiwi in such a way:
sudo kiwi --build $PWD/p2v.kiwi -d build --add-profile netboot --type pxe
For more details on how to use the generated image, report to the kiwi
documentation on PXE images:
L<https://doc.opensuse.org/projects/kiwi/doc/#chap.pxe>
=head1 ADDING AN SSH IDENTITY
You can inject an SSH identity (private key) file to the kiwi config and
hence into the ISO using the I<--inject-ssh-identity> option. Note that you
I<cannot> inject a key once the ISO has been built.
First create a key pair. It must have an empty passphrase:
ssh-keygen -t rsa -N '' -f id_rsa
This creates a private key (C<id_rsa>) and a public key (C<id_rsa.pub>)
pair. The public key should be appended to the C<authorized_keys> file on
the virt-v2v conversion server (usually to C</root/.ssh/authorized_keys>).
The private key should be added to the kiwi config and then discarded:
virt-p2v-make-kiwi [...] --inject-ssh-identity id_rsa
rm id_rsa
The ISO can then be built from the kickstart in the usual way (see above),
and it will contain the embedded SSH identity (F</var/tmp/id_rsa>).
When booting virt-p2v, specify the URL of the injected file like this:
│ User name: [root_____________________________] │
│ │
│ Password: [ <leave this field blank> ] │
│ │
│ SSH Identity URL: [file:///var/tmp/id_rsa___________] │
or if using the kernel command line, add:
p2v.identity=file:///var/tmp/id_rsa
For more information, see L<virt-p2v(1)/SSH IDENTITIES>.
=head1 オプション
=over 4
=item B<--help>
ヘルプを表示します。
=item B<--inject-ssh-identity> id_rsa
Add an SSH identity (private key) file into the kickstart. See L</ADDING AN
SSH IDENTITY> above.
=item B<-o> OUTPUT
=item B<--output> OUTPUT
Write kiwi configuration to the C<OUTPUT> folder. If not specified, the
default is F<p2v.kiwi> in the current directory.
=item B<-V>
=item B<--version>
バージョン番号を表示して、終了します。
=back
=head1 ファイル
=over 4
=item F<$libdir/virt-p2v/virt-p2v.xz>
The L<virt-p2v(1)> binary which is copied into the kiwi configuration.
The location of the binary can be changed by setting the
C<VIRT_P2V_DATA_DIR> environment variable.
=item F<$datadir/virt-p2v/issue>
=item F<$datadir/virt-p2v/launch-virt-p2v.in>
=item F<$datadir/virt-p2v/kiwi>
=item F<$datadir/virt-p2v/p2v.service>
Various data files that are used to make the kiwi appliance.
The location of these files can be changed by setting the
C<VIRT_P2V_DATA_DIR> environment variable.
=back
=head1 環境変数
=over 4
=item C<VIRT_P2V_DATA_DIR>
The directory where virt-p2v-make-kiwi looks for data files and the virt-p2v
binary (see L</FILES> above). If not set, a compiled-in location is used.
=back
=head1 関連項目
L<virt-p2v(1)>, L<virt-p2v-make-disk(1)>, L<virt-v2v(1)>, L<kiwi(1)>,
L<http://libguestfs.org/>.
=head1 著者
Cédric Bosdonnat
=head1 COPYRIGHT
Copyright (C) 2016 SUSE Ltd.
|
