Notes for installing the 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/.
*
********************************************************************

Please 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 using something like the
	the following:
	    tar -xvf jgofs_v1.6.tar  [This unpacks the source files.]
	Do this in a directory where you want to have your JGOFS software,
	such as /some/nice/place/jgofs.
		
	2. edit the build-env file for your values of MYADDR, CC, 
	BUTTONIMAGEDIR, and SYS (see the notes below)
	
	3. Build the JOGFS software on your machine with the 
	build command
		 ./build
	See the notes below and the INSTALL.doc file for further 
	information.
		 
	4. Modify your web serving software configuration
	file to add the /jg/ alias. 
  
  		ScriptAlias /jg/ /your/JGOFS/software_root/htmlbin/
  		
	Follow the instructions on how to re-configure your HTTPD 
	server configuration file (usually called httpd.conf) located
    	at http://globec.whoi.edu/globec-dir/software/install-httpd.html

TESTING

To directly test the software from your compouter, from your JGOFS
root directory, type:

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

You should see test hydrographic data displayed.

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

	http://your/machine/name/jg/serv/test.html0 

which should give you the top level of same test hydrographic data. 


NOTES FOR THE build-env FILE:

  MYADDR - an environment variable, edit this to be your machines's hostname 
           and if you are using a port different from 80 (standard).
           For example: setenv MYADDR mycpu.school.edu

  PERL - enter here the location for your Perl interpreter.  On some systems
  	you can enter "which perl" to determine where the perl program is
  	located.  For example: setenv PERL /usr/bin/perl
  	
  SYS - Currently set to Solaris.  Other platforms supported include
   	"linux", "SunOS", and "Irix".

  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, leave 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 the files from:

              anonymous ftp at globec.whoi.edu in /pub/images
              
		Download the file called jgofs_buttons.tar and untar
		using the command tar -xvf jgofs_buttons.tar
		or bring each file down by name.
	
	      If you prefer to use plain hypertext links, comment out the
	      line by adding a pound sign (#) in front of the line.

  PROGRAM - the choices are GLOBEC, JGOFS, and other.  If you are part of the
  	GLOBEC or JGOFS program enter these words, respectively.  If you are
  	not, leave it as other.  This parameter affects how the system
  	defines the location of the information files, the location of
  	the directory source, the title of the directory page, and the starting
  	point within the directory structure.
	      
  CC - an environment variable used to indicate the C compiler.
	Edit this if you wish to use a compiler different from the one
	already defined.

  OBJDIR - an environment variable used to define the "entry level" of the
  	data object tree.  For the U.S. GLOBEC program, this is defined as
  	"globec".  However, you can change this to whatever you wish your
  	entry level to be.  All data object searches start from the 
  	OBJDIR subdirectory and you can create any number of subdirectories 
  	you wish.
             

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}