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.

Gathering the Dependency Source Code

dev mkdir ossim_dependencies_source ods cd ossim_dependencies_source

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.4 ​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} --enable-shared --disable-static

Note, for mac osx you need to configure ./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

OpenSceneGraph 2.4

CMake Will need to make sure that cmake is on the system, if not download and install it ./bootstrap --prefix=${INSTALL_HERE}; make ; make install

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}g/Trolltech/Qt-4.4.0 --fast make make install

Verification:

which qmake

should return: /usr/localTrolltech/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

These are some notes that I had on building the NTM plugin 

Compile and install the classified plugin (unix instructions)

You will find the source for the classified plugin in both the talmage and mlucas accounts.  Basically, set the environmental variables, copy it into the ossim_plugins source directory.

As a user (ex: mlucas), not root

DEV_HOME=<your source tree>

cd $(DEV_HOME)/ossim/ossim_ntm_plugin vi make.opt   to modify the following values

DEV_HOME=<your source tree> OSSIM_HOME=$(DEV_HOME)/ossim/build/ossim OP_DIRECTORY=$(DEV_HOME)/ossim/ossim_ntm_plugin LD_LIBRARYPATH=${INSTALL_HERE}/lib

Note:  Make sure that these directories jive with the actual locations in the workspace.  you will receive errors from the make command if they are incorrect.

make

make install

Set up ossim_preferences and local variables, copy the plugin to the ossim plugins directory to have it automatically picked up

Verification, you can run imagelinker and verify that the plugin is loaded.   also, 

Added with the 1.7.10 release there is an ossim_plugins command utility that will list the loaded plugins

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