SysTutorials

Linux Manual Pages › Section 1

livemedia-creator(1)

NAME

livemedia-creator – Create live install media

SYNOPSIS

livemedia-creator [-h]
 (–make-iso | –make-disk | –make-fsimage | –make-appliance | –make-ami | –make-tar | –make-pxe-live | –make-ostree-live)
 [–iso ISO] [–disk-image DISK_IMAGE]
 [–fs-image FS_IMAGE] [–ks KS]
 [–image-name IMAGE_NAME] [–image-only]
 [–fs-label FS_LABEL]
 [–compression] [–compress-arg]
 [–live-rootfs-size LIVE_ROOTFS_SIZE]
 [–live-rootfs-keep-size LIVE_ROOTFS_KEEP_SIZE]
 [–keep-image] [–no-virt] [–proxy PROXY]
 [–anaconda-arg ANACONDA_ARGS]
 [–armplatform ARMPLATFORM] [–location LOCATION]
 [–logfile LOGFILE]
 [–lorax-templates LORAX_TEMPLATES] [–tmp TMP]
 [–resultdir RESULT_DIR] [–app-name APP_NAME]
 [–app-template APP_TEMPLATE] [–app-file APP_FILE]
 [–ram MEMORY] [–vcpus VCPUS] [–vnc VNC]
 [–arch ARCH] [–kernel-args KERNEL_ARGS]
 [–dracut-arg DRACUT_ARGS] [–title TITLE]
 [–project PROJECT] [–releasever RELEASEVER]
 [–volid VOLID] [–squashfs_args SQUASHFS_ARGS]

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