Documentation sur Oracle Cloud Infrastructure

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

La commande de diagnostic aide à 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 le script d'installation, qui fournit une rétroaction précieuse et identifie les problèmes d'installation potentiels. Il 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 plugiciel.

Activation du diagnostic

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

Pour Linux et macOS :

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

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 sommaire du diagnostic s'affiche avec toutes les conclusions. S'il y a des problèmes, le script de diagnostic génère une liste d'avertissements et de recommandations sur la façon de les corriger.
Note

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 de système d'exploitation et de système d'exploitation) et du type d'agent (OCA ou OMA), un sommaire de diagnostic avec les critères vérifiés et les résultats affichés en tant que réponses Oui/Non est fourni.

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

Échec 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 réussi : 
======================================================================================================
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 selon 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 : Sommaire des diagnostics

Critères Solution/Recommandation
L'utilisateur dispose des privilèges sudo/root? Assurez-vous que vous disposez de l'accès sudo, root ou administrator.
L'interpréteur de commandes est-il pris en charge? Assurez-vous d'utiliser la dernière version de l'interpréteur de commandes.
  • Windows : Vous devez utiliser PowerShell version 5.1 ou ultérieure.
  • Linux : Si vous utilisez un interpréteur de commandes non pris en charge, mettez à jour le shell et exécutez à nouveau le script d'installation.
Système d'exploitation certifié? Assurez-vous que la version du système d'exploitation est prise en charge. Voir les exigences du système JMS pour les plates-formes prises en charge.

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

Peut atteindre le point d'extrémité OCI? Vérifiez vos paramètres de connexion Internet et de mandataire.
Répond aux exigences minimales en matière de disque? Toutes les plates-formes nécessitent 300 Mo d'espace disque libre. Nettoyez le disque et réexécutez le script.
Répond aux exigences minimales de mémoire? L'agent de gestion avec des plug-ins 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 Utilisateurs? Assurez-vous de conserver Java dans 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. Voir Préalables pour l'agent.
Le programme d'installation de l'agent de gestion est-il disponible? Assurez-vous de 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, spécifiez le chemin à l'aide du paramètre --use-agent-installer-path.

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

    OR

  • Réinstallez l'agent de gestion à l'aide du paramètre --reinstall.
Vérification du parc réussie? Si l'OCID du parc est trouvé lors de la vérification, vous pouvez mettre à niveau l'agent. Si l'ID parc est introuvable, réinstallez l'agent à l'aide du paramètre --reinstall.
Les conditions requises pour Oracle Cloud Agent ont-elles été installées? Assurez-vous que les conditions requises suivantes sont remplies avant d'installer Oracle Cloud Agent :
  • L'instance est située 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.
  • L'ensemble 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 exécutez de nouveau le script. Vous pouvez également forcer l'installation de l'agent de gestion à l'aide de l'argument --install-mgmt-agent.
Satisfait aux exigences Java? Assurez-vous d'avoir installé les versions Java suivantes à exécuter :
  • Agent de gestion - Oracle JDK 1.8 ou version ultérieure
  • Plugiciel OCA JMS : Oracle JDK 11 ou version ultérieure
Installeur 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, exécutez de nouveau 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.
L'agent de gestion existant a-t-il des plugiciels JMS? S'il manque des plugiciels dans l'agent de gestion existant, vous pouvez :
  • Déployer les plugiciels à 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 relatives aux fonctionnalités avancées JMS? Pour activer les fonctions avancées JMS sur l'instance, assurez-vous que l'exécutable sudo est accessible.
Un système d'exploitation certifié pour Oracle Cloud Agent? Java Management Service prend uniquement en charge Oracle Cloud Agent 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é réussie?
Note

Actuellement, cette option n'est disponible que pour les plates-formes Linux et macOS.
Assurez-vous que le service est accessible en vérifiant les paramètres du pare-feu et du mandataire.
L'horloge est-elle synchronisée avec la plate-forme OCI?
Note

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

Pour plus d'informations, voir Variation d'horloge maximale autorisée pour le client.