-------------------------------------------------------------------------------
README:  Oracle Solaris Legacy Containers
-------------------------------------------------------------------------------

This document details how to install or update your Oracle Solaris Legacy
Containers software.  Follow directions to ensure a proper installation.

The Oracle Solaris Legacy Containers download includes two versions of the
product:

    - Oracle Solaris Legacy Containers 1.0.1
        - For Oracle Solaris 10 10/08 or later

    - Oracle Solaris Legacy Containers 1.0
        - For Oracle Solaris 10 08/07
        - For Oracle Solaris 10 05/08

Both product versions contain identical features.  The 1.0.1 product depends
on Solaris packages introduced in Solaris 10 10/08.  The 1.0 product delivers
these packages to pre-10/08 versions of Solaris.

-------------------------------------------------------------------------------
Oracle Solaris Legacy Containers Installation Instructions:

    - For systems running pre-10/08 Solaris updates or kernels, including:

        - Solaris 10 8/07 (plus 127111-01 or later)
        - Solaris 10 5/08
        - KU 127111-*
        - KU 127127-*
        - KU 137111-*

        Oracle Solaris Legacy Containers requires a minimum KU patch of
        127111-01 or later.  Download and install this patch if needed from
	http://support.oracle.com or http://sunsolve.sun.com.
		
        To install the Oracle Solaris Legacy Containers 1.0 software:

            1. Download the Oracle Solaris Legacy Containers software bundle
	       from www.oracle.com.

            2. Unarchive and install 1.0 software packages:
               # unzip solarislegacycontainers-solaris10-sparc.zip
               # cd solarislegacycontainers/1.0/Product
               # pkgadd -d `pwd` SUNWs8brandr SUNWs8brandu
	       # pkgadd -d `pwd` SUNWs9brandr SUNWs9brandu SUNWs9brandk

        The 1.0 software packages includes Oracle Solaris Legacy Containers
	patch 128548-08.  Later patches to Solaris Legacy Containers require
	Solaris patch 137137-09 or later Solaris patches.

    - For systems running Solaris 10/08 or later updates or kernels, including:

        - Solaris 10/08 or later
        - KU 137137-* or later

	Verify following Solaris packages are installed on the target host:

            SUNWs8brandr
            SUNWs8brandu
            SUNWs9brandr
            SUNWs9brandu

	These packages are required.  If they are not installed, install them
        from the most recent of:

            - The Solaris 10 10/08 installation media.
            - The Solaris 10 installation media most recently used to install
              or upgrade the host.

           After installing the above packages, any patches that have been
           applied to the system which update these packages need to be
           re-applied.  Such patches can be identified via the command:

                # [ -f /var/sadm/patch/*/log ] && \
                    grep '^PKG=SUNWs[89]brand[ur]' /dev/null \
                    /var/sadm/patch/*/log | cut -f 5,5 -d/ | sort -u

           Patch 137137-09 need not be re-applied.

           It is recommended that these packages be added immediately after
           upgrading to Solaris 10/08 or patching to 137137-09 to avoid the
           need to re-apply any patches.

        To install the Oracle Solaris Legacy Containers 1.0.1 software:

            1. Download the Oracle Solaris Legacy Containers software bundle
	       from www.oracle.com.

            2. Unarchive and install 1.0.1 software package:
               # unzip solarislegacycontainers-solaris10-sparc.zip
               # cd solarislegacycontainers/1.0.1/Product
               # pkgadd -d `pwd` SUNWs8brandk
               # pkgadd -d `pwd` SUNWs9brandk


-------------------------------------------------------------------------------
Upgrading Oracle Solaris Legacy Containers for systems upgrading or patching
to Solaris 10/08 or later updates or kernels:

    For systems installed with Oracle Solaris Legacy Containers 1.0 (or the
    prior Solaris 8 Containers 1.0 or Solaris 8 Migration Assistant release),
    the software must be updated to version 1.0.1 after updating to:

        - Solaris 10/08 or later
        - KU 137137-* or later

    After updating to one of the above, install the Oracle Solaris Legacy
    Containers 1.0.1 package for the Solaris 8 branded zone feature:

        1. Download the Oracle Solaris Legacy Containers software bundle from
           www.oracle.com.

        2. Unarchive and install the following software package:
           # unzip solarislegacycontainers-solaris10-sparc.zip
           # cd solarislegacycontainers/1.0.1/Product
           # pkgadd -d `pwd` SUNWs8brandk

    If the Oracle Solaris Legacy Containers software is not updated to version
    1.0.1, use of the product will produce warning messages, and it may not be
    possible to install future patches.

