NAME¶
mic-image-creator - 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
SEE ALSO¶
mic-image-convertor(1),
mic-chroot(1),
mic-image-writer(1),
mic-livecd-iso-to-disk(1),
mic-image-manager(1)