Luna Pier Release Notes                                                      20100222
-----------------------

This is the first release of the modified kernel for Intel Luna Pier.  All work
was performed using the Fedora 11 distro as a base and the 2.6.30 update kernel
sources.


Contents:

  LICENSE                    - text file with license information
  docs-20100222.tar.bz2      - notes and sample configs
  kernel-20100120.tar.bz2    - tarball of the kernel source and binary packages
                               (local yum repo)


For This Release:

The following changes were made to the kernel:

- include the e1000e ethernet driver from Intel 
- backport the GPU DRM code from the upstream (2.6.31.6) kernel used in F12
- configure to build the Intel video driver (and omit others)

All development was performed on an up-to-date Fedora 11 build host using the
standard GNU tools (make, gcc, etc.) and Revisor.  The kernel was built using 
mock, i.e., 

  mock -r fedora-11-i386 rebuild --target=i586 --with firmware \
      SRPMS/kernel-2.6.30.10-105.lp01.fc11.src.rpm

Mock Notes: 
- Mock must be properly configured on the build host and the user must be 
  in the "mock" group for this command to run successfully.
- Mock is not required to build the kernel SRPM.  "rpmbuild" can be used 
  directly from a properly configured Fedora 11 build host.

More information on the setup and use of mock can be found at:

  https://fedoraproject.org/wiki/Projects/Mock


An example LiveCD image was built using Revisor, e.g., 

sudo revisor \
   --cli \
   --respin \
   --yes \
   --config=/opt/intel/luna-pier/revisor/revisor-lunapier.conf \
   --model=lunapier-i386 \
   --kickstart=/opt/intel/luna-pier/revisor/luna-pier-live-base.ks \
   --kickstart-include \
   --kickstart-default \
   --live-optical \
   --debug=1


Revisor Notes:
- Example Revisor configuration files are provided (in docs-20100222.tar.bz2).
  They should be placed in /opt/intel/luna-pier/revisor.
- The configuration files assume a local yum repository containing the modified
  kernel will be located in /opt/intel (provided in kernel-20100120.tar.bz2)
- Revisor requires "root" privileges in order to create a LiveCD image.  In the 
  example above "sudo" was used instead of running as "root".
- The 'debug' option is not required, but will provide more verbose output 
  during the process.

The resultant ISO image and sha1sum will be on the host file system in:

  /srv/revisor/lunapier-i386/live/
	lp-11-Live-i386.iso
	SHA1SUM


More information on rebranding Fedora using Revisor can be found at:

  http://revisor.fedoraunity.org/development/rebranding-fedora-with-revisor


Installation Notes:

When installing from the LiveCD image, SQUASHFS errors were sometimes encountered.
This has been observed on other Linux systems when booting from a LiveCD and is 
typically associated with hardware issues (memory, older CD-ROM drives, etc.).  
Adding the "nodma" option to the kernel command line on boot eliminated the issue, 
and permitted a clean installation to the hard drive to be performed.

There are known issues when performing an install to hard drive from the LiveCD image 
if there was a previously installed version of Fedora which used LVM.  The work-around 
is to use fdisk to manually remove the old partitions prior to performing the
installation.

WARNING - Removing the old partitions using fdisk will destroy any data on those
partitions.  Back up any data you wish to save prior to removing the paritions.


