Effectuer des tâches de prérequis génériques

Pour configurer Oracle Management Cloud afin de surveiller votre environnement Oracle E-Business Suite, vous devez exécuter un ensemble de tâches génériques.

Activer la licence Enterprise Edition

Les offres Oracle Management Cloud sont classées et disponibles dans différentes éditions de licence, y compris Enterprise Edition.

Oracle Management Cloud – Enterprise Edition offre les avantages suivants :

Oracle Application Performance Monitoring : fournit une plate-forme de surveillance et de gestion des applications.
Oracle Infrastructure Monitoring : surveille le statut et l'état de l'ensemble de l'infrastructure technologique des informations à partir d'une plate-forme unique et signale aux administrateurs des problèmes.
Oracle Orchestration : automatise l'infrastructure cloud et on-premise et exécute des tâches en appelant des API REST ou en utilisant des structures d'automatisation tierces.
Oracle IT Analytics : fournit à 360-degree un aperçu des performances, de la disponibilité et des capacités des applications et des investissements en infrastructure.

Activer Oracle Management Cloud : Enterprise Edition pour le système Oracle Cloud Infrastructure hôte et pour Oracle E-Business Suite.

Connectez-vous à la console Oracle Management Cloud en tant qu'administrateur Oracle Management Cloud.
Si le panneau de navigation Management Cloud n'est pas affiché, cliquez sur l'icône Navigation OMC dans l'angle supérieur gauche.
Dans le panneau de navigation de la console Oracle Management Cloud, cliquez sur Administration, puis sur Configuration d'entité.
Cliquez sur Gestion des licences, puis sur Sélectionner les entités.
Localisez et sélectionnez les entités requises, puis cliquez sur le bouton Sélectionner.
Sélectionnez Enterprise Edition pour chaque entité répertoriée ou cliquez sur Edition de licence et sélectionnez Tout définir sur Enterprise.
Cliquez sur Enregistrer.

Installer les agents Oracle Management Cloud

Installez les agents Oracle Management Cloud qui extraient les mesures de surveillance.

Agent de passerelle : installez l'agent de passerelle sur un hôte disposant d'un accès Internet à Oracle Management Cloud et accessible par tous les hôtes sur lesquels les agents cloud sont déployés. Tous les agents Oracle Management Cloud doivent utiliser une passerelle commune.
Agents cloud : installez des agents cloud sur chaque hôte de la topologie Oracle E-Business Suite pour surveiller et collecter des données (par exemple, des mesures, des informations de configuration et des journaux) à partir des entités résidant sur ces hôtes.

Avant d'installer les agents

Avant d'installer des agents sur Oracle E-Business Suite, veillez à tenir compte des points suivants.

Pour le répertoire de base d'agent où vous installez un agent :

Assurez-vous que seul l'utilisateur root et l'utilisateur agent installation disposent de droits d'accès en écriture sur le répertoire de base de l'agent et son répertoire parent, même après l'installation de l'agent. Cela garantit que toutes les opérations de cycle de vie d'agent, telles que la mise à jour ou la suppression, ont été effectuées.
Si le répertoire de base d'agent est créé avant l'installation, assurez-vous qu'il est vide. L'utilisateur de l'installation de l'agent doit disposer d'un accès en écriture au répertoire.
Si le répertoire de base d'agent n'est pas créé avant l'installation, il est créé par défaut sous le répertoire dans lequel le fichier ZIP du logiciel d'agent est extrait. Assurez-vous que l'utilisateur de l'installation de l'agent dispose d'un accès en écriture au répertoire parent dans lequel le répertoire de base de l'agent est créé.

Créer ou télécharger une clé d'inscription

Une clé d'inscription est émise par rapport à votre domaine d'identité et utilisée lors du déploiement des agents cloud. Une fois qu'un agent est installé avec la clé d'inscription, vous pouvez l'enlever de Oracle Management Cloud.

Lorsque vous créez une clé d'inscription, vous indiquez le nombre d'utilisations de cette clé. Une clé expire lorsque le nombre d'utilisations est supérieur ou égal à l'utilisation maximale indiquée lors de la création de la clé.

