UNIX Installation Guide
=======================

Introduction
^^^^^^^^^^^^

Pre-Requisites
^^^^^^^^^^^^^^
GeoMOOSE requires a pretty full feature MapServer build.  The following options are used by the development team on UN*X based systems to build MapServer::

	--with-php=[path to php includes] 
	--with-agg=[path to agg libs]
	--with-gd=[path to gd libs]
	--with-wfs 
	--with-wmsclient 
	--with-wfsclient 
	--with-postgis 
	--with-proj=[path to proj]
	--with-geos=[path to geos-config]/geos-config
	--with-freetype=[path to freetype]
	--with-gdal=[path to gdal-config]/gdal-config
	--with-ogr
 
MapServer's PHP/Mapscript must also be installed.  Please see the MapServer website for additional details on how to install and compile MapServer.  You will also find information about the MapServer mailing lists which are very helpful for trouble shooting and additional instructions.

Current development efforts are against MapServer versions 5.2 and 5.4.

**VERY IMPORTANT NOTE**: Some Linux distributions come pre-packaged with a version of MapServer.  This version of MapServer can be extremely out-dated and can be missing critical functionality (AGG rendering for example).

Installation
^^^^^^^^^^^^
If the Pre-req's have been met then the hard part is actually over. Extract the GeoMOOSE .tar.gz file to a conveinent directory::

	tar -xzvf geomoose-[version].tar.gz

Enter the directory and run configure::

	cd geomoose-[version]
	./configure

There are a few important configuration options to keep in mind before moving on::

	--prefix=DIR	Installation directory (defaults to /opt/geomoose2)
	--with-temp-directory=DIR	Temporary directory for script output (/tmp/www)
	--with-url-path=DIR	URL Path, the root web directory for the application (/geomoose2/)
	--with-projection=SRS	SRS string defining the map's projection (default EPSG:26915)
	--with-mapfile-root=PATH	Path to the mapfiles root (default PREFIX/maps)
	--with-mapserver-url=URL	URL to mapserver (default /cgi-bin/mapserv)
	--with-server-name=SERVERNAME	Self referential name of the server (defaults to localhost)

The most important of these is --prefix, --with-temp-directory, and --with-url-path as they define where GeoMOOSE will be installed, GeoMOOSE's critical temporary directory, and the URL from which GeoMOOSE will be served.  The defaults have been tested to work but they are not appropriate for all installations.

Next we need to actually install the files::

	make install

This will move all of the files to the appropriate directory and write an apache configuration file that matches your parameters above.  The final step of the installation is to reference that apache file in your apache configuration.  There are two ways of doing this:
	1. Add an "Include" directive to httpd.conf::
		Include "/opt/geomoose2/geomoose2_httpd.conf"
	2. Add a symbolic link into a http.d directory.   This varies greatly by system, this is just an example.::
		ln -s /opt/geomoose2/geomoose2_httpd.conf /etc/apache/http.d/other/geomoose2_httpd.conf