awips2/install/install-cave/index.html
2023-05-03 16:57:50 +00:00

1496 lines
No EOL
44 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/install/install-cave/">
<meta name="author" content="support-awips@unidata.ucar.edu">
<link rel="shortcut icon" href="../../images/favicon.ico">
<meta name="generator" content="mkdocs-1.4.3, mkdocs-unidata-2.0.3">
<title>Install CAVE - Unidata AWIPS User 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="Unidata AWIPS User 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">
Install CAVE
</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="Unidata AWIPS User Manual" class="md-nav__button md-logo">
<img src="../../images/home.png">
</a>
Unidata AWIPS User 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 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">
Install CAVE
</label>
<a href="./" title="Install CAVE" class="md-nav__link md-nav__link--active">
Install CAVE
</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="#latest-cave-versions" title="Latest CAVE Versions" class="md-nav__link">
Latest CAVE Versions
</a>
</li>
<li class="md-nav__item">
<a href="#general-requirements" title="General Requirements" class="md-nav__link">
General Requirements
</a>
</li>
<li class="md-nav__item">
<a href="#linux" title="Linux " class="md-nav__link">
Linux
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#system-requirements" title="System Requirements" class="md-nav__link">
System Requirements
</a>
</li>
<li class="md-nav__item">
<a href="#download-and-installation-instructions" title="Download and Installation Instructions" class="md-nav__link">
Download and Installation Instructions
</a>
</li>
<li class="md-nav__item">
<a href="#run-cave" title="Run CAVE" class="md-nav__link">
Run CAVE
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#windows" title="Windows " class="md-nav__link">
Windows
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#method-1-direct-windows-install" title="Method 1: Direct Windows Install" class="md-nav__link">
Method 1: Direct Windows Install
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#download-and-installation-instructions_1" title="Download and Installation Instructions" class="md-nav__link">
Download and Installation Instructions
</a>
</li>
<li class="md-nav__item">
<a href="#run-cave_1" title="Run CAVE" class="md-nav__link">
Run CAVE
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#method-2-linux-virtual-machine" title="Method 2: Linux Virtual Machine" class="md-nav__link">
Method 2: Linux Virtual Machine
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#system-requirements_1" title="System Requirements" class="md-nav__link">
System Requirements
</a>
</li>
<li class="md-nav__item">
<a href="#download-and-installation-instructions_2" title="Download and Installation Instructions" class="md-nav__link">
Download and Installation Instructions
</a>
</li>
<li class="md-nav__item">
<a href="#run-cave_2" title="Run CAVE" class="md-nav__link">
Run CAVE
</a>
</li>
</ul>
</nav>
</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="#system-requirements_2" title="System Requirements" class="md-nav__link">
System Requirements
</a>
</li>
<li class="md-nav__item">
<a href="#download-and-installation-instructions_3" title="Download and Installation Instructions" class="md-nav__link">
Download and Installation Instructions
</a>
</li>
<li class="md-nav__item">
<a href="#run-cave_3" title="Run CAVE" class="md-nav__link">
Run CAVE
</a>
</li>
<li class="md-nav__item">
<a href="#macos-monterey-warning" title="MacOS Monterey Warning" class="md-nav__link">
MacOS Monterey Warning
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#edex-connection" title="EDEX Connection" class="md-nav__link">
EDEX Connection
</a>
</li>
<li class="md-nav__item">
<a href="#local-cache" title="Local Cache" class="md-nav__link">
Local Cache
</a>
</li>
<li class="md-nav__item">
<a href="#uninstalling-cave-linux" title="Uninstalling CAVE (Linux)" class="md-nav__link">
Uninstalling CAVE (Linux)
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../install-edex/" title="Install EDEX" class="md-nav__link">
Install EDEX
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/common-problems/" title="Common Problems" class="md-nav__link">
Common Problems
</a>
</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 16/17" class="md-nav__link">
GOES 16/17
</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-tools/" title="Display Tools" class="md-nav__link">
Display Tools
</a>
</li>
<li class="md-nav__item">
<a href="../../cave/d2d-radar-tools/" title="Radar Tools" class="md-nav__link">
Radar 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="../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="../../appendix/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/appendix-grid-parameters/" title="AWIPS Grid Parameters" class="md-nav__link">
AWIPS Grid Parameters
</a>
</li>
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/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="#latest-cave-versions" title="Latest CAVE Versions" class="md-nav__link">
Latest CAVE Versions
</a>
</li>
<li class="md-nav__item">
<a href="#general-requirements" title="General Requirements" class="md-nav__link">
General Requirements
</a>
</li>
<li class="md-nav__item">
<a href="#linux" title="Linux " class="md-nav__link">
Linux
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#system-requirements" title="System Requirements" class="md-nav__link">
System Requirements
</a>
</li>
<li class="md-nav__item">
<a href="#download-and-installation-instructions" title="Download and Installation Instructions" class="md-nav__link">
Download and Installation Instructions
</a>
</li>
<li class="md-nav__item">
<a href="#run-cave" title="Run CAVE" class="md-nav__link">
Run CAVE
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#windows" title="Windows " class="md-nav__link">
Windows
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#method-1-direct-windows-install" title="Method 1: Direct Windows Install" class="md-nav__link">
Method 1: Direct Windows Install
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#download-and-installation-instructions_1" title="Download and Installation Instructions" class="md-nav__link">
Download and Installation Instructions
</a>
</li>
<li class="md-nav__item">
<a href="#run-cave_1" title="Run CAVE" class="md-nav__link">
Run CAVE
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#method-2-linux-virtual-machine" title="Method 2: Linux Virtual Machine" class="md-nav__link">
Method 2: Linux Virtual Machine
</a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#system-requirements_1" title="System Requirements" class="md-nav__link">
System Requirements
</a>
</li>
<li class="md-nav__item">
<a href="#download-and-installation-instructions_2" title="Download and Installation Instructions" class="md-nav__link">
Download and Installation Instructions
</a>
</li>
<li class="md-nav__item">
<a href="#run-cave_2" title="Run CAVE" class="md-nav__link">
Run CAVE
</a>
</li>
</ul>
</nav>
</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="#system-requirements_2" title="System Requirements" class="md-nav__link">
System Requirements
</a>
</li>
<li class="md-nav__item">
<a href="#download-and-installation-instructions_3" title="Download and Installation Instructions" class="md-nav__link">
Download and Installation Instructions
</a>
</li>
<li class="md-nav__item">
<a href="#run-cave_3" title="Run CAVE" class="md-nav__link">
Run CAVE
</a>
</li>
<li class="md-nav__item">
<a href="#macos-monterey-warning" title="MacOS Monterey Warning" class="md-nav__link">
MacOS Monterey Warning
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#edex-connection" title="EDEX Connection" class="md-nav__link">
EDEX Connection
</a>
</li>
<li class="md-nav__item">
<a href="#local-cache" title="Local Cache" class="md-nav__link">
Local Cache
</a>
</li>
<li class="md-nav__item">
<a href="#uninstalling-cave-linux" title="Uninstalling CAVE (Linux)" class="md-nav__link">
Uninstalling CAVE (Linux)
</a>
</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_18.2.1/docs/install/install-cave.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a>
<h1 id="install-cave">Install CAVE<a class="headerlink" href="#install-cave" title="Permanent link"></a></h1>
<p>CAVE is the <strong>C</strong>ommon <strong>A</strong>WIPS <strong>V</strong>isualization <strong>E</strong>nvironment that is used for rendering and analyzing data for AWIPS. Unidata supports CAVE to work on three platforms: <a href="#linux">Centos (Redhat) Linux</a>, <a href="#windows">Windows</a>, and <a href="#macos">macOS</a>. The installer may require administrator privileges to install and may require other system changes (environment variables, etc) as well.</p>
<hr />
<h2 id="latest-cave-versions">Latest CAVE Versions<a class="headerlink" href="#latest-cave-versions" title="Permanent link"></a></h2>
<ul>
<li><a href="#linux"><strong>Linux: 18.2.1-6</strong></a></li>
<li><a href="#windows"><strong>Windows: 18.2.1-6</strong></a></li>
<li><a href="#macos"><strong>Mac: 18.2.1-6</strong></a></li>
<li><a href="../install-cave-beta-v20/"><strong>BETA Version: 20.3.2-0.3</strong></a></li>
</ul>
<p><a href="https://www.unidata.ucar.edu/blogs/news/tags/awips-release"><strong>View release notes</strong></a></p>
<hr />
<h2 id="general-requirements">General Requirements<a class="headerlink" href="#general-requirements" title="Permanent link"></a></h2>
<p>Regardless of what Operating System CAVE is running on, these general requirements are recommended in order for CAVE to perform optimally:</p>
<ul>
<li>
<p>Local machine</p>
<div class="admonition error">
<p class="admonition-title">Running CAVE via X11 forwarding or ssh tunneling is <strong>not</strong> supported. Using a <a href="../../appendix/common-problems/#remotely-connecting-to-cave">VNC connection is the only remote option</a>, and may result in worse performance than running locally.</p>
</div>
</li>
<li>
<p>Java 1.8</p>
</li>
<li>OpenGL 2.0 Compatible Devices</li>
<li>At least 4GB RAM</li>
<li>At least 2GB Disk Space for Caching</li>
<li>NVIDIA Graphics Card</li>
<li>
<p><a href="http://www.nvidia.com/Download/index.aspx?lang=en-us">Latest NVIDIA Driver</a></p>
<div class="admonition warning">
<p class="admonition-title">While other graphics cards <em>may</em> work, NVIDIA Quadro graphics card is recommended for full visualization capability</p>
</div>
</li>
</ul>
<hr />
<h2 id="linux">Linux <i class="fa fa-linux"></i><a class="headerlink" href="#linux" title="Permanent link"></a></h2>
<p><strong>Latest Version: 18.2.1-6</strong></p>
<h3 id="system-requirements">System Requirements<a class="headerlink" href="#system-requirements" title="Permanent link"></a></h3>
<ul>
<li>64 bit CentOS/Red Hat 7</li>
<li>Bash shell environment</li>
</ul>
<div class="admonition note">
<p class="admonition-title">While CentOS8 has reach End of Life as of Dec. 31, 2021, CentOS7 End of Life isn't until June 30, 2024.</p>
</div>
<h3 id="download-and-installation-instructions">Download and Installation Instructions<a class="headerlink" href="#download-and-installation-instructions" title="Permanent link"></a></h3>
<ol>
<li>Download the following installer: <a href="https://downloads.unidata.ucar.edu/awips2/current/linux/awips_install.sh"><strong>awips_install.sh</strong> <i class="fa fa-download"></i></a></li>
<li>In a terminal, go to the download directory </li>
<li>Make the installer an executable by running: <code>chmod 755 awips_install.sh</code></li>
<li>Run the installer: <code>sudo ./awips_install.sh --cave</code><ul>
<li>This will install the application in <code>/awips2/cave/</code> and set the local cache to <code>~/caveData/</code></li>
</ul>
</li>
</ol>
<h3 id="run-cave">Run CAVE<a class="headerlink" href="#run-cave" title="Permanent link"></a></h3>
<p>To run CAVE either:</p>
<ul>
<li>Use the terminal and type the command <code>cave</code></li>
<li>Find the application in the Linux Desktop menu: Applications &gt; Internet &gt; AWIPS CAVE</li>
</ul>
<p>Additionally users can choose to run a <a href="#method-2-linux-virtual-machine">virtual machine (VM)</a> on Linux.</p>
<hr />
<h2 id="windows">Windows <i class="fa fa-windows"></i><a class="headerlink" href="#windows" title="Permanent link"></a></h2>
<p><strong>Latest Version: 18.2.1-6</strong></p>
<p>For Windows, Unidata offers two installation options: a <a href="#method-1-direct-windows-install"><strong>Direct Windows Installation</strong></a>, or a <a href="#method-2-linux-virtual-machine"><strong>Linux Virtual Machine</strong></a>.</p>
<div class="admonition note">
<p class="admonition-title">As of 4/24/2023, the direct install method has been completely simplified! No admin privileges or extra software needed.</p>
</div>
<div class="admonition warning">
<p class="admonition-title">At the moment, the VM option may not render all products in CAVE (ex. RGB composites of satellite imagery)</p>
</div>
<h3 id="method-1-direct-windows-install">Method 1: Direct Windows Install<a class="headerlink" href="#method-1-direct-windows-install" title="Permanent link"></a></h3>
<p>This method has been simplified to include python and java packaged with CAVE so no other software installation is necessary. CAVE no longer needs changes to any environment variables in order to run.</p>
<h4 id="download-and-installation-instructions_1">Download and Installation Instructions<a class="headerlink" href="#download-and-installation-instructions_1" title="Permanent link"></a></h4>
<ol>
<li>Download and install: <a href="https://downloads.unidata.ucar.edu/awips2/current/windows/awips-cave.msi"><strong>awips-cave.msi</strong> <i class="fa fa-download"></i></a><ul>
<li>This will install CAVE to the user level in <code>%HOMEPATH%\AppDir\Roaming\UCAR Unidata\AWIPS CAVE</code>.</li>
</ul>
</li>
</ol>
<h4 id="run-cave_1">Run CAVE<a class="headerlink" href="#run-cave_1" title="Permanent link"></a></h4>
<p>To run CAVE, either:</p>
<ul>
<li>Double click on the <code>CAVE</code> shortcut on the desktop</li>
<li>Type "cave" in the start bar and hit enter</li>
</ul>
<h3 id="method-2-linux-virtual-machine">Method 2: Linux Virtual Machine<a class="headerlink" href="#method-2-linux-virtual-machine" title="Permanent link"></a></h3>
<p>This is an additional installation method, however at this time, some CAVE functionality may be missing (ex: rendering RGB satellite images).</p>
<h4 id="system-requirements_1">System Requirements<a class="headerlink" href="#system-requirements_1" title="Permanent link"></a></h4>
<ul>
<li><a href="https://www.vmware.com/products/workstation-player/workstation-player-evaluation.html">VMWare Workstation Player</a> must be installed (free software):</li>
<li>
<p>For high definition monitors (4k), you will want to enable the high DPI setting for VMWare Workstation Player</p>
<ol>
<li>Create a desktop shortcut for VMWare Workstation Player</li>
<li>Right-click the shortcut and select Properties</li>
<li>Open the Compatability Tab</li>
<li>Select the "Change high DPI settings" button</li>
<li>Check the "High DPI scaling ovveride" checkbox and choose "Application" in the enabled dropdown</li>
</ol>
<p><img alt="VMWare Workstation Player DPI Setting" src="../../images/vmwareplayer-update-dpi.png" /></p>
</li>
</ul>
<h4 id="download-and-installation-instructions_2">Download and Installation Instructions<a class="headerlink" href="#download-and-installation-instructions_2" title="Permanent link"></a></h4>
<ol>
<li>Download the zipped file containing the virtual machine: <a href="https://downloads.unidata.ucar.edu/awips2/current/windows/unidata_cave.zip"><strong>unidata_cave.zip</strong> <i class="fa fa-download"></i></a></li>
<li>Unzip the folder by right-clicking and selecting "Extract All". All files will be extracted into a new folder.</li>
<li>Open VMWare Player and go to <strong>Player</strong> &gt; <strong>File...</strong> &gt; <strong>Open</strong> and locate the folder that was created from the downloaded zipped file. Select the file called <strong>"CentOS 7 - Unidata CAVE 18-2-1-6.vmx"</strong>.</li>
<li>Run this new VM option. If it asks if it's been moved or copied, select <strong>"I Copied It"</strong>.<ul>
<li>There will be a user in the Linux machine named "awips" and the password is "awips"</li>
<li>The root password is "unidataAWIPS" if ever needed</li>
</ul>
</li>
</ol>
<h4 id="run-cave_2">Run CAVE<a class="headerlink" href="#run-cave_2" title="Permanent link"></a></h4>
<p>Once inside the VM, to run CAVE either:</p>
<ul>
<li>Use the desktop icon </li>
<li>Use the terminal and type the command <code>cave</code></li>
<li>Find the application in the Linux Desktop menu: Applications &gt; Internet &gt; AWIPS CAVE</li>
</ul>
<hr />
<h2 id="macos">macOS <i class="fa fa-apple"></i><a class="headerlink" href="#macos" title="Permanent link"></a></h2>
<p><strong>Latest Version: 18.2.1-6</strong></p>
<h3 id="system-requirements_2">System Requirements<a class="headerlink" href="#system-requirements_2" title="Permanent link"></a></h3>
<div class="admonition error">
<p class="admonition-title">MacOS Monterey version 12.3 and above no longer supports Python2. This will cause several visualization aspects to fail in CAVE. If you update to MacOS 12.3 CAVE will not be fully functional. Please <a href="../install-cave-beta-v20/#macos">download and install our beta v20 of CAVE</a> for newer MacOS versions.</p>
</div>
<ul>
<li>Will need admin privileges to install <code>awips-python.pkg</code></li>
<li>
<p>NVIDIA Graphics card is recommended, however some Intel Graphics cards will support a majority of the functionality</p>
<div class="admonition warning">
<p class="admonition-title">Most AMD graphics cards are not supported</p>
</div>
</li>
</ul>
<h3 id="download-and-installation-instructions_3">Download and Installation Instructions<a class="headerlink" href="#download-and-installation-instructions_3" title="Permanent link"></a></h3>
<ol>
<li>
<p>Download and install: <a href="https://downloads.unidata.ucar.edu/awips2/current/mac/awips-python.pkg"><strong>awips-python.pkg</strong> <i class="fa fa-download"></i></a> <em>(This step requires administrative privileges)</em></p>
<ul>
<li>Once downloaded, double click and the installer will launch with the following screens, <strong>please keep the default selections</strong>:</li>
</ul>
<p><img alt="mac pkg install 1" src="../../images/mac-pkg-install1.png" />
<img alt="mac pkg install 2" src="../../images/mac-pkg-install2.png" />
<img alt="mac pkg install 3" src="../../images/mac-pkg-install3.png" /></p>
<div class="admonition warning">
<p class="admonition-title">Between these steps it will prompt for an administrator's password</p>
</div>
<p><img alt="mac pkg install 4" src="../../images/mac-pkg-install4.png" /></p>
<div class="admonition note">
<p class="admonition-title">The awips-python.pkg is not necessarily required, and CAVE will still run without it, but any derived data such as barbs, arrows, and various grid products will not render without having <strong>jep</strong> installed (it is assumed to be in /Library/Python/2.7/site-packages/jep/)</p>
</div>
</li>
<li>
<p>Download and install: <a href="https://downloads.unidata.ucar.edu/awips2/current/mac/awips-cave.dmg"><strong>awips-cave.dmg</strong> <i class="fa fa-download"></i></a></p>
<ul>
<li>
<p>Either use the default location, which is in the system-wide "Applications" directory, by clicking and dragging the CAVE icon into the Applications folder, in the window that pops up when installing:</p>
<p><img alt="Cave System Install" src="../../images/mac-install.png" /></p>
</li>
<li>
<p>Or open a new Finder window to your [user home]/Applications/ directory (if it doesn't exist, simply create a new folder with the name "Applications"), and drag the CAVE icon into that folder:
<img alt="Cave User Install" src="../../images/caveMacUserInstall.png" /></p>
</li>
<li>This will install CAVE as an application and set the local cache to <code>~/Library/caveData</code></li>
</ul>
</li>
</ol>
<h3 id="run-cave_3">Run CAVE<a class="headerlink" href="#run-cave_3" title="Permanent link"></a></h3>
<p>To run CAVE either:</p>
<ul>
<li>Use the System Menu Go &gt; Applications &gt; CAVE</li>
<li>Type &#8984; + Spacebar and then type "cave", the application should appear and you can hit <strong>enter</strong> to run it</li>
</ul>
<div class="admonition note">
<p class="admonition-title">The first time CAVE is opened, it will ask you if you are sure you want to run it, because it was downloaded from the internet and not the Apple Store. This is normal, and hit Open. Your message my differ slightly but should look like the image below:</p>
</div>
<p><img alt="internet warning" src="../../images/mac-cave-internet-download.png" /></p>
<h3 id="macos-monterey-warning">MacOS Monterey Warning<a class="headerlink" href="#macos-monterey-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>This message can be ignored, and will hopefully go away when we release version 20+ of AWIPS.</p>
<hr />
<h2 id="edex-connection">EDEX Connection<a class="headerlink" href="#edex-connection" title="Permanent link"></a></h2>
<p>Unidata and XSEDE Jetstream have partnered to offer a EDEX data server in the cloud, open to the Unidata university community. Select the server in the Connectivity Preferences dialog, or enter <strong>edex-cloud.unidata.ucar.edu</strong> (without <em>http://</em> before, or <em>:9581/services</em> after).</p>
<p><img alt="EDEX in the cloud" src="../../images/boEbFSf28t.gif" /></p>
<hr />
<h2 id="local-cache">Local Cache<a class="headerlink" href="#local-cache" title="Permanent link"></a></h2>
<p>After connecting to an EDEX server, you will have a local directory named <strong>caveData</strong> which contains files synced from EDEX as well as a client-side cache for data and map resources.</p>
<p>You can reset CAVE by removing the <strong>caveData</strong> directory and reconnecting to an EDEX server. Your local files have been removed, but if you are re-connecting to an EDEX server you have used before, the remote files will sync again to your local <strong>~/caveData</strong> (bundles, colormaps, etc.).</p>
<ul>
<li>Linux: <code>/home/&lt;user&gt;/caveData/</code></li>
<li>macOS: <code>/Users/&lt;user&gt;/Library/caveData/</code></li>
<li>Windows: <code>C:\Users\&lt;user&gt;\caveData\</code></li>
</ul>
<hr />
<h2 id="uninstalling-cave-linux">Uninstalling CAVE (Linux)<a class="headerlink" href="#uninstalling-cave-linux" title="Permanent link"></a></h2>
<p>These are instructions to manually uninstall CAVE. However, the <a href="#download-and-installation-instructions"><code>awips_install.sh</code></a> script will do these steps for you if you are installing a newer version of CAVE.</p>
<p><strong>1. Make sure you have exited out of any CAVE sessions</strong></p>
<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>
<p><strong>2. Remove currently installed CAVE</strong></p>
<pre><code>sudo yum clean all
sudo yum groupremove &quot;AWIPS CAVE&quot;
</code></pre>
<div class="admonition note">
<p class="admonition-title">If you are having trouble removing a group, see the <a href="../../appendix/common-problems/#troubleshooting-uninstalling-edex">troubleshooting</a> section.</p>
</div>
<p><strong>3. Check to make sure all awips rpms have been removed</strong></p>
<pre><code>rpm -qa | grep awips2
</code></pre>
<p>If you still have rpms installed, remove them</p>
<pre><code>sudo yum remove awips2-*
</code></pre>
<p><strong>4. Remove the cave directory in /awips2 and caveData from your home directory</strong></p>
<pre><code>rm -rf /awips2/cave
rm -rf ~/caveData
</code></pre>
</article>
</div>
</div>
</main>
<footer class="md-footer">
<div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid">
<a href="" title="Home" 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>
Home
</span>
</div>
</a>
<a href="install/install-edex/" title="Install EDEX" 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>
Install EDEX
</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; 2022 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>