Previous:  Development Environment Next: IDV Source Tree Table of contents Index Glossary Images Frames U09-NRM-127: The role of Distributed Data Access Technologies in NRM - for ITC-IDV version 2.7 > Java Developer Topics > Development Environment

6.0.0 Building the IDV from Source
Developers can download the source files for the IDV and build it from scratch.

Before building the IDV you need to first install Java and Java 3D on your system. You need to use the Java SDK, because the Java RunTime Environment (JRE) does not contain the Java compiler (javac). You need to use a version of Java 1.5 (preferably the latest version). You can use either the Java 3D SDK or JRE, version 1.3.x.

You will also need to install Ant (http://ant.apache.org/) on your machine. Ant is similar to make - instead of a Makefile, Ant uses a build.xml file. Be sure to follow the instructions for installing Ant, especially those for setting up environment variables.

Download the IDV source files from the Unidata Web Site (under Downloads->IDV->Source):

  1. Open the IDV Downloads page in a new window by clicking here.
  2. To download the IDV source, you must be registered as a Unidata user. If you have already registered, log in using your user name and password. If you have not registered or you have forgotten your password, follow the instructions on the login sidebar.
  3. Under "IDV 2.7 Documentation and Source Code", click on the IDV 2.7 Source Code link to start the download. You will be prompted for a location to save the file to. Save it your home directory.
  4. You will also need the set of ancillary libraries (VisAD, netCDF, etc) that the IDV uses contained in the zip file: IDV 2.7 Jar Files. Save this to your home directory.
  5. After the download is complete, close the extra browser window.

You are now ready to install the IDV source.

  1. Open a terminal window.
  2. Change to your home directory or the directory to which you downloaded the source and binary files (if you are not already there).
  3. unJAR the source file.
    jar  xvf  idv_src_2.7.jar
    This will create a "idv" directory underneath the install directory (where you unJAR'ed the file).

  4. Next, you need to create a lib directory as a peer of the ucar directory under idv that holds the ancillary JAR files from the IDV Binary distribution that are needed to build the classes. The structure will look like this:
    idv
       |
       +----ucar
       |
       +----lib (holds the ancillary jar files).
    
  5. Change to the lib (if you are not already there).
    cd  /home/idv/idv/lib
  6. Unzip the file you downloaded into this directory.
    unzip  ../../idv_jars_2.7.zip
Now you should be able to build the IDV from scratch.
  1. Change to the ucar directory.
    cd  /home/idv/idv/ucar
  2. Execute the ant command to build idv.jar.
    ant  clean idv
    This removes all Java class files (there will be none the first time), re-builds them and creates the idv.jar file, copying it to the lib directory.

  3. To run the IDV using your build:

 


Previous:  Development Environment Next: IDV Source Tree Table of contents Index Glossary Images Frames Français Español Portugese Italian Japanese Korean Russian Chinese-simp Chinese-trad Dutch German Greek Français Español Portugese Italian Japanese Korean Russian Chinese-simp Chinese-trad Dutch German Greek

U09-NRM-127: The role of Distributed Data Access Technologies in NRM - for ITC-IDV version 2.7 > Java Developer Topics > Development Environment