Dépannage de Direct Access gateway

Cette section décrit plusieurs actions à entreprendre pour résoudre les problèmes rencontrés par Direct Access gateway.

Affichage et téléchargement de fichiers journaux

Les fichiers journaux fournissent des informations sur les opérations Direct Access gateway. Qlik Support peut vous demander de fournir des fichiers journaux à des fins de dépannage. Vous pouvez afficher ou télécharger les fichiers journaux dans la visionneuse du journal. Dans des circonstances normales, il n'y a pas de raison d'examiner les fichiers journaux ; mais si vous rencontrez des échecs répétés ou d'autres problèmes, les fichiers journaux permettront généralement de repérer la cause.

Pour ouvrir la visionneuse du journal :

1. Dans la Console de gestion, accédez à Passerelles de données et repérez votre Direct Access gateway.

2. Cliquez sur à la fin de la ligne et sélectionnez Afficher les journaux.

   La fenêtre Visionneuse du journal s'ouvre.

3. Dans la liste déroulante dans le coin supérieur gauche, sélectionnez le type de journal que Qlik Support vous a demandé d'afficher ou de télécharger.

   Les journaux suivants sont disponibles :

   • Journaux Direct Access gateway (DirectAccessAgent)
   • Journaux DCaaS(dcaas_logs)
   • Journaux de connecteur basé sur ODBC (odbc-connector_logs)
   • Journaux de connecteur SAP BW (QvSAPBwConnector-<date + timestamp>)
   • Journaux de connecteur SAP SQL (QvSqlBwConnector-<date + timestamp>)
   • Journaux d'agent de connecteurs (connector-agent_logs_<date>)

4. Dans la liste déroulante adjacente, sélectionnez le journal à afficher ou télécharger. Les fichiers journaux sont triés du plus récent (le fichier journal actuellement actif) au plus ancien. Après avoir sélectionné un fichier journal, vous pouvez utiliser les boutons et pour passer au début ou à la fin du fichier journal, respectivement.

   Note ConseilLa vue du fichier journal n'est pas mis à jour automatiquement avec les messages les plus récents. Pour mettre la vue à jour, cliquez sur pour passer à la fin du fichier journal, qui sera actualisé à l'aide des messages les plus récents.

5. Pour télécharger le fichier journal, cliquez sur Télécharger.

   Suivant les paramètres de votre navigateur, le fichier est téléchargé sur votre ordinateur ou vous serez invité à l'enregistrer.

Ouverture des journaux Direct Access gateway sur le poste Direct Access gateway

Outre le fait de pouvoir télécharger les journaux Direct Access gateway (DirectAccessAgent) depuis la Console de gestion, vous pouvez également les ouvrir directement sur le poste Direct Access gateway. Avec une installation par défaut, ces journaux sont placés dans :

C:\Program Files\Qlik\ConnectorAgent\data\logs

Modification du niveau de détail de la journalisation

Vous pouvez afficher et modifier le niveau de détail de la journalisation des journaux Direct Access gateway (DirectAccessAgent) selon les besoins. Pour ce faire, exécutez les commandes suivantes depuis le sous-dossier ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent avec une installation par défaut).

• Pour afficher le niveau de journalisation existant, exécutez :

  connectoragent configuration getloggers

• Pour définir le niveau de journalisation sur Trace, exécutez :

  connectoragent configuration setloggers -l Root -v DEBUG

• Pour définir le niveau de journalisation sur Verbose, exécutez :

  connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

Mise à jour de la clé d'inscription

Il peut être nécessaire de modifier la clé d'inscription en cas de corruption éventuelle de la clé ou si vous pensez qu'un utilisateur non autorisé a accédé au serveur de passerelles de données.

Pour mettre la clé d'inscription à jour :

1. Sur le serveur de la passerelle Accès direct, ouvrez une invite de commande en tant qu'administrateur et définissez le répertoire de travail sur le sous-dossier ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent avec une installation par défaut).

2. Exécutez les commandes suivantes :

   • Générez la nouvelle clé :

     connectoragent qcs generate_keys

   • Affichez la clé :

     connectoragent qcs get_registration

     La clé s'affiche :

     

3. Copiez la clé complète, comme indiqué dans l'exemple ci-dessus.

