Import Using GIT / Maven with Eclipse

Prerequisites

Please have Apache Maven and an Apache GIT client ready to use.

Checking out the koLibRI

git clone git@git.projects.gwdg.de:kolibri.git

Building an Eclipse project

mvn eclipse:eclipse

Import the folder (the one with the pom.xml file) to Eclipse using file > import > existing project into workspace.

Configuring the koLibRI

See “Configuration” below.

Running the koLibRI

Add an Eclipse runtime configuration:

  • Create a new Java application in the Eclipse Runtime Menu.
  • Use de.langzeitarchivierung.kolibri.WorkflowTool as main class.
  • Add -c [path to chosen config file].
  • Maybe you will have to increase memory capacities of the VM, if so, please use something like -Xmx1024m.

Do Run the Application.

You can check your imports either in the TextGridLab’s project you imported in or in the TextGridRep Sandbox, depending on your configuration.

Import Using GIT / Maven and Command Line

Prerequisites

Please have Apache Maven and an Apache GIT client ready to use.

Checking out the koLibRI

git clone git@git.projects.gwdg.de:kolibri.git

Building the module

mvn package

Configuring the koLibRI

See “Configuration” below.

Running the koLibRI

Run with your chosen configuration file:

mvn exec:java -Dexec.args="-c path/to/config_file.xml"

You can check your imports either in the TextGridLab’s project you imported in or in the TextGridRep Sandbox, depending on your configuration.

Import Using the koLibRI JAR File

Downloading the software

Please download at first the configuration and folder ZIP file, where all the needed config files and templates are stored in:

This ZIP please do extract to your preferred working folder. Furthermore you will need the koLibRI Command Line Module prepared for the usage of the TextGrid import. Please also put this JAR into your working folder and rename it to kolibri-cli-4.1.4-SNAPSHOT.jar (just for simplifying things):

You now should have a folder structure like the following:

kolibri-textgrid-import
        ⌊ config
                ⌊ tglab_config.xml
                ⌊ tgrep_config.xml
                ⌊ policies.xml
                ⌊ …some more koLibRI config files…
        ⌊ folders
                ⌊ dest
                ⌊ hotfolder
                        ⌊ data
                ⌊ hotfolder-dfg-viewer
                ⌊ hotfolder-test
                ⌊ log
                ⌊ metadata-responses
                ⌊ temp
                ⌊ work
        ⌊ kolibri-cli-4.1.4-SNAPSHOT.jar

Configuring the koLibRI

See “Configuration” below.

Starting the koLibRI workflow tool

If everything is configured correctly, and are all data copied, koLibRI can be started. You do need a Java Virtual Machine using Java 6. Change into your work directory containing the JAR and the config files and type:

java -jar kolibri-cli-4.1.4-SNAPSHOT.jar -c config/tglab_config.xml

You can check the status of your imports either in the TextGridLab’s project you imported in or in the TextGridRep Sandbox, depending on your configuration. It may be, depending on your local charset configuration, that special chars, such as ö, ä, ü, are not correctly imported. Then please use the following -D trigger:

java -Dfile.encoding=UTF8 -jar kolibri-cli-4.1.4-SNAPSHOT.jar -c config/tglab_config.xml