Effectuer des tâches Oracle E-Business Suite spécifiques

Vous devez exécuter un ensemble de tâches requises par Oracle Management Cloud pour extraire de manière transparente les données de surveillance de votre configuration Oracle E-Business Suite.

Configurer MBeans sur des serveurs Oracle WebLogic

Pour collecter les mesures de performances JVM à partir de la plate-forme MBeans, vous devez rendre l'instance MBeans accessible à l'aide du MBeanServer d'exécution.

Activez MBeans en accédant à chaque Oracle WebLogic Server de votre configuration Oracle E-Business Suite en vous y connectant ou à partir de la console WebLogic, comme suit :

  1. Connectez-vous à Oracle WebLogic Server.
  2. Accédez à la console WebLogic.
  3. Accédez à Domaine > Configuration > Page Général > Options avancées. Cochez la case Serveur MBean de plate-forme utilisé.

Configuration de DNS dans un environnement Oracle E-Business Suite

Les hôtes Oracle E-Business Suite doivent pouvoir en détecter un autre sur le réseau.

Pour vérifier que les serveurs DNS sont configurés correctement, exécutez la commande suivante :

nslookup any_publicDomain_hostname

Appliquer les autorisations aux bases de données pour la surveillance

Pour surveiller l'instance de base de données sur Oracle E-Business Suite, créez un utilisateur de base de données spécial et fournissez les privilèges requis à l'utilisateur.