Connectez-vous à la console Oracle Management Cloud en tant qu'administrateur Oracle Management Cloud.
Si le panneau de navigation Management Cloud n'est pas affiché, cliquez sur l'icône Navigation OMC dans l'angle supérieur gauche.
Dans le panneau de navigation de la console Oracle Management Cloud, cliquez sur Administration et sur Agents.
Cliquez sur le menu à droite, puis sélectionnez Gérer les clés d'inscription.
Créez une clé d'inscription en saisissant les détails obligatoires sur la page Clés d'inscription, puis en cliquant sur Créer une clé.
Pour télécharger une clé d'inscription existante, procédez comme suit :
1. Dans la liste des clés d'inscription, localisez la clé à télécharger.
2. Cliquez sur le menu Actions à droite de la page, puis sélectionnez Télécharger.
  Un fichier texte registrationKey.txt contenant la valeur de la clé d'inscription est téléchargé sur votre lecteur local. Pour visualiser la valeur de clé, ouvrez le fichier registrationKey.txt.

Vous ajouterez la valeur de clé dans le paramètre AGENT_REGISTRATION_KEY du fichier de réponses.

Télécharger l'agent de passerelle

Utilisez la console Oracle Management Cloud pour télécharger les fichiers ZIP de package d'installation de logiciel d'agent de passerelle sur votre hôte.

Lorsque vous extrayez le fichier ZIP de passerelle, un exemple de fichier de réponses, gateway.rsp, est fourni en tant que modèle.

Connectez-vous à la console Oracle Management Cloud en tant qu'administrateur Oracle Management Cloud.
Si le panneau de navigation Management Cloud n'est pas affiché, cliquez sur l'icône Navigation OMC dans l'angle supérieur gauche.
Dans le panneau de navigation de la console Oracle Management Cloud, cliquez sur Administration et sur Agents.
Cliquez sur le menu à droite et sélectionnez Télécharger les agents.
Cliquez sur Type d'agent, puis sélectionnez Passerelle.
Cliquez sur Système d'exploitation, puis sélectionnez le système d'exploitation sur lequel vous souhaitez installer l'agent.
Prenez note des valeurs de paramètre TENANT_NAME et OMC_URL affichées sous le lien d'agent. Lorsque vous installez l'agent de passerelle, vous devez mettre à jour le fichier de réponses avec ces valeurs.
Cliquez sur le lien du logiciel d'agent correspondant à votre système d'exploitation pour télécharger le fichier ZIP du logiciel de passerelle.
Vérifiez que le fichier ZIP téléchargé est complet en comparant la valeur du checksum SHA1 du fichier téléchargé à celle répertoriée pour l'agent sur la page de téléchargement de l'agent :
```
sha1sum <agent_binary_filename>.zip
```
La valeur de la colonne Checksum SHA1 dans l'interface utilisateur doit correspondre à la sortie.
Accédez au répertoire dans lequel vous avez téléchargé le groupe de logiciels et décompressez le logiciel.
```
unzip <agent_binary_filename>.zip
```

Télécharger l'agent cloud

Utilisez la console Oracle Management Cloud pour télécharger les fichiers ZIP de package d'installation de logiciel d'agent cloud sur votre hôte.

Lorsque vous extrayez le fichier ZIP d'agent, un exemple de fichier de réponses, agent.rsp, est fourni en tant que modèle.

Connectez-vous à la console Oracle Management Cloud en tant qu'administrateur Oracle Management Cloud.
Si le panneau de navigation Management Cloud n'est pas affiché, cliquez sur l'icône Navigation OMC dans l'angle supérieur gauche.
Dans le panneau de navigation de la console Oracle Management Cloud, cliquez sur Administration et sur Agents.
Cliquez sur le menu à droite et sélectionnez Télécharger les agents.
Cliquez sur Type d'agent, puis sélectionnez Agent cloud.
Cliquez sur Système d'exploitation, puis sélectionnez le système d'exploitation sur lequel vous souhaitez installer l'agent.
Prenez note des valeurs de paramètre TENANT_NAME et OMC_URL affichées sous le lien d'agent. Lorsque vous installez l'agent de passerelle, vous devez mettre à jour le fichier de réponses avec ces valeurs.
Cliquez sur le lien du logiciel d'agent correspondant à votre système d'exploitation pour télécharger le fichier ZIP du logiciel de passerelle.
Vérifiez que le fichier ZIP téléchargé est complet en comparant la valeur du checksum SHA1 du fichier téléchargé à celle répertoriée pour l'agent sur la page de téléchargement de l'agent :
```
sha1sum <agent_binary_filename>.zip
```
La valeur de la colonne Checksum SHA1 dans l'interface utilisateur doit correspondre à la sortie.
Accédez au répertoire dans lequel vous avez téléchargé le groupe de logiciels et décompressez le logiciel.
```
unzip <agent_binary_filename>.zip
```

