awips2/appendix/common-problems/index.html
2025-01-03 19:52:16 +00:00

1516 lines
No EOL
46 KiB
HTML

<!DOCTYPE html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta http-equiv="x-ua-compatible" content="ie=edge">
<meta name="description" content="Documentation for all things AWIPS.">
<link rel="canonical" href="http://unidata.github.io/awips2/appendix/common-problems/">
<meta name="author" content="support-awips@unidata.ucar.edu">
<link rel="shortcut icon" href="../../images/favicon.ico">
<meta name="generator" content="mkdocs-1.3.0, mkdocs-unidata-2.0.3">
<title>Common Problems - NSF Unidata AWIPS Manual</title>
<script src="../../assets/javascripts/modernizr-e826f8942a.js"></script>
<link rel="stylesheet" href="../../assets/stylesheets/application-37fa87ea8f.css">
<link rel="stylesheet" href="../../assets/stylesheets/application-624922a329.palette.css">
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700|Roboto+Mono">
<style>body,input{font-family:"Roboto","Helvetica Neue",Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono","Courier New",Courier,monospace}</style>
<link rel="stylesheet" href="https://fonts.googleapis.com/icon?family=Material+Icons">
<link rel="stylesheet" href="../../css/extra.css">
</head>
<body data-md-color-primary="blue-grey" data-md-color-accent="light-blue">
<svg class="md-svg">
<defs>
<svg xmlns="http://www.w3.org/2000/svg" width="416" height="448" viewBox="0 0 416 448" id="github"><path fill="currentColor" d="M160 304q0 10-3.125 20.5t-10.75 19T128 352t-18.125-8.5-10.75-19T96 304t3.125-20.5 10.75-19T128 256t18.125 8.5 10.75 19T160 304zm160 0q0 10-3.125 20.5t-10.75 19T288 352t-18.125-8.5-10.75-19T256 304t3.125-20.5 10.75-19T288 256t18.125 8.5 10.75 19T320 304zm40 0q0-30-17.25-51T296 232q-10.25 0-48.75 5.25Q229.5 240 208 240t-39.25-2.75Q130.75 232 120 232q-29.5 0-46.75 21T56 304q0 22 8 38.375t20.25 25.75 30.5 15 35 7.375 37.25 1.75h42q20.5 0 37.25-1.75t35-7.375 30.5-15 20.25-25.75T360 304zm56-44q0 51.75-15.25 82.75-9.5 19.25-26.375 33.25t-35.25 21.5-42.5 11.875-42.875 5.5T212 416q-19.5 0-35.5-.75t-36.875-3.125-38.125-7.5-34.25-12.875T37 371.5t-21.5-28.75Q0 312 0 260q0-59.25 34-99-6.75-20.5-6.75-42.5 0-29 12.75-54.5 27 0 47.5 9.875t47.25 30.875Q171.5 96 212 96q37 0 70 8 26.25-20.5 46.75-30.25T376 64q12.75 25.5 12.75 54.5 0 21.75-6.75 42 34 40 34 99.5z"/></svg>
</defs>
</svg>
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="drawer">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="search">
<label class="md-overlay" data-md-component="overlay" for="drawer"></label>
<header class="md-header" data-md-component="header">
<a href="../..">
<div class="background-logo" style="background-image:url('../../images/cave.png');background-repeat:no-repeat;height:107px">
<nav class="md-header-nav md-grid">
<div class="md-flex">
<div class="md-flex__cell md-flex__cell--shrink">
<a href="http://unidata.github.io/awips2/" title="NSF Unidata AWIPS Manual" class="md-header-nav__button md-logo">
<img src="../../images/home.png" width="24" height="24">
</a>
</div>
<div class="md-flex__cell md-flex__cell--shrink">
<label class="md-icon md-icon--menu md-header-nav__button" for="drawer"></label>
</div>
<div class="md-flex__cell md-flex__cell--stretch">
<span class="md-flex__ellipsis md-header-nav__title">
Common Problems
</span>
</div>
<div class="md-flex__cell md-flex__cell--shrink">
<label class="md-icon md-icon--search md-header-nav__button" for="search"></label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="search"></label>
<div class="md-search__inner">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" required placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="query">
<label class="md-icon md-search__icon" for="search"></label>
<button type="reset" class="md-icon md-search__icon" data-md-component="reset">&#xE5CD;</button>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" data-md-scrollfix>
<div class="md-search-result" data-md-component="result" data-md-lang-search="" data-md-lang-tokenizer="[\s\-]+">
<div class="md-search-result__meta" data-md-lang-result-none="No matching documents" data-md-lang-result-one="1 matching document" data-md-lang-result-other="# matching documents">
Type to start searching
</div>
<ol class="md-search-result__list"></ol>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="md-flex__cell md-flex__cell--shrink">
<div class="md-header-nav__source">
<a href="https://github.com/Unidata/awips2" title="Go to repository" class="md-source" data-md-source="github">
<div class="md-source__icon">
<svg viewBox="0 0 24 24" width="24" height="24">
<use xlink:href="#github" width="24" height="24"></use>
</svg>
</div>
<div class="md-source__repository">
GitHub
</div>
</a>
</div>
</div>
</div>
</nav>
</header>
<div class="md-container">
<main class="md-main">
<div class="md-main__inner md-grid" data-md-component="container">
<div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary" data-md-level="0">
<label class="md-nav__title md-nav__title--site" for="drawer">
<a href="http://unidata.github.io/awips2/" title="NSF Unidata AWIPS Manual" class="md-nav__button md-logo">
<img src="../../images/home.png">
</a>
NSF Unidata AWIPS Manual
</label>
<div class="md-nav__source">
<a href="https://github.com/Unidata/awips2" title="Go to repository" class="md-source" data-md-source="github">
<div class="md-source__icon">
<svg viewBox="0 0 24 24" width="24" height="24">
<use xlink:href="#github" width="24" height="24"></use>
</svg>
</div>
<div class="md-source__repository">
GitHub
</div>
</a>
</div>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../.." title="Home" class="md-nav__link">
Home
</a>
</li>
<li class="md-nav__item">
<a href="../../install/install-cave/" title="Install CAVE" class="md-nav__link">
Install CAVE
</a>
</li>
<li class="md-nav__item">
<a href="../../install/install-edex/" title="Install EDEX" class="md-nav__link">
Install EDEX
</a>
</li>
<li class="md-nav__item md-nav__item--active">
<input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="toc">
<label class="md-nav__link md-nav__link--active" for="toc">
Common Problems
</label>
<a href="./" title="Common Problems" class="md-nav__link md-nav__link--active">
Common Problems
</a>
<nav class="md-nav md-nav--secondary">
<label class="md-nav__title" for="toc">Table of contents</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="#all-operating-systems" title="All Operating Systems" class="md-nav__link">
All Operating Systems
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#removing-cavedata" title="Removing caveData" class="md-nav__link">
Removing caveData
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#linux" title="Linux" class="md-nav__link">
Linux
</a>
</li>
<li class="md-nav__item">
<a href="#windows" title="Windows" class="md-nav__link">
Windows
</a>
</li>
<li class="md-nav__item">
<a href="#mac" title="Mac" class="md-nav__link">
Mac
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#disappearing-configurations" title="Disappearing Configurations" class="md-nav__link">
Disappearing Configurations
</a>
</li>
<li class="md-nav__item">
<a href="#remotely-connecting-to-cave" title="Remotely Connecting to CAVE" class="md-nav__link">
Remotely Connecting to CAVE
</a>
</li>
<li class="md-nav__item">
<a href="#cave-spring-start-up-error" title="CAVE Spring Start Up Error" class="md-nav__link">
CAVE Spring Start Up Error
</a>
</li>
<li class="md-nav__item">
<a href="#products-not-loading-properly" title="Products Not Loading Properly" class="md-nav__link">
Products Not Loading Properly
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#windows_1" title="Windows" class="md-nav__link">
Windows
</a>
</li>
<li class="md-nav__item">
<a href="#mac_1" title="Mac" class="md-nav__link">
Mac
</a>
</li>
<li class="md-nav__item">
<a href="#linux_1" title="Linux" class="md-nav__link">
Linux
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#windows_2" title="Windows" class="md-nav__link">
Windows
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#cave-map-display-in-lower-left-quadrant-windows" title="CAVE Map Display in Lower Left Quadrant - Windows" class="md-nav__link">
CAVE Map Display in Lower Left Quadrant - Windows
</a>
</li>
<li class="md-nav__item">
<a href="#windows-cave-start-up-error" title="Windows CAVE Start Up Error" class="md-nav__link">
Windows CAVE Start Up Error
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#macos" title="macOS" class="md-nav__link">
macOS
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#monterey-cave-warning" title="Monterey CAVE Warning" class="md-nav__link">
Monterey CAVE Warning
</a>
</li>
<li class="md-nav__item">
<a href="#white-boxes-for-surface-resources" title="White Boxes for Surface Resources" class="md-nav__link">
White Boxes for Surface Resources
</a>
</li>
<li class="md-nav__item">
<a href="#model-data-not-rendering" title="Model Data Not Rendering" class="md-nav__link">
Model Data Not Rendering
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#linux_2" title="Linux" class="md-nav__link">
Linux
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#issue-starting-cave-rockyrhel8" title="Issue Starting CAVE (Rocky/RHEL8)" class="md-nav__link">
Issue Starting CAVE (Rocky/RHEL8)
</a>
</li>
<li class="md-nav__item">
<a href="#troubleshooting-uninstalling-edex" title="Troubleshooting Uninstalling EDEX" class="md-nav__link">
Troubleshooting Uninstalling EDEX
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
<label class="md-nav__link" for="nav-5">
CAVE User Manual
</label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="1">
<label class="md-nav__title" for="nav-5">
CAVE User Manual
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../cave/d2d-perspective/" title="D2D Perspective" class="md-nav__link">
D2D Perspective
</a>
</li>
<li class="md-nav__item">
<a href="../../cave/maps-views-projections/" title="Maps, Views, Projections" class="md-nav__link">
Maps, Views, Projections
</a>
</li>
<li class="md-nav__item">
<a href="../../cave/bundles-and-procedures/" title="Displays and Procedures" class="md-nav__link">
Displays and Procedures
</a>
</li>
<li class="md-nav__item">
<a href="../../cave/localization-perspective/" title="Localization Perspective" class="md-nav__link">
Localization Perspective
</a>
</li>
<li class="md-nav__item">
<a href="../../cave/nsharp/" title="NSHARP" class="md-nav__link">
NSHARP
</a>
</li>
<li class="md-nav__item">
<a href="../../cave/warngen/" title="WarnGen Walkthrough" class="md-nav__link">
WarnGen Walkthrough
</a>
</li>
<li class="md-nav__item">
<a href="../../cave/goes-16-17-satellite/" title="GOES East/West" class="md-nav__link">
GOES East/West
</a>
</li>
<li class="md-nav__item">
<a href="../../cave/d2d-gis-shapefiles/" title="GIS and Shapefiles" class="md-nav__link">
GIS and Shapefiles
</a>
</li>
<li class="md-nav__item">
<a href="../../cave/d2d-gridded-models/" title="Volume Browser" class="md-nav__link">
Volume Browser
</a>
</li>
<li class="md-nav__item">
<a href="../../cave/d2d-all-tools/" title="Tools" class="md-nav__link">
Tools
</a>
</li>
<li class="md-nav__item">
<a href="../../cave/d2d-edit-menus/" title="Editing Menus" class="md-nav__link">
Editing Menus
</a>
</li>
<li class="md-nav__item">
<a href="../../cave/cave-localization/" title="Change Localization" class="md-nav__link">
Change Localization
</a>
</li>
<li class="md-nav__item">
<a href="../../cave/import-export/" title="Import/Export" class="md-nav__link">
Import/Export
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-6" type="checkbox" id="nav-6">
<label class="md-nav__link" for="nav-6">
EDEX User Manual
</label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="1">
<label class="md-nav__title" for="nav-6">
EDEX User Manual
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../install/start-edex/" title="EDEX Basic Commands" class="md-nav__link">
EDEX Basic Commands
</a>
</li>
<li class="md-nav__item">
<a href="../../edex/settings/" title="EDEX Settings" class="md-nav__link">
EDEX Settings
</a>
</li>
<li class="md-nav__item">
<a href="../../edex/distributed-computing/" title="Distributed EDEX" class="md-nav__link">
Distributed EDEX
</a>
</li>
<li class="md-nav__item">
<a href="../../edex/edex-ingest-docker-container/" title="Docker EDEX" class="md-nav__link">
Docker EDEX
</a>
</li>
<li class="md-nav__item">
<a href="../../edex/ldm/" title="LDM Feeds" class="md-nav__link">
LDM Feeds
</a>
</li>
<li class="md-nav__item">
<a href="../../edex/data-distribution-files/" title="Data Distribution Files" class="md-nav__link">
Data Distribution Files
</a>
</li>
<li class="md-nav__item">
<a href="../../edex/new-grid/" title="Ingest a New Grid" class="md-nav__link">
Ingest a New Grid
</a>
</li>
<li class="md-nav__item">
<a href="../../edex/data-purge/" title="Purging and Retention" class="md-nav__link">
Purging and Retention
</a>
</li>
<li class="md-nav__item">
<a href="../../edex/edex-users/" title="Monitor Users" class="md-nav__link">
Monitor Users
</a>
</li>
<li class="md-nav__item">
<a href="../../edex/data-plugins/" title="Data Plugins" class="md-nav__link">
Data Plugins
</a>
</li>
<li class="md-nav__item">
<a href="../../edex/case-studies/" title="Archive Case Studies" class="md-nav__link">
Archive Case Studies
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../../python/overview/" title="Python-AWIPS" class="md-nav__link">
Python-AWIPS
</a>
</li>
<li class="md-nav__item">
<a href="../educational-resources/" title="Educational Resources" class="md-nav__link">
Educational Resources
</a>
</li>
<li class="md-nav__item">
<a href="../../dev/awips-development-environment/" title="Development" class="md-nav__link">
Development
</a>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-10" type="checkbox" id="nav-10">
<label class="md-nav__link" for="nav-10">
Appendix
</label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="1">
<label class="md-nav__title" for="nav-10">
Appendix
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../appendix-grid-parameters/" title="AWIPS Grid Parameters" class="md-nav__link">
AWIPS Grid Parameters
</a>
</li>
<li class="md-nav__item">
<a href="../maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations
</a>
</li>
<li class="md-nav__item">
<a href="../appendix-wsr88d/" title="WSR-88D Product Table" class="md-nav__link">
WSR-88D Product Table
</a>
</li>
<li class="md-nav__item">
<a href="../../cave/cave-keyboard-shortcuts/" title="Keyboard Shortcuts" class="md-nav__link">
Keyboard Shortcuts
</a>
</li>
<li class="md-nav__item">
<a href="../../raytheon/cave_d2d/" title="Raytheon: CAVE User's Manual" class="md-nav__link">
Raytheon: CAVE User's Manual
</a>
</li>
<li class="md-nav__item">
<a href="../../raytheon/smm/" title="Raytheon: AWIPS System Manager's Manual" class="md-nav__link">
Raytheon: AWIPS System Manager's Manual
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--secondary">
<label class="md-nav__title" for="toc">Table of contents</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="#all-operating-systems" title="All Operating Systems" class="md-nav__link">
All Operating Systems
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#removing-cavedata" title="Removing caveData" class="md-nav__link">
Removing caveData
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#linux" title="Linux" class="md-nav__link">
Linux
</a>
</li>
<li class="md-nav__item">
<a href="#windows" title="Windows" class="md-nav__link">
Windows
</a>
</li>
<li class="md-nav__item">
<a href="#mac" title="Mac" class="md-nav__link">
Mac
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#disappearing-configurations" title="Disappearing Configurations" class="md-nav__link">
Disappearing Configurations
</a>
</li>
<li class="md-nav__item">
<a href="#remotely-connecting-to-cave" title="Remotely Connecting to CAVE" class="md-nav__link">
Remotely Connecting to CAVE
</a>
</li>
<li class="md-nav__item">
<a href="#cave-spring-start-up-error" title="CAVE Spring Start Up Error" class="md-nav__link">
CAVE Spring Start Up Error
</a>
</li>
<li class="md-nav__item">
<a href="#products-not-loading-properly" title="Products Not Loading Properly" class="md-nav__link">
Products Not Loading Properly
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#windows_1" title="Windows" class="md-nav__link">
Windows
</a>
</li>
<li class="md-nav__item">
<a href="#mac_1" title="Mac" class="md-nav__link">
Mac
</a>
</li>
<li class="md-nav__item">
<a href="#linux_1" title="Linux" class="md-nav__link">
Linux
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#windows_2" title="Windows" class="md-nav__link">
Windows
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#cave-map-display-in-lower-left-quadrant-windows" title="CAVE Map Display in Lower Left Quadrant - Windows" class="md-nav__link">
CAVE Map Display in Lower Left Quadrant - Windows
</a>
</li>
<li class="md-nav__item">
<a href="#windows-cave-start-up-error" title="Windows CAVE Start Up Error" class="md-nav__link">
Windows CAVE Start Up Error
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#macos" title="macOS" class="md-nav__link">
macOS
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#monterey-cave-warning" title="Monterey CAVE Warning" class="md-nav__link">
Monterey CAVE Warning
</a>
</li>
<li class="md-nav__item">
<a href="#white-boxes-for-surface-resources" title="White Boxes for Surface Resources" class="md-nav__link">
White Boxes for Surface Resources
</a>
</li>
<li class="md-nav__item">
<a href="#model-data-not-rendering" title="Model Data Not Rendering" class="md-nav__link">
Model Data Not Rendering
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#linux_2" title="Linux" class="md-nav__link">
Linux
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#issue-starting-cave-rockyrhel8" title="Issue Starting CAVE (Rocky/RHEL8)" class="md-nav__link">
Issue Starting CAVE (Rocky/RHEL8)
</a>
</li>
<li class="md-nav__item">
<a href="#troubleshooting-uninstalling-edex" title="Troubleshooting Uninstalling EDEX" class="md-nav__link">
Troubleshooting Uninstalling EDEX
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content">
<article class="md-content__inner md-typeset">
<a href="https://github.com/Unidata/awips2/edit/unidata_20.3.2/docs/appendix/common-problems.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a>
<h1 id="common-problems">Common Problems<a class="headerlink" href="#common-problems" title="Permanent link"></a></h1>
<h2 id="all-operating-systems">All Operating Systems<a class="headerlink" href="#all-operating-systems" title="Permanent link"></a></h2>
<h3 id="removing-cavedata">Removing caveData<a class="headerlink" href="#removing-cavedata" title="Permanent link"></a></h3>
<p>Removing caveData (flushing the local cache) should be one of the first troubleshooting steps to take when experiencing weird behavior in CAVE. The cache lives in a folder called <strong>caveData</strong>, hence why this process is also referred to as removing or deleting caveData.</p>
<h4 id="linux">Linux<a class="headerlink" href="#linux" title="Permanent link"></a></h4>
<p>For Linux users, the easiest way is to open a new terminal and run the following command:</p>
<pre><code>rm -rf ~/caveData
</code></pre>
<h4 id="windows">Windows<a class="headerlink" href="#windows" title="Permanent link"></a></h4>
<p>For Windows users, simply delete the caveData folder in your home user directory:</p>
<p><img alt="Windows Remove caveData" src="../../images/windowsRemoveCavedata.png" /></p>
<h4 id="mac">Mac<a class="headerlink" href="#mac" title="Permanent link"></a></h4>
<p>For Mac users, the easiest way is to open a new terminal and run the following command:</p>
<pre><code>rm -rf ~/Library/caveData
</code></pre>
<hr />
<h3 id="disappearing-configurations">Disappearing Configurations<a class="headerlink" href="#disappearing-configurations" title="Permanent link"></a></h3>
<p>If you ever notice some of the following settings you've configured/saved disappear from CAVE:</p>
<ul>
<li>Saved Displays or Procedures</li>
<li>NSHARP settings (line thickness, etc)</li>
<li>Colormap settings</li>
<li>StyleRule settings</li>
</ul>
<div class="admonition note">
<p class="admonition-title">This is not a fully exhaustive list, so if something else has disappeared it might be the same underlying issue still.</p>
</div>
<p>Then it is likely we have recently changed our production EDEX server.
There is a good chance we can recover your settings. To do so, please send a short email to <a href="mailto:support-awips@unidata.ucar.edu">support-awips@unidata.ucar.edu</a> with the topic "Missing Configurations", and include the username(s) of the computer(s) you use to run CAVE.</p>
<hr />
<h3 id="remotely-connecting-to-cave">Remotely Connecting to CAVE<a class="headerlink" href="#remotely-connecting-to-cave" title="Permanent link"></a></h3>
<p>Since the pandemic began, many users have asked if they can use X11 forwarding or ssh tunneling to remotely connect to CAVE machines. <strong>This is not recommended or supported</strong>, and CAVE crashes in many different ways and expresses strange behavior as well.</p>
<p>We highly recommend you <a href="install-cave.md">download the appropriate CAVE installer</a> on your local machine, if that is an option.</p>
<p>If that is not an option, then the only remote access we recommend is using some type of VNC.
<a href="https://www.realvnc.com/en/"><strong>RealVNC</strong></a> and <a href="https://www.nomachine.com"><strong>nomachine</strong></a> are two options that are in use with positive outcomes. <a href="https://www.uvnc.com"><strong>UltraVNC</strong></a> may be another option, but may have quite a delay. There <em>may</em> also be other free or paid software available that we are not aware of.</p>
<div class="admonition warning">
<p class="admonition-title">It is likely that any VNC option you choose will also require some software or configuration to be set on the remote machine, and this will likely require administrative privileges.</p>
</div>
<hr />
<h3 id="cave-spring-start-up-error">CAVE Spring Start Up Error<a class="headerlink" href="#cave-spring-start-up-error" title="Permanent link"></a></h3>
<p>If you encounter the error below, please see one of our solution methods for resolving:</p>
<pre><code>CAVE's Spring container did not initialize correctly and CAVE must shut down.
</code></pre>
<p><img alt="CAVE Spring Start Up Error" src="../../images/caveSpringError.png" /></p>
<p>We have found the reason for this failure is because the host machine is set to use a language other than English (ie. Spanish, French, etc).</p>
<p>To resolve this issue, either:</p>
<ul>
<li>Switch your system to English, when using CAVE</li>
</ul>
<p>or</p>
<ul>
<li>Use our <a href="../install/install-cave/#method-2-linux-virtual-machine">Virtual Machine option</a>. This option allows your actual machine to stay in whichever language you choose, while allowing you to run CAVE in an environment set to English. Although we list this installation under the Windows OS, this can also be done on Linux.</li>
</ul>
<div class="admonition warning">
<p class="admonition-title">The VM option has one notable drawback at the moment -- it cannot render RGB satellite products.</p>
</div>
<hr />
<h3 id="products-not-loading-properly">Products Not Loading Properly<a class="headerlink" href="#products-not-loading-properly" title="Permanent link"></a></h3>
<p>This problem is most commonly seen with the direct Windows installation. It can also manifest in the Mac installation (and is possible on Linux), and the root of the problem is not having Python installed properly for CAVE to use the packages.</p>
<p>There are derived products which use the local machine to create and render the data. This creation is dependent upon python and its required packages working correctly. The dataset will be available in the menus and product browser, but when loaded, no data is drawn on the editor, but an entry is added to the legend.
<img alt="failed load" src="../../images/failedJepMetarLoad.png" /></p>
<p>You may see an error that mentions the python package, <strong>jep</strong>.</p>
<p>Known datasets this can affect (this is not a comprehensive list):</p>
<ul>
<li>Model Winds</li>
<li>Metars Winds</li>
<li>METAR Station Plot</li>
<li>GFS Precip Type</li>
</ul>
<h4 id="windows_1">Windows<a class="headerlink" href="#windows_1" title="Permanent link"></a></h4>
<p>To correct this issue on Windows:</p>
<ul>
<li>Make sure you only have the latest version of <a href="https://unidata.github.io/awips2/install/install-cave/#method-1-direct-windows-install">CAVE installed</a> (which now fully bundles the proper version of Python with the application)</li>
<li>If you have ever previously added <code>PYTHONHOME</code>, <code>PYTHONPATH</code>, or <code>JAVA_HOME</code> to your user or system variables, please delete those.<ul>
<li>Open the Environment Variables window by typing "env" in the start bar</li>
</ul>
</li>
</ul>
<h4 id="mac_1">Mac<a class="headerlink" href="#mac_1" title="Permanent link"></a></h4>
<p>To correct this issue on Mac:</p>
<ul>
<li>Make sure you have the latest verison of <a href="https://unidata.github.io/awips2/install/install-cave/#macos">CAVE installed</a> (which now fully bundles the proper version of Python with the application)</li>
</ul>
<h4 id="linux_1">Linux<a class="headerlink" href="#linux_1" title="Permanent link"></a></h4>
<p>To correct this issue on Linux:</p>
<ul>
<li>When running <code>which python</code> from a terminal, make sure <code>/awips2/python/</code> is returned, if not, reset that environment variable, or re-run the <a href="install-cave.md#download-and-installation-instructions"><strong>awips_install.sh</strong> script from our installation instructions</a></li>
</ul>
<hr />
<h2 id="windows_2">Windows<a class="headerlink" href="#windows_2" title="Permanent link"></a></h2>
<h3 id="cave-map-display-in-lower-left-quadrant-windows">CAVE Map Display in Lower Left Quadrant - Windows<a class="headerlink" href="#cave-map-display-in-lower-left-quadrant-windows" title="Permanent link"></a></h3>
<p>If you start up CAVE in Windows and notice the map is showing up only in the bottom left quadrant of your display, you will just need to tweak a few display settings.</p>
<p><img alt="CAVE Map 1/4 of screen" src="../../images/CAVE_map.png" /></p>
<p>Try following these steps to fix your issue:</p>
<ul>
<li>Right-click on the no_env.exe, select Properties</li>
</ul>
<div class="admonition note">
<p class="admonition-title">This is not the batch file (CAVE.bat) that gets installed as the CAVE shortcut on the Desktop, the no_env.exe is located in <code>C:\Users\[your_username]\AppData\Roaming\UCAR Unidata\AWIPS CAVE\no_env.exe</code>.</p>
</div>
<ul>
<li>Select the Compatibility tab</li>
<li>Click "Change High DPI Settings"</li>
<li>At the bottom enable "Override High DPI scaling behavior"</li>
<li>Change the dropdown from Application to System</li>
</ul>
<hr />
<h3 id="windows-cave-start-up-error">Windows CAVE Start Up Error<a class="headerlink" href="#windows-cave-start-up-error" title="Permanent link"></a></h3>
<div class="admonition note">
<p class="admonition-title">This should no longer be an issue for our v20 release of AWIPS.</p>
</div>
<p>One common error some users are seeing manifests itself just after selecting an EDEX server to connect to. The following error dialogs may show up:</p>
<ul>
<li>
<p><em>Error purging logs</em><br />
<img alt="Error purging logs. Reason: Error occurred during purge and rotate" src="../../images/errorPurgingLogs.png" /></p>
</li>
<li>
<p><em>Error instantiating workbench: null</em><br />
<img alt="Error instantiating workbench: null" src="../../images/errorWorkbenchNull.png" /></p>
</li>
</ul>
<p>These errors are actually happening because the Windows machine is using IPv6, which is not compatible with AWIPS at this time.</p>
<p><strong>To fix the issue simply follow these steps:</strong></p>
<div class="admonition note">
<p class="admonition-title">These screenshots may vary from your system.</p>
</div>
<div class="admonition warning">
<p class="admonition-title">These instructions are <i>per connection</i>, so if you use multiple connections or switch between wired and wireless connections, you'll need to do the following for each of those connections so that CAVE will always run properly.</p>
</div>
<p><strong>1. Close all error windows and any open windows associated with CAVE.</strong></p>
<p><strong>2. In the Windows search field, search for "control panel".</strong></p>
<p><img alt="" src="../../images/ipv6ProblemStep2.png" /></p>
<p><strong>3. Once in the Control Panel, look for "Network and Sharing Center".</strong></p>
<p><img alt="" src="../../images/ipv6ProblemStep3a.png" />
<img alt="" src="../../images/ipv6ProblemStep3b.png" /></p>
<p><strong>4. Select the adapter for your current connection (should be either "Ethernet" or "Wi-Fi").</strong></p>
<p><img alt="" src="../../images/ipv6ProblemStep4.png" /></p>
<p><strong>5. Click on "Properties".</strong></p>
<p><img alt="" src="../../images/ipv6ProblemStep5.png" /></p>
<p><strong>6. Uncheck "Internet Protocol Version 6 (TCP/IPv6)" and select OK.</strong></p>
<p><img alt="" src="../../images/ipv6ProblemStep6.png" /></p>
<div class="admonition note">
<p class="admonition-title">You may need to restart your machine for this to take effect</p>
</div>
<p><strong>7. Restart CAVE.</strong></p>
<hr />
<h2 id="macos">macOS<a class="headerlink" href="#macos" title="Permanent link"></a></h2>
<h3 id="monterey-cave-warning">Monterey CAVE Warning<a class="headerlink" href="#monterey-cave-warning" title="Permanent link"></a></h3>
<p>If you are running MacOS Monterey, you may see the following message when starting CAVE:</p>
<p><img alt="Monterey warning" src="../../images/monterey-warning.png" /></p>
<p>Monterey versions 12.3 or newer will not support our production (v18) CAVE.</p>
<div class="admonition note">
<p class="admonition-title">Please <a href="../install/install-cave-beta-v20.md#macos">download and install our beta v20 CAVE</a> for newer MacOS Versions to avoid this issue.</p>
</div>
<hr />
<h3 id="white-boxes-for-surface-resources">White Boxes for Surface Resources<a class="headerlink" href="#white-boxes-for-surface-resources" title="Permanent link"></a></h3>
<p>If you do not have an NVIDIA graphics card and driver, you may see "boxes" drawn on the editor for some of the products (<strong>METARS Station Plots</strong> and <strong>Surface Winds</strong> are the resources we're aware of), as shown below:</p>
<p><img alt="" src="../../images/caveMacGraphicsCard.png" /></p>
<p>You may be able to fix this issue:</p>
<ul>
<li>
<p>Check what graphics cards are available on your machine, by going to the Apple menu (far left, upper corner) &gt; About This Mac &gt; Overview tab (default):</p>
<p><img alt="" src="../../images/aboutMac.png" /></p>
</li>
<li>
<p>If you see two entries at the <strong>Graphics</strong> line, like the image shown above, then you have two graphics cards on your system. <strong>Intel graphics cards <em>may</em></strong> be able to render our products properly. In this case, you can "force" your computer to use the Intel card by running the following in a terminal:</p>
<p><code>sudo pmset -[a|b|c] gpuswitch 0</code></p>
<p>Where <code>[a|b|c]</code> is only one of those options, which mean:</p>
<ul>
<li>a: adjust settings for <strong>all</strong> scenarios</li>
<li>b: adjust settings while running off <strong>battery</strong></li>
<li>c: adjust settings while connected to <strong>charger</strong></li>
</ul>
<p>The argument <code>0</code> sets the computer to use the dedicated GPU (in our case above the Intel GPU).</p>
<p>The two other options for that argument are:</p>
<ul>
<li>1: automatic graphics switching</li>
<li>2: integrated GPU </li>
</ul>
<div class="admonition note">
<p class="admonition-title">It may be smart to run <code>pmset -g</code> first, so you can see what the current <code>gpuswitch</code> setting is (likely <code>1</code>), that way you can revert the settings if you want them back to how they were, when not using CAVE.</p>
</div>
</li>
</ul>
<hr />
<h3 id="model-data-not-rendering">Model Data Not Rendering<a class="headerlink" href="#model-data-not-rendering" title="Permanent link"></a></h3>
<p>This behavior has appeared with MacOS Sonoma (v14) -- model data is no longer loading and you see the following errors on the screen or in the AlertView:</p>
<blockquote>
<p>ERROR: An internal error occured during: "Initializing...".</p>
<p>ERROR: An internal error occured during: "Product Loader".</p>
<p>ERROR: An internal error occured during "Initializing...".</p>
</blockquote>
<p><img alt="" src="../../images/macModelFailure.png" /></p>
<p>If you encounter this behavior, please close CAVE, <a href="#mac">clear caveData as described above</a>, then restart CAVE and try to load the data again.</p>
<p>If you still experience issues, please let us know at support-awips@unidata.ucar.edu</p>
<hr />
<h2 id="linux_2">Linux<a class="headerlink" href="#linux_2" title="Permanent link"></a></h2>
<h3 id="issue-starting-cave-rockyrhel8">Issue Starting CAVE (Rocky/RHEL8)<a class="headerlink" href="#issue-starting-cave-rockyrhel8" title="Permanent link"></a></h3>
<p>If you are running CAVE on RHEL or Rocky 8 and are getting an error when CAVE starts up: <code>Error instantiating workbench</code> or if you look in <code>~/caveData/cave_*_console.log</code> and see an error: <code>org.eclipse.swt.SWTException: Unsupported color depth</code> then you may need to change your display from "Wayland" to "X11".</p>
<p><img alt="" src="../../images/caveError.png" /></p>
<p>To change your default display, you can edit the <code>/etc/gdm/custom.conf</code> and uncomment the <code>WaylandEnable</code> line like below and reboot.</p>
<pre><code># GDM configuration storage
[daemon]
# Uncomment the line below to force the login screen to use Xorg
WaylandEnable=false
[security]
[xdmcp]
[chooser]
[debug]
# Uncomment the line below to turn on debugging
#Enable=true
</code></pre>
<p>To temporarily change your display, logout of your user. Before logging in, select your user and click on the gear/settings icon and select an <code>X11 display</code>.</p>
<p><img alt="" src="../../images/displayType.png" /></p>
<h3 id="troubleshooting-uninstalling-edex">Troubleshooting Uninstalling EDEX<a class="headerlink" href="#troubleshooting-uninstalling-edex" title="Permanent link"></a></h3>
<p>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:</p>
<pre><code>yum groupremove &quot;AWIPS EDEX Server&quot;
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
</code></pre>
<p>To solve this issue, mark the group you want to remove and then try removing it again:</p>
<pre><code>yum groups mark remove &quot;AWIPS EDEX Server&quot;
yum groupremove &quot;AWIPS EDEX Server&quot;
</code></pre>
<div class="admonition note">
<p class="admonition-title">Check to make sure your <code>/etc/yum.repos.d/awips2.repo</code> file has <code>enabled=1</code>.</p>
</div>
</article>
</div>
</div>
</main>
<footer class="md-footer">
<div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid">
<a href="install/install-edex/" title="Install EDEX" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div>
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis">
<span class="md-footer-nav__direction">
Previous
</span>
Install EDEX
</span>
</div>
</a>
<a href="cave/d2d-perspective/" title="D2D Perspective" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis">
<span class="md-footer-nav__direction">
Next
</span>
D2D Perspective
</span>
</div>
<div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
</div>
</a>
</nav>
</div>
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-footer-copyright">
<div class="md-footer-copyright__highlight">
Copyright &copy; 2025 NSF Unidata Program Center.
</div>
powered by
<a href="http://www.mkdocs.org" title="MkDocs">MkDocs</a>
and
<a href="http://squidfunk.github.io/mkdocs-material/" title="Material for MkDocs">
Material for MkDocs</a>
</div>
<div class="md-footer-social">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
<a href="https://www.unidata.ucar.edu/software/awips2" class="md-footer-social__link fa fa-globe"></a>
<a href="https://github.com/Unidata/awips2" class="md-footer-social__link fa fa-github-alt"></a>
<a href="https://twitter.com/Unidata" class="md-footer-social__link fa fa-twitter"></a>
<a href="https://facebook.com/Unidata" class="md-footer-social__link fa fa-facebook"></a>
</div>
</div>
</div>
</footer>
</div>
<script src="../../assets/javascripts/application-eaeb7b21e3.js"></script>
<script>app.initialize({url:{base:"../.."}})</script>
</body>
</html>