Changes between Initial Version and Version 1 of unixinstallnotes

Timestamp:

Nov 25, 2008, 7:13:05 PM (15 years ago)

Author:

mlucas

Comment:

--

unixinstallnotes

@@ +1 @@
+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/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
+
+
+
+
+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
+
+
+
+