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" >
2020-12-09 16:55:48 +00:00
< a href = "#method-1-linux-virtual-machine" title = "Method 1: Linux Virtual Machine" class = "md-nav__link" >
Method 1: Linux Virtual Machine
2020-11-17 22:09:13 +00:00
< / 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" >
2020-12-09 16:55:48 +00:00
< a href = "#method-1-linux-virtual-machine" title = "Method 1: Linux Virtual Machine" class = "md-nav__link" >
Method 1: Linux Virtual Machine
2020-11-17 22:09:13 +00:00
< / 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-12-09 16:55:48 +00:00
< li > Java 1.8< / 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 >
2020-12-09 16:55:48 +00:00
< li > NVIDIA Graphics Card< / li >
2020-11-17 22:09:13 +00:00
< li > < a href = "http://www.nvidia.com/Download/index.aspx?lang=en-us" > Latest NVIDIA Driver< / a > < blockquote >
2020-12-09 16:55:48 +00:00
< p > Note: While other graphics cards < em > may< / em > work, NVIDIA Quadro graphics card is recommended for full visualization capability< / p >
2020-11-17 22:09:13 +00:00
< / 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 >
2020-12-09 16:55:48 +00:00
< 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 >
< blockquote >
< p > Note: At the moment, the VM option may not render all products in CAVE (ex. RGB composites of satellite imagery)< / p >
< / blockquote >
< 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 >
2020-11-17 22:09:13 +00:00
< 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 >
2020-12-09 16:55:48 +00:00
< p > Once inside the VM, to run CAVE either:< / p >
2020-11-17 22:09:13 +00:00
< 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 >
2020-12-09 16:55:48 +00:00
< 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. < / p >
2020-11-17 22:09:13 +00:00
< h4 id = "system-requirements_2" > System Requirements< a class = "headerlink" href = "#system-requirements_2" title = "Permanent link" > < / a > < / h4 >
< ul >
2020-12-09 16:55:48 +00:00
< li > 64-bit Miniconda3 (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 Update 3 (14.1)< / 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 >
2020-11-17 22:09:13 +00:00
< / 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 >
2020-12-09 16:55:48 +00:00
< li > Download and install 64-bit < a href = "https://repo.anaconda.com/miniconda/Miniconda3-py37_4.8.2-Windows-x86_64.exe" > Miniconda Python 4.8.2 for Windows< / a > < ul >
2020-11-17 22:09:13 +00:00
< li > Allow Miniconda3 to set < strong > PATH< / strong > and other environment variables< / li >
2020-12-09 16:55:48 +00:00
< li > Register miniconda as the default python< / 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)< / li >
< / ul >
< / li >
< li > Set the environment variables:< 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 > User Variables: < strong > PYTHONPATH< / strong > and < strong > PYTHONHOME< / strong > < / li >
< li > System Variable: < strong > JAVA_HOME< / strong >
< img alt = "Env Vars" src = "../../images/envVars.png" / > < blockquote >
2020-11-17 22:09:13 +00:00
< p > Note: If PYTHONHOME is not set, the < strong > gridslice< / strong > Python module will not be installed or available< / p >
< / blockquote >
< / li >
< / ul >
< / li >
2020-12-09 16:55:48 +00:00
< li > < a href = "https://my.visualstudio.com/Downloads?q=visual%20studio%202015&wt.mc_id=o~msft~vscom~older-downloads" > Download and install 64-bit Microsoft Visual Studio C++ Build Tools< / a > < ul >
2020-11-17 22:09:13 +00:00
< 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 >
2020-12-09 16:55:48 +00:00
< li > Download 64-bit < strong > Visual C++ Build Tools 2015 Update 3< / strong > < / li >
< li > When running the installer, choose the < strong > Default< / strong > Installation< / li >
2020-11-17 22:09:13 +00:00
< / ul >
< / li >
< li > Install dependent Python packages< ul >
2020-12-09 16:55:48 +00:00
< li > Open a terminal by typing "cmd" into the start bar and hitting enter< / li >
< li > Run the following command: < code > pip install numpy==1.15.1 jep=3.8.2< / code > < / li >
2020-11-17 22:09:13 +00:00
< / 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 >
2020-12-09 16:55:48 +00:00
< 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 >
2020-11-17 22:09:13 +00:00
< 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 >
