Réserver une Démo
Pré. Proc.

Dépannage PCS

Test Navigateur

Pour vérifier simplement que le Pro Cloud Server fonctionne sur les ports spécifiés définis dans le fichier de configuration, vous pouvez saisir cette adresse dans un navigateur Web :

<protocole>://<nom de la machine>:<port>

Par exemple, en utilisant les paramètres par défaut sur la machine sur laquelle Pro Cloud Server est installé :

http://localhost:1804/

Ou

https://sparxcloud.com:1804/

Si le port est activé, ce message est renvoyé :

Serveur cloud Sparx Systems Pro Cloud Server vX.X.XX

Félicitations, votre serveur est maintenant prêt à héberger vos modèles. Connectez-vous via le client de configuration pour ajouter ou supprimer des modèles.

Si ce message ne s'affiche pas, confirmez le nom du serveur et le port, vérifiez si d'autres services écoutent sur le port spécifié, vérifiez le fichier log du serveur pour les messages d'erreur et vérifiez les pare-feu entre le client et le serveur pour confirmer qu'il existe une connectivité et que le ou les ports concernés sont ouverts.

Test de connexion

Si vous rencontrez des problèmes avec la vitesse de réponse d'une connexion existante à un serveur Pro Cloud Server , une vérification initiale simple consiste à utiliser le Test de connexion Pro Cloud Server . Ce test est accessible à partir de :

  • Ruban : Démarrer > Aide > Aide > Connexion Pro Cloud Server .
Il renvoie les détails dans la fenêtre de sortie système dans ce format :
  • Le numéro de version Pro Cloud Server
  • Le temps de réponse Ping en millisecondes de la machine actuelle à la machine Pro Cloud Server
  • Le moment pour répondre à une requête simple.
Par exemple:
  • Pro Cloud Server : Version '5.0.100'
  • Pro Cloud Server : Temps de réponse : 26 ms
  • Pro Cloud Server : Temps d'exécution d'une requête de base de données simple : 23 ms
Lorsque le test Ping est élevé, la connectivité générale, y compris la connexion WAN ou les serveurs proxy, doit être vérifiée.

Lorsque le test Ping se situe dans une plage raisonnable, mais que l'exécution de la requête est élevée, il y a alors lieu de vérifier la connexion PCS au SGBD ou la réponse du SGBD lui-même.

Erreurs affichées dans la sortie du système Enterprise Architect

Message d'erreur

Signification

Voir aussi

Code d'état HTTP : 503 Service indisponible

Indique que le service Pro Cloud n'est pas en cours d'exécution sur le serveur.

  • Vérifiez que vous avez le nom de serveur et le port corrects
  • Vérifiez que le service « Sparx Systems Professional Cloud » est actuellement en cours d'exécution sur le serveur
Configuration Pro Cloud Server

Statut HTTP 401 Accès refusé

Indique un échec d'authentification auprès du serveur.

Avec le serveur Web intégré, cette erreur se produit si un nom d'utilisateur ou un mot de passe non valide a été fourni, ou si aucun nom d'utilisateur ou mot de passe n'a été fourni.

Statut HTTP 403

Indique une tentative d'accès à un modèle marqué sur le serveur comme « Nécessitant une connexion authentifiée et sécurisée ».

Cela peut indiquer que vous vous connectez à l'aide d'un protocole http au lieu de https , ou que le port que vous utilisez ne fournit pas d'authentification au modèle auquel vous vous connectez.

Vérifiez que vous utilisez https.

Vérifiez auprès de l’administrateur système que l’option d’authentification de sécurité pointe vers un modèle avec la sécurité activée.

Si la sécurité utilisateur est activée sur le modèle en question après l'activation de l'option « Exiger une connexion authentifiée et sécurisée » dans Pro Cloud Server demandez à l'administrateur système de désactiver puis de réactiver l'option « Exiger une connexion sécurisée et authentifiée », en veillant à enregistrer le gestionnaire de base de données à chaque fois. Cela réinitialisera l'indicateur interne que Pro Cloud Server conserve afin qu'il puisse valider les informations d'identification de l'utilisateur.

Configurer le gestionnaire de base de données Configuration du port

Statut HTTP 500 Impossible de se connecter au service

La connexion n'est pas acceptée.

  • Vérifiez le nom du serveur
  • Vérifiez les paramètres du pare-feu sur le client et le serveur
  • Vérifiez les ports sur lesquels le serveur écoute
Configuration du port Configuration Pro Cloud Server Paramètres du pare-feu

Le gestionnaire de base de données pour cette base de données a été arrêté

Enterprise Architect a établi une connexion à un Pro Cloud Server et a demandé à se connecter à un référentiel connu, mais le référentiel est actuellement désactivé.

Demandez à votre administrateur système de cocher l’option « Activé » pour le gestionnaire de base de données en question.

Configurer le gestionnaire de base de données

Il n'y a pas de gestionnaire de base de données configuré pour le référentiel demandé

Enterprise Architect a établi une connexion à un Pro Cloud Server , mais le nom du modèle demandé ne correspond à aucune base de données définie sur le serveur.

