Installation

Dépendances

Serposcope nécessite Java 8. Pour vérifier que Java est correctement installé sur votre ordinateur exécutez la commande suivante : java -version.

Depuis la version 2, c'est la seule dépendance nécessaire. La base de données et le serveur HTTP sont maintenant intégrés au logiciel pour faciliter l'installation.

En complément, nous vous recommandons vivement de créer un compte sur un service qui gère les captchas.

Remarque importante : serposcope peut mettre plus de 30 secondes à démarrer lors de son premier lancement.

Installation Windows

Téléchargez la version windows et exécutez le fichier en tant qu'administrateur. Suivez les instructions indiquées.

Suite à l'installation, serposcope doit maintenant être automatiquement démarré et accessible à l'URL suivante : http://127.0.0.1:7134/.

Serposcope sera lancé automatiquement à chaque démarrage. Utilisez serposcopew.exe ou serposcope-monitor pour surveiller et redémarrer le logiciel.

Windows version Java64

La plupart du temps c'est la version 32 bits de Java qui est installée, même sur les versions 64 bits de Windows. La version Java64 est réservée aux systèmes d'exploitation Windows 64 bits utilisant Java 64 bits. Essayez toujours la version compatible 32 bits & 64 bits en premier avant de tester la version Java64.

Pour savoir si vous utilisez une version 64 bits de Java, exécutez la commande java -version dans cmd.exe.

Une version 64 bits renverra :

java version "1.8.0_73"
Java(TM) SE Runtime Environment (build 1.8.0_73-b02)
Java HotSpot(TM) 64-Bit Server VM (build 25.73-b02, mixed mode)

Tandis que la version 32 bits renverra :

java version "1.8.0_73"
Java(TM) SE Runtime Environment (build 1.8.0_73-b02)
Java HotSpot(TM) Client VM (build 25.73-b02, mixed mode)

Installation Ubuntu & Debian

Tout d'abord, vérifiez que la version 1.8 (ou supérieur) de Java est installée. Pour cela, ouvrez un terminal et exécutez la commande java -version :

admin@localhost:~$ java -version
java version "1.8.0_66"

Il est recommandé d'installer Java 8 en utilisant le dépôt de webupd8, pour Ubuntu :

sudo apt-get -y install software-properties-common
sudo add-apt-repository -y ppa:webupd8team/java
sudo apt-get update
sudo apt-get -y install oracle-java8-installer

Plus d'instructions d'installation peuvent être trouvées sur leur site :

Si vous avez installé Java d'une autre façon, il est nécessaire que la variable JAVA_HOME soit correctement définie. Cette variable doit contenir le répertoire d'installation de java.

Si vous avez installé Java dans le répertoire /opt/java/1.8, le binaire Java doit être situé à /opt/java/1.8/bin/java et la variable JAVA_HOME=/opt/java/1.8

Plus d'information sur la variable JAVA_HOME ici.

Maintenant, vous pouvez télécharger le package .dev et l'installer via la commande suivante :

sudo dpkg -i serposcope.deb

Serposcope doit maintenant être automatiquement démarré et accessible à l'URL suivante : http://127.0.0.1:7134/.

Si serposcope n'arrive pas à localiser JAVA_HOME, vous pouvez définir la variable dans le fichier /etc/default/serposcope.

Serposcope sera lancé automatiquement à chaque démarrage. Si vous souhaitez démarrer, arrêter ou redémarrer serposcope :

sudo service serposcope start|stop|restart

Generic jar (Mac, CentOS and other unix distribution) install instructions

Tout d'abord, vérifiez que la version 1.8 (ou supérieur) de Java est installée. Pour cela, ouvrez un terminal et exécutez la commande java -version :

admin@localhost:~$ java -version
java version "1.8.0_66"

Sur MAC il peut être nécessaire de télécharger spécifiquement la version JDK 1.8 d'Oracle ici sur le site officiel.

Téléchargez la version jar de serposcope.

Ouvrez une ligne de commande et exécutez la commande suivante : java -jar serposcope.jar. Cela va lancer serposcope, il devrait être accessible quelques secondes plus tard à l'URL suivante : http://127.0.0.1:7134/.

Pour le moment, nous ne fournissons pas d'installeur ni de moyen de lancer serposcope automatiquement à chaque démarrage pour la version générique. Cependant, les contributions sont les bienvenues.

Fichiers et répertoires de données

Ces fichiers et répertoires sont créés automatiquement lors du premier lancement de serposcope. Leur chemin d'accès est différent en fonction des systèmes d'exploitation.

Windows

La plupart du temps : C:\ProgramData\serposcope. Si ce n'est pas le cas, vérifiez le contenu de la variable d'environnement %ProgramData%

Ce répertoire contient le dossier logs contenant tous les logs de serposcope, la base de données db.mv.db et le fichier de configuration serposcope.conf.

Debian/Ubuntu

  • Configuration /etc/serposcope.conf
  • Fichier logs /var/log/serposcope/
  • Répertoire de la base de données /var/lib/serposcope/

Mac OSX et autres systèmes

Le répertoire de données est situé dans le dossier serposcope du répertoire utilisateur. Par exemple, si l'utilistaur bob a lancé serposcope, ce sera /Users/bob/serposcope ou /home/bob/serposcope.

Les dossiers suivent la même hiérarchie que sous Windows.

Configuration avancée

Vous pouvez modifier la configuration et le démarrage de serposcope en modifiant le fichier serposcope.conf.

Si vous lancez directement serposcope en ligne de commande (Mac OSX ou version générique), vous devez spécifier le chemin du fichier serposcope.conf, exemple :

java -Dserposcope.conf=/path/to/serposcope.conf -jar serposcope.jar

Sur Windows et lors de l'installation via les packages .deb, le chemin d'accès est déjà défini. Il est situé dans le répertoire de données.

ATTENTION: La plupart du temps vous n'avez pas besoin de modifier ce fichier. Serposcope fonctionne automatiquement sans configuration supplémentaire.

# path where is stored embedded database and data files
#serposcope.datadir=

# log path
#serposcope.logdir=

# alternative database url, mysql example to use mysql : 
# serposcope.db.url=jdbc:mysql://HOSTNAME/DATABASE?user=USER&password=PASS&allowMultiQueries=true
#serposcope.db.url=

# additional database options
#serposcope.db.options=
#serposcope.db.debug=

# listen interface
#serposcope.listenAddress=

# listen port
#serposcope.listenPort=