TO8 ADE Installation and Build Instructions

Install ADE:

Installation of the ADE (AWIPS Development Environment) includes the source code.

1. Start by bringing up the ADE-CAVE Outbriefing and reading the installation instructions starting on page 380.
2. Decide on an installation directory. Mine is /scratch/malcolm/edwards/TO8/ade on malcolm. It's best to let the install wizard create the basename directory (ade in my case) but you must make sure the parent directory exists.
3. Run the wizard:

     cd /misc/linux/awips2
     ./setup_ade.sh

Specify "ade" in your install directory path when prompted by the install wizard. It will create the "ade" directory for you. Step through the wizard and complete the install. Quit the wizard when the install is done. It will create the following directories under the install directory:

• eclipse
• projects
• Uninstaller

The source code is under the "projects" directory. For example, source code for the radar decoder is in /scratch/malcolm/edwards/TO8/ade/projects/AWIPSEdex/extensions/plugin-radar/src/com/raytheon/edex/plugin/radar.

Uninstall the ADE:

To uninstall, go to <installDir>/ade directory and remove the files, or go to the <installDir>/ade/Uninstaller directory and run java -jar uninstaller.jar. If you want to uninstall the install directory, select it when the pup-up box appears. I usually don't select it, but I go in and delete the install directory because the uninstall leaves files around.  Then select Uninstall.  When the uninstall is done, select Quit.

Install EDEX:

If you want to run your workstation as a standalone, you will need to install EDEX as follows:

1. Go to /misc/linux/awips2 and run the install wizard setup_edex.sh.
2. Follow the install instructions starting on page 282 of the ADE-CAVE Outbriefing.
3. When you get to the installation path page, enter your install path. I entered /scratch/malcolm/edwards/TO8/run-time. DO NOT put "edex" on the end of your path.  The wizard does that for you, and generates the edex directory.
4. The next page enables you to select the packages you want to install. Do not select "Server Installation". If you do, you will need to install as root, which we're trying to avoid.
5. On the hdf5 page, since you'll be running EDEX on your system and not using gwar's server, set your local hdf5 path. Mine is set to /scratch/malcolm/edwards/TO8/run-time/edex/opt/data/hdf5.  The hdf5 directory will be created when you run PostGres. 
   
6. Everything else should be left as is.
   
7. When the install is complete press Done.

1. Before building EDEX, try running the servers.
   
• Download edex.tar into a directory. I placed mine in /scratch/malcolm/edwards/TO8/bin.
  
• Untar the file. This file contains four edex_ scripts and copyEdexFiles.sh.
  
• Modify the prefix target in each of the edex_ files to your runtime directory. Mine is set to /scratch/malcolm/edwards/TO8/run-time.
  
• Start up the edex daemons by running the edex_ scripts in the following specified order:
  
• ./edex_postgres start
• ./edex_activemq start
• ./edex_mule start
• ./edex_tomcat start
2. Now, you are ready to build. Kill the daemons by running the same edex_* scripts followed by stop. I follow the reverse order when stopping, but I don't know if it matters.

1. Set JAVA_HOME and ANT_HOME, if you haven't already done so from Jim Fluke's CAVE instructions.  I do that in my .cshrc file:

• setenv JAVA_HOME <runtimeDir>/jdk1.6.0_01. My runtime directory is /scratch/malcolm/edwards/TO8/run-time. jdk1.6.0_01 gets installed with EDEX.
  
• setenv ANT_HOME /misc/linux/awips2/apache-ant-1.7.0 (I have my own version of ant and I set up a symbolic link to my apache-ant-1.7.0 directory.)

2. Add JAVA_HOME and ANT_HOME to your path. I modified my .cshrc file as follows:

• set path=($JAVA_HOME/bin $path)
• set path=($ANT_HOME/bin $path)
  

3. Source your .cshrc file.
4. Start up Eclipse on your workstation.
   
5. Select you workspace, which is your .../ade/projects directory.
6. The Java-Eclipse workbench will open and Eclipse will start compiling. You will see all of the Eclipse projects on the left side under the Packages tab. You can find the EDEX source code if you expand AWIPSEdex project by clicking on the arrow on the left. There's lots to see.

1. If you haven't already done so, set your JAVA_HOME and ANT_HOME as described above.
   

2. Go to the directory where you untar'd the edex.tar file and modify copyEdexFiles.sh. Change the <ADEinstallDir> path in the "cd" command to point to yours. Don't change "projects/AWIPSEdex".
   

3. Run copyEdexFiles.sh. It cd's to <ADEinstallDir>/projects/AWIPSEdex and copies files to <ADEinstallDir>/projects/AWIPSEdex/build/lib/compile.

4. Go to your ade <installDir>/projects/AWIPSEdex/build directory and modify build.xml as follows:

in build.xml, change the 'else' and 'property name' statements
<!-- Properties to set the installation directory and the javadoc
directory -->
    <condition property="install.dir"
               value="${installto}"
               else="/awips">
        <isset property="installto"/>
    </condition>        
<property name="install.dir" value="/awips" />

to something like:
<!-- Properties to set the installation directory and the javadoc
directory -->
    <condition property="install.dir"
               value="${installto}"
               else="/scratch/malcolm/edwards/TO8/run-time/edex">
        <isset property="installto"/>
    </condition>
<property name="install.dir" value="/scratch/malcolm/edwards/TO8/run-time/edex" />

5. Now compile and deploy. Make sure you're pointing to the correct version of ant. If not, you will get a "filelist..." error when you try to deploy.

 ant clean
 ant build
 ant jibx
 ant client  (really only needed by cave builds)
 ant deploy  (assuming you wish to deploy edex into
              a runtime location)

6. You are now ready to re-rerun your EDEX daemons. Run your edex_* scripts as described in section "Run EDEX Daemons".