4. Dans la Console de gestion, ouvrez les paramètres de la passerelle de données en cliquant sur le bouton à la fin de la ligne correspondante et en sélectionnant Modifier.

5. Collez la clé dans le champ Clé (en remplaçant la clé existante) et enregistrez les paramètres.

6. Revenez au serveur de la passerelle Accès direct et redémarrez le service Qlik Data Gateway - Direct Access, comme décrit dans Gestion du service Qlik Data Gateway - Direct Access.

Atténuation des plantages de connecteur lors du chargement

L'isolation de processus permet aux administrateurs disposant d'un accès direct au système d'exploitation du serveur de passerelles de contrôler le nombre de processus disponibles pour les chargements par type de connecteur. La diffusion des chargements sur plusieurs processus de connecteur augmente le niveau d'isolement en réduisant le nombre de chargements exécutés simultanément sur chaque processus de connecteur. Cette opération, à son tour, améliore la stabilité générale de Direct Access gateway en cas de plantage de certains connecteurs.

Pour activer l'isolation de processus :

1. Ouvrez le fichier C:\ProgramData\Qlik\Gateway\configuration.properties. Si vous le faites via Windows Explorer, assurez-vous que l'option Show hidden files, folders, and drives (Afficher les fichiers, dossiers et lecteurs masqués) est sélectionnée.

   Le fichier contient trois préfixes correspondant aux différents types de connecteur : ODBC_<nom-de-propriété>, SAPBW_<nom-de-propriété> et SAPSQL_<nom de propriété>.

2. Définissez ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE sur Load et ODBC|SAPBW|SAPSQL_MAX_PROCESS_COUNT sur N.

   où :

   N = un processus de commande + nombre de processus de chargement simultanés à allouer. Par exemple, une valeur 10 signifie un maximum de 9 chargements simultanés.

   Note Informations

   Vous ne pouvez pas définir la valeur [ODBC|SAPBW|SAPSQL]_MAX_PROCESS_COUNT sur un chiffre supérieur à 10 avec les paramètres de plage et de numéro de port par défaut.

3. Enregistrez le fichier configuration.properties et redémarrez le service Qlik Data Gateway - Direct Access.

Pour désactiver l'isolation de processus :

1. Ouvrez le fichier C:\ProgramData\Qlik\Gateway\configuration.properties. Si vous le faites via Windows Explorer, assurez-vous que l'option Show hidden files, folders, and drives (Afficher les fichiers, dossiers et lecteurs masqués) est sélectionnée.

2. Définissez ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE sur None.

3. Enregistrez le fichier configuration.properties et redémarrez le service Qlik Data Gateway - Direct Access.

Exemples d'isolation de processus du connecteur ODBC

L'extrait de fichier configuration.properties suivant montre comment activer l'isolation de processus du connecteur ODBC pour un maximum de 9 chargements :

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=10

Si vous modifiez les paramètres de port par défaut, la valeur MAX_PROCESS_COUNT peut dépasser 10. Cependant, dans ce cas :

• Le nombre de ports entre ODBC_PORT ou ODBC_DATA_PORT_RANGE_START et SAPBW_PORT ou SAPBW_DATA_PORT_RANGE_START doit être supérieur ou égal à ODBC_MAX_PROCESS_COUNT

• Le nombre de ports entre SAPBW_PORT ou SAPBW_DATA_PORT_RANGE_START et SAPSQL_PORT ou SAPSQL_DATA_PORT_RANGE_START doit être supérieur ou égal à SAPBW_MAX_PROCESS_COUNT

Par exemple, pour définir ODBC_MAX_PROCESS_COUNT=30, les paramètres de port doivent ressembler à ceci :

# ODBC Connector

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=30

ODBC_DATA_PORT_RANGE_START=50260

ODBC_PORT=3005

# SAP BW Connector

SAPBW_PROCESS_ISOLATION_MODE=None

SAPBW_MAX_PROCESS_COUNT=0

SAPBW_DATA_PORT_RANGE_START=50290

SAPBW_PORT=3035

# SAP SQL Connector

SAPSQL_PROCESS_ISOLATION_MODE=None

SAPSQL_MAX_PROCESS_COUNT=0

SAPSQL_DATA_PORT_RANGE_START=50300

SAPSQL_PORT=3045