GET READY FOR THE HARVESTING DAY!

INSTALL YOUR FARM IN 3 STEPS


Requirements
--------------------

- Perl
- Apache Web server 


OAI Repository Installation Instructions
-------------------------------------------------------

1. Copy all files with default directory structure into a directory
   from which APACHE can serve documents.
   
2. Use the repository explorer (http://purl.org/net/oai_explorer)
   to test the sample interface, which is accessible at 
   http://yourserver.com/path/to/script/oai/oai.pl
   
The repository explorer should be able to access the OAI repository. 
If it cannot, maybe there is a problem with the path to your script. 
Double check.

3. Edit the configuration file with your own information.
Only the following 3 values need to be changed:

<repositoryName>IULA UPF OAI Archive</repositoryName>
<adminEmail>santiago.bel@upf.edu</adminEmail>
<archiveId>upf:iula</archiveId> 

The archiveId value must follow the convention of semicolons for
domain delimitations.



Adding your BAMDES records to your Repository
-------------------------------------------------------------------

The data folder contains some dummy registries for testing purposes.
Delete all the XML files from the data folder (but not the data folder itself), and 
then you can already place your BAMDES XML files in the data folder.

1. Generate a valid BAMDES file. This can be easily done by using the web 
application forms in
http://www.theharvestingday.eu

2. Save the XML file in the data folder. Please take into account that:
	a) Files must have .xml extension
	b) The filename will be used as OAI identifier. Therefore following some structure is
	highly recommended.
	c) Only one resource per file
	
3. Check that your resource is listed. Check the following url with your browser:

http://yourserver.com/path/to/script/oai/oai.pl?verb=ListRecords&metadataPrefix=oai_clarin


Finally, let us know about your farm
---------------------------------------------------

When you have finished, send us an email and let us know about your farm.

Conctact Email: carla.parra@upf.edu

In this way your farm will be harvested periodically, keeping everything up-to-date.


Upgrading from previous versions
-----------------------------------------------

1. Backup all your XML files in data folder. (data/*.xml)

   $> cp data/*.xml ../data_backup

Please do no set your backup folder inside the farm folder. It could be deleted in
the following steps.

2. Backup your configuration file (conf/config.xml). 

   $> cp conf/config.xml ../conf_backup/config.xml

Please do no set your backup folder inside the farm folder. It could be deleted in
the following steps.

3. Unzip the new version and overwrite the previous version with the content.

4. Copy your backuped XML files back to the data folder.

   $> cp ../data_backup/*.xml ./conf

5. Copy back your configuration file in the config folder.

   $> cp ../conf_backup/*.xml conf

6. Go inside ./scripts folder and run ./upgrade.sh to transform the data from previous versions

   $> cd scripts
   $> cd ./upgrade.sh

7. Copy ./scripts/upgraded_data content to ./data folder and overwrite/delete previous data. 
Backup your master data before gets overwritten is always recommended.

   $> cp upgraded_data/*.xml ../data