This is an old revision of the document!
METAMOD was initially developed to support scientific projects with data management. Development has focused on a cost effective system where several projects or operational services can share the same backend while maintaining a custom built user interface specific for each project. One METAMOD implementation may support many METAMOD instances. The first instance always own the database and some maintenance and configuration aspects are only available through this instance.
METAMOD was developed to support data management focusing on:
The runtime environment is generated during installation of the software (see the README file coming with the software for details). Basically the following procedure is used to set up a METAMOD instance:
update_target.plfound in source code using the user owning the web server
create_and_load_all.shlocated within the runtime source code tree directory
prepare_runtime_env.shlocated within runtime source code tree root directory
metamodInit.shlocated in the runtime source code tree root directory
If changes are made to
master_config.txt, repeat steps 1, 2, 4 and 5 and remember that all scripts need to be run as the user owning the web server. In step 5 use e.g.
sudo -u wwwuser ./metamodInit.sh restart or the two step procedure of first stopping and then starting the server.
The visual appearance of METAMOD is determined by style sheets and contents of the
master_config.txt file. Style sheets are located in the directory named
htdocs within the runtime source code directory of METAMOD. Appearance of most of the web pages, including buttons can be changed by changing the corresponding style elements within the following style sheets:
htdocs/style.css- Main style sheet determining the appearance of main menus and containers.
htdocs/sch/style.css- Style sheet used by the search interface.
htdocs/upl/style.css- Style sheet used by the upload interface.
htdocs/qst/style.css- Style sheet used by the quest interface.
METAMOD has two main menu containers. One top left (available within all modules) and one left (mainly in the search module and the upload). The top left menu is set up using the
APP_MENU tag of the
The search module menu is configured using the
SEARCH_CATEGORY_SEQUENCE of the
master_config.txt. This is configured using numbers (defined within the file
searchdata.xml) where the following mapping apply by default1):
In addition the keyword
Fulltext can be used.
In order to add new search categories the following sequence is required:
searchdata.xml(located within directory
import_searchdata.plwhich is located in the runtime directory
If several METAMOD instances are using the same database, this has to be done in the METAMOD instance that actually own the database. If the database has been running for a while, reinitialisation may take some time during which the METAMOD instances using the database will be unavailable.
Open Archive Initiative Protocol for metadata harvesting has been supported for a time. Support for ISO23950/Z39.50 (SRU implementation) is currently under implementation and is expected in the next release.
Information and schemata of the metadata-files used since Metamod 2.1 can be found under XML format for dataset descriptions.
The metadata structure is configurable, so this question must relate to a specific application of the database. The answer below is based on the applications implemented at met.no, which corresponds more or less to the EXAMPLE application available as part of the SVN source tree.
The METAMODPMH module contain a translation from the database to DIF XML. For the time being, this translation is implemented in a PHP script oaidp-config.php. This script contains an array which defines the translation:
$key_conversion = array( '!DS_name 1', 'Entry_ID', '', 'title', 'Entry_Title', '', 'PI_name', 'Data_Set_Citation Dataset_Creator', '', 'title', 'Data_Set_Citation Dataset_Title', '', 'institution', 'Data_Set_Citation Dataset_Publisher', '', 'dataref', 'Data_Set_Citation Online_Resource', '', 'variable', '*Parameters Category', 'EARTH SCIENCE', 'variable 1', 'Parameters Topic', '', 'variable 2', 'Parameters Term', '', 'variable 3', 'Parameters Variable_Level_1', '', 'variable', 'Parameters Detailed_Variable', '', 'topiccategory', 'ISO_Topic_Category', '', 'keywords', 'Keyword', '', 'datacollection_period 1', 'Temporal_Coverage Start_Date', '', 'datacollection_period 2', 'Temporal_Coverage Stop_Date', '', 'southernmost_latitude', 'Spatial_Coverage Southernmost_Latitude', '', 'northernmost_latitude', 'Spatial_Coverage Northernmost_Latitude', '', 'westernmost_longitude', 'Spatial_Coverage Westernmost_Longitude', '', 'easternmost_longitude', 'Spatial_Coverage Easternmost_Longitude', '', 'area 1', '*Location Location_Category', '', 'area 2', 'Location Location_Type', '', 'area 3', 'Location Location_Subregion1', '', 'area 4', 'Location Detailed_Location', '', 'latitude_resolution 1', 'Data_Resolution Latitude_Resolution', '', 'longitude_resolution 1', 'Data_Resolution Longitude_Resolution', '', '!DS_ownertag 1', 'Project Short_Name', '', 'distribution_statement', 'Access_Constraints', '', 'institution', 'Originating_Center', '', '', 'Data_Center Data_Center_Name Short_Name', 'met.no', '', 'Data_Center Data_Center_Name Long_Name', 'Norwegian Meteorological Institute', '', 'Data_Center Data_Center_URL', 'http://met.no/', '', 'Data_Center Personnel Role', 'DATA CENTER CONTACT', '', 'Data_Center Personnel First_Name', 'Egil', '', 'Data_Center Personnel Last_Name', 'Støren', '', 'Data_Center Personnel Phone', '+4722963000', '', 'Data_Center Personnel Contact_Address Address', "Norwegian Meteorological Institute\nP.O. Box 43\nBlindern", '', 'Data_Center Personnel Contact_Address City', 'Oslo', '', 'Data_Center Personnel Contact_Address Postal_Code', 'N-0313', '', 'Data_Center Personnel Contact_Address Country', 'Norway', 'references', 'Reference', '', 'abstract', 'Summary', '', '', 'Metadata_Name', 'CEOS IDN DIF', '', 'Metadata_Version', '9.7', '!DS_datestamp', 'Last_DIF_Revision_Date', '', '', 'Private', 'False', );
In this array, triples of three consecutive elements (starting with elements 0, 1 and 2 on the first line) constitute the translation of one metadata item in the database to one XML element in the DIF.
Each triple comprise the following components:
If these three components has, for example, the following contenet:
'institution', 'Data_Set_Citation Dataset_Publisher', '',
and “METNO Norwegian Meteorological Institute” is the value in the database found for the 'institution' metadata type, then the following text will be part of the DIF XML:
<DIF ...> ... <Data_Set_Citation> ... <Dataset_Publisher>METNO Norwegian Meteorological Institute</Dataset_Publisher> ... </Data_Set_Citation> ... </DIF>
The sequence of triples in the array define the sequence of the elements in the DIF XML. If possible, one triple will use the same higher level XML elements as the previous triple.
These points constitute the general rule, but some special rules apply: