ISIS-OAI-PROVIDER

Isis-oai-provider is a software that provides a ISIS databases in OAI protocol to be harvested.

The application work with PHP 5.3.3 or later.

Instalation

1 Download the last version from Downloads link from github repository (zip or tar gz file) and extract the file to your server. Example: Creating a structure and deploy the application under server /opt/ directory:

    $ cd /opt/
    $ mkdir bireme
    $ cd bireme
    $ wget https://github.com/bireme/isis-oai-provider/tarball/master -O isis-oai-provider.tar.gz
    $ tar xvfzp isis-oai-provider.tar.gz
    $ mv bireme-isis-oai-provider-53c0abc/ isis-oai-provider

2 Deploy the aplication on the Web Server (ex. Apache Web Server)

* Option A - Using a specific VirtualHost for the web application

    <VirtualHost *:80>
       ServerName isis-oai-provider.local
       DocumentRoot /opt/bireme/isis-oai-provider/htdocs/

       <Directory "/opt/bireme/isis-oai-provider/cgi-bin">
            Options +ExecCGI
            AllowOverride None
            Order deny,allow
       </Directory>

       ScriptAlias /cgi-bin/ /opt/bireme/isis-oai-provider/cgi-bin/
       LogLevel warn
       CustomLog /var/log/apache2/isis-oai-provider.log combined
       ServerSignature On
    </VirtualHost>

* Option B - Using a existing VirtualHost

Assuming you have a website running you need to find the path where is located the following components:

DocumentRoot --- directory where static files and PHP scripts are located CGI-BIN --- directory with execution permission for CGI scripts ISIS dabases --- directory on the server where ISIS databases are located

Then move/copy or create symbolic links to the isis-oai-provider directories:

Ex. Assuming a website with this directory structure:
/home/sites/
           /site1/
                 htdocs/
                 cgi-bin/
                 bases/

$ cd /home/sites/site1/ $ cd htdocs $ ln -s /opt/bireme/isis-oai-provider/htdocs/isis-oai-provider/ . $ cd .. $ cd cgi-bin $ ln -s /opt/bireme/isis-oai-provider/cgi-bin/isis-oai-provider/ .

3 Rename configuration files

    $ cd htdocs/isis-oai-provider/
    $ mv oai-config-sample.php oai-config.php
    $ mv oai-databases-sample.php oai-databases.php

4 Test the application calling your browser and informing your server name like: http://your_server_name/isis-oai-provider/

Ex. http://isis-oai-provider.local/isis-oai-provider/