LOCKER:          opendx_v4.4

FILE:            /mit/opendx_v4.4/README.athena

CONTENTS:        Open DX  4.4 version locker

DESCRIPTION:     Open DX (Data Explorer) is an Open Source 3d data 
                 visualization application based on IBM's Visualization Data
                 Explorer that can be run in a variety of ways. The main
                 interface can be launched via the "dx" command. The system 
                 is complex; for more details please see the man page for dx 
                 and the online html documentation

HOW TO RUN:

  COMMAND:  add opendx
            dx

  FROM DASH:	 no

INTERFACES:	 GUI

VERSIONS:	 For Linux: Open DX 4.4.0
                 For Sun: Open DX 4.4.0
                  
DEPENDENCIES:	 Java, for the Java version

DATAFILES:	 Platform-independent

LICENSE SERVER:	 no

-------------------------------------------------------------------------

SUPPORT ISSUES --

I/S SUPPORT:

  CONSULTING:	 none

  TRAINING:	 none

  DOCUMENTATION: online help, including html manuals. 

OTHER SUPPORT:

  CONSULTING:	 (none)

  TRAINING:      tutorial starting at 
       http://web.mit.edu/opendx_v4.4/distrib/sun4x_510/html/pages/qikgu011.htm

  DOCUMENTATION: http://web.mit.edu/opendx_v4.4/www/allguidesun.htm (Sun)
                 http://web.mit.edu/opendx_v4.4/www/allguidelnx.htm (Linux)

  WEB PAGE:       http://www.opendx.org


BUG REPORTS:	 Use sendbug

-------------------------------------------------------------------------

LEGAL ISSUES -- 

STATUS: licensed under IBM Public License- see 
        http://web.mit.edu/opendx_v4.4/distrib/sun4x_510/LICENSE for details. 
        Additional license for add-ons at
        http://web.mit.edu/opendx_v4.4/distrib/sun4x_510/VIS-LICENSE

 SITES:         any
 
 RIGHTS: you may reproduce, prepare derivative works of, distribute,
         publicly display, publicly perform and sublicense the software
         provided by contributors in source code and object code form

         You may install and use a copy of the VIS-provided software on 
         your computer

         You are granted a royalty-free patent license under Licensed Patents 
         to make, use, sell, offer to sell, import and otherwise transfer the
         software provided by contributors in source code and object code form

 RESTRICTIONS: see full licenses above for details 
 
 DOCUMENTATION: 
                
-------------------------------------------------------------------------

ABOUT THIS LOCKER --

MAINTAINER(S):	 swmaint (group), alexp

DIRECTORY STRUCTURE:

        arch	           - arch hierarchy
	bin	           - @sys link to utility binaries
	include            - @sys link to utility includes
	lib	           - @sys link to  utility libraries
	man	           - link to man page
        www                - starting point for html documentation
	distrib/i386_rhel4 - Linux top level
          bin_linux        - Linux binaries
          lib_linux        - Linux libraries, make include, config files
	distrib/sun4x_510  - Sun top level
          bin_solaris      - Sun binaries
          lib_solaris      - Sun libraries, config files

	  bin		   - launch scripts
          doc              - various READMEs
          fonts            - fonts
          help             - help files
          html             - html help files
          include          - include files
          java             - Java support files
          man              - dx man page
          samples          - sample files
          ui               - configuration files

MODIFY HISTORY:
	10/2/06  - Alex Prengel
                   Created this README.athena, initial locker setup

MISCELLANEOUS:

To compile code examples, copy the samples subtree to a location where you have
write permission, type:

add opendx_v4.4
source /mit/opendx_v4.4/envset

cd to an appropriate sample directory and invoke the appropriate makefile, 
i.e. like:

cd /var/tmp/samples/callmodule
make

or

cd /var/tmp/samples/dxlink
make -f Makefile_solaris

Not all the examples work correctly for various reasons.

The Java applet component is meant to be run from a Web server. Athena isn't
set up to run individual Web servers, but running a Java client and server on
the same machine for demo purposes should be possible. Due to a design 
limitation, the user needs write permission within the java part of the 
software tree. To deal with this, we make a local copy of the installation
tree rooted in a temporary location /var/tmp/demo. To completely delete
this when you are done, do:

rm -fr /var/tmp/demo

To run the Java demos this way:

add opendx_v4.4
source /mit/opendx_v4.4/envsetjava
cd /var/tmp/demo/java/server/bin
./startserver (to start Java server)
./stopserver (to stop Java server)

Start Firefox by running:

dxdemo-firefox (this uses a script that sets environment variables for Java)

go to location:

file:///var/tmp/demo/java/htmlpages/Status.html

and try clicking on links to the various examples. These may work sometimes
and not others. You may find that a process dxexec is using up a large fraction
of the cpu- this seems to indicate that the system is "hung"- to recover kill
the dxexec process, then stop and restart the server as above.