			  PROVISIONING  
                          ------------

This document explains how to build the new provisioning system. 


  The new provisioning system has only been tested on a linux system
  running RedHat 6.2.  The xerces library used here is only 
  supported in a limited number of platforms.  You will need to
  port this library if you wish to move to a different platform.

  Requirements:

    Tools/Libraries 
	GNU make
	Java (1.3.1)
	MySQL
		MySQL-3.23.33-1.i386.rpm
		MySQL-client-3.23.33-1.i386.rpm
		MySQL-devel-3.23.33-1.i386.rpm
		mysql++-1.7.8-1.i386.rpm

	Xerces
		xerces-c-src1_4_0 (in vocal/contrib)

    Linux
	GNU gcc/g++ 2.91.66 or later


  Build Instructions:

    To make the provisioning server
	$ cd vocal
	$ make prov

        The binary is located in:  vocal/prov/cpp/pserver/bin.*

    To make the provisioning server library
        $ cd vocal
        $ make provlib

        The library is located in:  vocal/prov/cpp/psLib/obj.*

    To make the provisioning agent library
        $ cd vocal
        $ make psagentx

        The library is located in:  vocal/prov/cpp/psAgentX/obj.* 


Our source code tree structure:

  Directory Structure

    vocal/prov/cpp/common
    vocal/prov/cpp/psAgentX
    vocal/prov/cpp/psLib
    vocal/prov/cpp/pserver
    vocal/prov/java/build
    vocal/prov/java/images
    vocal/prov/java/src
    vocal/prov/priv_doc
    vocal/prov/xml


The provisioning directory contains the following subdirectories:

1.  cpp/common    -- includes request, result, message type source code.
2.  cpp/psAgentX  -- includes provisioning agent source code.
3.  cpp/psLib     -- includes the provisioning server library source code.
4.  cpp/pserver   -- includes the provisoning server source code.
5.  java/build    -- includes the java build scripts to run javac and ant to
                     produce Mascarpone.jar
6.  java/images   -- images for the provisoning gui logo
7.  java/src      -- includes source code for the java gui
8.  priv_doc      -- includes the provisioning system architecure document 
                     in frame.
9.  xml           -- includes sample description xml files.



======================================================================

Copyright 2000-2003, Cisco Systems, Inc.
THE INFORMATION HEREIN IS PROVIDED ON AN "AS IS" BASIS, WITHOUT ANY
WARRANTIES OR REPRESENTATIONS, EXPRESS, IMPLIED OR STATUTORY, INCLUDING
WITHOUT LIMITATION, WARRANTIES OF NONINFRINGEMENT, MERCHANTABILITY OR
FITNESS FOR A PARTICULAR PURPOSE.

$Id: build.txt,v 1.2.2.1 2003/03/28 05:25:52 bko Exp $
