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
↓ 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