En général, dans l'environnement UNIX, la base de données est située à l'emplacement <EBS_home>/VISION/11.2.0 dans la structure de répertoires de la version 12.2. Vous pouvez vous connecter à l'instance de base de données en tant qu'utilisateur APPS ou avec n'importe quel rôle SYSDBA.
  1. Créez un utilisateur de base de données, MONCS et accordez les droits requis à l'utilisateur créé. Un script, grantPrivilegesMonSvc.sh, est disponible pour automatiser la création de l'utilisateur de base de données de surveillance et octroie les privilèges de surveillance requis.
    1. Téléchargez et enregistrez le script grantPrivilegesMonSvc.sh sur le même hôte que la base de données.

      Ce script doit être exécuté localement à partir de l'hôte sur lequel se trouve la base de données.

      Lorsque le script est exécuté, il vous invite à effectuer les opérations suivantes :

      • ORACLE_HOME [répertoire d'origine de la base de données Oracle].

      • SID [SID de la base de données Oracle].

      • SYSDBA USER [ tout utilisateur de base de données disposant de privilèges SYSDBA pour se connecter à la base de données.].

      • MOT DE PASSE SYSDBA.

      • Monitoring USER ; entrez MONCS.

        Si l'utilisateur de surveillance existe déjà, l'étape de création d'utilisateur est ignorée et les privilèges sont accordés à l'utilisateur existant. Si l'utilisateur de surveillance n'existe pas, il est créé, puis bénéficie de privilèges.

      • Surveillance d'USER PASSWORD.

  2. Fournissez les autorisations propres à Oracle E-Business Suite pour l'utilisateur MONCS.

    L'exemple de code ci-dessous utilise le nom de schéma APPS. Si le nom du schéma est différent dans votre configuration, remplacez APPS par ce nom en conséquence dans le code suivant.

    GRANT SELECT ON APPS.FND_OAM_CONTEXT_FILES TO MONCS;
    GRANT SELECT ON APPS.FND_PRODUCT_GROUPS TO MONCS;
    GRANT SELECT ON APPS.FND_CONC_PROG_ONSITE_INFO TO MONCS;
    GRANT SELECT ON APPS.FND_CONCURRENT_PROGRAMS_VL TO MONCS;
    GRANT EXECUTE ON APPS.FND_OAM_EM TO MONCS;
    GRANT SELECT ON APPS.FND_CONCURRENT_REQUESTS TO MONCS;
    GRANT SELECT ON APPS.FND_APPLICATION_VL TO MONCS;
    GRANT SELECT ON APPS.FND_CONCURRENT_QUEUES TO MONCS;
    GRANT SELECT ON APPS.FND_LOOKUPS TO MONCS;
    GRANT SELECT ON APPS.FND_CONCURRENT_WORKER_REQUESTS TO MONCS;
    GRANT SELECT ON APPS.FND_CONCURRENT_WORKER_REQUESTS TO MONCS;
    GRANT SELECT ON APPS.FND_CONCURRENT_QUEUES_VL TO MONCS;
    GRANT SELECT ON APPS.FND_OAM_FNDUSER_VL TO MONCS;
    GRANT SELECT ON APPS.FND_FORM_SESSIONS_V TO MONCS;
    GRANT SELECT ON APPS.FND_CP_SERVICES TO MONCS;
    GRANT SELECT ON APPS.FND_CONCURRENT_PROCESSES TO MONCS;
    GRANT SELECT ON APPS.FND_SVC_COMPONENTS TO MONCS;
    GRANT SELECT ON APPS.FND_LOG_MESSAGES TO MONCS;
    GRANT SELECT ON APPS.FND_CONCURRENT_PROGRAMS TO MONCS; 
    GRANT SELECT ON APPS.FND_CONFLICTS_DOMAIN TO MONCS; 
    GRANT SELECT ON APPS.FND_ORACLE_USERID TO MONCS; 
    GRANT SELECT ON APPS.FND_APP_SERVERS TO MONCS; 
    GRANT SELECT ON APPS.FND_NODES TO MONCS;
  3. Accordez les privilèges supplémentaires requis pour la collecte des données Oracle IT Analytics.
    1. Exécutez <AGENT_HOME>/plugins/oracle.em.sgfm.zip/<AGENT_VERSION>/scripts/grantPrivilegesITA.sh.

      Ce script doit être exécuté localement à partir de l'ordinateur sur lequel se trouve la base de données. Lorsque vous exécutez ce script, il vous invite à effectuer les opérations suivantes :

      • ORACLE_HOME [répertoire d'origine de la base de données Oracle].

      • SID [SID de la base de données Oracle].

      • SYSDBA USER [ tout utilisateur de base de données disposant de privilèges SYSDBA pour se connecter à la base de données.].

      • MOT DE PASSE SYSDBA.

      • Monitoring USER ; entrez MONCS.

      • Surveillance d'USER PASSWORD.

      • Nom du fichier de sortie [chemin complet du fichier texte]

    Le script grantPrivilegesITA.sh accorde les droits d'accès nécessaires à la surveillance et à la collecte des données. Si le rôle existe (créé par le script de surveillance), le script ajoute les droits d'accès nécessaires à la collecte des données Oracle IT Analytics au même rôle.

  4. Accordez des privilèges supplémentaires à partir de la ligne de commande, si nécessaire. Par exemple :
    GRANT SELECT ON APPS.ICX_SESSIONS to moncsrole;

Configurer Oracle Application Performance Monitoring pour Oracle E-Business Suite

Pour surveiller les performances des applications Oracle E-Business Suite à l'aide de Oracle Application Performance Monitoring, vous devez exécuter un ensemble de tâches.

  1. Installez l'agent Oracle Application Performance Monitoring sur le serveur géré oacore :
    1. 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.
    2. Dans le panneau de navigation de la console Oracle Management Cloud, cliquez sur Administration et sur Agents.
    3. Cliquez sur le menu à droite et sélectionnez Télécharger les agents.
    4. Cliquez sur Type d'agent, puis sélectionnez Agent APM.
    5. Téléchargez le fichier ZIP de l'agent Java APM sur votre hôte Linux et extrayez-le dans un répertoire vide. (Par exemple : /stage/apm_staging).
    6. Créez le script d'installation comme exécutable via chmod :
      chmod +x ProvisionAPMJavaAsAgent.sh
    7. Exécutez ProvisionApmJavaAsAgent avec les paramètres suivants :
      $ ./ProvisionApmJavaAsAgent.sh -d <PATH_TO_FMW_HOME>/user_projects/domains/<EBS_DOMAIN> -no-wallet
      • -d est le chemin absolu du répertoire d'origine Oracle Home du domaine WebLogic Server. L'agent Java APM sera installé sous ce répertoire.
      • -no-wallet signifie que vous n'utiliserez pas Oracle Wallet pour cette installation.

      Ce programme de configuration n'utilise pas de proxy ou de passerelle.

    8. Localisez la clé d'inscription que vous avez créée lors de l'installation des agents cloud. Copiez et collez la valeur de clé d'inscription sur la ligne de commande lorsque vous y êtes invité.
    9. Cliquez sur y pour confirmer et installer l'agent.
    Après avoir installé l'agent, vous obtenez une sortie vous demandant d'exécuter plus d'étapes. Ignorez les instructions de la sortie et passez à l'étape 2 ci-dessous.
  2. Activez l'agent Java APM sur les serveurs gérés WebLogic.
    Pour activer l'accès à Oracle E-Business Suite à partir de Oracle Application Performance Monitoring, vous devez apporter des modifications à la configuration JVM aux serveurs gérés WebLogic. Exécutez les étapes suivantes sur les serveurs gérés oacore :
    1. Connectez-vous à la console d'administration du serveur WebLogic en tant qu'utilisateur disposant du rôle admin security. Par défaut, il s'agit de l'utilisateur weblogic.
    2. Cliquez sur Serveurs. La page du récapitulatif du serveur d'administration et des serveurs gérés WebLogic apparaît.
    3. Cliquez sur le serveur géré oacore.
      Une page contenant différents onglets pour les paramètres du serveur géré apparaît.
    4. Cliquez sur Démarrage du serveur.
    5. Dans le centre des modifications, cliquez sur Verrouiller et modifier. Mettez à jour le champ Arguments avec les paramètres requis pour Oracle Application Performance Monitoring. Assurez-vous que les arguments existants ne sont pas modifiés.
    6. Cliquez sur Enregistrer.
    7. Dans le centre des modifications, cliquez sur Activer les modifications pour activer les modifications.
    8. Redémarrez les serveurs gérés à l'aide du script disponible dans $ADMIN_SCRIPTS_HOME dans l'environnement Oracle E-Business Suite pour arrêter et démarrer les serveurs gérés.
  3. Configurez l'agent du navigateur sur les serveurs gérés SOA et activez la surveillance de l'utilisateur final.
    1. Dans la console Oracle Management Cloud, cliquez sur le menu de navigation globale dans l'angle supérieur gauche et accédez à APM, sélectionnez Administration APM, puis Agent de navigateur.
    2. Dans la section Configurer la propriété de type d'injection de surveillance de l'utilisateur final, sélectionnez le serveur d'applications à modifier, puis cliquez sur l'icône Modifier dans la colonne Type d'injection, et sélectionnez le type d'injection requis.

Repérer les entités Oracle E-Business Suite

Pour surveiller les différentes entités dans Oracle E-Business Suite, vous devez les ajouter à l'aide de la page Ajouter des entités dans Oracle Management Cloud.

Remarque :

Après avoir installé un agent cloud, vous devez collecter les informations de configuration de l'agent avant de pouvoir l'ajouter. Attendez cinq minutes après l'installation d'un agent cloud, puis essayez de l'ajouter.

Pour effectuer ces tâches, vous devez disposer du rôle de administrateur Oracle Management Cloud.

  1. 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.
  2. Dans le menu principal de Oracle Management Cloud, cliquez sur Administration, Repérer, puis Ajouter une entité. La page Ajouter une entité apparaît.
  3. Dans la liste Type d'entité, sélectionnez EBS.
  4. Entrez le nom de l'entité.
  5. Dans la liste Nom d'hôte de la base de données, sélectionnez le nom d'hôte de la base de données contenant le schéma Oracle E-Business Suite. Entrez le nom du service de base de données. Le port de base de données par défaut est automatiquement disponible dans le champ Port de base de données. Vous pouvez le modifier, si nécessaire.
  6. Dans la liste Agent cloud, sélectionnez l'agent cloud à partir duquel le repérage doit être exécuté. Il est recommandé d'exécuter le repérage à partir de l'agent cloud installé sur l'hôte du serveur d'administration WebLogic.
  7. Sous la section Informations d'identification de surveillance, sélectionnez EBS 12.2, entrez les informations d'identification de la base de données, puis entrez les informations d'identification du serveur WebLogic.
  8. Sous Attributs d'entité, sélectionnez  Enterprise dans la liste Edition de licence.
  9. Pour associer automatiquement les journaux Oracle E-Business Suite lors de la collecte des journaux, activez l'option Associer les journaux.
  10. Cliquez sur Ajouter une entité. Vous revenez à la page Statut du travail d'ajout d'entité. Le nom du travail d'ajout d'entité apparaît dans la table des entités de la page.
  11. Revenez à la console Oracle Management Cloud.Cliquez sur Administration, Configuration d'entité, puis sur Gestion des licences. Assurez-vous que l'activation/la désactivation de la collection de journaux est activée pour EBS.

Vérifier la configuration d'Oracle E-Business Suite

Une fois que vous avez configuré l'environnement pour utiliser Oracle Management Cloud avec Oracle E-Business Suite, vérifiez la configuration avec quelques tests.

Vous pouvez valider votre environnement en effectuant les vérifications suivantes pour commencer à l'utiliser :

  • Le visualiseur de topologie affiche correctement la hiérarchie Oracle E-Business Suite.

  • Toutes les mesures sont collectées sans délai. Les tables et les graphiques de mesures sont corrélés et les données sont exactes.

  • Les tableaux de bord reflètent les hôtes, entités, mesures d'hôte, mesures Oracle WebLogic Server et widgets de journal Oracle E-Business Suite corrects.

  • Dans l'explorateur de journaux, lorsque le composite EBS est sélectionné, les journaux relatifs à Oracle WebLogic Server, l'instance de base de données et les hôtes d'application Oracle E-Business Suite sont inclus.