NAME¶

SYNOPSIS¶

 virt-p2v-make-disk -o /dev/sdX [os-version]

DESCRIPTION¶

virt-p2v-make-disk is a script which creates a bootable disk image or USB key containing virt-p2v. It uses virt-builder(1) to do this, and is just a small shell script around virt-builder.

The required -o parameter specifies where the output should go, for example to a USB key (eg. "-o /dev/sdX") or to a file. If you pass a device name, then the existing contents of the device will be erased.

 virt-builder -l

EXAMPLES¶

 virt-p2v-make-disk -o /dev/sdX

Write a virt-p2v bootable virtual disk image, and boot it under qemu:

 virt-p2v-make-disk -o /var/tmp/p2v.img
 qemu-kvm -m 1024 -boot c \
   -drive file=/var/tmp/p2v.img,if=virtio,index=0 \
   -drive file=/var/tmp/guest.img,if=virtio,index=1

where /var/tmp/guest.img would be the disk image of some guest that you want to convert (for testing only).

ADDING EXTRA PACKAGES¶

 virt-p2v-make-disk -o /var/tmp/p2v.img --install tcpdump,traceroute

ADDING AN SSH IDENTITY¶

First create a key pair. It must have an empty passphrase:

 ssh-keygen -t rsa -N '' -f id_rsa

This creates a private key ("id_rsa") and a public key ("id_rsa.pub") pair. The public key should be appended to the "authorized_keys" file on the virt-v2v conversion server (usually to "/root/.ssh/authorized_keys").

The private key should be injected into the disk image and then discarded:

 virt-p2v-make-disk [...] --inject-ssh-identity id_rsa
 rm 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 "SSH IDENTITIES" in virt-p2v(1).

32 BIT VIRT-P2V¶

This option requires that you have built virt-p2v.$arch (ie. usually virt-p2v.i686) by some means, and that you install it next to the ordinary virt-p2v binary (eg. in $libdir/virt-p2v/ or $VIRT_V2V_DATA_DIR). This is outside the scope of this manual page, but you can find some tips in "BUILDING i686 32 BIT VIRT-P2V" in guestfs-building(1).

OPTIONS¶

--help

Display help.

--arch ARCH

Set the architecture of the virt-p2v ISO. See "32 BIT VIRT-P2V" above.

If this option is not supplied, then the default is to use the same architecture as the host that is running virt-p2v-make-disk.

--inject-ssh-identity id_rsa

Add an SSH identity (private key) file into the image. See "ADDING AN SSH IDENTITY" above.

--install pkg,pkg,...

Add extra packages to the image. See "ADDING EXTRA PACKAGES" above.

--no-warn-if-partition

Normally you should not write to a partition on a USB drive (ie. don’t use "-o /dev/sdX1", use "-o /dev/sdX" to make a bootable USB drive). If you do this, virt-builder prints a warning. This option suppresses that warning.

-o OUTPUT

--output OUTPUT

Write output to "OUTPUT", which can be a local file or block device. The existing contents of the device will be erased.

-v

--verbose

Enable verbose output. Use this if you need to debug problems with the script or if you are filing a bug.

-V

--version

Display version number and exit.

FILES¶

$libdir/virt-p2v/virt-p2v.xz

The virt-p2v(1) binary which is copied into the bootable disk image.

The location of the binary can be changed by setting the "VIRT_P2V_DATA_DIR" environment variable.

$datadir/virt-p2v/issue

$datadir/virt-p2v/launch-virt-p2v.in

$datadir/virt-p2v/p2v.service

Various data files that are copied into the bootable disk image.

The location of these files can be changed by setting the "VIRT_P2V_DATA_DIR" environment variable.

ENVIRONMENT VARIABLES¶

"VIRT_P2V_DATA_DIR"

The directory where virt-p2v-make-disk looks for data files (see "FILES" above). If not set, a compiled-in location is used.

SEE ALSO¶

AUTHORS¶

COPYRIGHT¶

LICENSE¶

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

BUGS¶

To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

When reporting a bug, please supply:

• The version of libguestfs.
• Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
• Describe the bug accurately and give a way to reproduce it.
• Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.