S’asseoir avec des experts en progression

Le Progress OpenEdge L’équipe a récemment organisé un webinaire sur Soutenir PAS pour OpenEdge avec les experts du progrès Roy Ellis et Dan Mitchell. Le webinaire fournira des connaissances de base de l’AP pour OpenEdge et certains outils pour vous aider à prendre en charge et à déboguer les problèmes. Voici un récapitulatif de certains des sujets clés qui ont été couverts.

Comprendre l’architecture

Avant de commencer à déboguer le Progress Application Server pour OpenEdge (PAS pour OpenEdge)il est essentiel de saisir son architecture. Cette compréhension n’est pas seulement une formalité technique; C’est une étape critique qui améliore l’efficacité et l’efficacité de vos efforts de débogage. Savoir comment PAS pour OpenEdge est structuré vous aide à identifier les problèmes plus précisément et à les résoudre plus rapidement, à minimiser les temps d’arrêt et à soutenir les opérations plus lisses.

Le Classic AppServer nécessite plusieurs processus et un adaptateur pour servir les pages Web. En revanche, PAS pour les fonctions OpenEdge en tant que serveur Web, réduisant le nombre de processus et simplifiant les opérations. Il s’exécute en tant qu’application Web dans Tomcat et utilise un nouvel agent multi-session prenant en charge plusieurs applications ABL.

Ensuite, vous devrez comprendre l’aller-retour d’une demande via PAS pour OpenEdge. Cela commence par la connexion client, où les clients se connectent via HTTP ou HTTPS. Le serveur Web TomCat gère toutes les demandes entrantes et l’authentification Spring gère l’authentification des utilisateurs, défaut en anonyme sinon spécifié. Le gestionnaire de session traite ensuite ces demandes et les envoie à l’agent, qui utilise des threads de travail pour trouver une session ABL disponible et exécuter les demandes. Enfin, la réponse est renvoyée via le gestionnaire de session à Tomcat puis au client.

Problèmes de débogage et de résolution

Problèmes de débogage

Commencez toujours à déboguer les problèmes en examinant les fichiers journaux. Savoir quel fichier journal se rapporte à chaque partie du processus aller-retour est essentiel et est démontré dans le graphique ci-dessous. Vous pouvez trouver des informations détaillées sur les fichiers journaux.

Corriger les problèmes courants

Le problème le plus courant lorsque les applications sont migrées du classique vers le PAS pour OpenEdge est les fuites de mémoire des applications. La fonction de suivi Ablobjects trouve des fuites de mémoire pour vous, mais la réalisation des modifications de code d’application peut prendre beaucoup de temps, vous avez donc besoin d’un moyen de récupérer la mémoire du système pendant que vous corrigez les fuites de mémoire.

Pour maintenir votre application en cours d’exécution, ou pour réparer tout agent multi-session mal comportemental, l’arrêt de l’agent est votre meilleur plan d’action. Démarrez toujours un nouvel agent en utilisant d’abord les API Oemanager et envoyez une commande «Stop» à l’agent mal comportemental. De nouvelles demandes seront envoyées au nouvel agent tandis que l’agent de mauvaise conduite continuera de traiter les demandes actuelles. Une fois les demandes terminées, l’agent de mauvaise conduite se terminera et les ressources système seront retournées.

Remarque: Ne tuez pas l’agent multi-session, arrêtez-vous toujours en utilisant les API Oemanager.

Conseils et astuces

Pour un débogage efficace, collectez toujours des journaux complets dans le répertoire des journaux et la base de données. Vérifiez le fichier OpenEdge.Properties pour les détails de configuration importants. Recherchez les fichiers PROTRACE ou CORE dans le répertoire Work ou Logs pour des informations de débogage supplémentaires. Renseignez-vous sur les changements récents, car même des mises à jour mineures peuvent entraîner des problèmes importants. Enfin, comprenez si la configuration du système est sur une seule boîte ou plusieurs, et si l’équilibrage de charge est utilisé, pour mieux diagnostiquer et résoudre les problèmes.

Outils de diagnostic pour PAS pour OpenEdge

Il existe de nombreux outils de diagnostic pour PAS pour OpenEdge. Nous couvrirons les API Oemanager REST, les appels de ligne de commande OEJMX, les scripts Oemanager et la santé dans un futur webinaire et blog.

