NWS Source for OpenSolaris
		"@(#)ReleaseNotes	1.11	06/11/08 SMI"


The Network Storage, NWS, source for OpenSolaris contains the source for the Sun Fibre-Channel 
transport drivers, utilities and the Sun iSCSI device drivers and management utilities.


This delivery of NWS buildable source for OpenSolaris consists of 1 archive:

1.  Source compressed archive (nws-src-DATE.tar.bz2)


**The NWS source is dependent on the OS-NET (ON) source for this release of OpenSolaris.**
To build the NWS source, you will need to download and build the 
version of on-src-DATE that matches the nws-src-DATE.  
See http://www.opensolaris.org/os/downloads/ 

(For a short time the ON source may be named opensolaris-src-DATE)

Follow all the instructions for building ON first.  This ON portion of OpenSolaris build 
will be used as your reference build in environment settings listed below.

General questions on the NWS code for OpenSolaris should be directed to the 
OpenSolaris Storage discussion list (storage-discuss@opensolaris.org).  Please note 
that the mailing lists are configured to only allow posts via the web forum interface 
or from list subscribers.


A. Building the NWS consolidation from source

Once you have downloaded the NWS source, follow these steps 
to build the source.

1.  Unpack the buildable source into your build area, e.g.,

    $ bzip2 -dc nws-src-DATE.tar.bz2 | tar -xf -
    
    This will create the directory nws-src-DATE in your build area.

2.  Change directories to the newly created nws-src-DATE directory.

3.  Included with this release are:
    a.  src directory
    b.  ReleaseNotes
    c.  opennws.env
    d.  opennws_build

4.  Edit the opennws.env setting file for your build environment.
    

    a.  BUILD_OPTIONS		Minimum settings N or D (Nondebug and/or Debug)
    b.  OS_REF_BUILD		Points to your built ON for OpenSolaris workspace
    c.  GATE			Name of your NWS for OpenSolaris source workspace directory
    d.  CODEMGR_WS		Full path to where your NWS build workspace resides
    e.  MAILTO			Upon completion, an email containing the build log will be 
    				sent to this address
    f.  SPRO_ROOT		This variable should point to the location where the SUNWspro
    				has been installed to.
    g.  ONBLD_TOOLS		The directory where the SUNWonbld package was installed to.
    

5.  Build the NWS consolidation source

    ./opennws_build -E ./opennws.env &


B. Building Individual Components

If you would like to build a specific component without the use of the build routine opennws_build, 
the following variables need to be set or expanded.

CODEMGR_WS
	It should be set to the full path to your workspace.

MACH
	The instruction set architecture of the machine as given by uname -p, e.g. sparc, i386. 
	If you do set it manually, be sure not to set it to anything other than the output of 
	`/usr/bin/uname -p` on the specific machine you are using:
	
		MACH=`/usr/bin/uname -p`

ROOT
	Root of the proto area for the build. The makefiles direct the installation of header files 
	and libraries to this area and direct references to these files by builds of commands and 
	other targets. It should be expressed in terms of $CODEMGR_WS. This variable should be set 
	to ${CODEMGR_WS}/proto/root_${MACH}.

MAKEFLAGS
	This variable is not directly related to do the source; however, in order for the 
	build to work properly, make(1) must have access to the contents of the environment 
	variables described in this section. Therefore the MAKEFLAGS environment variable 
	should be set and contain at least ``e''. It is only needed if you are building.  
	It is possible to dispense with this by using 'make -e' if you are building using 
	make(1) or dmake(1) directly, but use of MAKEFLAGS is strongly recommended.
	
NONDEBUG
	The source will build debug binaries by default.  If you would like to build 
	non-debug binaries, the NONDEBUG variable needs to be set to NULL (NONDEBUG="") 
	to override the default setting of NONDEBUG=# in the makefiles.  To resume debug 
	builds unset NONDEBUG.

ON_REF_GATE
	This variable is used by the sources makefiles only.  It is needed to define the location
	of the built ON for OpenSolaris workspace.  

sparc_BUILD_TOOLS
	The sparc_BUILD_TOOLS variable is used to identify the location of the Sun Studio 11
	compilers.  This should be the location of the SUNWspro installation.  If you installed
	the Sun Studio 11 compilers into the default location, the sparc_BUILD_TOOLS variable
	would be set to /opt/SUNWspro.  You only need to set this variable if the hardware you are
	building on is sparc.

i386_BUILD_TOOLS
	The i386_BUILD_TOOLS variable is used to identify the location of the Sun Studio 11
	compilers.  This should be the location of the SUNWspro installation.  If you installed
	the Sun Studio 11 compilers into the default location, the i386_BUILD_TOOLS variable
	would be set to /opt/SUNWspro.  You only need to set this variable if the hardware you are
	building on is i386.

ONBLD
	This variable is used by the sources makefiles.  It should be set to the full path to the
	bin directory where your SUNWonbld is installed.  If you installed the SUNWonbld package
	with its default settings, the ONBLD variable should be set to /opt/onbld/bin.