TO10 CAVE Client Installation Instructions

Note:

• Intellectual Property concerns are still an issue for TO10. In short, do not give the AWIPS II software to anyone. For details see the "AWIPS-II Software Distribution Guidance and Procedures" document. I, Jim Fluke, am the GSD/ISB focal point for this. So for GSD/ISB folks, if anyone asks you for the software refer them to me.

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.
• You can have only one CAVE installation for your account on a given machine. Since our home directories are on homestar this pretty much means one CAVE installation for your account, period, although there is a way around this if you really need it. This in turn means that connecting to your own EDEX installation, if you have one, and the dx1-a2dp EDEX is problematic. You will have to change your configuration each time you switch from one to the other. We are investigating a fast way to do this.
• You must have dx1-a2dp'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/TO10/awips/cave 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/TO10/awips, in this case). Note that I still have my TO9 install in /scratch2/socrates/fluke/TO9, and I am not having any problems so far. If you decide to remove your TO9 cave instead, make sure your remove the caveData directory.
   
2. Run the wizard under your own account:
   cd /misc/linux/awips2-TO10
./setup_cave.sh
   Refer to the CAVE installation instructions in Raytheon's "AWP_TO10_Flow Tag_Cluster_Deploymnt_Rev1.pdf" and "AWP_TO10_Flow Tag_Standalone_Deploymnt_Rev1.pdf" documents in "/misc/linux/awips2-TO10/TO10 Resources/InstallProcedures/."
   Install CAVE in your install directory when prompted by the install wizard. Enter the full path, letting the install wizard create the basename directory (cave in my case) by answering "OK" when it asks.
   On the "Packs" screen select both CAVE and Basemaps.
   Change the EDEX server to "dx1-a2dp" (from localhost).
   Change the DB Address to "dx3-a2dp"
   Ensure that DB User is "awips"
   Ensure that DB Password is "awips"
   Change the hdf5 data directory to "/data/hdf5".
   (These can be changed later in "Preferences" to switch to a local EDEX)
   It looks like there is a BOU localization available by default. You might try it or wait for confirmation.
   On the shortcuts screen, unselect all shortcuts and then select "Next".
   Step through the wizard and complete the install. Do not select to create an installer on the last screen. Quit the wizard when the install is done.
3. In <install directory> create a startCave script that looks like this:
   

      #!/bin/sh
      export JAVA_HOME=/misc/linux/awips2-TO10/install_files/jre-linux
      export PATH="$JAVA_HOME/bin:$PATH"
      umask 02
      ./cave.sh > cave.out 2>&1
   

   We think the umask is particularly important to accomodate the new file locking for the hdf5 directory. Make this file executable.
4. Launch CAVE:
   

      cd <install directory>
      ./startCave
   

   In the top-menu bar, select CAVE > Preferences...
   • Click on Localization and ensure that it's set to "OAX" (or perhaps "BOU") and uses "http://dx1-a2dp:9581/services" as the server.
   • Click on Connectivity and ensure that JMS Server and HTTP Server refer to "dx1-a2dp" (not localhost) in the URL.
   • Click on Directory Paths and
   • ensure that Base Maps Directory is "<install directory>/basemaps".
   • ensure that Server Data Directory is "/data/hdf5".
   • We have not dealt with Hydro Apps yet, so leave that alone, unless you are brave.
   • Click Apply if you made changes, Cancel otherwise.
   Exit and relaunch CAVE. Green times should show up within 30 seconds.
   
   Note that a caveData directory will now exist under your home directory as well as a caveData in your install directory's parent. Only the one in your home directory has anything in it, and what it has is your configuration. This is why you can have only one CAVE install - you can have only one configuration per home directory. Of course you could fudge this with a sym link if you need to.

Notes by Jim Fluke. Last modified 5 Mar 09.