I
		S
		D
		A
		T

• Isdat home
• Tour
  • Server
  • Client
  • Screenshots
• Using
  • Getting started
  • Running dbh
  • Howtos
• About
  • Installing
  • Features
  • License
  • News
• Status
  • Release notes
• Download
• Wec cal. files
• Dataset modules
• Clients
• Reference manuals
• Developer
  • Introduction
  • Discussion
• History
  • Development

Page maintained by
Reine Gill

Isdat build howto

This document explains how to build/install the ISDAT software and tells you howto solve known problems. If you find a solution to a problem not in this list. Please send me an email (reine.gill@irfu.se) so I can add it to the list.
This howto is divided into four sections as described below.

• Requirements
• Build/compile Instructions
• Post build installation
• Problems and solutions

• Some special problems

To build the basic ISDAT system with libraries and Igr you will need

1. ANSI c compiler
   • such as gcc or cc.
2. Unix parse generator tools
   • yacc/flex, or the gnu equivalent bison/flex
3. Perl with the standard module Cwd.
4. Motif (A window widget library)
   • A good free version is Lesstif which you can find at http://www.lesstif.org/

Some of the server modules require extra tools/libraries.

1. The Ephemeris module can be built to use the maglib written in Fortran. This gives you enhanced functionality and is recommended.
   • In this case you need a Fortran 77 compiler, any one of g77 or f77 works fine.
2. To build the Csds server module you will also need the cdf library. Isdat is built to use cdf version 2.6 (although it seems to work with later versions as well).
   • Download cdf from http://nssdc.gsfc.nasa.gov/cdf/cdf_home.html

Given that the requirements are fulfilled ISDAT is known to compile on the following platforms:

• Linux Intel, Suse 7.0, RedHat >6.0 and probably other distributions as well.
• Solaris SPARC, Intel 2.8, 2.7, 2.6
• Free BSD Intel 3.5
• openVMS VAX
• HP/UX 10.20, 11.0

ISDAT uses the imake system (not required since it comes with isdat) to create the platform dependent makefiles, which is needed on the very first build.

1. Unpack the distribution media
   • Unzip, untar, etc. the files in the directory you wish to have the ISDAT system. If you have cvs access read the Isdat cvs howto
   • Set up the environment. Go to the script directory in the Isdat source distribution. Edit my_isdat_profile so that the variable ISDAT_HOME points to your Isdat source distribution (my_isdat_profile.csh for csh users). Source the appropriate file.
   • Configure the first build. Copy the file
     $ISDAT_ROOT/config/cf/site.def_DEFAULT to
     $ISDAT_ROOT/config/cf/site.def
     Edit this file to suit you needs. You may wish to add some build options, such as compiling the IDL or Matlab APIs, use of CDF etc. If you want some of this functionality set is corresponding variable to YES and make shure all paths are correct.

     NOTE:

     • You do not have to uncomment HasGcc2 for Linux, it will use gcc any way.
     • IF YOU DO NOT HAVE CDF please remove the $ISDAT_HOME/server/Csds directory or rename $ISDAT_HOME/server/Csds/Init.c to something else.
     • If you build on sun and enables any special resource use the rows that are comment away (uses sun specific flags) instead of the existing ones.
   • Starting the first build Change directories so to $ISDAT_HOME. Start the first build by typing:
     make isdat
     This will generate a lot of messages. After some time you should end up with a message saying "Full Build of ISDAT of completed"

The ISDAT distribution does not have an install stage as many other systems have. All the binaries after the build will be linked from $ISDAT_HOME/bin into their source code directory where they reside. After a Isdat build it is allays a good idea to have a look in this directory. If the link to a special binary exist it has been successfully build. Otherwise have a look at the last section Problems and solutions

After a successful build you need to set a few things in order to run the ISDAT system.

1. Setting environment variables.
   You need the set a few environment variables. Look at the file $ISDAT_HOME/scripts/my_isdat_profile which contains these variables along with comments. Specially make shure ISDAT_DATABASE is set to whatever Isdat server you intend to use.
   You can conveniently copy this file into your HOME directory and rename it as you wish (or include it into you usually profile file).
2. Setting paths to the data files.
   For the ISDAT server to find data files, calibration files, etc. you must edit the $ISDAT_HOME/configure/isdat.server file. If you plan on running your own Isdat dbh have a look at:
   http://www.space.irfu.se/isdat/using/dbh.html and
   http://www.space.irfu.se/isdat/using/HOWTO/accessControl.html