Merge remote-tracking branch 'unidata/unidata_18.2.1' into unidata_18…

….2.1

.github/workflows/deploy_docs.yml

@@ -1,9 +1,10 @@
 name: publish mkdocs to github pages
 
 on:
+  workflow_dispatch:
   push:
     branches:
-      - unidata_18.1.1
+      - unidata_18.2.1
     paths:
       - 'docs/**'
       - 'mkdocs.yml'

docs/install/common-problems.md

@@ -98,3 +98,29 @@ To correct this issue:
   - Redo all necessary [installation instructions in **steps 1 through 6**](install-cave.md#download-and-installation-instructions_2)
 
 ---
+
+## Troubleshooting Uninstalling EDEX (Linux)
+
+Sometimes yum can get in a weird state and not know what AWIPS groups have been installed. For example if you are trying to remove AWIPS you may see an error:
+
+```
+yum groupremove "AWIPS EDEX Server"
+
+    Loaded plugins: fastestmirror, langpacks
+    Loading mirror speeds from cached hostfile
+    * base: mirror.dal.nexril.net
+    * elrepo: ftp.osuosl.org
+    * epel: mirrors.xmission.com
+    * extras: mirrors.cat.pdx.edu
+    * updates: mirror.mobap.edu
+
+    No environment named AWIPS EDEX Server exists
+    Maybe run: yum groups mark remove (see man yum)
+    No packages to remove from groups
+```
+
+To solve this issue, mark the group you want to remove and then try removing it again:
+```
+yum groups mark remove "AWIPS EDEX Server"
+yum groupremove "AWIPS EDEX Server"
+```

docs/install/install-cave.md

@@ -111,6 +111,7 @@ For additional assistance we have created an [**installation video**](https://yo
     - Make note of where it installs on your computer (the default is C:\ProgramFiles\Java\jdk1.8.0_181)
 3. Set the environment variables:
     - Access the Environment Variables window by typing "env" in the start bar, hitting enter, and clicking on the "Environment Variables..." button at the bottom of the "System Properties" window
+    - Create the variables in their respective locations using the **New...** buttons
     - User Variables: **PYTHONPATH** and **PYTHONHOME**
     - System Variable: **JAVA_HOME**
     ![Env Vars](../images/envVars.png)
@@ -206,3 +207,35 @@ You can reset CAVE by removing the **caveData** directory and reconnecting to an
 - Linux: `/home/<user>/caveData/`
 - macOS: `/Users/<user>/Library/caveData/`
 - Windows: `C:\Users\<user>\caveData\`
+
+---
+
+## Uninstalling CAVE (Linux)
+These are instructions to manually uninstall CAVE. However, the [`awips_install.sh`](#download-and-installation-instructions) script will do these steps for you if you are installing a newer version of CAVE.
+
+**1. Make sure you have exited out of any CAVE sessions**
+
+**2. Remove currently installed CAVE**
+```
+sudo yum clean all
+sudo yum groupremove "AWIPS CAVE"
+```
+
+!!! note "If you are having trouble removing a group, see the [troubleshooting](common-problems.md#troubleshooting-uninstalling-edex) section."
+
+**3. Check to make sure all awips rpms have been removed**
+```
+rpm -qa | grep awips2
+```
+
+If you still have rpms installed, remove them
+
+```
+sudo yum remove awips2-*
+```
+
+**4. Remove the cave directory in /awips2 and caveData from your home directory**
+```
+rm -rf /awips2/cave
+rm -rf ~/caveData
+```

docs/install/install-edex.md

@@ -250,8 +250,7 @@ This file specifies configuration and runtime parameters. If you are pulling in
   </queue>
 ```
 
-!!! note "[Read more about registry.xml in the LDM User Manual] https://www.unidata.ucar.edu/software/ldm/ldm-current/basics/LDM-registry.html"
-
+!!! note "[Read more about registry.xml in the LDM User Manual](https://www.unidata.ucar.edu/software/ldm/ldm-current/basics/LDM-registry.html)"
 
 ---
 
@@ -275,3 +274,116 @@ This file specifies configuration and runtime parameters. If you are pulling in
 ```
 rpm -qa | grep awips2-edex
 ```
+
+---
+
+## Uninstalling EDEX
+These are instructions to manually uninstall EDEX. However, the [`awips_install.sh`](#1-install-edex) script will do all of these steps for you if you are installing a newer version of EDEX.
+
+**1. Make sure all EDEX processes are stopped**
+```
+sudo edex stop
+sudo edex status
+
+[edex status]
+ postgres    :: not running
+ pypies      :: not running
+ qpid        :: not running
+ EDEXingest  :: not running
+ EDEXgrib    :: not running
+ EDEXrequest :: not running
+ ldmadmin    :: not running
+```
+
+**2. Backup any important configuration files that you may want to reference**
+
+Here are some possible important directories/files to backup:
+
+```
+/awips2/database/data/pg_hba.conf
+/awips2/edex/data/utility/*
+/awips2/edex/bin/*
+/awips2/ldm/*
+/awips2/dev/*
+/awips2/edex/conf*
+/awips2/edex/etc/*
+/awips2/edex/logs/*
+/usr/bin/edex/*
+/etc/init.d/edexServiceList
+```
+
+**3. See what AWIPS yum groups are currently installed**
+
+In this case the ```AWIPS EDEX Server``` group is installed
+
+```
+sudo yum grouplist
+
+Available Environment Groups:
+   Minimal Install
+   Compute Node
+   Infrastructure Server
+   File and Print Server
+   Cinnamon Desktop
+   MATE Desktop
+   Basic Web Server
+   Virtualization Host
+   Server with GUI
+   GNOME Desktop
+   KDE Plasma Workspaces
+   Development and Creative Workstation
+Installed Groups:
+   AWIPS EDEX Server
+   Development Tools
+Available Groups:
+   AWIPS ADE SERVER
+   AWIPS CAVE
+   AWIPS Development
+   AWIPS EDEX DAT Server
+   AWIPS EDEX Database/Request Server
+   AWIPS EDEX Decode/Ingest Node (No Database, PyPIES, GFE)
+   Cinnamon
+   Compatibility Libraries
+   Console Internet Tools
+   Educational Software
+   Electronic Lab
+   Fedora Packager
+   General Purpose Desktop
+   Graphical Administration Tools
+   Haskell
+   LXQt Desktop
+   Legacy UNIX Compatibility
+   MATE
+   Milkymist
+   Scientific Support
+   Security Tools
+   Smart Card Support
+   System Administration Tools
+   System Management
+   TurboGears application framework
+   Xfce
+```
+
+**4. Remove any currently installed AWIPS yum groups**
+```
+sudo yum clean all
+sudo yum groupremove "AWIPS EDEX Server"
+```
+
+!!! note "If you are having trouble removing a group, see the [troubleshooting](common-problems.md#troubleshooting-uninstalling-edex) section."
+
+**5. Check to make sure all awips rpms have been removed**
+```
+rpm -qa | grep awips2
+```
+
+If you still have rpms installed, remove them
+
+```
+sudo yum remove awips2-*
+```
+
+**6. Remove everything in the /awips2 directory**
+```
+rm -rf /awips2/*
+```