FAQ XQual - Questions fréquemment posées

Comment puis-je essayer XQual ?

Vous pouvez demander un essai de serveur dédié gratuitement et pendant 30 jours.
Vous voulez essayer XStudio GRATUITEMENT ?
Dans notre cloud   Essayez gratuitement 
Dans votre infrastructure   Contactez-nous
Si vous préférez l'installer sur site, configurez un serveur XQual complet.

Remarque :
  • Si vous souhaitez tester avec MSSQL, vous devez obtenir une licence d'essai
  • Si vous souhaitez tester avec Oracle, vous devez obtenir une licence d'essai
  • Si vous souhaitez effectuer un test avec LDAP, vous devez obtenir une licence d'essai

Quelle édition est la meilleure à évaluer ?

Vous pouvez obtenir une description des différentes fonctionnalités présentes dans chaque édition ici.

Comment puis-je obtenir de l'aide pour accélérer mon évaluation ?

Vous avez un accès direct et gratuit à différentes ressources de formation gratuitement sur notre portail dédié:
- Un Portail de e-learning (vidéos en Anglais et en Français)
- BootStrap qui fournit un guide et les fichiers d'import à charger certaines données vous évitant de saisir trop d'informations
- Des white-papers pour s'informer et devenir expert avec XQual
- Diverse présentations mettant le focus sur certaines fonctionnalités
Vous avez également accés à:
- Notre Service Helpdesk
24h/24 et 7j/7 - Accès direct à notre support sur support@xqual.com

Après avoir évalué XQual, puis-je conserver les données que j'ai déjà saisies ?

OUI, toutes les données seront dans votre instance de production et vous n'aurez pas à les ressaisir.

Après avoir évalué XQual, puis-je conserver les données que j'ai déjà saisies ?

OUI, toutes les données seront dans votre instance de production et vous n'aurez pas à les ressaisir.

Puis-je passer d'une édition à une autre si je le décide ?

Vous pouvez toujours mettre à niveau ou rétrograder pendant ou après votre évaluation.
La rétrogradation réduira l'ensemble des fonctionnalités, mais vous conserverez toutes vos données.

Comment puis-je obtenir une assistance technique ?

L'assistance la plus rapide est fournie via :
- Notre Service Helpdesk
24h/24 et 7j/7 - Accès direct à notre support sur support@xqual.com

Puis-je obtenir une assistance directe en utilisant uniquement des e-mails ?

OUI, notre système de billetterie permet des e-mails directs. Il suffit d'envoyer et de répondre aux e-mails pour conserver l'historique.
Votre e-mail initial doit être envoyé à notre support à support@xqual.com.

Comment puis-je être au courant des dernières modifications et si le bogue que j'ai signalé a été corrigé ?

Pour les bugs urgents et les évolutions spécifiquement demandées et planifiées, nous vous alertons simplement directement.

Nous gardons également un Changelog" transparent et aussi précis que possible.
Aussi, vous pouvez vouloir nous suivre sur nos réseaux sociaux (voir contacts).

J'ai trouvé un bug. Où puis-je le soumettre ?

Les bogues peuvent être signalés via notre Système de billetterie dédié.
Vous pouvez également contacter directement support@xqual.com pour obtenir une réponse rapide et/ou une correction de bogue.

Dans TOUS les cas, veuillez d'abord activer les traces et fournir ces traces dans votre rapport, indiquez la version exacte que vous utilisez, le client et le OS que vous utilisez.

C'est aussi une bonne idée de vérifier d'abord l'intégrité de votre base de données en cliquant sur l'élément de menu Outils > Vérifier l'intégrité de la base de données

Comment obtenir le journal/les traces de XQual ?

Avec le serveur XQual

Il y a des traces côté serveur (la partie la plus intéressante) et côté client.

Côté serveur :
Les traces sont généralement situées dans un fichier nommé catalina.out sur le serveur.
L'emplacement spécifique de ce fichier dépend du système d'exploitation, de la version de Tomcat, de la façon dont vous l'avez installé et de la façon dont il est configuré pour enregistrer les traces.

