2 Installation, lancement, désinstallation

2.1 Principes techniques

Installation mono-poste, sous PC, Mac et Linux

Interface accessible via un navigateur internet (adresse http://127.0.0.1:3333/ ou localhost:3333 )

Les données et le logiciel restent sur le PC (pas besoin de connexion Internet)

Extension possible avec des plug-ins développés par la communauté (pas tous compatibles avec la dernière version)

Accès possible par API (permet une automatisation des traitements)

Peut être containerisé avec Docker

OpenRefine est écrit en langage Java. Cela peut compliquer l’installation sous Mac : en cas de problème, vérifier que Java 8 est installé (ce n’est pas le cas par défaut) et que la variable d’environnement $JAVA_PATH contient bien le chemin de cette version.
Pour utiliser plus de 4 Go de mémoire, il faut utiliser la version 64 bits de Java

2.2 Installation

En cas de mise à jour

A noter : les données des projets et les extensions ajoutées à Openrefine sont stockées dans un dossier particulier, quel que soit l’emplacement du programme exécutable. Il est conseillé de les sauvegarder avant d’installer une nouvelle version du logiciel.

  • pour Windows : plusieurs cas en fonction de la version de Windows :
    • C:\Documents and Settings\[nom_de_l_usager]\Local Settings\Application Data\OpenRefine
    • C:\Users\[nom_de_l_usager]\AppData\Roaming\OpenRefine
    • C:\Users\[nom_de_l_usager]\AppData\Local\OpenRefine
    • C:\Users\[nom_de_l_usager]\OpenRefine
  • pour Mac : /Users/[nom_de_l_usager]/Library/Application Support/OpenRefine
  • pour Linux : ~/.local/share/openrefine/

Téléchargement de la dernière version officielle

Aller sur le menu Download du site officiel (http://openrefine.org/download.html) ou bien directement sur la page de téléchargement du dépot Github (https://github.com/OpenRefine/OpenRefine/releases/)

Télécharger la dernière version (3.1 Beta) correspondant à son système d’exploitation.

Openrefine peut s’exécuter depuis n’importe quel emplacement, y compris depuis une clé USB.

Installer le programme :

  • pour Windows : décompresser le fichier zip téléchargé, déplacer le dossier créé à l’emplacement souhaité (“Bureau”, “Program Files”, “C:/”, etc)
  • pour Linux : décompresser le fichier tar.gz téléchargé, déplacer le dossier créé à l’emplacement souhaité
  • pour Mac : ouvrir le fichier dmg téléchargé, puis dans la fenêtre qui s’ouvre faire glisser l’icône Openrefine dans le dossier Applications

Sous Windows, si Openrefine n’est pas installé sur le bureau il peut être utile de faire manuellement un raccourci pour le retrouver plus rapidement.

Après installation, les fichiers zip, tar.gz ou dmg peuvent être supprimés.

2.3 Paramétrage facultatif : ajouter de la mémoire

Par défaut Openrefine utilisera 1 Go de mémoire vive au maximum. Si la machine dispose d’assez de mémoire il peut être intéressant d’augmenter ce seuil en modifiant un fichier de configuration.

Sous Windows : dans le fichier refine.ini, modifier la ligne REFINE_MEMORY refine.ini

Sous Mac : ouvrir le fichier ‘/Applications/OpenRefine.app/Contents/info.plist’ et modifier la valeur <string>-Xmx1024</string> (par ex: <string>-Xmx2048</string> pour doubler la mémoire maximale)

2.4 Lancement du programme

  • pour Windows : exécuter openrefine.exe ou openrefine.bat
    • openrefine.exe s’exécute avec les paramètres par défaut
    • openrefine.bat prend en compte les paramètres définis dans òpenrefine.ini. Si ce fichier a été modifié, toujours passer par openrefine.bat.
  • pour Linux : exécuter ./refine
  • pour Mac : lancer l’application Openrefine (dans la liste des applications)

Openrefine se lance normalement automatiquement dans le navigateur par défaut de la machine, dans un nouvel onglet avec l’URL localhost:3333 ou 127.0.0.1.
Il ne fonctionne qu’avec Chrome ou Firefox : si votre navigateur par défaut est Safari, IE ou Edge, fermez-le, ouvrez Chrome ou Firefox et saisissez dans un nouvel onglet l’URL localhost:3333.

2.5 Sortie du programme

Puisque le logiciel tourne en tâche de fond, fermer le navigateur ne suffit pas fermer proprement Openrefine. Pour cela il faut…

  • sous Windows : fermer la console consolewin

  • sous Mac : utiliser le menu Quitter dockmac

2.6 Désinstallation

  • pour Windows et Linux : supprimer simplement le dossier contenant l’exécutable
  • pour Mac : supprimer l’application Openrefine.app dans la liste des applications

Par défaut les données resteront stockées sur la machine. Pour les effacer, supprimer le dossier où elles sont contenues (cf plus haut)