1LIVEMEDIA-CREATOR(1) General Commands Manual LIVEMEDIA-CREATOR(1)
2
6 livemedia-creator - Create live install media
7
10 livemedia-creator [-h]
11 (--make-iso | --make-disk | --make-fsimage | --make-appliance |
12 --make-ami | --make-tar | --make-pxe-live | --make-ostree-live)
13 [--iso ISO] [--disk-image DISK_IMAGE]
14 [--fs-image FS_IMAGE] [--ks KS]
15 [--image-name IMAGE_NAME] [--image-only]
16 [--fs-label FS_LABEL]
17 [--compression] [--compress-arg]
18 [--live-rootfs-size LIVE_ROOTFS_SIZE]
19 [--live-rootfs-keep-size LIVE_ROOTFS_KEEP_SIZE]
20 [--keep-image] [--no-virt] [--proxy PROXY]
21 [--anaconda-arg ANACONDA_ARGS]
22 [--armplatform ARMPLATFORM] [--location LOCATION]
23 [--logfile LOGFILE]
24 [--lorax-templates LORAX_TEMPLATES] [--tmp TMP]
25 [--resultdir RESULT_DIR] [--app-name APP_NAME]
26 [--app-template APP_TEMPLATE] [--app-file APP_FILE]
27 [--ram MEMORY] [--vcpus VCPUS] [--vnc VNC]
28 [--arch ARCH] [--kernel-args KERNEL_ARGS]
29 [--dracut-arg DRACUT_ARGS] [--title TITLE]
30 [--project PROJECT] [--releasever RELEASEVER]
31 [--volid VOLID] [--squashfs_args SQUASHFS_ARGS]
32 [--virt-uefi] [--ovmf-path OVMF_PATH]
33
36 livemedia-creator uses Anaconda, kickstart and Lorax to create bootable
37 media that use the same install path as a normal system install. It can
38 be used to make live isos, bootable (partitioned) disk images and
39 filesystem images for use with virtualization.
40 The general idea is to use virt-install to install into a disk image
42 and then use the disk image to create the bootable media.
43 livemedia-creator --help will describe all of the options available. At
45 the minimum you need:
46 --make-iso to create a final bootable .iso --iso to specify the Ana‐
48 conda install media to use with virt-install --ks is the kickstart to
49 use to install the system
50
54 -h, --help
55 show this help message and exit
56 --make-iso
59 Build a live iso
60 --make-disk
63 Build a partitioned disk image
64 --make-fsimage
67 Build a filesystem image
68 --make-appliance
71 Build an appliance image and XML description
72 --make-ami
75 Build an ami image
76 --make-tar
79 Build a tar of the root filesystem. Defaults to root.tar.xz
80 --make-pxe-live
83 Build a live pxe boot squashfs image
84 --make-ostree-live
87 Build a live pxe boot squashfs image of Atomic Host
88 --iso ISO
91 Anaconda installation .iso path to use for virt-install
92 --disk-image DISK_IMAGE
95 Path to disk image to use for creating final image
96 --fs-image FS_IMAGE
99 Path to existing filesystem image to use for creating final
100 image.
101 --qcow2
104 Create qcow2 image instead of raw sparse image when making disk
105 images.
106 --qcow2-arg
109 Arguments to pass to qemu-img. Pass once for each argument
110 >>>>>>> d04a99e... livemedia-creator: Add support for making
111 tarfiles
112 --compression
115 Compression binary for make-tar. xz, lzma, gzip, and bzip2 are
116 supported. xz is the default.
117 --compress-arg
120 Arguments to pass to compression. Pass once for each argument
121 --ks KS
124 Kickstart file defining the install.
125 --image-name IMAGE_NAME
128 Name of fs/disk image to create. Default is a random name.
129 --image-only
132 Exit after creating fs/disk image.
133 --keep-image
136 Keep raw disk image after .iso creation
137 --no-virt
140 Use Anaconda's image install instead of virt-install
141 --proxy PROXY
144 proxy URL to use for the install
145 --anaconda-arg ANACONDA_ARGS
148 Additional argument to pass to anaconda (no-virt mode). Pass
149 once for eachargument
150 --armplatform ARMPLATFORM
153 the platform to use when creating images for ARM, i.e., high‐
154 bank, mvebu, omap,tegra, etc.
155 --location LOCATION
158 location of iso directory tree with initrd.img and vmlinuz. Used
159 to run virt-install with a newer initrd than the iso.
160 --logfile LOGFILE
163 Path to logfile
164 --lorax-templates LORAX_TEMPLATES
167 Path to mako templates for lorax
168 --tmp TMP
171 Top level temporary directory
172 --resultdir RESULT_DIR
175 Directory to copy the resulting images and iso into. Defaults to
176 the temporaryworking directory
177 --title TITLE
180 Substituted for @TITLE@ in bootloader config files
181 --project PROJECT
184 substituted for @PROJECT@ in bootloader config files
185 --releasever RELEASEVER
188 substituted for @VERSION@ in bootloader config files
189 --volid VOLID
192 volume id
193 --squashfs_args SQUASHFS_ARGS
196 additional squashfs args
197
200 --app-name APP_NAME
201 Name of appliance to pass to template
202 --app-template APP_TEMPLATE
205 Path to template to use for appliance data.
206 --app-file APP_FILE
209 Appliance template results file.
210
213 --live-rootfs-size
214 Size of root filesystem of live image in GiB. By default approx‐
215 imate size of space used in root filesystem is used.
216 --live-rootfs-keep-size
219 Keep the size of original root filesystem (rounded down to GiB)
220 in live image
221
224 --ram MEMORY
225 Memory to allocate for installer in megabytes.
226 --vcpus VCPUS
229 Passed to --vcpus command
230 --vnc VNC
233 Passed to --graphics command
234 --arch ARCH
237 Passed to --arch command
238 --kernel-args KERNEL_ARGS
241 Additional argument to pass to the installation kernel
242 --virt-uefi
245 Boot the virtual machine in UEFI mode. Requires OVMF_CODE.fd and
246 OVMF_VARS.fd
247 --ovmf-path
250 Path to OVMF_CODE.fd and OVMF_VARS.fd. Defaults to
251 /usr/share/OVMF/, the UEFI firmware files need to be installed
252 manually, they are not shipped with RHEL.
253
256 --dracut-arg='ARG'
257 Argument to pass to dracut when rebuilding the initramfs. Pass
258 this once for each argument, single quoting the arguments like
259 this: '--xz' NOTE: this overrides the default, so all dracut
260 arguments must be included.
261
264 Documentation in /usr/share/docs/lorax/README.livemedia-creator
265
268 Brian C. Lane
269 2018-08-14 LIVEMEDIA-CREATOR(1)