mic-image-creator(1) Create various images


mic-image-creator [options]


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.


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


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.


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.


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


Create a live CD image:

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


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


Yi Yang, Anas Nashif, Jianfeng Ding