9c8a3a1c86
- replaced all '> Note' notes with either '!!! note' or '!!! warning' as appropropriate, for more consitency on our website - updated steps 4 and 5 of the download and installation instructions for the direct windows download to include the new steps to use the new build tools installer to install the proper C++ build tools packages and then run the pip installs - added screenshots for clarity - added a new subsection in the common problems page titled "Products Not Loading Properly in Windows" and added some description, and a screenshot of the behavior when jep isn't installed properly - added a link back to our installation instructions telling them to redo steps 4 and 5
3.9 KiB
Common Problems
General Troubleshooting
Along with closing and restarting CAVE, one of the first things user's should turn to for resolving weird or unexpected behavior is flushing their local cache. The cache lives in a folder called caveData, so this process is also referred to as removing or deleting caveData.
Linux
For Linux users, the easiest way is to open a new terminal and run the following command:
rm -rf ~/caveData
Windows
For Windows users, simply delete the caveData folder in your home user directory:
Mac
For Mac users, the easiest way is to open a new terminal and run the following command:
rm -rf ~/Library/caveData
Remotely Connecting to CAVE
Since the pandemic began, many users have asked if they can use X11 forwarding or ssh tunneling to remotely connect to CAVE machines. This is not recommended or supported, and CAVE crashes in many different ways and expresses strange behavior as well.
We highly recommend you download the appropriate CAVE installer on your local machine, if that is an option.
If that is not an option, then the only remote access we recommend is using some type of VNC. RealVNC and nomachine are two options that are in use with positive outcomes. UltraVNC may be another option, but may have quite a delay. There may also be other free or paid software available that we are not aware of. !!! warning "It is likely that any VNC option you choose will also require some software or configuration to be set on the remote machine, and this will likely require administrative privileges."
Windows CAVE Start Up Error
One common error some users are seeing manifests itself just after selecting an EDEX server to connect to. The following error dialogs may show up:
These errors are actually happening because the Windows machine is using IPv6, which is not compatible with AWIPS at this time.
To fix the issue simply follow these steps:
Note
: These screenshots may vary from your system.
1. Close all error windows and any open windows associated with CAVE.
2. In the Windows 10 search field, search for "control panel".
3. Once in the Control Panel, look for "Network and Sharing Center".
4. Select the adapter for your current connection (should be either "Ethernet" or "Wi-Fi").
5. Click on "Properties".
6. Uncheck "Internet Protocol Version 6 (TCP/IPv6)" and select OK.
7. Restart CAVE.
Products Not Loading Properly in Windows
If the Windows installation was not completed properly, it is possible to see incorrect behavior when loading certain products. These are derived products which use the local machine to create and render the data. This creation is dependent upon python and its required packages working correctly.
The dataset will be available in the menus and product browser, but when loaded, no data is drawn on the editor, but an entry is added to the legend.
You may see an error that mentions the python package, jep.
Known datasets this can affect (this is not a comprehensive list):
- Model Winds
- Metars Winds
- METAR Station Plot
- GFS Precip Type
To correct this issue, please redo the installation instructions from steps 4 and 5, related to the C++ Build Tools and pip installations.