Installer l'agent de passerelle

Un agent de passerelle fait office de canal sécurisé entre Oracle Management Cloud et tous les autres agents Oracle Management Cloud.

Pour installer un agent de passerelle, procédez comme suit :

Modifiez le fichier de réponses de la passerelle, gateway.rsp (que vous avez obtenu lors du téléchargement et de l'extraction du fichier ZIP de la passerelle), dans un éditeur de texte et indiquez les valeurs des paramètres nécessaires à l'installation d'une passerelle.

Le tableau suivant répertorie les paramètres requis pour l'installation de la passerelle.

Paramètre	Description
`TENANT_NAME` ou `TENANT_ID` (pris en charge dans les versions antérieures et restant compatible en amont)	Nom du locataire où Oracle Management Cloud est exécuté. Vous pouvez obtenir la valeur `TENANT_NAME` d'un agent en accédant à Administration > Agents > Télécharger, puis en sélectionnant un type d'agent dans la liste déroulante Type d'agent. La valeur `TENANT_NAME` apparaît au bas de la page.
`OMC_URL` ou `UPLOAD_ROOT` (pris en charge dans les versions antérieures et restant compatible en amont)	URL absolue incluant le protocole obligatoire pour la connexion à Oracle Management Cloud en vue du téléchargement des données pour le serveur `TENANT_NAME` spécifique. Pour obtenir cette valeur, accédez à Administration > Agents > Télécharger, puis sélectionnez un type d'agent dans la liste déroulante Type d'agent. La valeur `OMC_URL` apparaît au bas de la page.
`AGENT_REGISTRATION_KEY`	Clé permettant de valider l'identité du locataire et l'authenticité de l'installation. Vous pouvez obtenir la clé d'inscription à partir du tableau de bord Oracle Management Cloud en accédant à Administration > Agents > Clés d'inscription.
`AGENT_BASE_DIRECTORY`	Répertoire vide dans lequel l'agent doit être installé sur l'ordinateur hôte. Si le répertoire indiqué n'est pas présent, un répertoire est créé lors de l'installation. Remarque : pour Windows, la longueur du chemin de répertoire incluant la lettre du lecteur doit être inférieure à 23 caractères.

Enregistrez le fichier de réponses.
Exécutez une vérification de prérequis pour valider les paramètres. Utilisez l'interface de ligne de commande pour exécuter le script AgentInstall.sh qui transmet le paramètre EXECUTE_PREREQ=true.
```
$ ./AgentInstall.sh EXECUTE_PREREQ=true
Unzipping agent software, this may take some time...
Installing Gateway...
Executing Pre-requisite checks only for Gateway..
Gateway parameter validation started...
Gateway pre-requisite checks started...
Pre-requisite checks successfully completed for [Gateway]. 
```
Le script exécute la vérification de prérequis. Si la vérification de prérequis échoue, le script s'arrête avec le message d'erreur concerné.

Pour plus de détails, reportez-vous au fichier journal situé sous <AGENT_ZIP_FILE_EXTRACTED_DIRECTORY>/AgentInstall_<timestamp>.log. Corrigez toutes les erreurs avant d'installer la passerelle.
Installez l'agent en exécutant le script AgentInstall.sh avec le nom du fichier de réponses en tant que paramètre.
./AgentInstall.sh AGENT_RSP_FILE=<absolute path to the gateway.rsp file>

Installer l'agent cloud

Un agent cloud collecte les données d'entité auprès de l'hôte sur lequel vous déployez l'agent cloud.

L'installation de l'agent cloud exige des noms de domaine qualifiés complets pour vos hôtes. Pour les environnements UNIX, ajoutez le nom de domaine qualifié complet dans le fichier /etc/hosts et assurez-vous qu'il est mis en correspondance avec le nom d'hôte et l'adresse IP corrects de l'hôte.

Remarque : installez l'agent cloud sur chacun des hôtes de niveau application et de base de données.

Pour installer un agent Cloud, procédez comme suit :

Modifiez le fichier de réponses de l'agent cloud, agent.rsp (que vous avez obtenu lors du téléchargement et de l'extraction du fichier ZIP de l'agent cloud), dans un éditeur de texte et indiquez les valeurs des paramètres requis pour l'installation d'un agent cloud.

Le tableau suivant répertorie les paramètres requis sur et au-dessus de la passerelle pour l'installation d'un agent cloud qui utilise une passerelle pour communiquer avec Oracle Management Cloud sur un serveur proxy.

Paramètre	Description
`GATEWAY_HOST`	Si l'agent cloud communique avec Oracle Management Cloud à l'aide d'une passerelle, indiquez le nom de domaine qualifié complet de la passerelle. Lorsque vous installez l'agent cloud, veillez à indiquer le même nom d'hôte de passerelle que celui utilisé pour installer la passerelle. Par exemple, lors du déploiement de la passerelle, si vous indiquez `ORACLE_HOSTANME=abc.xyz.com` et que vous installez l'agent cloud, vous spécifiez `GATEWAY_HOST=abc`, des échecs d'inscription de l'agent cloud se produiront. Un agent de passerelle doit être installé sur l'hôte et doit être en fonctionnement.
`GATEWAY_PORT`	Lorsqu'un agent cloud utilise une passerelle pour communiquer avec Oracle Management Cloud, vous devez spécifier le port de passerelle. Vous pouvez obtenir le numéro de port en exécutant la commande suivante : `$Gateway_Agent_Home/agent_inst/bin/omcli status agent`
`OMC_PROXYHOST`	Adresse du serveur proxy à utiliser pour la connexion. Veillez à ne pas transmettre la valeur `https://` avec les détails de l'hôte proxy.
`OMC_PROXYPORT`	Port de votre serveur proxy.
`OMC_PROXYUSER`	Nom utilisateur obligatoire pour accéder à votre serveur proxy.
`OMC_PROXYPWD`	Mot de passe obligatoire pour accéder à votre serveur proxy.
`OMC_PROXYREALM`	Domaine d'authentification (le cas échéant) à utiliser pour accéder à votre serveur proxy.
`AGENT_PORT`	Numéro de port auquel le processus d'agent sera lié. Le script `AgentInstall` arrête le processus d'installation si ce port est occupé au moment de l'installation.

Enregistrez le fichier de réponses.
Exécutez une vérification de prérequis pour valider les paramètres. Utilisez l'interface de ligne de commande pour exécuter le script AgentInstall.sh qui transmet le paramètre EXECUTE_PREREQ=true.
```
$ ./AgentInstall.sh EXECUTE_PREREQ=true
Unzipping agent software, this may take some time...
Installing Gateway...
Executing Pre-requisite checks only for Gateway..
Gateway parameter validation started...
Gateway pre-requisite checks started...
Pre-requisite checks successfully completed. 
```
Le script exécute la vérification de prérequis. Si la vérification de prérequis échoue, le script s'arrête avec le message d'erreur concerné.
Installez l'agent en exécutant le script AgentInstall.sh avec le nom du fichier de réponses en tant que paramètre.
./AgentInstall.sh AGENT_RSP_FILE=<absolute path to the agent.rsp file>

Vérifier l'installation de l'agent

Une fois la passerelle et l'agent cloud installés, vérifiez que les agents ont été déployés.

Connectez-vous à la console Oracle Management Cloud en tant qu'administrateur Oracle Management Cloud.
Si le panneau de navigation Management Cloud n'est pas affiché, cliquez sur l'icône Navigation OMC dans l'angle supérieur gauche.
Dans le panneau de navigation de la console Oracle Management Cloud, cliquez sur Administration et sur Agents.
Cliquez sur l'onglet correspondant au type d'agent, tel que Passerelles ou Agents cloud.
Vérifiez que le nom d'hôte de la passerelle déployée ou de l'agent cloud existe dans la liste des agents disponibles.