Lorsque vous accédez au modèle à l'aide de l'écran Connexion Cloud Enterprise Architect , assurez-vous que le nom Modèle saisi correspond à l'alias affiché dans le client de configuration Pro Cloud Server . Pour l'alias, consultez la rubrique d'aide Configurer le gestionnaire de base de données .

Configurer le gestionnaire de base de données Connecter Enterprise Architect à un Modèle Cloud

Impossible de se connecter à la base de données

Enterprise Architect a établi une connexion à un Pro Cloud Server et a demandé à se connecter à un référentiel connu ; cependant, lorsque le serveur a tenté d'ouvrir une connexion à la base de données à l'aide des détails fournis, il a échoué.

Note : chaque fois que cette erreur se produit, un message de niveau d’avertissement contenant des informations plus détaillées sera écrit dans les journaux Pro Cloud Server .

Si le référentiel est :

  • À l'aide d'ODBC, demandez à votre administrateur système de vérifier qu'une connexion ODBC est définie comme un DSN système (et non un DSN utilisateur) sur le serveur, que tous les paramètres de connexion sont corrects et que le nom d'utilisateur et le mot de passe de la base de données ont été enregistrés dans le DSN ODBC ou la string de connexion.
  • Oracle, demandez à votre administrateur système de vérifier que le nom d'utilisateur et le mot de passe ont été enregistrés avec la string de connexion et que toutes les autres options de la connexion sont correctes
  • Connexion à SQL Server via OLE DB et authentification Windows , demandez à votre administrateur système de vérifier que le nom d'utilisateur du service Pro Cloud Server est en cours d'exécution et qu'il a reçu l'autorisation d'accéder à la base de données SQL Server (au minimum, il aura besoin des rôles db_datareader et db_datawriter) et que toutes les autres options de la connexion sont correctes
  • Connexion au serveur SQL via OLE DB et authentification SQLServer, demandez à votre administrateur système de vérifier que le nom d'utilisateur défini a reçu l'autorisation d'accéder à la base de données SQL Server (au minimum, il aura besoin des rôles db_datareader et db_datawriter), que l'option permettant d'enregistrer le mot de passe avec la string de connexion a été activée et que toutes les autres options de la connexion sont correctes

12007 - Le nom ou l'adresse du serveur n'a pas pu être résolu

