Liste de liens :
Liste de liens :
On trouve une description :
Répertoire des corpus importés (=corpus binaires), des résultats, des macros, etc.
Ce répertoire contient les corpus binaires et les éléments habituels d'un Workspace Eclipse.
TODO: vérifier car il y a eu des changements depuis la 0.7.7
TODO
La sauvegarde des résultats dans TXM se fait dans des fichiers .prefs stockés dans le répertoire du projet RCP (Corpus) concerné.
Depuis TXM 0.7.7, les plugins des mises à jour ne sont plus stockés dans le dossier utilisateur RCP (.txm) mais dans le dossier d'installation de TXM.
Pour des tests rapides, notamment sans être obligé de builder une maj de type DEV, il est possible de remplacer un .class directement dans un .jar d'un plugin et de relancer TXM (testé sous Windows uniquement, avec 7zip). La fonction d'historique des majs RCP garde une copie de tous les plugins qui ont été modifiés depuis l'installation originale, ceci pour permettre les opérations de revert. Il faut donc utiliser la dernière version du .jar du plugin ciblé.
Le plugin Preference Editor permet de modifier les valeurs de préférences du scope INSTANCE, CONFIGURATION, BUNDLE (bundle_defaults) et DEFAULT ou bien d'un répertoire de projet.
Utilisation depuis Eclipse :
Chaque modification de préférences de commande/plug-in génère un fichier .prefs dans les dossiers suivants. Ces fichiers n'existent que si au moins une valeur de préférence n'est pas égale à la valeur par défaut. Les valeurs par défaut de chaque commande/plug-in sont codées en dur dans les PreferencesInitializer de chaque plug-in.
Il s'agit du fichier des préférences utilisateur de TXM. Concrètement il stocke toutes les préférences accessibles via l'UI (Tools\Parameters) du noeud “TXM”. Les préférences des autres noeuds sont stockées ailleurs [TODO].
Il s'agit du fichier de la ligne de commande de lancement de TXM (launcher equinox RCP) et permet de modifier certains arguments utiles pour le debug (comme les arguments de la JVM).
==== install.prefs ====
Fichier d'initialisation des préférences de TXM au premier lancement.
* Windows 7 : C:\Program Files\TXM\install.prefs
* Linux : /usr/lib/TXM/install.prefs
* Mac OS X : /Applications/TXM/install.prefs
Lorsque TXM se réinstalle, une copie du précédent fichier org.txm.rcpapplication.prefs est faite dans le répertoire temporaire, ce qui permettra à TXM de le relire lors de la post-installation (Java)
-Xms512m -Xmx2048m -Dfile.encoding=UTF-8 -Dorg.eclipse.ecf.provider.filetransfer.excludeContributors=org.eclipse.ecf.provider.filetransfer.httpclient4 -Dorg.eclipse.ecf.provider.filetransfer.retrieve.connectTimeout=6000 -Dorg.eclipse.ecf.provider.filetransfer.retrieve.retryAttempts=5
-XX:MaxPermSize=256m
Description/raison :
-XstartOnFirstThread -Dorg.eclipse.swt.internal.carbon.smallFonts
Description/raison :
-Dswing.defaultlaf=javax.swing.plaf.metal.MetalLookAndFeel
Description/raison :
Cette section est aussi liée à la page https://groupes.renater.fr/wiki/txm-info/public/options_arguments_lancement.
Tests pour activer tous les logs. Après l'install, avant de lancer TXM, ouvrir le fichier [Répertoire d'installation de TXM]\install.prefs et modifier/ajouter/fusionner les lignes suivantes :
log_console=true log_file=true log_in_console=true log_in_file=true log_level=ALL log_stacktrace=true
-consoleLog
avant la ligne -vmargs
Pour démarrer et forcer le niveau de log maximum de TXM (et RCP) il faut éditer le fichier de lancement de TXM (Windows : TXM.bat, Linux : /usr/bin/TXM et MacOSX : /Applications/TXM/TXM.app/Contents/MacOSX/TXM.sh) en ajoutant les arguments suivant juste devant l'argument “-run” :
[...] TXM -run -log -debug [...]
Il faut alors lancer TXM depuis le terminal avec le script de lancement
TODO: pour avoir tous les logs ajouter “&> ~/TXM/Logs.txt” à la fin de la dernière ligne de commande du fichier /usr/bin/TXM
Particulièrement utile pour obtenir les sorties CQP sous Linux depuis un TXM installé (car sinon elles ne s'affichent nul part). Sous Windows, dans le cadre d'un TXM installé, ces sorties sont redirigés dans les fichiers TXMLogs.txt et TXMErrorLogs.txt (voir plus bas pour les chemins des fichiers). Dans le cas d'un lancement depuis Eclipse, ces sorties sont affichées dans la console Eclipse (TODO: à vérifier s'il faut ou non lancer TXM avec l'option -noredirection).
Ci-dessous la liste et les emplacements des principaux fichiers de logs
Activé dans les préférences avancées de TXM, le journal contient tous les messages de la console + les messages utilisant les méthodes severe, warning, info et fine de logs de la classe : org.txm.utils.logger.Log
Il est créé dans un fichier temporaire avec le nom : TXM_YYYY-MM-DD.log (YYYY-MM-DD, les numéro de l'année, du mois et du jour).
Le chemin du fichier est indiqué au démarrage de TXM :
Copie des messages dans /tmp/TXM-2016-07-20.log
Chemins classiques :
Il s'agit du fichier de log de l'application RCP, contenant le chargement des bundles/plugins, etc..
“XXXXXX” étant le pid.
Fichier contenant les commandes R appelée lors de la session, il est généré à partir du bouton “Afficher le journal” de la vue “R Variables”
Fichier contenant la redirection des messages d'erreur du script de lancement de TXM
Fichier contenant la redirection des messages du script de lancement de TXM
Sous Win 7, ce fichier contient notamment le sdtout CQP (une fois TXM fermé).
TODO Description
TODO Description
Au lancement d'une application RCP un fichier de log temporaire est créé puis effacé si le lancement est réussi. Si le lancement échoue ce fichier ne s'efface pas et peut être utilisé pour le debug. Le fichier se situe à :
“XXXXXXXX” étant une suite de chiffres constituée, à confirmer, du timestamp au format Unix.
TODO
TODO: à quoi sert la pref “Run RServe in debug mode” dans les prefs TXM ? Est-ce qu'elle permet d'avoir plus de logs et si oui à quel endroit, console, fichier ?
A rédiger :
Lors d'une nouvelle installation, TXM essaie de récupérer l'ancien fichier de préférences utilisateur s'il existe, ce qui peut être problématique si on veut debugger sur une fresh install.
Installation (Windows 7)
NOTE : si ce fichier n'existe pas à l'installation, il est créé à partir du fichier install.prefs du dossier d'installation de TXM au premier lancement, c'est bien ça ?
Pour diverses raisons, notamment après un plantage de TXM, on peut avoir des corpus présents dans le répertoire utilisateur de TXM (Win : C:\Users\<USER>\TXM\corpora) mais qui ne sont pas chargés par TXM au démarrage. Soit ils n'apparaissent pas dans la vue “Corpus” de l'UI, soit ils apparaissent mais quand on clique une fois dessus le message “NOM DU CORPUS is not ready” apparaît dans la barre de statut de TXM et les commandes ne fonctionnent pas dessus. Voici 2 solutions pour remédier à ce problème. Attention, avant toute manipulation il est sans doute préférable de faire une copie du dossier du corpus.