Installation

De Notix - Logiciel documentaire de gestion de notices bibliographiques.

Sommaire

Utilisation des binaires précompilés

Windows

Un programme d'installation pour plate formes Windows est disponible dans la section téléchargements de Notix. Il est basé sur le logiciel libre NSIS.

Fedora

Installation du JRE/JDK Sun

Les distributions Fedora sont livrées avec une machine virtuelle java libre (OpenJDK) qui n'est pas compatible avec Notix (en raison de ce bogue : http://icedtea.classpath.org/bugzilla/show_bug.cgi?id=179).

Pour que Notix fonctionne correctement, récupérez d'abord la dernière version RPM du JDK 6.0 depuis le site http://java.sun.com.

Exécutez le fichier .rpm.bin obtenu : 

su -c 'sh jdk-6u14-linux-i586-rpm.bin'

Accepter le contrat de licence, le JDK sun sera installé automatiquement.

Installation du serveur Tomcat

Tomcat est disponible dans les dépôts de base de Fedora. Pour l'installer, la commande qui suit suffit : 

su -c 'yum install tomcat6 tomcat6-webapps'

Vous pourrez désirer installer également l'interface d'administration (qui n'est plus fournie par l'installation de tomcat par défaut désormais) : 

su -c 'yum install tomcat6-admin-webapps'

Vous pourrez ensuite démarrer le service de la façon suivante : 

su -lc 'service tomcat6 start'

Le démarrage automatique à l'amorce du système est achevé par la commande : 

su -lc 'chkconfig tomcat6 on'

Sur les autres distributions GNU/Linux, tomcat6 est généralement disponible sur les dépôts par défaut, la procédure sera donc sensiblement similaire.

Pensez également à éditez le fichier de configuration de tomcat (/etc/tomcat6/tomcat6.conf), et faites pointer la variable JAVA_HOME vers le JDK précédemment installé : 

JAVA_HOME="/usr/java/jdk1.6.0_14/"

Installation de notix

Trois paquets RPM sont disponibles dans la section téléchargements :

  • notix : la webapp Notix en elle-même
  • notix-examples : des bases exemple pour notix
  • notix-javadoc : la javadoc de Notix

Les paquetages RPM sont signés numériquement, aussi, vous pourrez vouloir installer la clé publique de la façon suivante (notamment pour utiliser yum) : 

su -c 'rpm --import http://adullact.net/frs/download.php/3806/RPM-GPG-KEY-adavignon'

L'installation des paquetages se fait via la commande rpm ou yum : 

su -c 'yum localinstall notix*.rpm'

Utilisation

Une fois les étapes de l'installation complétées, relancez le serveur tomcat : 

su -c 'service tomcat6 restart'

Puis lancez notix depuis votre navigateur web, à l'adresse : 

http://localhost:8080/notix

Autres systèmes d'exploitation

Les autres distributions qui utilisent une machine virtuelle différente de celle devraient pouvoir être configurées de façon similaire à Fedora.
Dans le cas contraire, veuillez vous reporter à la documentation de votre distribution pour connaitre la meilleure procédure à suivre pour l'installation du JDK Sun.

Pour installer Notix, référez-vous à la procédure d'installation manuelle décrite ci-dessous (l'utilisation des RPM Fedora 11 sur d'autres versions/distributions est très fortement déconseillée).

Installation manuelle

Récupérez et installez le JDK Java Sun 6.0 depuis le site http://java.sun.com/. Reportez-vous à la documentation de votre système d'exploitation pour connaître la procédure d'installation de Java.

Téléchargez et installez Tomcat.

Récupérez et décompressez le fichier ZIP ou tar bzippé de Notix depuis https://adullact.net/frs/?group_id=574.

  • Copiez le contenu du dossier src dans un contexte de webapp. Exemple : /home/tomcat/webapps/notix ou C:\tomcat\webapps\notix. Notez qu'il est impératif d'éviter les espaces dans le chemin d'installation de tomcat.
  • Renommez les fichiers de configuration génériques (dans le répertoire src/WEB-INF) :
    • cocoon.xconf.tmpl vers cocoon.xconf
    • web.xml.tmpl vers web.xml
    • XDBConfig.xml.tmpl vers XDBConfig.xml
    • ainsi que le dossier xmldb.tmpl vers xmldb
  • Renommez le fichier de configuration générique global-variables.xmap (dans le répertoire src) :
    • global-variables.xmap.tmpl vers global-variables.xmap
C'est dans ce fichier que vous pourrez modifier les identifiants et l'adresse email du super utilisateur.

Éventuellement :

  • Copiez le fichier dist/notix.xml vers le dossier de configuration de tomcat ($CATALINA_HOME/conf/Catalina/localhost/)
  • Éditez le fichier $CATALINA_HOME/conf/Catalina/localhost/notix.xml et adaptez les attributs « docBase" et « workDir » en fonction de l'emplacement de votre contexte webapp et de votre dossier work.
Récupérée de « http://notix.org/wiki/Installation »
Outils personnels