2017-07-07 17:54:00 -07:00
<!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/" >
2020-06-04 22:53:23 +00:00
< meta name = "author" content = "support-awips@unidata.ucar.edu" >
2017-07-07 17:54:00 -07:00
< link rel = "shortcut icon" href = "../../images/favicon.ico" >
2018-09-19 13:52:37 -07:00
< meta name = "generator" content = "mkdocs-0.17.5, mkdocs-unidata-1.5.4" >
2017-07-07 17:54:00 -07:00
< 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" >
2017-09-26 20:27:20 -07:00
Install CAVE
2017-07-07 17:54:00 -07:00
< / 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 >
2017-09-27 11:24:37 -07:00
< div class = "md-search" data-md-component = "search" role = "dialog" >
< label class = "md-search__overlay" for = "search" > < / label >
2017-07-07 17:54:00 -07:00
< div class = "md-search__inner" >
< form class = "md-search__form" name = "search" >
2017-09-27 11:24:37 -07:00
< input type = "text" class = "md-search__input" name = "query" required placeholder = "Search" autocapitalize = "off" autocorrect = "off" autocomplete = "off" spellcheck = "false" data-md-component = "query" >
2017-07-07 17:54:00 -07:00
< label class = "md-icon md-search__icon" for = "search" > < / label >
2017-09-27 11:24:37 -07:00
< button type = "reset" class = "md-icon md-search__icon" data-md-component = "reset" >  < / button >
2017-07-07 17:54:00 -07:00
< / form >
< div class = "md-search__output" >
< div class = "md-search__scrollwrap" data-md-scrollfix >
2017-09-27 11:24:37 -07:00
< div class = "md-search-result" data-md-component = "result" data-md-lang-search = "" data-md-lang-tokenizer = "[\s\-]+" >
2017-07-07 17:54:00 -07:00
< 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" >
2018-09-19 13:52:37 -07:00
< a href = "https://github.com/Unidata/awips2/" title = "Go to repository" class = "md-source" data-md-source = "github" >
2017-07-07 17:54:00 -07:00
< 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" >
2017-09-27 11:24:37 -07:00
< div class = "md-nav__button md-logo" >
< i class = "md-icon md-icon--home" > < / i >
< / div >
2017-07-07 17:54:00 -07:00
Unidata AWIPS User Manual
< / label >
< div class = "md-nav__source" >
2018-09-19 13:52:37 -07:00
< a href = "https://github.com/Unidata/awips2/" title = "Go to repository" class = "md-source" data-md-source = "github" >
2017-07-07 17:54:00 -07:00
< 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" >
2020-06-22 22:19:47 +00:00
2017-07-07 17:54:00 -07:00
< 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" >
2020-06-22 22:19:47 +00:00
2017-07-07 17:54:00 -07:00
< label class = "md-nav__title" for = "toc" > Table of contents< / label >
< ul class = "md-nav__list" data-md-scrollfix >
< li class = "md-nav__item" >
2020-11-17 22:09:13 +00:00
< a href = "#general-requirements" title = "General Requirements" class = "md-nav__link" >
General Requirements
2017-07-07 17:54:00 -07:00
< / a >
2018-09-19 21:27:59 -07:00
< / li >
< li class = "md-nav__item" >
2020-11-17 22:09:13 +00:00
< 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
2018-09-19 13:52:37 -07:00
< / a >
2020-11-17 22:09:13 +00:00
< / 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 >
< / ul >
< / nav >
2018-09-19 13:52:37 -07:00
< / li >
2018-09-19 21:27:59 -07:00
< li class = "md-nav__item" >
2020-11-17 22:09:13 +00:00
< 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-recommended" title = "Method 1: Linux Virtual Machine (Recommended)" class = "md-nav__link" >
Method 1: Linux Virtual Machine (Recommended)
< / 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
2018-09-19 21:27:59 -07:00
< / a >
2020-11-17 22:09:13 +00:00
< / 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 >
< / ul >
< / nav >
< / li >
< / ul >
< / nav >
2018-09-19 21:27:59 -07:00
< / li >
< li class = "md-nav__item" >
2020-11-17 22:09:13 +00:00
< 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
2018-09-19 21:27:59 -07:00
< / a >
2018-09-19 13:52:37 -07:00
2020-11-17 22:09:13 +00:00
< / 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 >
< / ul >
< / nav >
2017-07-07 17:54:00 -07:00
< / li >
< li class = "md-nav__item" >
2020-11-17 22:09:13 +00:00
< a href = "#edex-connection" title = "EDEX Connection" class = "md-nav__link" >
EDEX Connection
2017-07-07 17:54:00 -07:00
< / a >
< / li >
< li class = "md-nav__item" >
2020-11-17 22:09:13 +00:00
< a href = "#local-cache" title = "Local Cache" class = "md-nav__link" >
Local Cache
2017-07-07 17:54:00 -07:00
< / 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 >
2020-06-22 22:13:20 +00:00
< li class = "md-nav__item" >
< a href = "../common-problems/" title = "Common Problems" class = "md-nav__link" >
Common Problems
< / a >
< / li >
2017-07-07 17:54:00 -07:00
< li class = "md-nav__item md-nav__item--nested" >
2020-06-22 22:13:20 +00:00
< input class = "md-toggle md-nav__toggle" data-md-toggle = "nav-5" type = "checkbox" id = "nav-5" >
2017-07-07 17:54:00 -07:00
2020-06-22 22:13:20 +00:00
< label class = "md-nav__link" for = "nav-5" >
2017-07-07 17:54:00 -07:00
CAVE User Manual
< / label >
< nav class = "md-nav" data-md-component = "collapsible" data-md-level = "1" >
2020-06-22 22:13:20 +00:00
< label class = "md-nav__title" for = "nav-5" >
2017-07-07 17:54:00 -07:00
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 = "Bundles and Procedures" class = "md-nav__link" >
Bundles 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" >
2019-03-21 14:54:16 -07:00
< a href = "../../cave/goes-16-satellite/" title = "GOES 16/17" class = "md-nav__link" >
GOES 16/17
2017-07-07 17:54:00 -07:00
< / 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 >
2018-08-03 11:47:52 -07:00
< li class = "md-nav__item" >
< a href = "../../cave/import-export/" title = "Import/Export" class = "md-nav__link" >
Import/Export
< / a >
< / li >
2017-07-07 17:54:00 -07:00
< / ul >
< / nav >
< / li >
< li class = "md-nav__item md-nav__item--nested" >
2020-06-22 22:13:20 +00:00
< input class = "md-toggle md-nav__toggle" data-md-toggle = "nav-6" type = "checkbox" id = "nav-6" >
2017-07-07 17:54:00 -07:00
2020-06-22 22:13:20 +00:00
< label class = "md-nav__link" for = "nav-6" >
2017-07-07 17:54:00 -07:00
EDEX User Manual
< / label >
< nav class = "md-nav" data-md-component = "collapsible" data-md-level = "1" >
2020-06-22 22:13:20 +00:00
< label class = "md-nav__title" for = "nav-6" >
2017-07-07 17:54:00 -07:00
EDEX User Manual
< / label >
< ul class = "md-nav__list" data-md-scrollfix >
2017-09-26 20:27:20 -07:00
< li class = "md-nav__item" >
2020-06-30 20:45:56 +00:00
< a href = "../start-edex/" title = "EDEX Basic Commands" class = "md-nav__link" >
EDEX Basic Commands
2017-09-26 20:27:20 -07:00
< / a >
< / li >
2017-07-07 17:54:00 -07:00
< li class = "md-nav__item" >
2018-08-03 11:47:52 -07:00
< 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
2017-07-07 17:54:00 -07:00
< / a >
< / li >
2018-09-28 09:12:06 -07:00
< li class = "md-nav__item" >
< a href = "../../edex/edex-ingest-docker-container/" title = "Docker EDEX" class = "md-nav__link" >
Docker EDEX
< / a >
< / li >
2017-07-07 17:54:00 -07:00
< 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 >
2017-10-25 12:51:10 -07:00
< li class = "md-nav__item" >
< a href = "../../edex/case-studies/" title = "Archive Case Studies" class = "md-nav__link" >
Archive Case Studies
< / a >
< / li >
2017-07-07 17:54:00 -07:00
< / ul >
< / nav >
< / li >
< li class = "md-nav__item" >
2020-07-28 20:39:11 +00:00
< a href = "../../dev/awips-development-environment/" title = "Development" class = "md-nav__link" >
Development
2017-07-07 17:54:00 -07:00
< / a >
< / li >
2017-08-14 10:18:50 -07:00
< li class = "md-nav__item" >
2020-07-23 17:29:38 +00:00
< a href = "../../python/overview/" title = "Python API" class = "md-nav__link" >
Python API
2017-08-14 10:18:50 -07:00
< / a >
< / li >
2017-07-07 17:54:00 -07:00
< li class = "md-nav__item md-nav__item--nested" >
2020-07-28 20:39:11 +00:00
< input class = "md-toggle md-nav__toggle" data-md-toggle = "nav-9" type = "checkbox" id = "nav-9" >
2017-07-07 17:54:00 -07:00
2020-07-28 20:39:11 +00:00
< label class = "md-nav__link" for = "nav-9" >
2017-07-07 17:54:00 -07:00
Appendix
< / label >
< nav class = "md-nav" data-md-component = "collapsible" data-md-level = "1" >
2020-07-28 20:39:11 +00:00
< label class = "md-nav__title" for = "nav-9" >
2017-07-07 17:54:00 -07:00
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 >
2019-02-06 10:17:32 -07:00
< li class = "md-nav__item" >
< a href = "../../python/maps-database/" title = "Maps Database" class = "md-nav__link" >
Maps Database
< / a >
< / li >
2017-07-07 17:54:00 -07:00
< 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 >
< / 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" >
2020-06-22 22:19:47 +00:00
2017-07-07 17:54:00 -07:00
< label class = "md-nav__title" for = "toc" > Table of contents< / label >
< ul class = "md-nav__list" data-md-scrollfix >
< li class = "md-nav__item" >
2020-11-17 22:09:13 +00:00
< a href = "#general-requirements" title = "General Requirements" class = "md-nav__link" >
General Requirements
2017-07-07 17:54:00 -07:00
< / a >
2018-09-19 21:27:59 -07:00
< / li >
< li class = "md-nav__item" >
2020-11-17 22:09:13 +00:00
< 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
2018-09-19 13:52:37 -07:00
< / a >
2020-11-17 22:09:13 +00:00
< / 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 >
< / ul >
< / nav >
2018-09-19 13:52:37 -07:00
< / li >
2018-09-19 21:27:59 -07:00
< li class = "md-nav__item" >
2020-11-17 22:09:13 +00:00
< 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-recommended" title = "Method 1: Linux Virtual Machine (Recommended)" class = "md-nav__link" >
Method 1: Linux Virtual Machine (Recommended)
< / 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
2018-09-19 21:27:59 -07:00
< / a >
2020-11-17 22:09:13 +00:00
< / 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 >
< / ul >
< / nav >
< / li >
< / ul >
< / nav >
2018-09-19 21:27:59 -07:00
< / li >
< li class = "md-nav__item" >
2020-11-17 22:09:13 +00:00
< 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
2018-09-19 21:27:59 -07:00
< / a >
2018-09-19 13:52:37 -07:00
2020-11-17 22:09:13 +00:00
< / 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 >
< / ul >
< / nav >
2017-07-07 17:54:00 -07:00
< / li >
< li class = "md-nav__item" >
2020-11-17 22:09:13 +00:00
< a href = "#edex-connection" title = "EDEX Connection" class = "md-nav__link" >
EDEX Connection
2017-07-07 17:54:00 -07:00
< / a >
< / li >
< li class = "md-nav__item" >
2020-11-17 22:09:13 +00:00
< a href = "#local-cache" title = "Local Cache" class = "md-nav__link" >
Local Cache
2017-07-07 17:54:00 -07:00
< / a >
< / li >
< / ul >
< / nav >
< / div >
< / div >
< / div >
< div class = "md-content" >
< article class = "md-content__inner md-typeset" >
2018-07-30 11:05:17 -07:00
< a href = "https://github.com/Unidata/awips2/edit/unidata_18.1.1/docs/install/install-cave.md" title = "Edit this page" class = "md-icon md-content__icon" > edit< / a >
2017-07-07 17:54:00 -07:00
2020-06-22 22:19:47 +00:00
< h1 id = "install-cave" > Install CAVE< a class = "headerlink" href = "#install-cave" title = "Permanent link" > < / a > < / h1 >
2020-11-17 22:09:13 +00:00
< 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 = "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 >
2020-11-18 16:35:24 +00:00
< li > Java< / li >
2020-11-17 22:09:13 +00:00
< li > OpenGL 2.0 Compatible Devices< / li >
< li > At least 4GB RAM< / li >
< li > At least 2GB Disk Space for Caching< / li >
< li > < a href = "http://www.nvidia.com/Download/index.aspx?lang=en-us" > Latest NVIDIA Driver< / a > < blockquote >
< p > Note: NVIDIA Quadro graphics card is recommended for full visualization capability< / p >
< / blockquote >
< / li >
< / ul >
< hr / >
< h2 id = "linux" > Linux < i class = "fa fa-linux" > < / i > < a class = "headerlink" href = "#linux" title = "Permanent link" > < / a > < / h2 >
< 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 >
2020-11-18 19:19:52 +00:00
< li > In a terminal, go to the download directory < / li >
2020-11-17 22:09:13 +00:00
< 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 >
< 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 > For Windows, Unidata offers two installation options: a < a href = "#method-1-linux-virtual-machine-recommended" > < strong > Linux Virtual Machine< / strong > < / a > , or a < a href = "#method-2-direct-windows-install" > < strong > Direct Windows Installation< / strong > < / a > . Currently, the virtual machine is the recommended form of install. The direct installation can work, but currently we do not have complete instructions on how to get < strong > jep< / strong > (which is a python package) running properly with CAVE. Because of this, CAVE will install just fine, but certain data products will not render in the application. The direct install also requires several system modifications and will require administrator priviledges. We are in the process of producing a working set of instructions for the direct install, but as of now just have old instructions, which likely will not have jep working properly.< / p >
< h3 id = "method-1-linux-virtual-machine-recommended" > Method 1: Linux Virtual Machine (Recommended)< a class = "headerlink" href = "#method-1-linux-virtual-machine-recommended" title = "Permanent link" > < / a > < / h3 >
< 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"< / strong > .< / li >
< li > Run this new VM option. If it asks if it's been moved or copied, select < strong > copied< / 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 >
< p > 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 >
< h4 id = "system-requirements_2" > System Requirements< a class = "headerlink" href = "#system-requirements_2" title = "Permanent link" > < / a > < / h4 >
< ul >
< li > Miniconda3< / li >
< li > Python< / li >
< li > Numpy< / li >
< li > Jep< / li >
< li > PYTHONHOME must be defined< / li >
< li > JAVA_HOME must be defined< / li >
< li > Visual C++ Build Tools 2015 Update 3 (Version 14.1)< / li >
< / ul >
2020-11-18 19:19:52 +00:00
< div class = "admonition warning" >
< p class = "admonition-title" > < a href = "#download-and-installation-instructions_2" > Specific instructions< / a > are detailed for installing the above, but they still may not install jep properly< / p >
< / div >
2020-11-17 22:09:13 +00:00
< 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 < a href = "https://conda.io/miniconda.html" > Miniconda Python 3.7 for Windows< / a > < ul >
< li > Allow Miniconda3 to set < strong > PATH< / strong > and other environment variables< / li >
< li > Ensure that < strong > PYTHONHOME< / strong > is set to the Miniconda3 location
< img alt = "Environment Variables Screenshot" src = "../../images/windows_envvars.png" / > < blockquote >
< p > Note: If PYTHONHOME is not set, the < strong > gridslice< / strong > Python module will not be installed or available< / p >
< / blockquote >
< / li >
< / ul >
< / li >
< li > < a href = "https://my.visualstudio.com/Downloads?q=visual%20studio%202015&wt.mc_id=o~msft~vscom~older-downloads" > Download and install Microsoft Visual Studio C++ Build Tools< / a > < ul >
< li > To access the page linked above you will need a Microsoft account< / li >
< li > Once at that webpage, < strong > search for< / strong > < strong > < em > "build tools c+"< / em > < / strong > in order for the proper download to be returned< / li >
< li > Download < strong > Visual C++ Build Tools 2015 Update 3< / strong > < / li >
< / ul >
< / li >
< li > Install dependent Python packages< ul >
< li > < code > pip install numpy==1.15.1 jep=3.8.2< / code > < / 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.< blockquote >
< p > Note: 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 >
< / blockquote >
< / li >
< / ul >
< / li >
< / ol >
< hr / >
< h2 id = "macos" > macOS < i class = "fa fa-apple" > < / i > < a class = "headerlink" href = "#macos" title = "Permanent link" > < / a > < / h2 >
< h3 id = "system-requirements_3" > System Requirements< a class = "headerlink" href = "#system-requirements_3" title = "Permanent link" > < / a > < / h3 >
< ul >
< li > NVIDIA Graphics card is recommended, some Intel Graphics cards will working< / li >
< / ul >
< blockquote >
< p > Note: Most AMD graphics cards are not supported< / p >
< / blockquote >
< 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 > Download and install both: < a href = "https://www.unidata.ucar.edu/downloads/awips2/awips-cave.dmg" > < strong > awips-cave.dmg< / strong > < i class = "fa fa-download" > < / i > < / a > and < a href = "https://www.unidata.ucar.edu/downloads/awips2/awips-python.pkg" > < strong > awips-python.pkg< / strong > < i class = "fa fa-download" > < / i > < / a > < ul >
< li > This will install CAVE as an application and set the local cache to < code > ~/Library/caveData< / code > < / li >
< / ul >
< / li >
< / ol >
< blockquote >
< p > Note: 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 >
< / blockquote >
< 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 >
< 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 >
2017-07-07 17:54:00 -07:00
< p > < img alt = "EDEX in the cloud" src = "../../images/boEbFSf28t.gif" / > < / p >
< hr / >
2020-11-17 22:09:13 +00:00
< h2 id = "local-cache" > Local Cache< a class = "headerlink" href = "#local-cache" title = "Permanent link" > < / a > < / h2 >
2018-09-19 21:27:59 -07:00
< 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 >
2020-11-17 22:09:13 +00:00
< 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 >
2018-09-19 21:27:59 -07:00
< / ul >
2017-07-07 17:54:00 -07:00
< / 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" >
2020-06-04 22:53:23 +00:00
Copyright © 2020 Unidata Program Center.
2017-07-07 17:54:00 -07:00
< / 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" >
2018-02-15 12:27:30 -07:00
< a href = "https://www.unidata.ucar.edu/software/awips2" class = "md-footer-social__link fa fa-globe" > < / a >
2017-07-07 17:54:00 -07:00
< 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 >
2020-08-04 21:31:53 +00:00
< script src = "../../assets/javascripts/application-0b7df094bf.js" > < / script >
2017-07-07 17:54:00 -07:00
< / body >
2020-06-04 22:53:23 +00:00
< / html >