Les 2 endroits les plus courants:
/var/lib/tomcatX/logs/
/var/logs/tomcatX/

Autres façons de les trouver:
- chercher le fichier logging.properties dans l'installation Tomcat et consulter la valeur de la propriété 1catalina.org.apache.juli.FileHandler.directory.
- vérifier le fichier server.xml de votre installation Tomcat.
- Consulter le script catalina.sh de votre installation Tomcat.
- Cherche les fichiers contenant le texte 'GET COMMAND =' (e.g. sur linux: find /var/lib/tomcat9 -type f -exec grep -l "GET COMMAND =" {} \;)
Côté client :
Activez simplement le débogueur de votre navigateur en appuyant sur la touche F12.
Les traces sont disponibles dans l'onglet console du débogueur.

Comment supprimer un utilisateur ?

La suppression d'un utilisateur est fortement déconseillée.

La suppression d'un utilisateur supprime définitivement toutes les données associées à ce compte, y compris les tests, les bugs et les autres informations liées.

Nous recommandons fortement de désactiver les utilisateurs qui ne sont plus actifs. Les utilisateurs désactivés ne sont plus comptabilisés dans votre limite de licence, alors que toutes leurs données sont conservées.

Si vous souhaitez malgré tout supprimer définitivement un utilisateur
Si vous comprenez les risques et souhaitez supprimer l'utilisateur ainsi que toutes les données associées :
  • Connectez-vous en tant qu'admin, ou avec un compte disposant du droit "Supprimer un utilisateur" (ce droit n'est pas accordé par défaut).
  • Sélectionnez l'utilisateur et désactivez le compte.
  • Le bouton Supprimer devient alors disponible.
  • Cliquez sur Supprimer et confirmez l'opération, en ignorant l'avertissement affiché.
⚠ Avertissement : La suppression d'un utilisateur est définitive et supprime toutes les données associées à cet utilisateur. Assurez-vous que c'est vraiment ce que vous souhaitez faire avant de continuer.

XQual n'est pas encore localisé pour ma langue

Il est très facile de localiser XQual. Il existe une procédure assez simple pour ajouter une localisation personnalisée décrite ici.

Je ne peux pas télécharger de fichiers de plus de 1 Mo. Pourquoi ça ?

La configuration par défaut de MySql empêche de télécharger des fichiers de plus de 1 Mo.
Dans ce cas, vous pouvez rencontrer des erreurs telles que :
java.sql.SQLNonTransientConnectionException : impossible d'envoyer la requête : réinitialisation de la connexion par l'homologue : erreur d'écriture de socket ou similaire.

Pour changer cela, éditez le fichier my.ini et ajoutez le paramètre de configuration max_allowed_packet=100M dans la section [mysqld].

Il existe également un paramètre dans les paramètres de XQual pour limiter en douceur la taille des pièces jointes. Assurez-vous également qu'il n'y a pas de limite.

Où sont téléchargées mes pièces jointes ?

Lorsque vous cliquez sur le bouton télécharger ou télécharger et verrouiller, les fichiers sont téléchargés dans le répertoire temporaire de votre système. Sous Windows, il se trouve souvent dans C:\\Documents and Settings\\<votre compte>\\Local Settings\Temp\\ (ceci est spécifié dans le %TEMP% ou %TMP%).

J'ai perdu mon mot de passe administrateur et je n'ai pas d'autre compte avec les droits administrateur. Comment puis-je récupérer mon mot de passe ?

Vous ne pouvez pas le faire à partir de XQual (espérons-le ou ce serait une faille de sécurité majeure !).
Vous devez demander à votre administrateur de base de données de mettre à jour manuellement la colonne user_password du admin user dans la table table_user avec la valeur :
984F1197F84B21DDA2A631F72F9D082501B4FA1AA3798DC420A26ADE0B8792504325EBD701.
Cette procédure restaure le mot de passe administrateur par défaut : password.

