Software Organization and Testing
This page describes how the BCO-DMO software is organized and stored on disk, in which directories various components are maintained, and provides links to various operational utilities that are needed to maintain the system.
Organization of Scripts
Applications (PHP, Perl, etc. scripts) that support the workings of BCO-DMO are located starting at /data1/Software. See below for the location of CGI applications and scripts. [Additional information about live and test versions of software to follow.]
General purpose cgi PHP, Perl, etc. scripts used via the http://access1.bco-dmo.org web site, for example,
http://access1.bco-dmo.org/bco-bin/List_programs.active
and
http://access1.bco-dmo.org/bco-bin/dataset_by_program_project.active
should reside in the /data1/www/access1/bco-dmo/Scripts directory with the most recent, live version called platform_infor.pl_V1.xx and a symbolic link established as
ln -s platform_infor.pl_V1.xx platform_infor.active
Then in /data1/www/access1/bco-dmo/bco-bin there should be a
symbolic link set up as follows:
ln -s ../Scripts/platform_infor.active platform_infor.active
Your live version of the software accesses the software (and any configuration file) as
/data1/www/access1/bco-dmo/bco-bin/platform_infor.active
Your test version of the software accesses the software (and any configuration file) as
/data1/www/access1/bco-dmo/bco-test/platform_infor.pl
This approach allows people to work on a new version of software without affecting the live system. Once a new version is ready to be used, a new symbolic link is created, for example, as follows. In the ../Scripts subdirectory:
cp platform_infor.pl platform_infor.pl_V1.02
ln -s platform_infor.pl_V1.02 platform_infor.active
This preserves the older version and allows for returning to a previous version if necessary.
MapServer Software
To be completed.
Recaching the MapServer Static Files
To recache the static MapServer files, use the following URLs:
Live: http://mapservice.bco-dmo.org/maps-bin/admin/recache
Test: http://mapservice.bco-dmo.org/mapsdev-bin/admin/recache
JGOFS/GLOBEC Perl Scripts and Applications
The JGOFS/GLOBEC Perl scripts and applications are located starting at the JGOFS/GLOBEC root installation, currently located on dmoserv2 at /home/bco/dbase-v2. The htmlbin subdirectory contains the dir, info and applications. The methods subdirectory contain the methods such as def, defgb, rs, etc.
Using the system while accessing the test database
To access the MapServer features of BCO-DMO but using the contents of the test version of the metadata database, use the following URL:
http://mapservice.bco-dmo.org/mapsdev-bin/global/map
To access the OSPREY/Text based system but using the contents of the test version of the metadata database, use the following URL:
http://cis.whoi.edu/science/bcodmo-adm-test/index.cfm
As a reference, the link to the OSPREY/Text based system using the contents of the live version of the metadata database is as follows:
http://cis.whoi.edu/science/bcodmo-admin/index.cfm