BUILD SETUP INSTRUCTIONS for Likewise Open Agent Client
=======================================================

Build Requirements
------------------

1. Microsoft Visual Studio

   All the included projects were built using Microsoft Visual Studio 2003.
   
   If youre using a different version, some conversions are required. 

2. .NET Framework 1.1

   This can be downloaded from http://www.microsoft.com.

3. Microsoft Platform SDK SP2

   The following Web page describes the changes included in this component:

   http://msdn.microsoft.com/library/default.asp?url=/library/en-us/sdkintro/sdkintro/windows_xp_sp2.asp


4. NAnt

   NAnt is a free .NET build tool.
   In theory its kind of like make without make's wrinkles.
   In practice it's a lot like Ant.

   NAnt can be downloaded from http://nant.sourceforge.net.

Build Setup
-----------

1. All the projects should be built using a command window with the correct build environment.

   For example, assume the Likewise Open source folder is <Likewise_Root_Dir> --  <Likewise_Root_Dir> might be c:\LikewiseOpen.

   The file <Likewise_Root_Dir>\Windows\commandshell.cmd will set up the correct build environment.

   Create a desktop shortcut with the following target:

      cmd /k "<Likewise_Root_Dir>\Windows\commandshell.cmd"

   Set the "Start In" value for this shortcut to be the following:

      <Likewise_Root_Dir>\Windows

   Note: Be sure to replace <Likewise_Root_Dir> with the actual directory path.

2. The following variables must be defined in the build environment.

   The <Likewise_Root_Dir>\userbuildenv folder contains some configuration files that help set up the appropriate environment for the build user.

   Create a folder in <Likewise_Root_Dir>\userbuildenv with a name that matches the ID of the current user (or the build user).
   The environment variable %USERNAME% provides the value of the current user ID.

   Copy the file <Likewise_Root_Dir>\userbuildenv\guest\rc-guest.cmd to <Likewise_Root_Dir>\userbuildenv\%USERNAME%\rc-%USERNAME%.cmd.

   Change the settings in the copied file to valid paths.
   For example, the variable LIKEWISE_DIST_PATH is the setting for the path where build results are written.

3. Invoke the desktop shortcut, which will open the necessary command build window.

   Type "nant dist" to make a debug build.

   Type "nant dist -D:config=release" to make a release build.

   Note: These commands will be successful only when the current folder is <Likewise_Root_Dir>.
   
Installation
------------

1. The application installer can be built using the following command in the <Likewise_Root_Dir>\Windows folder.

   nant -D:config=release install
   
   The corresponding installation binaries can be found at <Likewise_Root_Dir>\Windows\Install\LikewiseOpen\bin\Release
   
   At this time, only the release configuration is supported.
   
2. The appropriate checks to enforce administrative privileges, have not been incorporated in the setup binaries yet.

   Until these checks are available, please install the application when logged in as a user with administrative
   privileges.

