Difference between revisions of "OAI manual Installation and launch"

From Archives Portal Europe Wiki
Jump to: navigation, search
Line 1: Line 1:
The tool is distributed as a zip-file, named e.g. '''''OAIHarvester-2.4.1-package''''', where the number indicates the version of the tool. The most recent version of the tool, v2.8.0, can be downloaded [http://dpt.archivesportaleurope.net/OAIHarvester-2.8.0-package.zip here].
+
The tool is distributed as a zip-file, named e.g. '''''OAIHarvester-2.4.1-package''''', where the number indicates the version of the tool. The most recent version of the tool, v2.8.3, can be downloaded [https://github.com/ArchivesPortalEuropeFoundation/ape-backend/releases here].
  
 
Once you have downloaded the zip-file, please do the following:
 
Once you have downloaded the zip-file, please do the following:

Revision as of 06:22, 30 March 2022

The tool is distributed as a zip-file, named e.g. OAIHarvester-2.4.1-package, where the number indicates the version of the tool. The most recent version of the tool, v2.8.3, can be downloaded here.

Once you have downloaded the zip-file, please do the following:

  • Uncompress the zip-file with winzip, 7-zip, unzip or a similar tool towards a location of your choice to create the executable and auxiliary files: two folders (named: conf and lib) and five files:
OAI Harvester manual, figure 1


  • To launch the tool please perform the following steps according to your operating system (OS):
    • Using Windows: double-click on the file named oaiharvester.bat
    • Using Linux: use your terminal tool to launch the file named oaiharvester.sh (i.e. make sure that the file has at least execution rights on your system using this command: chmod +x oaiharvester.sh), then type in your terminal tool: sh oaiharvester.sh)
    • Using MacIntosh: double-click on the file named: oaiharvester.jar


The tool should now be running (see the screenshot below). If this is not the case, then please read the third chapter of this manual.

OAI Harvester manual, figure 2


When launched the tool creates two additional folders, data and logs; the first one will contain the harvested data and the second one the log files where the actions processed will be registered (useful in case errors occur):

OAI Harvester manual, figure 3


In the logs folder, the file named: harvester will indicate in detail how the harvests have been processed; this file allows you to check everything if needed.