Getting Source, Build, and Run ToolsUI

In preperation for some hands on IOServiceProvider work, we need a few things setup and ready to go. First, we'll look at how to get the netCDF-Java/CDM code. Second, we'll build it with Ant. And, Finally, we'll run the ToolsUI application.

Getting Source

Distribution

The current stable release code distribution can be found on

• The netCDF-Java home page: http://www.unidata.ucar.edu/software/netcdf-java/
• The netCDF-Java FTP site: ftp://ftp.unidata.ucar.edu/pub/netcdf-java/v2.2.22/

Source for Workshop

The required source is available from a tar file at /data/nj/nj22WkshpCode.tar.gz. Unpack this in your home directory:

1. Make a directory to unpack into
   
• cd ~/ncj
• mkdir nj-2.2.22
• cd nj-2.2.22
2. Unpack the code
• tar xvzf /data/nj/nj22WkshpCode.tar.gz
  

Build from Source

To build the netCDF-Java library (CDM) and ToolsUI application:

1. Move into the cdm directory, the location of the Ant script
• cd cdm
2. Clean your working directory
• ant clean
3. Build CDM and the ToolsUI
• ant compileUI

• compile - compiles the netCDF-Java/CDM code
  
• makeJar - builds the minimal netCDF library, ncCore-*.jar, which reads netCDF-3 files; and the full netCDF library, netcdf-*.jar, which implements the full CDM.
• compileUI - compiles the netCDF-Java/CDM and ToolsUI code
• makeJarUI - builds the netCDF ToolsUI library, netcdfUI-*.jar, which includes the netCDF library plus the user interface classes for the netCDF ToolsUI application.

Now let's run the netCDF ToolsUI application:

1. Run script at target/runToolsUI
• chmod +x target/runToolsUI
• target/runToolsUI
  

This script runs the following command (with the classpath expanded):

• java -Xmx512m -classpath <classpath> ucar.nc2.ui.ToolsUI

Excercise: Unpack Source, Build, and Run ToolsUI

We'll take the next 15 minutes so you can get this setup on your machines.

1. Unpack the source
2. Build using Ant
3. Run ToolsUI

Build Using IntelliJ IDEA

Most of our netCDF-Java and THREDDS team uses IntelliJ IDEA. So, we have IntelliJ project files available. If you know IntelliJ (or just want to try it), we have the latest distribution available at /data/ncj/idea-6.0.5.tar.gz. It's easy and no license is required for a 30 day trail.

1. Install IntelliJ IDEA in your home directory
• cd ~/nj
• tar xvzf /data/nj/idea-6.0.5.tar.gz
2. Set JDK_HOME environment variable
• vi ~/.bashrc
3. Change memory settings for IDEA
• cd idea-6180/bin
• vi idea.vmoptions
• Set -Xms option to -Xms256m
• Set -Xmx option to -Xmx512m
4. Run IDEA
   
• ./idea.sh &
5. Open Project: intelliJ/thredds.ipr
6. Open project window
7. Set default VCS to subversion
   
8. Set up JDK (/usr/java/jdk1.5.0_12)
9. Build project
   
10. Setup to run ToolsUI
1. Select menu item: "Run" - "Edit Configurations"
2. Add new configuration by selecting the "+" icon and "Application"
3. Set name to "ToolsUI"
4. Set main class to "ucar.nc2.ui.ToolsUI"
5. Set VM parameters to "-Xmx256 -ea"
6. Set working directory to the "ui" rather than "intelliJ" directory
7. Click on the OK button
   
11. Run ToolsUI
    

Build Using Eclipse

Sorry, you are on your own with Eclipse. Not many Eclipse users at Unidata.

Build Using NetBeans

Sorry, once again you are on your own if you want to use NetBeans.