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.
- 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
- 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/ .
- Rename configuration files
$ cd htdocs/isis-oai-provider/
$ mv oai-config-sample.php oai-config.php
$ mv oai-databases-sample.php oai-databases.php
- To test the application call your browser and inform your server name like: http://your_server_name/isis-oai-provider/