Differences

This shows you the differences between two versions of the page.

--- en:user_advanced:oai [2018/07/30 23:01] – [Serving OAI Data using Greenstone] kjdon
+++ en:user_advanced:oai [2018/07/30 23:15] – [Downloading records from an OAI repository] kjdon
@@ Line 20: / Line 20: @@
 ^Option^Description^
 |Source URL (''-url <string>'')|(REQUIRED) OAI repository URL|
-|Metadata prefix (''-metadata_prefix <string>'')|The metadata format used in the exported metadata, e.g. oai_dc, qdc, etc. (//Default: oai_dc//)|
+|Metadata prefix (''-metadata_prefix <string>'')|The metadata format used in the exported metadata, e.g. oai_dc, qdc, etc. The formats available depend on what is offered by the OAI server. All repositories must offer oai_dc. (//Default: oai_dc//)|
 |Restrict to set (''-set <string>'')| Restrict the download to the specified set in the repository|
 |Get document (''-get_doc'')|Download the source document if one is specified in the record|
-|Only include file types (''-get_doc_exts <string>'')|Permissible filename extensions of documents to get (//Default: ''doc,pdf,ppt''//)|
+|Only include file types (''-get_doc_exts <string>'')|If downloading source documents, only download those whose file extensions match this list. (//Default: ''doc,pdf,ppt''//)|
 |Max records (''-max_records <int>'')|Maximum number of records to download. If not specified, will download all records.|
@@ Line 46: / Line 46: @@
 then Greenstone downloads the page and scans though it looking for ''href'''s that match the specified file extensions, and downloads these.
+==== Downloading on the command line ====
+You can also download OAI records on the command line, using the perl script that GLI uses in the background: **downloadfrom.pl**. There is lots of information about command line downloading on [[en:user_advanced:command_line_download|downloading from the command line]] page.
+  * **Set up the Greenstone environment** in the terminal by running one of the following:
+<code>
+source gs3-setup.sh (linux/MacOS, gs3)
+gs3-setup (Windows, gs3)
+source setup.bash (Linux/MacOS, gs2)
+setup (Windows, gs2)
+</code>
+  * **To see the options available**, run:
+<code>
+perl -S downloadinfo.pl OAIDownload
+</code>
+The options are the same as you can see in the GLI OAI download panel, listed above.
+  ***An example usage would be:**
+<code>
+ perl -S downloadfrom.pl -mode OAI -url http://www.nzdl.org/cgi-bin/oaiserver.cgi -set demo -max_records 5
+</code>
+This will try to download 5 records from the set //demo// at the nzdl.org's OAI server.
+The records (and optionally documents) will be downloaded into the folder the script is run from. To change this, use the **-cache_dir full-path-to-folder** option.
 ===== Serving OAI Data using Greenstone=====