Notes for installing v1.6 JGOFS data system
____________________________________________________

*************************   WARNING   ******************************
* 
*  Please make a backup of the software tree containing existing
*  JGOFS system software.  This process overwrites the methods/
*  directory entries, as well as those in htmlbin/ and objects/.
*
********************************************************************

Pleaes read the README file for additional information and instructions.

Four steps are necessary to install the JGOFS software: 

	1. Extract the files from the tar file
	2. edit the build-env file 
	3. build
	4. Modify your web serving software configuration
  file to add the /jg/ alias. 

Once you have the tar file, login in another window or change
directories to the place where you want to install the software and
then follow these steps:

    1.tar -xvf jgofs_v1.6.tar  [This unpacks the source files.]
    2.build  [This makes the software as requested. Read the INSTALL.doc 
    		for additional information.]
    3.Follow the instructions on how to re-configure HTTPD for serving data
    	at http://globec.whoi.edu/globec-dir/software/install-httpd.html

TESTING

To directly test the software from your compouter, type:

	bin/listvar /test
and 
	bin/list -f -n /test

You should see some test hydrographic data displayed.

After you've edited your web serving software's configuration file, 
try the following from a browser: 

http://yourmachinename/jg/serv/test.html0 

which should give you the top level of hydrographic data. 


NOTES FOR THE build-env FILE:

  MYADDR - an environment variable, edit this if your
           WWW alias is different from the machines's hostname 
           or if you are using a port different from 80 (standard).

  CC - an environment variable used to indicate the C compiler
           edit this if you wish to use a compiler different from default.

  BUTTONIMAGESDIR - an environment variable indicating the location of the 
           button images used in methods and documentation links.  The names
           of these GIF images are:
             dir.gif, datadisp.gif, doc.gif, youhere.gif,
             level0.gif, leveln.gif, flat.gif, more.gif
           ** if you wish to display buttons, rather than plain hypertext
              links, you must un-comment the 
                 setenv BUTTONIMAGESDIR url-of-images 
              line in build-env.  This item contains a default location, but
              you are encouraged to download local copies of them, from:

              anonymous ftp at dataone.whoi.edu in pub/images
   

NOTES ABOUT THE build SCRIPT:

When building with the SunPRO ANSI C compiler, the following warnings are
generated and are, we believe, harmless:

"HTTCP.c", line 202: warning: argument #1 is incompatible with prototype:
        prototype: pointer to char : "/usr/lang/SC3.0.1/include/cc_413_U1/string.h", line 19
        argument : pointer to struct in_addr {union {..} S_un}
"HTTCP.c", line 234: warning: argument #1 is incompatible with prototype:
        prototype: pointer to char : "/usr/lang/SC3.0.1/include/cc_413_U1/string.h", line 19
        argument : pointer to struct in_addr {union {..} S_un}