livemedia-creator (1) - Linux Manuals

livemedia-creator: Create live install media

Command to display livemedia-creator manual in Linux: $ man 1 livemedia-creator

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.

AUTHOR

Brian C. Lane