livemedia-creator (1) Linux Manual Page
NAME
livemedia-creator – Create live install media
SYNOPSIS
livemedia-creator [-h]
DESCRIPTION
livemedia-creator uses Anaconda, kickstart and Lorax to create bootable media that use the same install path as a normal system install. It can be used to make live isos, bootable (partitioned) disk images and filesystem images for use with virtualization.
The general idea is to use virt-install to install into a disk image and then use the disk image to create the bootable media.
livemedia-creator –help will describe all of the options available. At the minimum you need:
–make-iso to create a final bootable .iso –iso to specify the Anaconda install media to use with virt-install –ks is the kickstart to use to install the system
OPTIONAL ARGUMENTS:
-h, –help- show this help message and exit
–make-iso- Build a live iso
–make-disk- Build a partitioned disk image
–make-fsimage- Build a filesystem image
–make-appliance- Build an appliance image and XML description
–make-ami- Build an ami image
–make-tar- Build a tar of the root filesystem. Defaults to root.tar.xz
–make-pxe-live- Build a live pxe boot squashfs image
–make-ostree-live- Build a live pxe boot squashfs image of Atomic Host
–iso ISO- Anaconda installation .iso path to use for virt-install
–disk-image DISK_IMAGE- Path to disk image to use for creating final image
–fs-image FS_IMAGE- Path to existing filesystem image to use for creating final image.
–qcow2- Create qcow2 image instead of raw sparse image when making disk images.
–qcow2-arg- Arguments to pass to qemu-img. Pass once for each argument >>>>>>> d04a99e… livemedia-creator: Add support for making tarfiles
–compression- Compression binary for make-tar. xz, lzma, gzip, and bzip2 are supported. xz is the default.
–compress-arg- Arguments to pass to compression. Pass once for each argument
–ks KS- Kickstart file defining the install.
–image-name IMAGE_NAME- Name of fs/disk image to create. Default is a random name.
–image-only- Exit after creating fs/disk image.
–keep-image- Keep raw disk image after .iso creation
–no-virt- Use Anaconda’s image install instead of virt-install
–proxy PROXY- proxy URL to use for the install
–anaconda-arg ANACONDA_ARGS- Additional argument to pass to anaconda (no-virt mode). Pass once for eachargument
–armplatform ARMPLATFORM- the platform to use when creating images for ARM, i.e., highbank, mvebu, omap,tegra, etc.
–location LOCATION- location of iso directory tree with initrd.img and vmlinuz. Used to run virt-install with a newer initrd than the iso.
–logfile LOGFILE- Path to logfile
–lorax-templates LORAX_TEMPLATES- Path to mako templates for lorax
–tmp TMP- Top level temporary directory
–resultdir RESULT_DIR- Directory to copy the resulting images and iso into. Defaults to the temporaryworking directory
–title TITLE- Substituted for @TITLE@ in bootloader config files
–project PROJECT- substituted for @PROJECT@ in bootloader config files
–releasever RELEASEVER- substituted for @VERSION@ in bootloader config files
–volid VOLID- volume id
–squashfs_args SQUASHFS_ARGS- additional squashfs args
APPLIANCE ARGUMENTS:
–app-name APP_NAME- Name of appliance to pass to template
–app-template APP_TEMPLATE- Path to template to use for appliance data.
–app-file APP_FILE- Appliance template results file.
PXE-LIVE ARGUMENTS:
–live-rootfs-size- Size of root filesystem of live image in GiB. By default approximate size of space used in root filesystem is used.
–live-rootfs-keep-size- Keep the size of original root filesystem (rounded down to GiB) in live image
VIRT-INSTALL ARGUMENTS:
–ram MEMORY- Memory to allocate for installer in megabytes.
–vcpus VCPUS- Passed to –vcpus command
–vnc VNC- Passed to –graphics command
–arch ARCH- Passed to –arch command
–kernel-args KERNEL_ARGS- Additional argument to pass to the installation kernel
DRACUT ARGUMENTS:
–dracut-arg DRACUT_ARGS- Argument to pass to dracut when rebuilding the initramfs. Pass this once foreach argument. NOTE: this overrides the default.
SEE ALSO
Documentation in /usr/share/docs/lorax/README.livemedia-creator
AUTHOR
Brian C. Lane
