Changes to the development webpage:
-modified the markdown.yml file since there is only one webpage under "Development" no need to have a subdirectory -added title header -updated repo code line to point to el7 instead of 6 -converted steps from an ordered list into proper sections with subheadings -added an initial section about removing existing AWIPS instances -added some steps for setting up eclipse to convert some errors to warnings and to turn off auto building when importing the repos and turn it back on afterwards -added a section for troubleshooting with a note taken from Jason Burks' tutorials -added note in the intro section specifying this is a dev only Environment -bolded the repo in Step 2 -removed Maven from the mentioned installed packages in Step 3 (it's now packaged with eclipse)
This commit is contained in:
Shay Carter
parent
f4257da6ec
commit
8800d97d2f
2 changed files with 117 additions and 57 deletions
|
|
@ -1,67 +1,128 @@
|
||||||
Quick instructions on how to deploy CAVE from Eclipse.
|
# AWIPS Development Environment (ADE)
|
||||||
|
|
||||||
|
Quick instructions on how to download the latest source code and run CAVE from Eclipse.
|
||||||
|
|
||||||
1. Change `/etc/yum.repos.d/awips2.repo` to
|
> **Note**: It is important to keep in mind these instructions are intended for a system that is specifically used for developing AWIPS. It should not be used in conjunction with installed production versions of AWIPS.
|
||||||
|
|
||||||
[awips2repo]
|
## 1. Remove AWIPS Instances
|
||||||
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.6.1), Java (1.8), Ant (1.9.6), Maven, Python 2.7 and its modules (Numpy, Matplotlib, Shapely, others).
|
First, make sure to remove any instances of AWIPS that are already installed, this can potentially cause problems when setting up the development environment. Below is an example that had CAVE installed.
|
||||||
|
|
||||||
|
Uninstall with yum:
|
||||||
|
|
||||||
3. `git clone https://github.com/Unidata/awips2.git`
|
yum clean all
|
||||||
|
yum groupremove awips2-cave
|
||||||
The full list of repositories required:
|
|
||||||
|
Check to make sure all rpms have been removed:
|
||||||
git clone https://github.com/Unidata/awips2.git
|
|
||||||
git clone https://github.com/Unidata/awips2-core.git
|
rpm -qa | grep awips2
|
||||||
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:
|
Remove the awips2 directory:
|
||||||
|
|
||||||
|
rm -rf /awips2
|
||||||
|
|
||||||
Select **awips2-core**, **awips2-core-foss**, **awips2-foss**, **awips2-ncep**, etc. > Select All Projects > Finish
|
---
|
||||||
|
|
||||||
* Project > Clean
|
## 2. Set Up AWIPS Repo
|
||||||
|
|
||||||
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:
|
Create a repo file named `/etc/yum.repos.d/awips2.repo`, and set the contents to the following:
|
||||||
|
<pre>
|
||||||
|
[awips2repo]
|
||||||
|
name=AWIPS II Repository
|
||||||
|
baseurl=https://www.unidata.ucar.edu/repos/yum/<b>el7-dev</b>/
|
||||||
|
enabled=1
|
||||||
|
protect=0
|
||||||
|
gpgcheck=0
|
||||||
|
proxy=_none_
|
||||||
|
</pre>
|
||||||
|
>**Note**: This file may already exist if AWIPS had been previously installed on the machine, so make sure to edit the baseurl.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Install the ADE
|
||||||
|
|
||||||
|
Install the AWIPS Development Environment (ADE) using yum. This will install Eclipse (4.6.1), Java (1.8), Ant (1.9.6), Python 2.7 and its modules (Numpy, Matplotlib, Shapely, Jep, and others).
|
||||||
|
|
||||||
|
yum clean all
|
||||||
|
yum groupinstall awips2-ade
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Download the Source Code
|
||||||
|
|
||||||
|
If it's not already installed, install git:
|
||||||
|
|
||||||
Select **Run As** > **Eclipse Application** to launch CAVE in the development environment.
|
yum install git
|
||||||
|
|
||||||
Select **Debug** > **Eclipse Application** to launch CAVE in in debug mode.
|
Next clone all of the required repositories for AWIPS:
|
||||||
|
|
||||||
|
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
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Set Up Eclipse
|
||||||
|
|
||||||
|
Open eclipse by running: `/awips2/eclipse/eclipse.sh`
|
||||||
|
|
||||||
|
Verify or make the following changes to set up eclipse for AWIPS development:
|
||||||
|
|
||||||
|
* Preferences > Java
|
||||||
|
|
||||||
|
Set to **/awips2/java**
|
||||||
|
|
||||||
|
* Preferences > PyDev > Python Interpreter
|
||||||
|
|
||||||
|
Set to **/awips2/python/bin/python**
|
||||||
|
|
||||||
|
* There might be some unresolved errors. These should be made to warnings instead.
|
||||||
|
|
||||||
|
Preferences > Java > Compiler > Building > **Circular Dependencies** > Change to Warning
|
||||||
|
Preferences > Plug-in Development > API Baselines > **Missing API Baseline** > Change to Warning
|
||||||
|
|
||||||
|
* **Turn off automatic building** (you will turn this back on after importing the repos)
|
||||||
|
|
||||||
|
Project > Uncheck "Build Automatically"
|
||||||
|
|
||||||
|
* 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**).
|
||||||
|
Select **awips2-core**, **awips2-core-foss**, **awips2-foss**, **awips2-ncep**, etc. > Select All Projects > Finish
|
||||||
|
|
||||||
|
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
|
||||||
|
|
||||||
|
* Project > Clean
|
||||||
|
|
||||||
|
Clean the build and ensure no errors are reported.
|
||||||
|
|
||||||
|
* Turn automatic building back on
|
||||||
|
|
||||||
|
Project > Check "Build Automatically"
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Run CAVE
|
||||||
|
|
||||||
|
Launch CAVE from eclipse using **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.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
* If you are getting a lot of errors, try changing your Java Compiler to 1.7, build the project, then change back to 1.8 and rebuild.
|
||||||
|
|
|
||||||
|
|
@ -84,8 +84,7 @@ pages:
|
||||||
# - Model Sounding Data: python/model-sounding-data.md
|
# - Model Sounding Data: python/model-sounding-data.md
|
||||||
# - Map Resources and Topography: python/map-resources-and-topography.md
|
# - Map Resources and Topography: python/map-resources-and-topography.md
|
||||||
# - Surface Obs Plot with MetPy: python/surface-obs-plot-metpy.md
|
# - Surface Obs Plot with MetPy: python/surface-obs-plot-metpy.md
|
||||||
- Development:
|
- Development: dev/awips-development-environment.md
|
||||||
- AWIPS Development Environment (ADE): dev/awips-development-environment.md
|
|
||||||
- Appendix:
|
- Appendix:
|
||||||
- AWIPS Grid Parameters: appendix/appendix-grid-parameters.md
|
- AWIPS Grid Parameters: appendix/appendix-grid-parameters.md
|
||||||
- Maps Database: python/maps-database.md
|
- Maps Database: python/maps-database.md
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue