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=https://www.unidata.ucar.edu/repos/yum/el6-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-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 two 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
            
        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.