Dépannage

Récupération des logs

Serveur

Les logs serveurs sont stockés sur /opt/xtc/current/Var/Logs/. Les logs sont configurés en mode INFO par défaut. Le niveau DEBUG peut être activé depuis le fichier settings.ini.

Note

Il est possible de changer le niveau de logs à chaud en faisant un xtcl reload

Client

Les logs du client sont disponibles dans <Program Files>/Extensive Testing Client/Logs/ Les logs sont configurés en mode INFO par défaut.

Le niveau DEBUG peut être activé depuis les préférences du client.

../_images/preferences_application_logs.png ../_images/client_logs.png

Boîtes à outils

Les logs de la boîte à outils sont disponibles dans <Program Files>/Extensive Testing Toolbox/Logs/ Les logs sont configurés en mode INFO par défaut.

Le niveau DEBUG peut être activé depuis le fichier settings.ini.

../_images/toolbox_logs.png

Note

Un redémarrage de la boîte à outils est nécessaire pour prendre en compte le changement

Foire aux questions

Comment changer le port d’écoute (tcp/443) du serveur ?

Editer le fichier /etc/httpd/conf.d/extensivetesting.conf et modifier le port d’écoute du virtual host 443. Ne pas oublier de modifier le fichier /etc/httpd/conf/httpd.conf pour ajouter le nouveau port d’écoute.

Note

Un redémarrage d’apache est nécessaire.

Comment changer le port de connexion du client ?

Le port de destination peut être modifié depuis les préférences du client. Ou bien directement depuis le fichier settings.ini.

../_images/preferences_network_ports.png

Afficher la version du serveur?

./xtctl version
Server version: 18.0.0

Quoi faire si l’installation du serveur ne fonctionne pas?

Le déroulement de l’installation du serveur est loggué dans un fichier install.log présent dans le répertoire après extraction du paquet. Il faut rechercher les messages d’erreurs présents dans le fichier.

Quoi faire si ma connection au serveur ne fonctionne pas?

Si la connection depuis le client au serveur ne fonctionne pas, une analyse est nécessaire.

Le 1er reflex à avoir est de se connecter sur le serveur en SSH et d’exécuter la commande xtctl status pour vérifier si le serveur tourne.

  1. Si le serveur est en cours d’exécution alors il faut vérifier:
  • la connectivité réseau en le client et le serveur
  • un parefeu bloquant le flux https (443)

2. Si la connectivité réseau est bonne et que le serveur fonctionne (ou pas), il faut vérifier les logs. Le fichier est disponible dans le répertoire /opt/xtc/current/Var/Logs/output.log. Il faut rechercher les messages de type ERROR

Comment corriger l’erreur « hping3 n’est pas installé » ?

Cette erreur apparait durant l’exécution d’un test quand l’adaptateur Pinger est utilisé. En effet nécessite d’avoir la librairie système hping3 d’installée sur le serveur.

Il faut récupérer les sources depuis https://github.com/antirez/hping et les compiler:

cd hping-master
yum install libpcap-devel-1.5.3-9.el7.x86_64
ln -s /usr/include/pcap/bpf.h /usr/include/net/bpf.h
./configure
make
make install

Comment installer le serveur dans un répertoire spécifique?

Par défaut, le serveur s’installe dans le répertoire /opt/xtc/, il est possible de changer ce répertoire au moment de l’installation en modifiant la clé INSTALL dans le fichier default.cfg

INSTALL=/opt/xtc/

L’installation du serveur reste bloquée sur l’ajout des librairies externes

Avant de lancer l’installation du serveur, il faut vérifier que le service yum n’est pas déjà en cours d’exécution. Si oui alors, le script d’installation restera bloqué tant que yum n’est pas disponible. Ce problème arrive généralement lorsque le serveur est installé en mode graphique.

Dans les logs , on peut observer l’erreur suivante:

Existing lock /var/run/yum.pid: another copy is running as pid 3293.
Another app is currently holding the yum lock; waiting for it to exit...
  The other application is: PackageKit
    Memory :  26 M RSS (429 MB VSZ)
    Started: Tue Nov  1 11:09:25 2016 - 00:42 ago
    State  : Sleeping, pid: 3293

Pour résoudre ce problème, il faut arrêter le programme qui utilise déjà yum.

Impossible de naviguer dans l’interface web

Si vous arrivez à vous connecter sur l’interface web mais qu’il est impossible de naviguer dans les menus. Le cookie généré par le serveur peut être expiré, il faut vérifier que le serveur est bien à l’heure.