Bug #3018
closedDocument installation and deployment of registry system
0%
Description
Currently there is no documentation on how to set up and deploy the registry aspects of Metacat, and much of this knowledge resided in prior developers. To fix this, the registry setup instructions should be verbosely described so that anyone can install it on a new machine without hacking through things.
The main Perl components in use with Metacat:
- register-dataset.cgi: creating and maintaining metadata documents
- ldapweb.cgi: accessing LDAP resources for authentication and authorization
- Metacat.pm: Perl client for accessing Metacat
Additional optional components:
- AdminDB.pm: NCEAS admin database access, only needed for NCEAS skin
- get_eml.pl: grab EML documents; deprecated?
- getlsid.pl: LSID resolution; deprecated?
The following aspects should be documented:
- meeting the Perl dependencies of the above modules, both through apt-get on debian-based machines and CPAN for others
- Setting up Apache for cgi-bin usage with Perl
- Ant targets for installing registry components
- Necessary file creation issues, including:
+ an appropriate cgi-bin directory
+ the creation of a {$skin}.lastid file within the skin folder
+ giving the apache user write permissions to the context temporary folder, usually something like '/tmp/knb' with a user of www-data (can this be automated within ant?)
- An explanation of Ant properties that matter for the registry, and their usage. Ditto for the ${skin}.cfg file.