fura ( Grid Middleware ) Files

SYSTEM REQUIREMENTS

Your system must meet the following requirements if you want to compile and use Fura. 

* UNIX: The usual UNIX runtime (sockets, glibc, etc)

* WINDOWS: The source code might compile if you have
	- a Unix-like environment running on top of Windows 
	 (eg, cygwin32 from http://www.cygwin.com/),
	- Microsoft Visual C++ 6.0 
	- Microsoft Visual Basic 6.0. To compile the Visual Basic bindings, MS SOAP SDK 3.0 
	  is needed. You can find it at: http://www.microsoft.com/downloads/details.aspx?familyid=c943c0dd-ceec-4088-9753-86f052ec8450&displaylang=en

	IMPORTANT: Use a compilation directory without spaces in its path.

* Perl: The usual Perl interpreter (http://www.perl.org/) 
	You also need the log4perl package 
	(see http://log4perl.sourceforge.net/ for installation instructions). 

* Java: Access to a Java 1.5 compiler and its runtime environment
  
* Ant: Ant 1.6 or higher (http://ant.apache.org/)

* Building tools: The GNU build tools: automake, autoconf and libtool (http://www.gnu.org/)
	In windows you can use cygwin (http://www.cygwin.com/) to get these tools. 

* Disk space: Fura requires about 1GB of disk space

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

ENVIROMENT VARIABLES

Make sure the PATH variable contains the path to the binaries for Perl, Java, Ant,
automake, autoconf, and libtool.

Add JAVA_HOME variable containing the path to the Java JDK.

WINDOWS: 
	- Add the bin directory of cygwin to the path.
	- You need to be able to access to the Visual Studio tools from a command line.
	The following directories need to be added to the path:
	C:\Program Files\Microsoft Visual Studio\Common\Tools\WinNT;
	C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Bin;
	C:\Program Files\Microsoft Visual Studio\Common\Tools;
	C:\Program Files\Microsoft Visual Studio\VC98\Bin;
	C:\Program Files\Microsoft Visual Studio\VB98;

	(You may need to change "C:\Program Files" above. 
	Do 'echo %ProgramFiles%' to find the actual value.)

    - When adding the bin directory of Java to the path in Windows, use a path 
    without spaces. For instance: 
    C:\PROGRA~1\Java\jdk1.5.0_09
    instead of
    C:\Program Files\Java\jdk1.5.0_09
    
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

THIRD PARTY SOFTWARE
    
Third Party software needed to compile is presented in a separate zip for your convenience. Notice that some packages cannot be redistributed due to licence limitations. In particular

    JavaBeans(TM) Activation Framework 1.1
    
    and
    
    JavaMail 1.4 bundle.    
    
    cannot be distributed with this project due to license restrictions.
    
    Please, manually download them from

    http://java.sun.com/products/javabeans/jaf/downloads/index.html
    
    and
    
    http://java.sun.com/products/javamail/downloads/index.html
    
    and then copy the zip files jaf-1_1-fr.zip and javamail-1_4.zip to thirdParty/activationBin before trying to build the project.    

    
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

COMPILING

From a shell or command prompt, change directories to where FuraSrc was unpacked,
and then type:

	UNIX: ./compile.sh
	or 	
	Windows: compile.bat

This will compile all source files.

Beware that compilation can last more than an hour.

Compilation will create four new directories into FuraSrc's root directory: 
	/dev Agent
	/devPortal 
	/devServer 
	/DISTRO.

The directories /dev Agent, /devPortal, and /devServer contain the source files for
the Grid Agent, Portal, and Server respectively and should be used for development
and testing purposes.

The /DISTRO directory contains a full Fura distribution ready to be installed in the
platform type in which you compile the source code.

NOTE: Scan the output for possible error messages. If there is any error you cannot
solve, do not hesitate to contact us or post it in our forum.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

HELP

If you need some help, please use this forum:

	http://www.gridsystems.com/forum/

or this mailing list:

	http://sourceforge.net/mail/?group_id=188380

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

LICENSE

Fura is distributed under the terms of the GPL 2.0. Please visit
http://www.gnu.org/licenses/gpl.txt to get a copy of the license. If you have special
licensing needs, contact GridSystems (see below). Unless otherwise specified, all
files should be considered to be covered by the GNU General Public License (GPL).

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

CONTACT

Grid Systems SA -- http://www.gridsystems.com