Indique que le nom du serveur (ou l'adresse IP) est incorrect.

  • Vérifiez que le nom du serveur est correct
  • Tentez le Test Navigateur décrit au début de cette rubrique

12029 - Impossible d'établir une connexion avec le serveur

Cela peut indiquer que le Pro Cloud Server n'est pas installé, que le service n'est pas en cours d'exécution ou qu'un port incorrect a été saisi.

  • Confirmer que le Pro Cloud Server est installé
  • Vérifiez que le service « Sparx Systems Professional Cloud » est en cours d'exécution
  • Vérifiez que vous avez entré un port valide (c'est-à-dire qu'il doit correspondre à celui défini dans le client de configuration)
  • Tentez le Test Navigateur décrit au début de cette rubrique
Configuration du port

12031 - La connexion avec le serveur a été réinitialisée

Cela peut se produire si vous essayez de vous connecter avec le protocole HTTP, mais que le port que vous avez entré est configuré pour HTTPS (par exemple 805).

  • Si vous avez sélectionné le protocole HTTP, confirmez que le port que vous avez saisi est configuré pour l'accès HTTP
  • Si vous avez sélectionné le protocole HTTPS, confirmez que le port que vous avez saisi est configuré pour l'accès HTTPS
Consultez la rubrique d’aide sur la configuration des ports pour plus de détails.
Configuration du port

Après la réinstallation, Enterprise Architect ne fonctionne plus

Votre environnement fonctionnait correctement, puis vous avez effectué la mise à jour vers la dernière version de Pro Cloud Server et maintenant les clients Enterprise Architect ne peuvent pas se connecter à vos modèles Cloud .

Lors du processus de réinstallation, le programme d'installation de Pro Cloud Server désinstalle la version d'origine, puis installe la nouvelle. Par conséquent, l'exception de pare-feu ajoutée automatiquement par le programme d'installation est supprimée et recréée. Si l'exception de pare-feu par défaut avait été ajustée (après l'installation d'origine) pour s'adapter à votre environnement, ces modifications auraient été perdues lors du processus de réinstallation. Une méthode pour empêcher que cela ne se reproduise à l'avenir consiste à créer une toute nouvelle exception de pare-feu (avec un nom différent) qui est une copie de celle créée par le programme d'installation, et à apporter les modifications manuelles nécessaires à cette exception.

Lecture des journaux du serveur

Comme mentionné précédemment, Sparx Systems Pro Cloud Server est une application de services Windows et doit donc se conformer à certaines règles de base. Le dépannage des services Windows peut être problématique, car ils exécuter indépendamment de toute saisie/interaction utilisateur et ne contiennent donc aucun écran/interface graphique d'aucune sorte. Pour cette raison, Sparx Systems Pro Cloud Server écrit tout message potentiel dans des fichiers journaux.

Le fichier de configuration Pro Cloud Server contient un certain nombre de paramètres qui contrôlent l'emplacement, le nombre et la taille des fichiers log . Par défaut, le Pro Cloud Server enregistre tous les fichiers log dans un dossier \Logs\ sous :

\Services\ (C:\Program Files (x86)\ Sparx Systems \ Pro Cloud Server \Service\Logs)

Il conservera jusqu'à trois fichiers. Un nouveau fichier sera créé à chaque démarrage du service Cloud ou à chaque fois que la taille maximale du fichier sera atteinte. Le nom de fichier « SSProCloudServerLog-1. log » sera toujours le fichier log le plus récent et chaque fois qu'un nouveau fichier est créé, les plus anciens sont renommés en augmentant le numéro. Par exemple, SSProCloudServerLog-2. log est renommé en SSProCloudServerLog-3. log .

Le fichier de configuration contient également un paramètre qui contrôle le niveau de journalisation effectué. Pour plus de détails, consultez les options liées à la journalisation dans la rubrique d'aide Propriétés étendues du serveur . Lors du dépannage, il est recommandé de définir la propriété LOG_LEVEL Pro Cloud Server sur le niveau le plus élevé, SYSTEM.

When trouble shooting it is recommended to set the LOG_LEVEL property to the highest level.

Chaque entrée log comprendra l'heure, le niveau de journal et le message ; si une erreur se produit, le message contiendra normalement une description du problème et à partir de cette description, l'action appropriée peut être entreprise.

Message de journal

Explication

En-tête du fichier journal

Chaque fois qu'un nouveau fichier journal est créé, le Pro Cloud Server écrira un résumé des principaux paramètres ; ces informations sont particulièrement utiles si vous demandez support de Sparx Systems .

Démarrage des gestionnaires de bases de données

Lorsqu'un Pro Cloud Server est initialement démarré et que le niveau de journalisation est défini sur INFO (ou inférieur), il log un résumé de chaque modèle configuré qui inclut la string de connexion du modèle.

[INFO] : Ajout du gestionnaire de base de données - ConnectionStr : 'eaexample --- Connect=Provider=MSDASQL.1;...

Si le niveau de journal est inférieur à INFO, des entrées log supplémentaires seront écrites pour chaque modèle ; par exemple :

[SYSTEM] : SUCCÈS Démarrage du gestionnaire de base de données firebird :anonymous@eaexample

Ménage

Le Pro Cloud Server effectue des tâches de « maintenance » régulières, dont la fréquence est contrôlée par le paramètre AUDIT_TIME_PERIOD dans le fichier de configuration Pro Cloud Server .

Lorsque le niveau log est défini sur INFO, chaque fois qu'une maintenance est effectuée, le Pro Cloud Server log un résumé des connexions pour chaque gestionnaire de base de données défini et indique le nombre actuellement disponible, le nombre maximal utilisé simultanément et le nombre total d'utilisations depuis le dernier audit.

[AUDIT] firebird:anonymous@eaexample | Gratuit : 0 | Max Actif : 3 | Acquisitions : 192 |

Normalement, ces entrées peuvent être ignorées car elles constituent uniquement des informations de référence.

Liste des ports ouverts

Lorsqu'un Pro Cloud Server est démarré initialement et que le niveau de journalisation est défini sur SYSTEM, il log un message de réussite pour chaque port configuré, qui comprend le port de gestion (803) et tous les ports http/https. Vous devriez voir une ligne telle que :

[SYSTEM] SUCCÈS Lié et à l'écoute sur le port 804.

Si le fichier log manque de lignes ou si le message n'indique pas « SUCCESS », cela peut indiquer un problème avec le port du serveur.

Une erreur courante ici est :

Impossible de créer un serveur sécurisé sur le port 443 .

Les causes possibles sont :

  • Fichier de certificat/clé privée introuvable dans C:\Program Files (x86)\ Sparx Systems \ Pro Cloud Server \Service\server.pem
  • Le fichier server.pem ne contient pas de certificat ni de clé privée valides
  • Fichier d'autorité de certification introuvable ou non valide dans C:\Program Files (x86)\ Sparx Systems \ Pro Cloud Server \Service\cacert.pem

Impossible de se connecter à la base de données

Lors des opérations générales, le Pro Cloud Server écrit des entrées dans son fichier log , qui incluent toutes les tentatives infructueuses d'ouverture d'un modèle. Cela ne se produit généralement pas tant qu'un utilisateur ne tente pas de se connecter à la base de données. Les erreurs qui peuvent se produire ici sont les suivantes :

ÉCHEC DE LA DEMANDE DE CONNEXION. Erreur (5) : Impossible de se connecter à la base de données

Cela signifie que le serveur a tenté d'ouvrir une connexion mais a échoué. Si vous voyez ce message, révision la liste des raisons potentielles décrites dans le tableau Erreurs affichées dans la sortie du système Enterprise Architect .

Apprenez Plus