1MKKSISO(1) Lorax MKKSISO(1)
2
3
4
6 mkksiso - Make Kickstart ISO Utility Documentation
7
8 Authors
9 Brian C. Lane <bcl@redhat.com>
10
11 mkksiso is a tool for creating kickstart boot isos. In it's simplest
12 form you can add a kickstart to a boot.iso and the kickstart will be
13 executed when the iso is booted. If the original iso was created with
14 EFI and Mac support the kickstart boot.iso will include this support as
15 well.
16
17 mkksiso needs to be run as root, it depends on mounting the original
18 iso and you need to be root to be able to do that.
19
21 Add a kickstart and files to an iso
22 usage: mkksiso [-h] [-a ADD_PATHS] [-c CMDLINE] [--debug] ks
23 input_iso output_iso
24
25 Optional arguments
26 -h, --help
27 show this help message and exit
28
29 -a ADD_PATHS, --add ADD_PATHS
30 File or directory to add to ISO (may be used multiple times)
31
32 -c CMDLINE, --cmdline CMDLINE
33 Arguments to add to kernel cmdline
34
35 --debug
36 print debugging info
37
38 -V VOLID, --volid VOLID
39 Set the ISO volume id, defaults to input's
40
41 Positional arguments
42 ks Kickstart to add to the ISO
43
44 input_iso
45 ISO to modify
46
47 output_iso
48 Full pathname of iso to be created
49
51 Create a kickstart like you normally would, kickstart documentation can
52 be found here, including the url and repo commands. If you are creat‐
53 ing a DVD and only need the content on the DVD you can use the cdrom
54 command to install without a network connection. Then run mkksiso like
55 this:
56
57 mkksiso /PATH/TO/KICKSTART /PATH/TO/ISO /PATH/TO/NEW-ISO
58
59 This will create a new iso with the kickstart in the root directory,
60 and the kernel cmdline will have inst.ks=... added to it so that it
61 will be executed when the iso is booted (be careful not to boot on a
62 system you don't want to wipe out! There will be no prompting).
63
64 By default the volume id of the iso is preserved. You can set a custom
65 volid by passing -V and the string to set. The kernel cmdline will be
66 changes, and the iso will have th custom volume id. eg.:
67
68 mkksiso -V "Test Only" /PATH/TO/KICKSTART /PATH/TO/ISO /PATH/TO/NEW-ISO
69
71 You can add repo directories to the iso using --add /PATH/TO/REPO/,
72 make sure it contains the repodata directory by running createrepo_c on
73 it first. In the kickstart you can refer to the directories (and files)
74 on the iso using file:///run/install/repo/DIRECTORY/. You can then use
75 these repos in the kickstart like this:
76
77 repo --name=extra-repo --baseurl=file:///run/install/repo/extra-repo/
78
79 Run mkksiso like so:
80
81 mkksiso --add /PATH/TO/REPO/ /PATH/TO/KICKSTART /PATH/TO/ISO /PATH/TO/NEW-ISO
82
84 You can use the kickstart liveimg command, to install a pre-generated
85 disk image or tar to the system the iso is booting on.
86
87 Create a disk image or tar with lorax-composer or livemedia-creator,
88 make sure the image includes tools expected by anaconda, as well as the
89 kernel and bootloader support. In lorax-composer use the liveimg-tar
90 image type. If you plan to install it to a UEFI machine make sure to
91 include grub2-efi and efibootmgr in the blueprint.
92
93 Add the root.tar.xz file to the iso using --add /PATH/TO/ROOT.TAR.XZ,
94 and in the kickstart reference it with the liveimg command like this:
95
96 liveimg --url=file:///run/install/repo/root.tar.xz
97
98 It is also a good idea to use the --checksum argument to liveimg to be
99 sure the file hasn't been corrupted:
100
101 mkksiso --add /PATH/TO/root.tar.xz /PATH/TO/KICKSTART /PATH/TO/ISO /PATH/TO/NEW-ISO
102
103 When this iso is booted it will execute the kickstart and install the
104 liveimg contents to the system without any prompting.
105
107 mkksiso first examines the system to make sure the tools it needs are
108 installed, it will work with xorrisofs or mkisofs installed. It mounts
109 the source iso, and copies the directories that need to be modified to
110 a temporary directory.
111
112 It then modifies the boot configuration files to include the inst.ks
113 command, and checks to see if the original iso supports EFI. If it does
114 it regenerates the EFI boot images with the new configuration, and then
115 runs the available iso creation tool to add the new files and directo‐
116 ries to the new iso. If the architecture is x86_64 it will also make
117 sure the iso can be booted as an iso or from a USB stick (hybridiso).
118
119 The last step is to update the iso checksums so that booting with test
120 enabled will pass.
121
123 Weldr Team
124
126 2018, Red Hat, Inc.
127
128
129
130
13133.2 Apr 28, 2020 MKKSISO(1)