TO8 CAVE Client Installation Instructions

Caveats:

• Your graphics card must support OpenGL. To see if it does run the command:
  glxinfo | grep rendering
  You should see
  direct rendering: Yes
  Ok, so it really does not have to support OpenGL. You could install and bring up CAVE without it, but images will not display, only contours and plots, etc.
• Zooming will not work so well without a scroll wheel mouse, and most of us don't have one. But, the problem is zooming back out - do this with the button 3 menu option. To zoom in click on button 2.
• Developers will probably end up with two CAVE installations, one as a client for the EDEX on gwar (described here), and another as a client for your locally-installed EDEX, since you will probably want a local one for ADE build testing. I have two now, and since they are both configured differently, I have not had a problem.
• You must have gwar's hdf5 directory remote mounted to your machine. The mount point is /data/hdf5. Test this with "cd /data/hdf5" to get the automounter to put it in place. If you can get there, it's available.

Now, on with the show.

1. Decide on an installation directory. Mine is in /scratch2/socrates/fluke/caveClient on socrates. Feel free to look at it, but you will have to log onto socrates to do it. Make sure the parent directory exists (/scratch2/socrates/fluke, in this case).
2. Run the wizard:
   cd /misc/linux/awips2
./setup_cave.sh
   If you wish, refer to the installation screens illustrated in the Raytheon Training materials. TO6 versions start on page 295, with TO8 updates starting on page 377.
   Install CAVE in your install directory when prompted by the install wizard. Enter the full path, letting the install wizard create the basename directory (caveClient in my case) by answering "OK" when it asks.
   When it asks which "Packs" you want to install, you will have to decide if you want the topo data. I selected it, but so far I cannot get it to display.
   Change the server to "gwar" (from localhost).
   Change the hdf5 data directory to "/data/hdf5".
   We don't have a kbou localization available, so leave it at koax.
   The screen about shortcuts seems to be a no-op, so just accept the defaults.
   Step through the wizard and complete the install. Quit the wizard when the install is done.
3. chmod -R 775 <install directory>
4. Create a .caverc file that looks like this:
   

      setenv JAVA_HOME /misc/linux/awips2/install_files/jre-linux
      setenv PATH "$JAVA_HOME/bin:$PATH"
   

   (Or choose any other name you like. Location doesn't matter, either.) Source this file.
5. Launch CAVE:
   

     cd <install directory>
     ./cave.sh
   

   In the top-menu bar, select CAVE > Preferences...
   
   • Click on Localization and verify that it's set to "koax" and uses http.
   • Click on Connectivity and
       Ensure that it uses HTTP. (JMS should work too.)
       Ensure that JMS Server and HTTP Server refer to "gwar" (not localhost) in the URL.
       Ensure that Server Data Directory is "/data/hdf5".
   • Click Apply if you made changes, Cancel otherwise.
   Exit and relaunch CAVE. Green times should show up within 30 seconds.