This manual page describes how to install the GFI CODAS distribution.
GFI extensions support small modifications of the original CODAS package. You must decide at compile time if you want to enable or disable these modifications. Furthermore, some GFI extensions need these modifications, so that you will have to recompile the CODAS package, even though if you already have one installed.
However, compiling the package should not be too difficult. The original CODAS package is supported by a lot of architectures, and GFI extensions come with Makefiles that should be portable on many systems.
First of all, you will need to create a directory where you want to install the package. Then you will need to decompress the archive and extract the files from it:
cd somewhere
mkdir codas
cd codas
gzip -d the_archive
tar xvf the_archive
gzip(1). Other compressions can be performed on demand.
Information about compiling the main CODAS files can be found in file compile.txt . The following description is just a shorter version of it.
From the root directory of the package, set the host type of your platform:
cd somewhere/codas/codas3c # or what ever
mkdir lib
mkdir bin
make/sethost.prl hh
Check the file include/dbhost.h for definitions that are
compatible with your platform. Several dbhost.HOST files
for different HOST types are available in the same directory.
Script sethost.prl will install the adequate for you as the
dbhost.h file. However, it is not a bad idea to check its
content before compiling the package.
Edit the file makefile.dep and adjust eventually the definitions to your own system. Additionnal GFI compile time options must also be listed in this file. As an example, see the DFLAGS variable at the beginning of file makelnx/makefile.dep/. Possible options are:
This option specifies the default screen size of
showdb(1).
The default is 25 lines. However, if working on larger windows,
increasing this value is quite convenient.
This option specifies the paper type for vector plots (see
vector). The default is letter. However europeans
will probably prefer a4.
This option will include additional control file parsing functions into the original CODAS libraries. See also
ioserv(3). This option is required if you want to compile
the GFI extensions.
This is a plugin for reading CTD files in C78 format. See also
This is a plugin for putnav(1). It adds keyword nav_pos to the list of navigation sources, and is used for loading positions into a CODAS database from a file with only time, longitude and latitude, as the one output by
getnav(1). This is useful for fast checks of the database content using adcpsect.
When this is done, you may build the libraries and binaries of the CODAS package:
make libs
make bins
The GFI extensions are built from sub-directory gfi. More definitions for specific GFI targets can be found in file gfi/make/HOST/makefile.dep, where HOST should be the host type of your system. However, you won't have to edit it in most cases.
GFI extensions are currently compiled on lnx and sgi platforms. If your host type is not listed above, you should do the following:
cd gfi
cd make
mkdir hh
cp sgi/* hh
cd ..
In other words, create a subdirectory in gfi/make for your host type (replace hh above with the host type), and copy the definitions file from the sgi platform.
To build the GFI libraries and binaries, execute
make libs
make bins
Once the package is built, you will need to configure your system. This step is required for each user. Information on how to do it can be found in gficfg(5). This file is located in directory gfi/doc/txt/etc.
Manual page written by Pierre Jaccard, Geophysical Institute, University of Bergen, 1999.