.\" Process this file with
.\" groff -man -Tascii convertz.8
.\"
.TH convertz 8 "December 2011" convertz "convertz admin manual"
.SH NAME
convertz \- A Simple Tool for Converting VM image to Live Image for Zoni
.SH SYNOPSIS
.B zoni [-i 
.I input VM image
.B ] [-n
.I live image name
.B ] [-u
.I update image
.B ] [-p
.I partition number (optional)
.B ] [-h] [-v]
.SH DESCRIPTION
.BI convertz
is a simple tool that will convert your VM image to a Live Image for Zoni.
It accepts any VM image formats such as raw, vdi, qcow, etc.
(generally formats supported by qemu-img), converts it to raw format and
make all necessary adjustments before converting it a squashfs image. It
also obtains other information of the image such as the Linux Kernel
(vmlinuz) and initial ramdisk (initrd.img) before making necessary steps
to register the information into Zoni and move the necessary files to their
respective folders.
.PP
Currently
.BI convertz
only supports full Ubuntu or Debian based VM images (with vmlinuz and initrd.img in
/boot folder) and it assumes that the VM images file system in Non LVM
based and only contains a / or root partition and a swap partition.
.SH OPTIONS
.IP "-i input VM image"
The input is the actual VM image that a user wants to convert to live image.
.IP "-n live image name"
This is the live image name that will be register into Zoni as well as the 
name that the converted live image be named (with a .squashfs extension).
.IP "-u"
Use this option to update existing Image.
.IP "-p partition number"
This is the partition number of the / or root of the VM image. This parameter
is optional as
.BI convertz
will try to detect the partition itself. It is usefull only if the VM image
has more than 2 partitions during creation of the VM image.
.IP -h
Print usage/help information and exit.
.IP -v
Print version and exit.
.SH FILES
.I convertz
depends on several other tools in order to perform its task. They are:
.RS
zoni, qemu-img, parted, mksquashfs and uuidgen.
.RE
.PP
In addition, it expects the Debian Live Project deb files are compiled
and prepared. They are:
.RS
live-boot, live-config and live-tools
.RE
Information on preparing these files are available at http://live.debian.net
.SH BUGS
This is still a work in progress. As mentioned earlier,
.BI convertz
only supports Ubuntu or Debian based VM images only. A fair amount of steps had been
added to try to capture any errors as early as possible, any bugs please
contact the author. Thanks.
.SH AUTHOR
Jing-Yuan Luke (jyluke(alias)gmail.com)