Hyrax - OLFS Build Instructions - Revision history

Ndp: /* From Subversion */

2013-04-26T22:52:43Z

From Subversion

← Older revision		Revision as of 22:52, 26 April 2013
Line 62:		Line 62:

	===From Subversion===		===From Subversion===
	* Check out the software for the OLFS from our [http://subversion.tigris.org/ Subversion] repository located at ~~http~~://scm.opendap.org~~:8090~~/svn/trunk/olfs:		* Check out the software for the OLFS from our [http://subversion.tigris.org/ Subversion] repository located at https://scm.opendap.org/svn/trunk/olfs:
	svn co https://scm.opendap.org/svn/trunk/olfs		svn co https://scm.opendap.org/svn/trunk/olfs

Jimg: /* From Subversion */

2012-10-24T16:33:42Z

From Subversion

← Older revision		Revision as of 16:33, 24 October 2012
Line 63:		Line 63:
	===From Subversion===		===From Subversion===
	* Check out the software for the OLFS from our [http://subversion.tigris.org/ Subversion] repository located at http://scm.opendap.org:8090/svn/trunk/olfs:		* Check out the software for the OLFS from our [http://subversion.tigris.org/ Subversion] repository located at http://scm.opendap.org:8090/svn/trunk/olfs:
	svn co ~~http~~://scm.opendap.org~~:8090~~/svn/trunk/olfs		svn co https://scm.opendap.org/svn/trunk/olfs



	----		----

	=Building the code=		=Building the code=

Jimg: /* Additional Libraries */

2011-01-14T19:05:39Z

Additional Libraries

← Older revision		Revision as of 19:05, 14 January 2011
Line 36:		Line 36:

	* The [http://jakarta.apache.org/commons/cli/ Apache Commons Command Line Interface] package, version 1.0		* The [http://jakarta.apache.org/commons/cli/ Apache Commons Command Line Interface] package, version 1.0
	* The [http://www.jdom.org/ JDOM] package, version 1.0		* The [http://www.jdom.org/ JDOM] package, version 1.1.1
	* The [http://www.unidata.ucar.edu/software/netcdf-java/ Java NetCDF] package, version 2.2.18		<!-- * The [http://www.unidata.ucar.edu/software/netcdf-java/ Java NetCDF] package, version 2.2.18 -->
	* The [http://www.unidata.ucar.edu/projects/THREDDS/ THREDDS] package, version 3.14.00		<!-- * The [http://www.unidata.ucar.edu/projects/THREDDS/ THREDDS] package, version 3.14.00 -->
	* The [http://www.slf4j.org/nlog4j/ NLOG4J] package, version 1.2.21		* The [http://www.slf4j.org/nlog4j/ NLOG4J] package, version 1.5.8 and [http://logback.qos.ch/ logback], version 0.9.16
	* The [http://xerces.apache.org/xerces2-j/index.html Xerces XML Parser] package, version 2.8.1 (you will need both the '''''xercesimpl.jar''''' and the '''''xml-apis.jar''''')		* The [http://xerces.apache.org/xerces2-j/index.html Xerces XML Parser] package, version 2.8.1 (you will need both the '''''xercesimpl.jar''''' and the '''''xml-apis.jar''''')


	----		----

	=Getting The Source Code=		=Getting The Source Code=

Ndp: /* [http://tomcat.apache.org/index.html Apache Tomcat] */

2008-02-28T13:20:52Z

[http://tomcat.apache.org/index.html Apache Tomcat]

← Older revision		Revision as of 13:20, 28 February 2008
Line 17:		Line 17:
	'''''Minimum''''': 5.5		'''''Minimum''''': 5.5

	'''''Recommended''''': 5.5		'''''Recommended''''': 6.x

	The servlets were developed and tested using Jakarta/Tomcat 5.5.20. In particular, the code was linked against the servlet.jar bundled with this particular version of Tomcat.		The servlets were developed and tested using Jakarta/Tomcat 6.0.14. In particular, the code was linked against the servlet.jar bundled with this particular version of Tomcat.

	==[http://ant.apache.org/ ANT]==		==[http://ant.apache.org/ ANT]==

Ndp: Hyrax 1.2: OLFS Build Instructions moved to Hyrax - OLFS Build Instructions

2007-11-07T07:03:06Z

Hyrax 1.2: OLFS Build Instructions moved to Hyrax - OLFS Build Instructions

← Older revision	Revision as of 07:03, 7 November 2007
(No difference)

Ndp: New page: How to build the OLFS from either a source code distribution, or directly from our [http://subversion.tigris.org/ Subversion] repository. ----- =Dependencies= ==[http://java.sun.com/jav...

2007-03-22T00:27:38Z

New page: How to build the OLFS from either a source code distribution, or directly from our [http://subversion.tigris.org/ Subversion] repository. ----- =Dependencies= ==[http://java.sun.com/jav...

New page

How to build the OLFS from either a source code distribution, or directly from our [http://subversion.tigris.org/ Subversion] repository.

-----
=Dependencies=

==[http://java.sun.com/javaee/index.jsp Java 5 Enterprise Edition (J2EE)]==

'''''Minimum''''': Java 1.5

'''''Recommended''''': Java 1.5.0 or newer.

This software was developed and tested against the 1.5.0_06-112 JVM on OS-X.

==[http://tomcat.apache.org/index.html Apache Tomcat]==

'''''Minimum''''': 5.5

'''''Recommended''''': 5.5

The servlets were developed and tested using Jakarta/Tomcat 5.5.20. In particular, the code was linked against the servlet.jar bundled with this particular version of Tomcat.

==[http://ant.apache.org/ ANT]==

'''''Minimum''''': 1.6.5

'''''Recommended''''': 1.6 or higher

This software now builds entirely with ANT. If you haven't already got ANT, then go get it: You need it. There is a build file in the top level directory, ''olfs/build.xml'' which relies on a couple of build files located in the ''olfs/buildfiles'' directory. The serious developer will want to read and understand all of the build related files.

'''''Compiling the source''''': This should be straight forward. Just go to the top level directory and type "ant compile". For more detailed instructions you should read the master build file, ''olfs/build.xml''

==Additional Libraries==

The core software depends on several third part libraries. All of these are included with the distribution, and these (should) be the ones that the code was compiled against for development and testing purposes. It is possibly (in fact likely) that newer versions of these libraries are available from the various development teams that create these products. Replace them at your own risk.

* The [http://jakarta.apache.org/commons/cli/ Apache Commons Command Line Interface] package, version 1.0
* The [http://www.jdom.org/ JDOM] package, version 1.0
* The [http://www.unidata.ucar.edu/software/netcdf-java/ Java NetCDF] package, version 2.2.18
* The [http://www.unidata.ucar.edu/projects/THREDDS/ THREDDS] package, version 3.14.00
* The [http://www.slf4j.org/nlog4j/ NLOG4J] package, version 1.2.21
* The [http://xerces.apache.org/xerces2-j/index.html Xerces XML Parser] package, version 2.8.1 (you will need both the '''''xercesimpl.jar''''' and the '''''xml-apis.jar''''')

----
=Getting The Source Code=

===As A Source Code Distribution===

The most recent source code distribution will available at both the [http://opendap.org/download/hyrax.html Hyrax download page] and the [http://opendap.org/download/olfs.html OLFS download page]. If you are attempting to build the OLFS in conjunction with the BES - for example you are building Hyrax - then get both the source distributions from the same Hyrax release on the [http://opendap.org/download/hyrax.html Hyrax download page], other wise you may experience compatibility issues.

Got get the source code bundle. It will be a file named something like olfs-''x.x.x''-src.jar

Unpack the bundle using the command:

jar -xvf olfs.''x.x.x''-src.jar

This will unpack the source code distribution into a directory called ''olf.x.x.x-src''

===From Subversion===
* Check out the software for the OLFS from our [http://subversion.tigris.org/ Subversion] repository located at http://scm.opendap.org:8090/svn/trunk/olfs:
svn co http://scm.opendap.org:8090/svn/trunk/olfs

----
=Building the code=

Building the OLFS software should be very simple.

# Make sure you have installed the current J2EE and ANT (see above) 
# Enter the top level directory of the OLFS source code tree (''olfs'' if you got the source code from Subversion, ''olfs-.x.x.x-src'' if you got it from a distribution bundle.) 
# Run the command: <code>ant compile</code> This will compile all of the distributed software, but nothing more. For more detailed information you should read (and try to understand) the ANT build file, ''build.xml'' and the related files in the ''buildfiles'' directory. ''For those of you using an IDE you will have to follow your own "path" to get this going.'' 
# To perform an end to end compile that builds the webb application and bundles it in a ''.war'' file, run the command: <code>ant server</code> Find the file ''olfs/build/dist/opendap.war'', that's the thing you want!

----

=Installing the OLFS from a source code build=
# Copy the file ''olfs/build/dist/opendap.war'' tp ''$CATALINA_HOME/webapps''
# (Re)start Tomcat.
#Done!