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 le centre d'activités Administration, 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 + horodatage>)
   • Journaux de connecteur SAP ODP (QvSapConnectorPackage-<id_de_processus>)
   • Journaux de connecteur SAP SQL (QvSqlBwConnector-<date + horodatage>)
   • 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 le centre d'activités Administration, vous pouvez également les ouvrir directement depuis le poste Direct Access gateway. Avec une installation par défaut, ces journaux se trouvent 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 le centre d'activités Administration, 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.

Prolongation de la durée de vie d'une session de chargement

Si la connexion entre Direct Access gateway et Qlik Cloud est inactive pendant au moins 20 secondes, l'opération de chargement peut parfois échouer en affichant l'erreur suivante :

Invalid object name '#<TempTableName>' (indicating that the Direct Access gateway temp tables are unavailable).

La durée de vie par défaut d'une session est de 20 secondes, mais si vous rencontrez souvent cette erreur, vous pouvez prolonger la durée de vie de la session comme suit :

1. Ouvrez C:\ProgramData\Qlik\Gateway\configuration.properties en tant qu'administrateur. 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. Recherchez le paramètre ODBC_RELOAD_SESSION_LIFE et augmentez sa valeur en fonction des besoins.
3. Enregistrez le fichier configuration.properties et redémarrez le service Qlik Data Gateway - Direct Access.

Extension du délai d'expiration des demandes de chargement

En cas d'interruptions de réseau, il se peut que les chargements échouent avec les erreurs suivantes :

Connector error: The session does not exist (DirectAccess-1509)

Connector error: The stream session expired for the load data request (DirectAccess-1012)

Si vous rencontrez souvent les erreurs ci-dessus, essayez de définir le paramètre EXTEND_FIRST_REQUEST_TIMEOUT sur 5-10 minutes.

Pour effectuer cette action :

1. Ouvrez C:\ProgramData\Qlik\Gateway\configuration.properties en tant qu'administrateur. 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. Recherchez le paramètre EXTEND_FIRST_REQUEST_TIMEOUT et augmentez sa valeur à 5-10 minutes. La valeur par défaut est 0.
3. Enregistrez le fichier configuration.properties et redémarrez le 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.

Désactivation de l'isolation de processus

Le Support Qlik peut vous demander de désactiver l'isolation de processus à des fins de dépannage.

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|SAPPACKAGE]_PROCESS_ISOLATION_MODE (Colorer toutes les lignes par condition) sur None (Lignes spécifiées).

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

Activation de l'isolement de processus ou modification du nombre de chargements simultanés

Pour activer l'isolement de processus ou modifier le nombre de chargements simultanés :

1. Ouvrez C:\ProgramData\Qlik\Gateway\configuration.properties en tant qu'administrateur. 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_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> et SAPPACKAGE_<property-name>.

2. Définissez [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE sur Load et [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_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.

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 12 chargements :

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=13

 

À partir de la version 1.6.7 de Direct Access gateway, la valeur MAX_PROCESS_COUNT peut dépasser 10 sans qu'il soit nécessaire de modifier d'autres paramètres. Pour isoler complètement les actualisations avec un type de connecteur spécifique (c'est-à-dire, pas plus d'une actualisation par processus de connecteur), cette valeur doit être définie sur un minimum de 30, mais il peut être nécessaire de la définir sur une valeur aussi élevée que 60 suivant la charge de travail.

Stockage de blocs de données corrompus ou manquants à des fins de chargement futur

Pour chaque opération d'actualisation, Direct Access gateway peut stocker des blocs de données corrompus ou manquants en mémoire et les décharger sur le disque. Cela s'avère particulièrement utile si vous n'utilisez pas la récupération automatique et si vous rencontrez régulièrement des erreurs 4025, 4020 et 4021. Vous activez cette fonctionnalité en définissant le seuil de taille de cache pour décharger des blocs de données corrompus ou manquants sur le disque (par chargement). Lorsque le seuil spécifié est atteint, la passerelle décharge les blocs chiffrés suivants sur le disque du poste Direct Access gateway.

Pour définir la taille de cache :

1. Ouvrez C:\ProgramData\Qlik\Gateway\configuration.properties en tant qu'administrateur. 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 RELOAD_CACHE_MEMORY_MB sur N (la valeur par défaut est 0, qui indique que la fonctionnalité n'est pas activée).

   où :

   N = taille qu'un bloc de données peut atteindre avant d'être actualisé.

   Note InformationsL'activation de cette fonctionnalité augmente la consommation de mémoire sur le poste Direct Access gateway ; c'est pourquoi, lorsque cette fonctionnalité est activée, nous recommandons de surveiller son impact sur la mémoire. La définition de la valeur RELOAD_CACHE_MEMORY_MB sur 100 devrait suffire dans la plupart des cas.
3. Enregistrez le fichier configuration.properties et redémarrez le service Qlik Data Gateway - Direct Access.