Les fichiers journaux sont la pierre angulaire du débogage, et puisque PAS pour OpenEdge diffère de l’Appserver classique, il a son propre ensemble de fichiers journaux. Les fichiers journaux sont votre première ligne de défense lors du diagnostic des problèmes dans PAS pour OpenEdge. Voici les fichiers journaux clés que vous devez être familiers:

• Journaux Tomcat:
• Catalina.out ou Catalina.date.log: Ces journaux fournissent des informations sur les problèmes de démarrage Tomcat, les erreurs Java et autres événements critiques. Recherchez ici les erreurs hors mémoire, les vannes bloquées (processus de longue durée) et les statuts de démarrage / arrêt.
• Fichier d’accès hôte local: Ce journal enregistre toutes les demandes à TomCat ou PAS pour OpenEdge, y compris la source de demande, le type de demande et le temps de réponse. Il est crucial pour suivre le flux des demandes et identifier les goulots d’étranglement des performances. Recherchez les codes de retour (200 pour le succès, 400 pour les problèmes de sécurité, 500 pour les défaillances des applications) et les ID de demande pour tracer les demandes via le système.
• OpenEdge Specific Journaux:
• Journaux du gestionnaire de session: oepas1.date.log: Ce journal est similaire à l’ancien ubroker.log et contient des messages du gestionnaire de session, tels que la disponibilité de la session et les erreurs d’état. Les erreurs ici indiquent souvent des problèmes qui sont nés ailleurs, alors utilisez ce journal pour guider une enquête plus approfondie.
• Journaux d’agent: oepas.agent.date.log: Ce journal fournit des détails sur les activités au niveau de l’application, y compris les connexions de base de données et d’autres opérations précédemment enregistrées par les journaux d’agent ou de serveur classiques.

En comprenant et en utilisant efficacement ces outils de diagnostic, vous pouvez dépanner et résoudre les problèmes dans PAS pour OpenEdge plus efficacement. N’oubliez pas que l’analyse des logarithmes logiques est essentielle pour identifier la cause profonde des problèmes et maintenir des opérations lisses.

Étapes essentielles pour le débogage des AP pour les problèmes d’OpenEdge

Une approche systématique est cruciale pour le débogage des AP pour OpenEdge. Voici un guide concis:

• Collectez tous les fichiers journaux: Rassemblez tous les journaux pertinents du répertoire des journaux et des journaux de base de données pour une analyse complète.
• Vérifiez le fichier OpenEdge.Properties: Fournit des informations sur les agents et les emplacements des fichiers journaux.
• Recherchez les fichiers ProTrace ou Core: Dans le répertoire des travaux ou des journaux, ceux-ci contiennent de précieuses informations de pile ABL.
• Renseignez-vous sur les changements récents: Renseignez-vous sur les correctifs ou les mises à jour du système récent.
• Comprendre la configuration: Sachez si tout se trouve sur une boîte ou réparti sur plusieurs – et si l’équilibrage de charge est utilisé.
• Identifier l’environnement de fonctionnement: Déterminez si la configuration est sur site, basée sur le cloud ou hybride.
• Vérifier les journaux système: Recherchez des processus hors mémoire si les agents disparaissent sans messages.
• Surveiller les ressources du système: Rassemblez des données sur la mémoire, l’échange et les E / S de disque pour identifier les problèmes de performances.
• Arrêtez, ne tuez pas les agents: Arrêtez correctement les agents problématiques pour éviter les perturbations de la base de données.
• Utilisez des connexions client-serveur: Empêchez les accidents de la base de données en utilisant des connexions client-serveur, même localement.
• Tester à partir de la ligne de commande: Aide à déterminer si les problèmes sont avec des outils ou des AP pour OpenEdge lui-même.
• Nettoyer les fichiers journaux: Utilisez Pasman ou TCMan Clean pour gérer les fichiers journaux.
• Configuration de la surveillance: Implémentez la surveillance avec OpenEdge Management, outils tiers ou scripts personnalisés.
• Utiliser l’équilibrage de la charge: Fournit des capacités supplémentaires et une manipulation de basculement plus facile.

Suivre ces étapes aide à maintenir un stable et efficace AP pour un environnement OpenEdge.

Cela semble intéressant? Regardez l’enregistrement du webinaire.