1521 lines
No EOL
46 KiB
HTML
1521 lines
No EOL
46 KiB
HTML
|
|
<!DOCTYPE html>
|
|
<html class="no-js">
|
|
<head>
|
|
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
|
|
<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-0.17.5, mkdocs-unidata-1.5.4">
|
|
|
|
|
|
|
|
<title>Install CAVE - Unidata AWIPS User Manual</title>
|
|
|
|
|
|
|
|
<script src="../../assets/javascripts/modernizr-56ade86843.js"></script>
|
|
|
|
|
|
<link rel="stylesheet" href="../../assets/stylesheets/application-b1a1975878.css">
|
|
|
|
<link rel="stylesheet" href="../../assets/stylesheets/application-f78e5cb881.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">
|
|
<nav class="md-header-nav md-grid">
|
|
|
|
<a href="../.."><div class="background-logo" style="background-image: url(../../images/cave.png);"></div>
|
|
|
|
<div class="md-flex">
|
|
<div class="md-flex__cell md-flex__cell--shrink">
|
|
|
|
<a href="../.." title="Unidata AWIPS User Manual" class="md-icon md-icon--home md-header-nav__button">
|
|
</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"></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">
|
|
<div class="md-nav__button md-logo">
|
|
|
|
<i class="md-icon md-icon--home"></i>
|
|
|
|
</div>
|
|
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-linux-virtual-machine" title="Method 1: Linux Virtual Machine" class="md-nav__link">
|
|
Method 1: 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_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-direct-windows-install" title="Method 2: Direct Windows Install" class="md-nav__link">
|
|
Method 2: Direct Windows Install
|
|
</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_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_3" 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>
|
|
|
|
</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="../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="../../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-9" type="checkbox" id="nav-9">
|
|
|
|
<label class="md-nav__link" for="nav-9">
|
|
Appendix
|
|
</label>
|
|
<nav class="md-nav" data-md-component="collapsible" data-md-level="1">
|
|
<label class="md-nav__title" for="nav-9">
|
|
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-linux-virtual-machine" title="Method 1: Linux Virtual Machine" class="md-nav__link">
|
|
Method 1: 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_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-direct-windows-install" title="Method 2: Direct Windows Install" class="md-nav__link">
|
|
Method 2: Direct Windows Install
|
|
</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_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_3" 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>
|
|
|
|
</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">edit</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 priviledges 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><strong>Linux: 18.2.1-1</strong></li>
|
|
<li><strong>Windows: 18.2.1-1</strong></li>
|
|
<li><strong>Mac: 18.2.1-2</strong></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="../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-1</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>
|
|
</ul>
|
|
<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://www.unidata.ucar.edu/software/awips2/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 > Internet > AWIPS CAVE</li>
|
|
</ul>
|
|
<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-1</strong></p>
|
|
<p>For Windows, Unidata offers two installation options: a <a href="#method-1-linux-virtual-machine"><strong>Linux Virtual Machine</strong></a>, or a <a href="#method-2-direct-windows-install"><strong>Direct Windows Installation</strong></a>.</p>
|
|
<p>Currently, the <a href="#method-1-linux-virtual-machine">virtual machine (VM)</a> is the recommended form of install for those who do not have administrative priviledges on the machine, or beginners who want a simpler installation process. </p>
|
|
<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>
|
|
<p>The <a href="#method-2-direct-windows-install">direct installation method</a> is recommended for those who have administrative priviledges and a little bit of experience installing more software.</p>
|
|
<h3 id="method-1-linux-virtual-machine">Method 1: Linux Virtual Machine<a class="headerlink" href="#method-1-linux-virtual-machine" title="Permanent link"></a></h3>
|
|
<p>This method is recommended for beginners, or those with less computer knowledge as it is a very simple installation, 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>
|
|
</ul>
|
|
<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 the zipped file containing the virtual machine: <a href="https://www.unidata.ucar.edu/downloads/awips2/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> > <strong>File...</strong> > <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-1-1.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_1">Run CAVE<a class="headerlink" href="#run-cave_1" 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 > Internet > AWIPS CAVE</li>
|
|
</ul>
|
|
<h3 id="method-2-direct-windows-install">Method 2: Direct Windows Install<a class="headerlink" href="#method-2-direct-windows-install" title="Permanent link"></a></h3>
|
|
<p>This method is recommended for personal use and requires Administrative priviledges. It should enable full CAVE capability, but it is a bit lengthy and might take about 20 minutes or so to complete.<br />
|
|
For additional assistance we have created an <a href="https://youtu.be/QAuBSsSp9Ak"><strong>installation video</strong></a> that walks through the steps below.</p>
|
|
<div class="admonition note">
|
|
<p class="admonition-title">It is important to use the exact versions of software that we link to or specify in our instructions. Deviations may cause installation problems or failures.</p>
|
|
</div>
|
|
<h4 id="system-requirements_2">System Requirements<a class="headerlink" href="#system-requirements_2" title="Permanent link"></a></h4>
|
|
<ul>
|
|
<li>64-bit Miniconda3 (Python3.7 - 4.8.2)</li>
|
|
<li>Python3 (comes with Miniconda installation)</li>
|
|
<li>64-bit Java JDK 1.8 (1.8_181)</li>
|
|
<li>64-bit Visual C++ Build Tools 2015 and 2019</li>
|
|
<li>Numpy (1.15.1)</li>
|
|
<li>Jep (3.8.2)</li>
|
|
<li>User Variable PATH must have miniconda3 location</li>
|
|
<li>User Variables PYTHONHOME and PYTHONPATH must be defined</li>
|
|
<li>System Variable JAVA_HOME must be defined</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 and install 64-bit <a href="https://repo.anaconda.com/miniconda/Miniconda3-py37_4.8.2-Windows-x86_64.exe">Miniconda Python3.7 version 4.8.2 for Windows</a><ul>
|
|
<li><strong>Allow</strong> Miniconda3 to set <strong>PATH</strong> and other environment variables</li>
|
|
<li><strong>Register</strong> miniconda as the default python
|
|
<img alt="Miniconda options" src="../../images/minicondaOptions.png" /></li>
|
|
</ul>
|
|
</li>
|
|
<li>Download and install the 64-bit <a href="https://www.unidata.ucar.edu/downloads/awips2/jdk-8u181-windows-x64.exe">Java JDK 1.8_181</a> (this is necessary so Jep can install properly).<ul>
|
|
<li>Select <strong>Development Tools</strong> as the installation options</li>
|
|
<li>Make note of where it installs on your computer (the default is C:\ProgramFiles\Java\jdk1.8.0_181)</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p>Set the environment variables:</p>
|
|
<ul>
|
|
<li>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</li>
|
|
<li>Create the variables in their respective locations using the <strong>New...</strong> buttons</li>
|
|
<li>User Variables: <strong>PYTHONPATH</strong> and <strong>PYTHONHOME</strong></li>
|
|
<li>
|
|
<p>System Variable: <strong>JAVA_HOME</strong>
|
|
<img alt="Env Vars" src="../../images/envVars.png" /></p>
|
|
<div class="admonition warning">
|
|
<p class="admonition-title">If PYTHONHOME is not set, the <strong>gridslice</strong> Python module will not be installed or available</p>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><a href="https://my.visualstudio.com/Downloads?q=Build%20Tools%20for%20Visual%20Studio%202019%20%28version%2016.9%29&pgroup=">Download and install 64-bit Microsoft Visual Studio C++ Build Tools</a></p>
|
|
<ul>
|
|
<li>To access the page linked above you will need a Microsoft account</li>
|
|
<li>Download the executable for <strong>Build Tools for Visual Studio 2019 (version 16.9)</strong></li>
|
|
<li>Allow it to run some pre-installations</li>
|
|
<li>The installer will pop up as shown below. Make sure to select the <strong>C++ build tools</strong> (upper left), and then view the <strong>Installation details</strong> on the right</li>
|
|
<li>Scroll down and check the <strong>MSVC v140 - VS 2015 C++ build tools</strong>
|
|
<img alt="buildToolsInstall" src="../../images/buildToolsInstall.png" /></li>
|
|
</ul>
|
|
</li>
|
|
<li>Install dependent Python packages<ul>
|
|
<li>Once the installer has finished, close the installer. Another window is present and there is an option to <strong>launch</strong> a command terminal
|
|
<img alt="launch terminal" src="../../images/buildToolsLaunchTerm.png" /></li>
|
|
<li>Click that and run the following:<ul>
|
|
<li><code>pip install numpy==1.15.1</code></li>
|
|
<li><code>pip install jep==3.8.2</code></li>
|
|
</ul>
|
|
<div class="admonition note">
|
|
<p class="admonition-title">These must be run as two separate commands, as stated above for all derived parameters to display properly.</p>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>Download and install: <a href="https://www.unidata.ucar.edu/downloads/awips2/awips-cave.msi"><strong>awips-cave.msi</strong> <i class="fa fa-download"></i></a><ul>
|
|
<li>In addition to the application directory, the MSI installer will attempt to copy the <a href="https://github.com/Unidata/gridslice"><em>gridslice</em></a> shared library to <code>$PYTHONHOME/Dlls/</code>. If the <code>$PYTHONHOME</code> environmental variable is not defined <em>gridslice</em> will not be installed. You can check to see if it was installed in the Dlls directory after you have completed steps 1-3.</li>
|
|
</ul>
|
|
<div class="admonition note">
|
|
<p class="admonition-title">CAVE will still run without gridslice, but certain bundles which use derived parameters, such as <a href="../../images/screenCapture-2016.04.04.13.41.26-20160404_000000.png"><strong>isentropic analysis</strong></a>, will not load.</p>
|
|
</div>
|
|
</li>
|
|
</ol>
|
|
<h4 id="run-cave_2">Run CAVE<a class="headerlink" href="#run-cave_2" title="Permanent link"></a></h4>
|
|
<p>To run CAVE, either:</p>
|
|
<ul>
|
|
<li>Type "cave" in the start bar and hit enter</li>
|
|
<li>Find and run CAVE app in the file browser: C:\Program Files\Unidata\AWIPS CAVE\cave.exe</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-2</strong></p>
|
|
<h3 id="system-requirements_3">System Requirements<a class="headerlink" href="#system-requirements_3" title="Permanent link"></a></h3>
|
|
<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://www.unidata.ucar.edu/downloads/awips2/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://www.unidata.ucar.edu/downloads/awips2/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 > Applications > CAVE</li>
|
|
<li>Type ⌘ + 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>
|
|
<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/<user>/caveData/</code></li>
|
|
<li>macOS: <code>/Users/<user>/Library/caveData/</code></li>
|
|
<li>Windows: <code>C:\Users\<user>\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>
|
|
<p><strong>2. Remove currently installed CAVE</strong></p>
|
|
<pre><code>sudo yum clean all
|
|
sudo yum groupremove "AWIPS CAVE"
|
|
</code></pre>
|
|
<div class="admonition note">
|
|
<p class="admonition-title">If you are having trouble removing a group, see the <a href="../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-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 © 2020 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-0b7df094bf.js"></script>
|
|
<script>app.initialize({url:{base:"../.."}})</script>
|
|
|
|
<script src="../../assets/javascripts/application-0b7df094bf.js"></script>
|
|
|
|
|
|
|
|
|
|
|
|
</body>
|
|
</html> |