Home | History | Annotate | Download | only in livemedia
      1 Welcome to the OpenSolaris Live Media kit.
      2 
      3 This kit may be used to construct a live DVD or USB flash device from a Solaris
      4 Express x86 installation DVD.  This kit contains the following:
      5 
      6 build_live_dvd: main script which is executed to construct the Live DVD image
      7 build_live_dvd.conf.sample: sample configuration file for build_live_dvd
      8 bootcd_skel: directory hierarchy of modifications for Live DVD operation
      9 packages: collection of additional pieces used in the live DVD, most notably
     10 the compressed lofi driver.
     11 usbcopy: utility to copy a live USB image to a designated device
     12 usbgen: utility to generate a live USB image from a live DVD iso
     13 
     14 To construct a live DVD or USB image:
     15 
     16 0.  Install Solaris Express, Community Edition.  In general you should be using
     17 the same (or close to the same) release as the version of the live DVD that
     18 you want to build, as some of the system configuration is
     19 pre-computed by build_live_dvd and may not work correctly on older releases.
     20 In particular, Solaris 10 (any version) will not correctly execute the Gnome
     21 pre-configuration steps.
     22 1.  Obtain a Solaris Express x86 installation DVD image.  Using lofi to
     23 mount up the .iso is recommended for speed of building.  A combined netinstall
     24 image constructed from CD's will also work.  This kit is configured to work
     25 correctly with build 70 and later.
     26 2.  Copy build_live_dvd.conf.sample to build_live_dvd.conf and configure it
     27 to use correct paths for its work.  Note that you'll need at least 5 GB
     28 of free space in the area pointed to by BOOTCD_PROTO, more if you intend to also
     29 build the USB images.
     30 3.  Execute build_live_dvd as root.  The entire process will be logged to
     31 build_live_dvd.log.  This will take roughly 1.5 hours on relatively new
     32 hardware.
     33 4.  Create your live media image:
     34 	- For a DVD, burn the resulting solaris_live.iso using cdrw or cdrecord.
     35 	- For a USB memory stick, run the included usbcopy program.  usbcopy
     36 	takes one command-line argument, the path to the image built above.
     37 	If you've chosen to use a ZFS volume for this by setting USB_ZVOL in
     38 	build_live_dvd.conf, the path will be /dev/zvol/rdsk/$USB_ZVOL.
     39 	Otherwise, the path is $USB_FILE.  And yes, you need to expand $USB_ZVOL
     40 	and $USB_FILE yourself, usbcopy doesn't read build_live_dvd.conf at this
     41 	time.
     42 5.  Insert the DVD or USB stick and reboot; you may need to interrupt your BIOS
     43 to select the correct boot device.  The GRUB menu offers both graphical
     44 and text mode.
     45 6.  You'll need to answer one question regarding keyboard layout.
     46 7.  Login as root, password is solaris.
     47 8.  If you'd like to install Solaris to a hard drivefrom the live image, you
     48 first need to create a Solaris2 fdisk partition (using Solaris fdisk, or your
     49 other favorite tool for doing so) and then double-click the "Install Solaris"
     50 icon on the desktop.  This will install to a UFS root file system.
     51 
     52 Known issues:
     53 1.  build_live_dvd generates the following warning:
     54 UX /usr/ccs/bin/tsort: INFORM: cycle in data
     55         SUNWdhcsr
     56         SUNWdhcsu
     57         SUNWwbcou
     58         SUNWwbapi
     59         SUNWj5rt
     60         SUNWmfrun
     61         SUNWcar
     62 	
     63 The warning is harmless and may be ignored.
     64 
     65 Questions, comments, contributions to livemedia-discuss (a] opensolaris.org
     66