Build instructions for SDP Toolkit
2007/07/03
Liam.Gumley@ssec.wisc.edu

Test system: terra.ssec.wisc.edu (Dual Intel Xeon, 2GB RAM)
Install directory: /data1/gumley/MOD09
Shell: tcsh

LINUX VERSION
-------------

$ uname -a
Linux terra 2.6.9-42.0.2.ELsmp #1 SMP Thu Aug 17 18:00:32 EDT 2006 i686 i686 i386 GNU/Linux
$ more /etc/redhat-release 
Red Hat Enterprise Linux WS release 4 (Nahant Update 4)
$ echo $SHELL
/bin/tcsh

COMPILER VERSIONS
-----------------

$ gcc --version
gcc (GCC) 3.2.1
Copyright (C) 2002 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
$ which gcc
/usr/local/bin/gcc
$ pgf90 -V
pgf90 5.2-1
Copyright 1989-2000, The Portland Group, Inc.  All Rights Reserved.
Copyright 2000-2004, STMicroelectronics, Inc.  All Rights Reserved.
$ which pgf90
/usr/pgi/linux86/5.2/bin/pgf90

NOTE: We use pgf90 exclusively, not pgf77. We have not tested g77 or g95.

PACKING LIST
------------

$ ls -lRa
.:
total 427456
drwxr-xr-x  3 gumley users      4096 Jul  3 11:38 .
drwxr-xr-x  5 gumley wheel      4096 Jul  3 11:28 ..
-rw-r--r--  1 gumley users 437260219 Jul  2 15:52 mod09dbv1.0.tar.gz
-rw-r--r--  1 gumley users      1833 Jul  2 15:51 README.txt
drwxr-xr-x  2 gumley users      4096 Jul  2 15:55 toolkits

./toolkits:
total 46944
drwxr-xr-x  2 gumley users     4096 Jul  2 15:55 .
drwxr-xr-x  3 gumley users     4096 Jul  3 11:38 ..
-rw-r--r--  1 gumley users     6556 Feb  6  2006 00README.txt
-rw-r--r--  1 gumley users  6335367 Feb  6  2006 HDF4.2r0.tar.Z
-rw-r--r--  1 gumley users  6897593 Feb  6  2006 hdf5-1.6.2.tar.Z
-rw-r--r--  1 gumley users  6759017 Feb  6  2006 HDF-EOS2.12v1.00.tar.Z
-rw-r--r--  1 gumley users  6710197 Feb  6  2006 HDF-EOS5.1.8.tar.Z
-rw-r--r--  1 gumley users   951397 Feb  6  2006 jpegsrc.v6b.tar.Z
-rw-r--r--  1 gumley users  7998959 Feb  6  2006 mapi2.3.4.tar.Z
-rw-r--r--  1 gumley users     1464 Sep 13  2006 PGS_MODIS_39500.f
-rw-r--r--  1 gumley users     2278 Feb  6  2006 README.linux
-rw-r--r--  1 gumley users 11635968 Feb  6  2006 SDPTK5.2.12v1.00.tar.Z
-rw-r--r--  1 gumley users    98774 Feb  6  2006 szip1.1.tar.gz
-rw-r--r--  1 gumley users   550920 Feb  6  2006 zlib-1.2.1.tar.Z

HOW TO BUILD THE TOOLKITS
-------------------------

(1) The toolkit tarfiles were obtained as follows:

% ftp edhs1.gsfc.nasa.gov (anonymous, guest)
quote site group sdptk
quote site gpass ecs-tkit
cd sdptk

The following files were downloaded:
HDF4.2r0.tar.Z
hdf5-1.6.2.tar.Z
HDF-EOS2.12v1.00.tar.Z
HDF-EOS5.1.8.tar.Z
jpegsrc.v6b.tar.Z
SDPTK5.2.12v1.00.tar.Z
szip1.1.tar.gz
zlib-1.2.1.tar.Z

(2) The SDP toolkit was built as follows:

gzip -dc toolkits/SDPTK5.2.12v1.00.tar.Z | tar xvf -
cd TOOLKIT
bin/INSTALL -f90 -fc_path /usr/pgi/linux86/5.2/bin/pgf90

If get a message like this when it's done, then the build was successful.

SDP Toolkit installation completed at Tue Jul  3 12:11:16 CDT 2007

Notes:
- You should accept the defaults to install all the packages (e.g., HDF4) from source. The toolkit
  install script builds all the required packages in a consistent way. Don't build them in advance.
- Because pgf90 was used to build the toolkit, it *must* be used to build the science code as
  well (do *not* use pgf77 or g77).

(3) Now you should set the environment variables required for compiling code science code
    which call the SDPTK, e.g.,
    
% source /data1/gumley/MOD09/TOOLKIT/bin/linux/pgs-dev-env.csh

or

$ . /data1/gumley/MOD09/TOOLKIT/bin/linux/pgs-dev-env.ksh

(4) The MAPI toolkit was built in the TOOLKIT directory as follows:

gzip -dc ../toolkits/mapi2.3.4.tar.Z | tar xvf -
cd mapi2.3.4 
setenv APIHOME $PWD
setenv API_DIR $APIHOME
setenv API_INC $APIHOME/h
setenv API_LIB $APIHOME/lib
setenv API_SRC $APIHOME/srclib
make -f makemapi.linux.mk

You will see an error message like this at the end of the build:

/bin/sh: example1: command not found
make[1]: *** [run] Error 127
make[1]: Leaving directory `/data1/gumley/MOD09/TOOLKIT/mapi2.3.4/examples'
make: *** [test] Error 2

Don't worry about it, as long as the file lib/libmapi.a was created, everything will be fine.

(5) The leapsecond and utcpole files were updated in the TOOLKIT directory as follows:

./update_leapsec_utcpole.csh