Pourquoi ne puis-je pas me connecter à mon serveur Microsoft SQL ?

Il peut y avoir plusieurs raisons à cela.
La première chose à vérifier est que votre serveur SQL est configuré pour accepter la connexion TCP. Vérifiez également qu'il écoute sur le nom/IP@ et le port (par défaut 1433) que vous utilisez dans votre Configuration XQual.
Vous pouvez tester cela facilement en utilisant PortQryV2 (c'est un scanner de ports gratuit mis à disposition gratuitement par Microsoft).

Assurez-vous également d'utiliser la bonne version du pilote JDBC correspondant et la bonne version de Java. Nous vous conseillons d'utiliser Java 17 avec le pilote JDBC sqljdbc_3.0/enu/sqljdbc4.jar

De quoi ai-je besoin pour configurer TLS/SSL sur la connexion à la base de données ?

Vous devez d'abord configurer votre serveur de base de données pour qu'il accepte les communications cryptées. Veuillez contacter votre fournisseur de base de données pour cela car cela dépend du type et de la version du serveur de base de données que vous utilisez (de nombreux tutoriels sont également disponibles sur Internet).

AVERTISSEMENT : Vous devrez acheter un certificat auprès d'une autorité de certification connue et l'installer sur votre serveur de base de données en suivant les instructions de votre fournisseur de base de données.

Vous devrez également configurer XQual pour initier une communication TLS/SSL avec le serveur de base de données.
Nous vous conseillons vivement de commencer par l'activer en cochant simplement Accepter TOUT certificat TLS/SSL dans les paramètres de la base de données de XQual. Plus tard, vous pourrez fournir le certificat X.509 du serveur.

Récemment, j'ai commencé à avoir des popups d'erreur lors de la création d'un élément. Les journaux montrent des problèmes liés à utf8mb4. Qu'est-ce qui ne va pas ?

C'est probablement parce que :
  • vous avez mis à jour votre serveur MySQL (ou MariaDb)
  • ou vous avez changé le jeu de caractères par défaut de votre serveur en utf8mb4
  • ou vous avez changé votre pilote JDBC dans XQual
  • ou mis à jour vers XQual 4.0sp3 (qui inclut un nouveau pilote JDBC par défaut mariadb-java-client-2.7.4)

Voici la cause :
1) Dans les anciennes versions de MySQL (ou MariaDb), seul le jeu de caractères "utf8" était supporté.
Mais il s'est avéré que cette implémentation était incomplète (certains emojis « exotiques » n'étant pas pris en charge).
Oracle a donc ajouté un jeu de caractères "utf8mb4" qui a corrigé le problème.
Ce jeu de caractères est supporté depuis la version 5.5.3 de MySQL

2) Du point de vue de XQual, nous ne forçons aucun jeu de caractères.
Le DBA peut utiliser le jeu de caractères par défaut qu'il souhaite pour l'ensemble de la base de données.
Le seul cas où nous forçons un jeu de caractères est pour les champs de texte enrichi.
Nous les forçons (depuis la première version de XQual) à "utf8". Ensuite, lorsque nous exécutons une requête SQL qui nécessite un tri, nous forçons le classement à "utf8_bin" (qui était le seul classement sensible à la casse pour utf8 dans la version précédente de MySQL).

Nous le faisons en ajoutant à la requête :
WHERE field_name=field_value COLLATE utf8_bin

Alors quel peut être le problème ?
i) Votre DBA a défini "utf8mb4" comme jeu de caractères par défaut sur votre base et le "COLLATE utf8_bin" que nous utilisons est incompatible avec "utf8mb4"

