livemedia-creator (1) - Linux Manuals

livemedia-creator: Create live install media

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

SEE ALSO

Documentation in /usr/share/docs/lorax/README.livemedia-creator