Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Motivation:

...

The DVUploader is a Java application packaged as a single jar file.  For Visit the tool's official home in GitHub for the current version (referenced here https://github.com/IQSS/dataverse-uploader/wiki/DVUploader,-a-Command-line-Bulk-Uploader-for-Dataverse), nothing has been done to simplify installation of the DVUploader. It would be possible to simplify this if desired.

To run it, you need to have Java and the DVUploader:

...

  • find the DOI for the existing dataset you wish to add files to, and
  • find or generate an API key for yourself in the Dataverse instance you are using (from the popup menu under your profile). You must create the API key on the same machine that you're running the DVUploader tool on and that your data is on.Users can generate a new key for themselves as explained in the Account Creation + Management section of the Official Dataverse User Guide (scroll down to API Token section)
  • Hint: It might be helpful to copy and paste the DOI and API key into a note or text file on your desktop while you prepare your upload. You can also use this document to prepare your command prior to entering it in the command line interface. 
  • Hint: The simplest way to run the DVUploader is to place the jar file (under Installation, above) into the directory containing a subdirectory with the files intended for upload. (The DVUploader can be placed anywhere on disk and can upload files from any directory, but this requires adding these paths to the command line and/or configuration of Java's classpath.)

...

would upload all of the files in the 'testdir' directory (relative to the current directory where the java command is run) to the Dataset at https://dataverse.tdl.org/dataset.xhtml?persistentId=10.5072/FK2/TUNNVE (if it existed: the dataset in this example is not real).

...

(The same information is written into a log file.)

Optional Parameters

The full set of available command-line arguments are shown in the example below.

	java -cp .\DVUploadClient.jar;. org.sead.acr.client.DVUploader -key=<api key> -did=<dataset doi> -server=<server URL> <-listonly> <-limit=<X>> <-ex=<ext>> < -verify> <-recurse> <-maxlockwait=<X>> <dir or file names>

...