Installer l'implémentation Java d'Apache UIMA (uimaj)

WARNING : The present information is out-of-date. Please consult this page for updates

INTRODUCTION

Cette page avait été écrit pour décrire l'installation de  l'implémentation Java d'Apache UIMA (uimaj)  Version Binary 2.2.2-incubating sous Linux.

Depuis j'ai produit un ensemble de scripts pour gérer automatiquement le téléchargement et l'installation d'un environnement pour utiliser Apache UIMA (>2.3) et développer avec sous Eclipse.

La documentation officielle référence deux guides 

•   l'UIMA overview and SDK Setup
•   le Getting started (une page ciblée sur l'installation de Java UIMA )

Jérôme Rocheteau décrit comment installer Apache UIMA Java en récupérant les sources sur le dépôts subversion et en les installant avec Maven.

Ci-dessous nous rapportons une synthèse en français des grandes étapes pour la version d'Apache UIMA 2.2.2-incubating et d'Eclipse Galileo 3.5.1; cela comprend l'application du correctif hf1.


1. Installation d'Eclipse et de ses plugins 
Eclipse n'est pas nécessaire pour l'installation et l'utilisation du framework Apache UIMA ou du SDK. Les outils Apache sont utilisables hors IDE même si la tendance serait à privilégier leur intégration seulement au sein de celui-ci (voir le CAS Editor).
Eclipse est néanmoins recommandé pour le développement de composants UIMA.
Nous renvoyons au billet http://enicolashernandez.blogspot.com/2009/12/comment-installer-eclipse-galileo-351.html pour l'installation d'Eclipse et de ses plugins. Nous supposons l'installation de Eclipse Galileo 3.5.1

2. Installation du framework Apache UIMA, de son SDK et des codes exemples


1. Sur http://incubator.apache.org/uima/downloads.cgi récupérer les archives des versions binaires pour Linux des latest official releases de 

• UIMA Java framework and SDK à savoir uimaj-2.2.2-incubating-bin.zip
• UIMA core hotfix 1
  
• UIMA Annotator Addons & Simple Server & Pear packaging tools

2. Désarchiver l'archive "UIMA Java framework and SDK" dans le répertoire de votre choix. Pour ce qui suit nous supposons l'existance d'un répertoire d'applications désigné par la variable d'environnement $APPLI

Au passage, je crée un lien symbolique pour me permettre de changer aisément de version à l'avenir.

cd $APPLI

unzip uimaj-2.2.2-incubating-bin.zip

mv apache-uima apache-uimaj-2.2.2-incubating-bin
ln -s apache-uimaj-2.2.2-incubating-bin apache-uimaj

3. Fixer les variables d'environnement. Pour cela je suis les consignes du fichier README présent dans l'archive.

• Set JAVA_HOME to the directory of your JRE installation you would like to use for UIMA.
• Set UIMA_HOME to the apache-uima directory of your unpacked Apache UIMA distribution
• Append UIMA_HOME/bin to your PATH
• Please run the script UIMA_HOME/bin/adjustExamplePaths.sh (or .sh), to update emacs .bashrc

#-- UIMA

export UIMA_HOME=${APPLI}/apache-uimaj

export PATH=${UIMA_HOME}/bin:$PATH

#export UIMA_CLASSPATH=/dir/to/my/component.jar

#export UIMA_LOGGER_CONFIG_FILE=$UIMA_HOME/config/myLoggerConfig.properties

4. Un test d'installation

Afin de réaliser ce test consulter la page "Comment exécuter des chaînes de traitement avec UIMA " notamment la section "Exécution d'une chaîne de traitement en ligne de commande".

5. Désarchiver le UIMA core hotfix 1 (correctif sur la gestion mémoire) et placer la bibliothèque uima-core.jar fournie dans $UIMA_HOME/lib à la place de celle existante.

6. Importer le répertoire de codes exemples UIMA_HOME/examples au sein d'Eclipse

• Cliquer onglet File > Import ; Sélectionner "General/Existing Project into Workspace" ; Cliquer "Next" ; Cliquer "Browse" et naviguer jusqu'au répertoire UIMA_HOME

7. Définir la variable UIMA_HOME au sein d'Eclipse

• Cliquer onglet Window > Preferences > Java > Build Path > Classpath Variables > Faire New (Name: UIMA_HOME et Path: Folder... > vers "applications/apache-uima") > Ok > Ok > Yes (rebuild)

8. Un test d'installation au sein d'Eclipse 

Afin de réaliser ce test consulter la page "Comment exécuter des chaînes de traitement avec UIMA " notamment la section "Exécuter une chaîne de traitement au sein d'Eclipse".

9. L'ajout des addons...
est décrit dans ce post.