LSID (Life Science Identifier) Files

lsid-perl version 0.07
======================

ABOUT

This module implements an object-oriented interface for building clients and servers that resolve LSIDs and perform metadata queries on LSIDs.

New Features:

* Caching

The client stack now caches all metadata, data and WSDL queries. The
default path is stored in /tmp/lsid-client and can be change through
then evironment variable LSID_CACHE_ROOT.

* LSID Authority Security
 
Versions 0.07 of the Perl LSID resolver library and authority
framework provide HTTP Basic authentication for securing
authorities. In order to use this functionality, you must
use the following mod_rewrite configuration directives
in Apache:
 
Alias /authority/ "/var/www/htdocs/authority/authority.pl"
                                                                                                                  
<Location /authority>
    SetHandler cgi-script
    Options +ExecCGI
    RewriteEngine on
    RewriteCond %{HTTP:Authorization} ^(.*)
    RewriteRule ^(.*) $1 [e=HTTP_CGI_AUTHORIZATION:%1,t=application/x-httpd-cgi,l]
</Location>
 
This is to overcome Apache's automatic consumption of the
authentication headers.

* Authority Framework

There is a new authority framework, see LS::Authority::Service POD for an example.


INSTALLATION

lsid-perl can be installed like any Perl module found on CPAN.  In short:

On Unix or Linux:

   perl Makefile.PL
   make
   make test
   make install
   
On Windows:

Download the nmake utility from ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe, then

   perl Makefile.PL
   nmake
   nmake test
   nmake install

OR

   Copy LS.pm and the LS folder into your Perl's lib directory.  You can find the lib
   directory by typing
   
   	perl -e 'print "@INC"'

For more information on installing Perl modules, see http://search.cpan.org/author/JHI/perl-5.8.0/pod/perlmodinstall.pod

DEPENDENCIES

lsid-perl requires these other modules and libraries:

SOAP-Lite-0.55
URI-1.21
libwww-perl-5.53
Net::FTP 2.65
Net-DNS-0.28
XML-XPath-1.12
MIME-Base64-2.12
File::Temp 0.12
RDF-Core-0.30

This module is known to work with the versions given, but later and earlier ones may also work.


COPYRIGHT AND LICENSE

Copyright (c) 2002,2003 IBM Corporation 
All rights reserved.   This program and the accompanying materials
are made available under the terms of the Common Public License v1.0
which accompanies this distribution, and is available at
http://www.opensource.org/licenses/cpl.php