Compiling OSSIM on a 64 bit machine

Date written 20 Jul 2008 Mark Lucas, with assistance from Garrett Potts, Scott Bortman, Patrick Depret, and Nikki Burns

Installing the Source Code:

Assuming a default installation from source in your home directory:

	cd
	mkdir Development
	cd Development
	mkdir ossimsource
	cd ossimsource

for a system install

	cd /usr/local
	su
	chgrp -R mlucas /usr/local
	mkdir ossim
	chown mlucas ossim   		(use your user name instead of mlucas)
	chgrp staff /usr/local/ossim   (or an appropriate group for access)
	chmod 775 ossim
	exit

This approach will allow you to install with out super user privs into /usr/local/ossim

To check out the entire source code tree from svn, you must be connected to the internet and type:

svn co http://svn.osgeo.org/ossim/trunk .      (note the trailing dot)

Alternatively, if you have a packaged source files:

Copy and unpack the files in the Development directory, for example:

• Locate the source files
• Copy to the source file location
• uncompress them
• set up the target directory for the ossim install (/usr/local/ossim shown above)
• ensure that all required compiler packages are available on your system
• Verify that all required complier components exist on the system. If the target OS is Redhat Enterprise 5, any missing packages can be obtained from the Install DVD #1 of 1 (for 64 bit AMD and Intel64). Note, some of the underscores may be dashes and vice versa.

The rpm installs were on a RHEL 5 server with no development libraries installed. If the packages are already on the machine, the following commands will simply report that it is already installed. No harm will come from running these items. If there is arequired package that is not available, the rpm program will report this as well. In that event, just find the required packages, install and add it to the list below:

	cd /media/RHEL_5x86_64DVD/Server

	rpm -i glibc-devel-2.4-12.x86-64.rpm
	rpm -i glibc-headers-2.4-12.x86_64.rpm
	rpm -i libgomp-4.1.1-53.e15.x86_64.rpm
	rpm -i gcc-4.1.1-52.e15.x86_64.rpm
	rpm -i libstdc++-devel-4.1.1-52.e15.x86_64.rpm
	rpm -i gcc-c++-4.1.1-52.e15.x86_64.rpm
	rpm -i libjpeg-devel-6b-37.x86_64.rpm
	rpm -i pcre-devel-6.6-2.el5_1.7.x86_64.rpm
	rpm -i ant - 1.6.5-2jpp.2.x86_64 (need later version 1.7)

ossimbashrc

Under the ossim_package_support directory is an ossimbashrc file. These build instruction assume the use of the ossimbashrc file. It includes a number of environmental variables and alias’s that are used in the build instructions. When you open a terminal to perform these instructions, be sure to source the file:

	source ossimbashrc

(alternatively you can add this line to your .bashrc file)

Instructions for building the OSSIM distribution on unix systems. This tutorial tracks an install of the OSSIM distribution from July 2008 on a freshly installed version of Red Hat Enterprise 5.0 x86-64. This tutorial assumes a build out of a home directory Development folder with default installation at /usr/local/ossim as defined by the INSTALL_HERE environmental variable.

The entire OSSIM distribution contains many source directories and dependencies. Proper set up of the environmental variables used during the build is key to a successful build from source code. Please source the ossimbashrc file.

	cd  
	mv .bashrc bashrc.old
	vi .bashrc
	cd /Users/Shared/Development/ossimsource
	svn update .
	cd ossim_package_support/
	cp ossimbashrc ~/
	cd

Now edit the ossimbashrc file to point to your Development directory. This is the directory where all of the source code exists. The default ossimbashrc defaults to Development in your home directory.

	vi .bashrc
	i
	source ossimbashrc
	<esc>
	:wq

	source .bashrc

Now we’ll check and use the ‘dev’ alias to change directories

	dev

The prompt should echo back Development Directory and list any files that are in that directory.

The following dependencies are need to build and can be downloaded into the source directory. URLs are provided

Look at ​http://ossim.telascience.org/ossimdata/sourcesnaps where these dependencies have been provided for your convenience.

expat                 http://sourceforge.net/projects/expat/
openmpi           http://www.open-mpi.org/software/ompi/v1.2/openmpi-1.2.6.tar.gz
gdal   		   http://trac.osgeo.org/gdal/wiki/DownloadSource
geotiff               ftp:://ftp.remotesensing.org/geotiff
libtiff                 (with bigtiff support)  http://ossim.telascience.org/ossimdata/sourcesnaps/libtiff-4.0.0.tgz
Qt4                    http://trolltech.com/downloads

OpenSceneGraph 2.6.1   http://www.openscenegraph.org/projects/osg/wiki/Downloads
	OpenThreads use the one from OpenSceneGraph
	collada for OpenSceneGraph colladadom_21.tgz in snapshots

ffmpeg             svn checkout svn://svn.mplayerhq.hu/ffmpeg/trunk ffmpeg

Make an ossim_dependencies directory

	dev
	cd ossimsource
	mkdir ossim_dependencies
	ozd             (should move you to ossim_dependencies directory)

move and uncompress all of the dependencies into this directory

	ozd
	tar xvf cmake-2.6.0.tar 
	tar xvfz colladadom_21.tgz 
	tar xvfz expat-2.0.1.tar.gz 
	unzip ffmpeg.zip 
	tar xvfz gdal-1.5.1.tar.gz 
	tar xvfz libgeotiff-1.2.3.tgz 
	tar xvfz libtiff-4.0.0.tgz 
	tar xvfz openmpi-1.2.6.tar.gz 
	unzip OpenSceneGraph-2.4.0.zip 
	tar xvf qt-x11-opensource-src-4.4.0.tar 
	unzip OpenSceneGraph-Data-2.4.0.zip 
	tar xvfz jpegsrc.v6b.tar.gz

libjpeg

to make sure we are picking up 64 bit version

ozd
cd jpeg-6b
which libtool
ln -s /usr/bin/libtool .
 ls
./configure --prefix=/usr/local --enable-static --enable-shared
make
make install

ffmpeg

	ozd
   	cd ffmpeg
   	./configure --prefix=${INSTALL_HERE} --disable-vhook --disable-mmx --enable-shared --disable-static
	make
	make install

The include files don’t line up with code, in the install location created ffmpeg dir and moved the libavs down into it.

	cd ${INSTALL_HERE}/include
	mkdir ffmpeg
	mv libav* ffmpeg
	cd ffmpeg
	cp libavcodec/* .
	cp libavdevice/* .
	cp libavformat/* .
	cp libavutil/* .

EXPAT

Downloaded from ​http://sourceforge.net/project/downloading.php?group_id=10127&use_mirror=internap&filename=expat-2.0.1.tar.gz&87780402

	ozd
	cd expat-2.0.1
	./configure --prefix=${INSTALL_HERE} 
	make
	make install

libtiff (bigtiff)

	ozd
	cd libtiff-4.0.0
	chmod +x configure
	./configure --prefix=${INSTALL_HERE} 
	make
	make install
	cd libtiff
	cp *.h /usr/local/include

Geotiff

	ozd
	cd libgeotiff-1.2.3
	./configure --prefix=${INSTALL_HERE} --with-libtiff=${INSTALL_HERE} 
	rm config.status
	./configure --prefix=${INSTALL_HERE} --with-libtiff=${INSTALL_HERE} 
	make clean
	make
	make install

	cd ${INSTALL_HERE}/lib
	ls  (should see the installed libtiff and libgeotiff libs)

GDAL

	ozd
	cd gdal-1.5.1
	./configure --prefix=${INSTALL_HERE} --with-libtiff=${INSTALL_HERE} --with-libgeotiff=${INSTALL_HERE} --with-expat-inc=${INSTALL_HERE}/include --with-expat-lib=${INSTALL_HERE}/lib  --with-expat=${INSTALL_HERE)
	make clean;
	make
	make install

OpenMPI

	ozd
	cd openmpi-1.2.6
	./configure                   (had to run this without args first)
	./configure --prefix=${INSTALL_HERE}
	make
	make install

CMake

Will need to make sure that cmake is on the system, if not download and install it

  	ozd
	cd cmake-2.6.0
	./bootstrap --prefix=${INSTALL_HERE}
	make
	make install

ColladaDOM 2.1

The Linux build needs libxml, PCRE, and boost filesytem development files installed on your machine to build the DOM.

pcre-devel-6.6-2.el5_1.7.x86_64.rpm     (install this through the package manager)
pcre-6.6-2.el5_1.7.x86_64.rpm

	ozd
	cd colladadom_21m

	cd dom
	make all
	ih
	cd include
	mkdir colladadom

ozd; cd colladadom/dom
edit the Makefile line 179 to read:
prefix :=/usr/local
	make install (gets the headers in place then fails)
	cd build
	cd linux-1.4/
	cp -r libcollada14dom* ${INSTALL_HERE}/lib/

OpenSceneGraph

Note: On the mac, just build OpenSceneGraph with the included xcode project.

Follow the default install instructions which install in /usr/local on unix:

	ozd
	cd OpenSceneGraph
	./configure  (first time error’d out )
	./configure
	make

Next steps require admin privileges

	make install
	exit
	ozd
	su
	cp -r OpenSceneGraph-Data /usr/local/share
	exit

To see if you have OpenSceneGraph installed and running:

	ozd
	cd OpenSceneGraph-Data
	osgviewer cow.osg
	press <esc> to quit

OSSIM

	oz
	./configure --prefix=${INSTALL_HERE} --with-libtiff=${INSTALL_HERE} --with-geotiff=${INSTALL_HERE} --with-freetype=/usr --with-mpi=${INSTALL_HERE} --with-openthreads=${INSTALL_HERE}
	make depends
	make 
	make install

libwms

need to manually copy lib/include to INSTALL_HERE

 	oz
	cd ../libwms
	make
	cd bin
	cd Linux64/
	cp * ${INSTALL_HERE}/bin/
	cd ${OSSIM_DEV_HOME}/libwms/src/Linux64.Opt   (build location for RH E)
	cp libwms.so ${INSTALL_HERE}/lib/
	cd ../../include/
	cp -r * ${INSTALL_HERE}/include/

ossim_plugins

	ozd
	cd ../ossim_plugins
	make all
	make install

typing

	cd ${INSTALL_HERE}/lib
	ls *_plugin.so

should return the installed, built plugins

libossimcontrib_plugin.so libossimgdal_plugin.so libossimpng_plugin.so

move them into an ossim_plugins directory

	mkdir ossim_plugins (if necessary)opt
	mv -r *_plugins.so ossim_plugins

ossimPredator

	oz
	cd ../ossimPredator
	mkdir lib
	cd src
	make
	cd ../lib
	cp libossimPredator.so ${INSTALL_HERE}/lib

ossimPlanet

	opt
	cd Make

edit the makedefs file and uncomment the DEV += -DOSSIMPLANET_ENABLE_PREDATOR line.

	opt
	make
	cd src/ossimPlanet/Linux64.Opt    (for RH E 5.0)
	cp libossimPlanet.so ${INSTALL_HERE}/lib

	opt
	cd examples/ossimplanetviewer/Linux64.Opt
	cp ossimplanetviewer ${INSTALL_HERE}/bin
	
	opt
	cd include
	cp -r ossimPlanet ${INSTALL_HERE}/include

Copy the reference data in place

from the ossim_package_support directory, do a recursive copy of the images directory to the install location for future retrival,

	cd
	mkdir .ossim
	opt
	cd ../ossim_package_support
	cp -r fonts icons geoids images ${INSTALL_HERE}/dotossim

make a copy in the install location so other users can copy it

	cp -r ${INSTALL_HERE}/dotossim ~/.ossim 

Trolltech QT 4

This is a fairly lengthy install, so we use the --fast switch to install the minimum. QT is the cross platform GUI system used by imagelinker, iview and ossimplanet.

Be sure to configure with the complete path /usr/local/ossim/Trolltech/Qt-4.4.0.

	ozd
	cd qt-x11-opensource-src-4.4.0
	./configure --prefix=${INSTALL_HERE}/Trolltech/Qt-4.4.0 --fast
	make
	make install

Verification:

	which qmake

should return:

/usr/local//Trolltech/Qt-4.4.0/bin/qmake

OSSIM_QT4

	oqt
	qmake
	make
	cd bin
	mv * ${INSTALL_HERE}/bin/
	cd ../include/
	mv * ${INSTALL_HERE}/include/
	cd ../lib
	mv * ${INSTALL_HERE}/lib/
	cd 
	which imagelinker
	imagelinker

ossimPlanetQt

	oz
	cd ../ossimPlanetQt		
	cd src
	vi src.pro
	/INSTALL_PREFIX
	:177

uncomment the lines 162, 179 to define INSTALL_PREFIX and LOCAL_ROOT to $INSTALL_HERE

At this approximate location you can uncomment the INSTALL_PREFIX assignment to install at your variable location

e.g. INSTALL_PREFIX=/usr/local/lib uncomment the INSTALL_PREFIX=$$

also change the LOCAL_ROOT by uncommenting the one with INSTALL_PREFIX :159 LOCAL_ROOT=/usr/local/

	cd ..
	make clean
	qmake
	make
	make install

Changing the src.pro install doesn’t get the application, copy manually

	cp ossimplanet ${INSTALL_HERE}/bin

Line 184 the -L for LOCAL_ROOT was not in parenthesis and not being picked up. Same with the include line

added -L$$(INSTALL_PREFIX)/lib in LIBS += lines

to use the ossim commands, the startup environment will need to be modified for any user that wants to use them.  Need to have LD_LIBRARY_PATH variable set in the appropriate shell file (.cshrc or .bashrc).  Any custom ossim_preferences should be in a local version of the ossim_preferences in a users home directory.  Otherwise, all preferences will come from the system level file.

OMS - OSSIM Mapping Services

oz
cd ../oms/com
make
make install  (might put it in /usr/local/ossim move includes and libs to /usr/local)
cd ../joms
ant dist

needed to update ant to 1.7

ossim preferences file setup

There is a template under ossim/etc/templates need to fill this out, save (~/ossim_preferences) and

make sure that

export OSSIM_PREFS_FILE=~/ossim_preferences

is set in your bashrc or ossimbashrc file.

Note, the ~.ossim subdirectory (dotossim) will be picked up by default in the home directory

~/.ossim