Print this page
Kayak for ISO.
Starting with this commit, "gmake install-usb" will build the entire Kayak
world, both for PXE boot and for USB/ISO installers as well.
The CDDL license text and copyrights for OmniTI-original code are now
updated, too.
Additionally, there are files now present to allow pxeboot (Loader's PXE
booter) instead of pxegrub (GRUB's PXE booter).
Some portions Reviewed by: Lauri Tirkkonen <lotheac@iki.fi>
| Split |
Close |
| Expand all |
| Collapse all |
--- old/README.md
+++ new/README.md
1 1 Using Kayak
|
↓ open down ↓ |
1 lines elided |
↑ open up ↑ |
2 2 ===========
3 3
4 4 Building
5 5 --------
6 6
7 7 * Set PKGURL to be the source of the OmniOS bits we wish to install with
8 8 kayak, in case it's not the default "omnios" publisher for whatever release
9 9 branch you have checked out.
10 10
11 11 * zfs create rpool/kayak_image
12 - * gmake BUILDSEND=rpool/kayak_image
12 + * gmake {PREBUILT_ILLUMOS=<path>} BUILDSEND=rpool/kayak_image <target>
13 13
14 +BUILDSEND must be specified.
15 +
16 +PREBUILT_ILLUMOS should point to an already-built illumos-omnios of the
17 +version you wish to construct an installer. It is optional, but the build
18 +will warn you if you do not specify it. The build uses "svccfg-native" if
19 +possible to manipulate SMF on target images without conversing with the host
20 +machine's SMF services.
21 +
22 +<target> must be specified.
23 +
24 +install-http:
25 + Builds the <VERSION>.zfs.bz2 file, which is what Kayak uses
26 + for any install it does. Independent target.
27 +
28 +install-tftp:
29 + Builds the miniroot.gz file, which is what PXE Kayak feeds to
30 + GRUB or Loader to boot itself on a PXE boot. Independent target.
31 +
32 +install-iso:
33 + Builds both install-{http,tftp} and then proceeds to construct
34 + <VERSION>.iso using components from both.
35 +
36 +install-usb:
37 + Builds install-iso, and then proceed to construct <VERSION>.usb-dd
38 + based on the ISO image.
39 +
14 40 Operation
15 41 ---------
16 42
17 43 DHCP server:
18 44 * your server should be set to PXE boot
19 45 * the DHCP server must return and IP, a nextserver and a bootfile
20 - * the boot file should be the file {{{/boot/grub/pxegrub}}} from an existing OmniOS system
46 + * the boot file should be the file {{{/boot/grub/pxegrub}}} or {{{/boot/pxeboot}}} from an existing OmniOS system
21 47
22 48 TFTP server:
23 - * menu.lst.01<macaddr_just_hex_caps> based on the template provided in this directory should be placed in /tftpboot/
24 - * /boot/grub/pxegrub should be placed in /tftpboot/
49 + * menu.lst.01<macaddr_just_hex_caps> based on the template provided in this directory should be placed in /tftpboot/ if using grub, or put loader.conf.local in /tftpboot/boot
50 + * /boot/grub/pxegrub or /boot/pxeboot should be placed in /tftpboot/
25 51 * /platform/i86pc/kernel/amd64/unix should be placed in /tftpboot/omnios/kayak/
26 52 * the miniroot.gz file should be placed in /tftpboot/omnios/kayak/
27 53
28 54 HTTP server:
29 55 * The system install images should be placed an accessible URL
30 56 * The target system kayak config should be placed at a URL path with the filename <macaddr_just_hex_caps>
31 57
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX