awips2/docs/dev/awips-development-environment.md

Quick instructions on how to deploy CAVE from Eclipse.

1. Change /etc/yum.repos.d/awips2.repo to

    [awips2repo]
    name=AWIPS II Repository
    baseurl=http://www.unidata.ucar.edu/repos/yum/awips2-dev/
    enabled=1
    protect=0
    gpgcheck=0
    proxy=_none_
   

2. yum clean all && yum groupinstall awips2-ade

   This will install Eclipse (4.5), Java (1.8), Ant, Maven, Python 2.7 and its modules (Numpy, Matplotlib, Shapely, others).

3. git clone https://github.com/Unidata/awips2.git

   The full list of repositories required as of release 17.1.1:

    git clone https://github.com/Unidata/awips2.git
    git clone https://github.com/Unidata/awips2-core.git
    git clone https://github.com/Unidata/awips2-core-foss.git
    git clone https://github.com/Unidata/awips2-foss.git
    git clone https://github.com/Unidata/awips2-ncep.git
    git clone https://github.com/Unidata/awips2-goesr.git
    git clone https://github.com/Unidata/awips2-nws.git
    git clone https://github.com/Unidata/awips2-gsd.git
    git clone https://github.com/Unidata/awips2-drawing.git
    git clone https://github.com/Unidata/awips2-cimss.git
   

4. Run /awips2/eclipse/eclipse.sh

   • Preferences > Java

     Set to /awips2/java

   • Preferences > PyDev > Python Interpreter

     Set to /awips2/python/bin/python (should be resolved by Auto-Config)

   • File > Import > General > Existing Projects Into Workspace

     Import all of the git cloned project folders EXCEPT for the main (first) github.com/Unidata/awips2.git directory (which should be ~/awips2).

     You'll want to import ~/awips2 in three parts to ensure a clean and error-free Eclipse build:

     1. Import awips2/cave > Select All Projects > Finish
     2. Import awips2/edexOsgi > Select All Projects > Finish
     3. Import awips2/Radar > Select All Projects > Finish

        The Radar folder contains the EDEX Radar Server plugins. Though the Unidata release does not build or use the radar server, the common libraries are required for other AWIPS radar processing and visualization plugins.

     Now import all other repositories fully:

     Select awips2-core, awips2-core-foss, awips2-foss, awips2-ncep, etc. > Select All Projects > Finish

   • Project > Clean

     Run a clean build and ensure no errors are reported.

5. Run com.raytheon.viz.product.awips/developer.product

   Double-click the developer.product file to open the Product View in Eclipse. Select Overview > Synchronize and then right-click the file in the left-side package explorer:

   Select Run As > Eclipse Application to launch CAVE in the development environment.

   Select Debug > Eclipse Application to launch CAVE in in debug mode.