mic-image-creator(1) Create various images

SYNOPSIS

mic-image-creator [options]

DESCRIPTION

mic-image-creator is a powerful image creating tool, it can create live CD, live USB, VMWare, KVM and VirtualBox images using a yum repository and a kickstart file.

There are also many companion tools for doing various operations on images, including mic-image-convertor, mic-chroot, mic-image-writer, mic-livecd-iso-to-disk, etc. They are all command line tools except mic-image-writer which has GUI if current runtime environment is X. mic-image-manager is a more powerful GUI toolset for them.

OPTIONS

General options:

--version show version number and exit

-h, --help show this help message and exit

-c KSCFG, --config=KSCFG Path to kickstart config file

-f FORMAT, --format=FORMAT Image format, you can specify as livecd, liveusb, loop, raw, nand, mrstnand, ubi, vdi or vmdk

-t TMPDIR, --tmpdir=TMPDIR Temporary directory to use (default: /var/tmp)

-k CACHEDIR, --cache=CACHEDIR Cache directory to use (default: private cache)

-o OUTDIR, --outdir=OUTDIR Output directory to use (default: current work dir)

--genchecksum Generate checksum for image file if this option is provided

-S SUFFIX, --suffix=SUFFIX Image name suffix (default: date stamp)

-b, --build-bootstrap Build a bootstrap, it should be used with -B or --bootstrap together

--mainrepo=MAINREPO Specify main repo name, it must be a repo name in your kickstart file

--siteconf=SITECONF Specify site config file, it can be used to set tmpdir, cachedir, outputdir, it also can be used to remap/reroute a repo in kickstart to another equivalent repo, the default site config is ~/.mic2_site.conf.

--repo=REPO Specify additional repo, it may be a simple URL or a complicated tuple string, you can specify multiple repos using this option multiple times

-B BOOTSTRAP, --bootstrap=BOOTSTRAP Use a given bootstrap env to create image

--alt-initrd-name=ALT_INITRD_NAME Name of alternate initrd image, if NOT to use the one from kernel package

--record-pkgs=RECORD_PKGS Record the installed packages, valid values: name, content

--local-pkgs-path=LOCAL_PKGS_PATH Path for local pkgs (rpms) to be installed

OPTIONS For Live USB

These options are for creating the live USB file image

-i, --interactive Directly write into a USB disk.

--fstype=FSTYPE File system type for live USB file image, ext3 or vfat, the default is vfat.

--overlay-size-mb=OVERLAYSIZEMB overlay size in MB as unit, it means how size changes you can save in your live USB disk.

OPTIONS for MRST NAND

These options are for creating the MRST NAND image

--initrd-url=INITRD_URL URL of initrd.img, if it need to be retrieved from remote site.

--initrd-path=INITRD_PATH Path of initrd.img, if it was saved in local filesystem.

--kernel-url=KERNEL_URL URL of kernel file(vmlinuz), if it need to be retrieved from remote site.

--kernel-path=KERNEL_PATH Path of kernel file(vmlinuz), if it was saved in local filesystem.

--kernel-rpm-url=KERNEL_RPM_URL URL of kernel rpm package, if it need to be retrieved from remote site.

--kernel-rpm-path=KERNEL_RPM_PATH Path of kernel rpm package, if it was saved in local filesystem.

--bootimg-only Create boot image only.

OPTIONS For Debug

These options control the output of logging information during image creation

-d, --debug Output debugging information

-v, --verbose Output verbose progress information

--logfile=FILE Save debug information to FILE

EXAMPLES

Create a live CD image:

mic-image-creator -f livecd -c 2.1-final.ks

EXIT STATUS

mic-image-creator returns a zero exist status if it succeeds, otherwise return non-zero and print error message.

AUTHOR

Yi Yang, Anas Nashif, Jianfeng Ding