ii) votre version MySQL est supérieure à 5.5.3 et le jeu de caractères par défaut sur votre base est "utf8" (ou autre c'est-à-dire "latin1", etc.).
Étant donné que votre version de MySQL est supérieure à 5.5.3, elle prend en charge utf8mb4.
Lorsque vous utilisez un "ancien" pilote JDBC (c'est-à-dire mariadb-java-clien2.7.4.5 comme dans la version XQual <= 4.0sp2), il ne prend pas en charge utf8mb4 et tout continue de fonctionner normalement en utf8 .
Lorsque vous utilisez un pilote JDBC récent, il accepte le nouveau jeu de caractères "utf8mb4" préféré par Oracle et "convertit" en temps réel les champs "utf8" en "utf8mb4".

Dans ce cas, nous devrions utiliser le nouveau classement "utf8mb4_bin" ou l'un des nouveaux classements sensibles à la casse ("as_cs") ajoutés par MySQL/MariaDb (c'est-à-dire "utf8mb4_0900_as_cs" etc.) mais cela fait partie de notre code et ne peut pas être actuellement personnalisé.

Solution
Nous venons d'ajouter la possibilité de spécifier le classement dans les paramètres de XQual. Cela sera disponible dans XQual 4.0sp4+.

Solution de contournement possible jusqu'à ce que 4.0sp4 soit publié (en fonction de différents facteurs) Vous pouvez essayer de mettre à jour le pilote JDBC que vous utilisez et d'utiliser un ancien tel que mariadb-java-clien2.7.4.5.

Je reçois une erreur java.lang.noClassDefFoundError lors du démarrage de Tomcat

XQual prend en charge Java 17 et Tomcat 9.

Comment les outils téléchargés depuis XQual (XAgent, etc.) peuvent-ils utiliser une configuration différente de celle du serveur (par exemple un autre serveur SMTP) ?

Lorsque vous téléchargez un outil (XAgent, XContinuousIntegration, XReportDebugger ou XResultsPublisher) depuis XQual, le serveur génère un package pré-configuré : il y injecte ses propres fichiers de configuration (xstudio.conf, bugtracking.conf, requirement.conf et sso.conf), afin que l'outil soit immédiatement utilisable.

Par défaut, les outils reçoivent donc exactement le même xstudio.conf que le serveur. Ce n'est pas toujours ce que vous souhaitez.

Exemple : deux serveurs SMTP différents
Votre serveur XQual envoie ses notifications par e-mail via un relais SMTP interne accessible uniquement depuis le réseau du serveur (par exemple smtp-internal.mycompany.com), mais vos agents s'exécutent sur des machines de test situées dans un autre réseau et doivent utiliser un autre serveur SMTP (par exemple smtp-lab.mycompany.com) pour envoyer leurs e-mails.

Solution
  • Sur le serveur, créez un fichier webapps/xqual/xstudio_client.conf (dans le même dossier que xstudio.conf).
  • Mettez-y uniquement les paramètres qui doivent être différents pour les outils, ici les paramètres SMTP :
    mail.smtp.host=smtp-lab.mycompany.com
    mail.smtp.port=587
    mail.smtp.from=xagent@mycompany.com
    
  • Téléchargez à nouveau l'outil depuis XQual.
Lorsque xstudio_client.conf existe, le serveur injecte son propre xstudio.conf dans le package, mais les paramètres présents dans xstudio_client.conf remplacent les valeurs du serveur (les paramètres absents du xstudio.conf du serveur sont ajoutés). Tous les autres paramètres (base de données, etc.) restent ceux du xstudio.conf du serveur : vous n'avez donc pas à les maintenir en double. Le serveur lui-même continue d'utiliser son propre xstudio.conf et n'est pas impacté.

Si xstudio_client.conf n'existe pas, les outils reçoivent simplement le xstudio.conf du serveur, comme auparavant.

Remarque : les mots de passe (par exemple mail.smtp.password) sont stockés chiffrés dans xstudio.conf. Si vous en remplacez un dans xstudio_client.conf, il doit être chiffré de la même façon : un mot de passe en clair ne fonctionnera pas. De plus, les outils déjà déployés ne sont pas mis à jour automatiquement : téléchargez-les à nouveau (ou modifiez manuellement leur xstudio.conf).