Documentation Oracle Cloud Infrastructure

Exécution des diagnostics d'installation de l'agent

La commande de diagnostic permet de résoudre les problèmes lors du processus d'installation. Il affiche les messages d'erreur, les messages d'avertissement et les informations de débogage. La commande est incluse dans le programme d'installation du logiciel OMA et dans le script d'installation, qui fournit des informations précieuses et identifie les éventuels problèmes d'installation. Elle permet de déterminer si les conditions préalables sont remplies sur l'ordinateur hôte pour permettre l'installation réussie de l'agent et le déploiement du module d'extension.

Activation du diagnostic

Pour activer le diagnostic dans le programme d'installation et le script d'installation, exécutez la commande de diagnostic suivante avant de lancer le processus d'installation :

Pour Linux et macOS :

$ sudo bash ./JMS_YourFleetName_<linux|macos>.sh --diagnostic
Pour Windows (à l'aide de PowerShell) :
Remarque

PowerShell version 5.1 ou toute version inférieure à 7 est requise pour exécuter le programme d'installation ou le script d'installation. 
.\JMS_YourFleetName_windows.ps1 --diagnostic
Le diagnostic collecte toutes les informations possibles et utiles et ajoute la sortie au fichier journal. Le résumé de diagnostic s'affiche avec tous les résultats. En cas de problème, le script de diagnostic génère une liste d'avertissements et de recommandations sur la manière de corriger les problèmes.
Remarque

Les fichiers journaux peuvent se trouver dans le chemin suivant :
  • pour Linux : /var/log/oracle/JMSInstallScript/
  • pour macOS : /Library/Oracle/JMSInstallScript/
  • pour Windows : C:\ProgramData\Oracle\JMSInstallScript

En fonction de l'environnement d'installation (architecture du système d'exploitation et du système d'exploitation) et du type d'agent (OCA ou OMA), un récapitulatif de diagnostic avec critères vérifiés et ses résultats affichés sous forme de réponses Oui/Non est fourni.

Selon le système d'exploitation et le type d'agent, les résultats seront similaires à :

Echec du diagnostic: 

======================================================================================================
Diagnostic Summary
======================================================================================================
Shell is supported? : Yes
User has sudo/root privileges? : Yes
Certified OS? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Able to reach OCI https://oracle.com endpoint? : Yes
Meets Java requirement? : Yes
Valid Management Agent installer? : No    
   Found 2 files with 'oracle.mgmt_agent*.rpm' pattern in /home/opc folder.    
   Please, run script test_linux.sh again with --use-agent-installer-path parameter.
Management Agent has been detected? : No
======================================================================================================
Diagnostics have failed. Please resolve all issues and run the jms setup installer again.
Diagnostic terminé: 
======================================================================================================
Diagnostic Summary
======================================================================================================
Shell is supported? : Yes
User has sudo/root privileges? : Yes
Certified OS? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Able to reach OCI https://oracle.com endpoint? : Yes
Meets Java requirement? : Yes
Valid Management Agent installer? : Yes
Existing Management Agent has been detected? : Yes
Existing Management Agent has JMS plugins? : Yes
Existing Management Agent can be upgraded? : Yes
======================================================================================================
Diagnostics have finished running and no error occurred.

Les critères vérifiés lors de l'exécution du diagnostic peuvent différer en fonction de l'environnement d'installation. Le tableau suivant fournit une liste récapitulative de tous les critères vérifiés sur toutes les plates-formes prises en charge.

Tableau A-2 - Récapitulatif de diagnostic

Critères Solution/Recommandation
L'utilisateur dispose de privilèges sudo/root ? Assurez-vous que vous disposez de l'accès sudo, root ou administrator.
Shell pris en charge ? Veillez à utiliser la dernière version du shell.
  • Windows : vous devez utiliser PowerShell version 5.1 ou ultérieure.
  • Linux : si vous utilisez un shell non pris en charge, mettez à jour le shell et réexécutez le script d'installation.
Système d'exploitation certifié ? Assurez-vous que la version du système d'exploitation est prise en charge. Reportez-vous à la section System Requirements JMS pour connaître les plates-formes prises en charge.

Pour ignorer cette vérification, exécutez à nouveau le script du programme d'installation JMS avec le paramètre --ignore-unsupported.

Vous êtes capable d'atteindre l'adresse OCI ? Vérifiez vos paramètres de connexion Internet et de proxy.
Répond à la configuration disque minimale requise ? Toutes les plates-formes nécessitent 300 Mo d'espace disque libre. Nettoyez le disque et réexécutez le script.
Respecte la mémoire minimale requise ? L'agent de gestion avec des modules d'extension JMS nécessite 500 Mo de mémoire libre. Nettoyez la mémoire et réexécutez le script.
Java trouvé dans le répertoire Users ? Veillez à conserver Java à un emplacement commun accessible à tous les utilisateurs.
Java disponible pour l'installation de l'agent ? Assurez-vous d'utiliser la dernière version d'Oracle JDK 8 pour configurer l'agent de gestion. Reportez-vous à la section Prérequis relatifs aux agents.
Programme d'installation de Management Agent disponible ? Veillez à télécharger le fichier d'installation du logiciel d'agent approprié propre à votre système d'exploitation. Enregistrez le fichier d'installation dans le même répertoire que le script d'installation et vérifiez qu'il est accessible.

Si le programme d'installation ne se trouve pas dans le même répertoire que le script, indiquez le chemin à l'aide du paramètre --use-agent-installer-path.

Un agent de gestion existant a-t-il été détecté ? Si vous disposez déjà d'une installation d'agent de gestion et que vous souhaitez poursuivre la réinstallation, vous pouvez utiliser le paramètre --reinstall.
Un agent de gestion existant peut-il être mis à niveau vers une version plus récente ? Si vous avez activé la fonctionnalité de mise à niveau automatique, les agents sont automatiquement mis à niveau lorsque la nouvelle version est disponible. Toutefois, en cas de problème :
  • Mettez à jour l'agent de gestion en indiquant le chemin du programme d'installation à l'aide du paramètre --use-agent-installer-path.

    Ou

  • Réinstallez l'agent de gestion à l'aide du paramètre --reinstall.
Vérification de la flotte réussie ? Si l'OCID de parc est trouvé lors de la vérification, vous pouvez mettre à niveau l'agent. Si l'ID de parc est introuvable, réinstallez l'agent à l'aide du paramètre --reinstall.
Des prérequis pour l'agent Oracle Cloud ont été installés ? Assurez-vous que les prérequis suivants sont respectés avant d'installer l'agent Oracle Cloud :
  • L'instance se trouve dans un domaine $OCI_REALM_KEY pris en charge
  • Les métadonnées OCI et la configuration d'instance sont disponibles. Sinon, installez oci-metadata manuellement ou forcez l'installation de l'agent de gestion à l'aide de l'argument --install-mgmt-agent.
  • Le package jq est installé. Sinon, installez-le manuellement. Vous pouvez également forcer l'installation de l'agent de gestion à l'aide de l'argument --install-mgmt-agent.
  • L'interface de ligne de commande OCI est installée. Sinon, installez-la manuellement et réexécutez le script. Vous pouvez également forcer l'installation de l'agent de gestion à l'aide de l'argument --install-mgmt-agent.
Répond aux exigences Java ? Assurez-vous d'avoir installé les versions de Java suivantes à exécuter :
  • Agent de gestion - Oracle JDK 1.8 ou version ultérieure
  • Module d'extension JMS OCA : Oracle JDK 11 ou version ultérieure
Programme d'installation d'agent de gestion valide ? Assurez-vous que le package d'installation de l'agent de gestion propre à votre système d'exploitation est accessible. En cas de problème, réexécutez le script avec le paramètre --use-agent-installer-path.
L'agent de gestion peut-il être décompressé ? Une erreur se produit si le script ne peut pas utiliser les utilitaires jar et unzip pour décompresser l'agent de gestion. Téléchargez à nouveau l'agent de gestion et exécutez le script d'installation.
Un agent de gestion existant possède des modules d'extension JMS ? S'il manque des modules d'extension dans l'agent de gestion existant, vous pouvez :
  • Déployez les modules d'extension à l'aide de la page Agents de gestion dans OCI
  • Réinstallez l'agent de gestion avec Java Management Service en exécutant le script avec le paramètre --reinstall.
Répond aux exigences des fonctionnalités avancées JMS ? Pour activer les fonctionnalités avancées JMS sur l'instance, assurez-vous que l'exécutable sudo est accessible.
Système d'exploitation certifié pour l'agent Oracle Cloud ? Java Management Service prend uniquement en charge l'agent Oracle Cloud sur Oracle Linux. Pour forcer l'installation de l'agent de gestion sur une instance, utilisez l'argument --install-management-agent.
La vérification du certificat a été effectuée ?
Remarque

Actuellement, cette option est disponible uniquement pour les plates-formes Linux et macOS.
Assurez-vous que le service est accessible en consultant vos paramètres de pare-feu et de proxy.
La synchronisation d'horloge avec la plate-forme OCI est-elle effectuée ?
Remarque

Actuellement, cette option est disponible uniquement pour les plates-formes Linux et macOS.
Assurez-vous que l'horloge de l'hôte est synchronisée avec la plate-forme OCI. S'il n'est pas synchronisé, synchronisez l'horloge de l'hôte dans les 5 minutes qui suivent la plate-forme OCI et réexécutez le script.

Pour plus d'informations, reportez-vous à Décalage maximal autorisé de l'horloge client.