Configuration de l'agent sur des systèmes Windows

Vous pouvez configurer l'agent sur les systèmes d'exploitation Windows à l'aide de la fenêtre IBM Performance Management. Une fois que vous avez mis à jour les valeurs de configuration, démarrez l'agent pour sauvegarder les valeurs mises à jour.

1. Cliquez sur Démarrer > Tous les programmes > IBM Monitoring agents > IBM® Cloud Application Performance Management.
2. Dans la fenêtre IBM Performance Management, cliquez avec le bouton droit de la souris sur le modèle Monitoring Agent for Oracle Database, puis cliquez sur Configure agent.
   A faire : Après avoir configuré une instance d'agent pour la première fois, l'option Configure agent est désactivée. Pour reconfigurer l'instance d'agent, cliquez dessus avec le bouton droit de la souris et sélectionnez Reconfigure.
3. Dans la fenêtre Monitoring Agent for Oracle Database, procédez comme suit :
   1. Entrez un nom d'instance unique pour l'instance de Monitoring Agent for Oracle Database et cliquez sur OK.
4. Dans le panneau Default Database Configuration de la fenêtre Configure ITCAM Extended Agent for Oracle Database, procédez comme suit :
   1. Entrez le nom d'utilisateur par défaut. Il s'agit de l'ID utilisateur de la base de données par défaut utilisé pour les connexions à la base de données.
      Il s'agit de l'ID utilisé par l'agent pour accéder à l'instance de la base de données surveillée. Cet ID utilisateur doit disposer de privilèges de sélection sur les vues et les tables de performances dynamiques nécessaires à l'agent.
   2. Entrez le mot de passe par défaut. Il s'agit du mot de passe associé à l'ID utilisateur de la base de données par défaut spécifié.
   3. Si la version de l'agent Oracle est 8.0, procédez comme suit.
      1. Entrez le fichier jar d'Oracle JDBC. Il s'agit du chemin complet du fichier jar du pilote Oracle JDBC utilisé pour communiquer avec la base de données Oracle. Le pilote Oracle Java Database Connectivity (JDBC) qui prend en charge les versions de la base de données Oracle surveillées par l'agent Oracle doit être disponible sur l'ordinateur de l'agent.
   4. Si la version de l'agent Oracle est 6.3.1.10, procédez comme suit.
      1. Si l'Agent Oracle Database est installé sur le serveur de base de données Oracle surveillé, sélectionnez Use libraries in Oracle home et entrez le répertoire de base d'Oracle. (Facultatif) Le paramètre Oracle Home Directory peut ne pas être défini pour la surveillance locale ; la variable d'environnement système ORACLE_HOME sera utilisée.
      2. Si l'Agent Oracle Database est distant du serveur de base de données Oracle surveillé, sélectionnez Use libraries in Oracle instant client et entrez le répertoire d'installation du client Oracle Instant.
   5. Pour définir les options de configuration avancées, cochez Show advanced options ; sinon, passez à l'étape 5.
   6. Le paramètre Net Configuration Files Directories peut ne pas être défini et le répertoire par défaut est utilisé. Si la version de l'agent Oracle est 6.3.1.10, vous pouvez indiquer plusieurs répertoires de fichiers de configuration en séparant leur nom par un point-virgule (;). Pour l'agent Oracle version 8.0, seul un répertoire est pris en charge.
      Ce paramètre contient le(s) fichier(s) de configuration réseau de la base de données Oracle. Le répertoire est défini par la variable d'environnement TNS_ADMIN pour chaque instance de base de données Oracle. Le répertoire par défaut est %ORACLE_HOME%\NETWORK\ADMIN. Si cet élément n'est pas configuré, le répertoire par défaut est utilisé. Pour désactiver l'utilisation du répertoire par défaut, définissez la variable d'environnement d'agent suivante sur false : KRZ_LOAD_ORACLE_NET=false.
   7. Ne définissez pas le paramètre Customized SQL definition file name. Il n'est pas utilisé.
   8. Indiquez si le programme d'écoute dynamique par défaut est configuré sur ce poste de travail.
      Le programme d'écoute dynamique par défaut est (PROTOCOL=TCP)(HOST=localhost)(PORT=1521). Si le programme d'écoute dynamique par défaut est configuré sur ce poste de travail, définissez cette valeur sur Yes.
   9. Cliquez sur Suivant.
5. Dans le panneau Instance configuration de la fenêtre Configure ITCAM Extended Agent for Oracle Database, procédez comme suit :
   Définissez dans ce panneau les instances de connexion à la base de données réelles. Vous devez en ajouter au moins une. Vous pouvez également y éditer et y supprimer des instances de connexion à la base de données. S'il existe plusieurs configurations d'instance de connexion à la base de données, utilisez l'option Database connections pour choisir l'instance à éditer ou supprimer.
   1. Appuyez sur New dans la section Database connections.
   2. Définissez un alias pour la connexion à la base de données dans Database Connection Name.
      Cet alias vous permet de représenter la connexion à la base de données avec les restrictions suivantes. Seuls les lettres, les chiffres arabes, le caractère souligné et le caractère moins peuvent être utilisés dans le nom de connexion. La longueur maximale d'un nom de connexion est de 25 caractères.
   3. Définissez le paramètre Connection Type
      1. (Facultatif) Basic

         Le type de connexion le plus courant et par défaut est Basic. Si vous n'êtes pas sûr du type de connexion dont vous avez besoin, il est recommandé de choisir celui-ci.

         1. Sélectionnez le type de connexion Basic lorsque la base de données cible surveillée est une instance unique, telle qu'une instance de système de fichiers standard ou une instance ASM unique.
         2. Définissez le nom d'hôte ou l'adresse IP de la base de données dans la zone Hostname.
         3. Entrez le numéro de port utilisé par la base de données dans la zone Port.
         4. Sélectionnez Service Name ou SID.
            1. Si Service Name est sélectionné, entrez le nom du service qui est une représentation logique d'une base de données, une chaîne qui est le nom de service de base de données globale.

               Un nom de service est une représentation logique d'une base de données, à savoir la manière dont une base de données est présentée aux clients. Une base de données peut être présentée sous forme de services multiples et un service peut être implémenté en tant qu'instances de base de données multiples. Le nom de service est une chaîne qui correspond au nom de base de données global, à savoir un nom composé du nom de la base de données et du nom de domaine, saisie lors de l'installation ou de la création de la base de données. Si vous n'êtes pas sûr de connaître le nom de la base de données global, vous pouvez l'obtenir à partir de la valeur du paramètre SERVICE_NAMES dans le fichier de paramètres d'initialisation.

            2. Si SID est sélectionné, entrez l'ID système Oracle qui identifie une instance d'une base de données active.

               Il s'agit de l'identificateur système Oracle qui identifie une instance spécifique d'une base de données.

               Passez à l'étape 5d.

      2. (Facultatif) TNS
         1. Sélectionnez le type de connexion TNS si la variable d'environnement système ORACLE_HOME est définie et que l'alias TNS de la base de données cible surveillée est défini dans le fichier $ORACLE_HOME/network/admin/tnsnames.ora.
         2. Entrez le nom de l'alias TNS.

            Passez à l'étape 5d.

      3. (Facultatif) Advanced
         1. Sélectionnez le type de connexion avancé lorsqu'il existe plusieurs instances Oracle dans plusieurs noeuds physiques pour la base de données surveillée. Par exemple, un ASM avec une base de données Real Applications Cluster (RAC).
         2. Entrez la chaîne de connexion Oracle.
            Cet attribut prend en charge toutes les méthodes d'affectation de nom Oracle Net comme suit :

            • Chaîne URL SQL Connect de format ://host:port/service name. Par exemple, //dlsun242:1521/bjava21.
            • Paire mot clé-valeur Oracle Net. Par exemple,

              (DESCRIPTION=(ADDRESS=(PROTOCOL=tcp) (HOST=dlsun242) (PORT=1521)) 
              (CONNECT_DATA=(SERVICE_NAME=bjava21)))

            • Entrées TNSNAMES, telles que inst1 avec la variable d'environnement TNS_ADMIN ou ORACLE_HOME définie et les fichiers de configuration configurés.

            Passez à l'étape 5d.

   4. Cochez Use a different user name and password pour que cette connexion utilise des données d'identification différentes de celles par défaut que vous avez définies à l'étape 4a et à l'étape 4b ci-dessus. Sinon, passez à l'étape 5g.
   5. Entrez le nom d'utilisateur de la base de données pour cette connexion.
      Il s'agit de l'ID utilisé par l'agent pour accéder à l'instance de la base de données surveillée. Cet ID utilisateur doit disposer de privilèges de sélection sur les vues et les tables de performances dynamiques nécessaires à l'agent.
   6. Entrez le mot de passe de la base de données. Il s'agit du mot de passe associé à l'ID utilisateur de base de données spécifié.
   7. Sélectionnez un rôle qui correspond aux droits accordés aux données d'identification de la connexion à la base de données.
      Le rôle est l'ensemble de privilèges à associer à la connexion. Pour un utilisateur disposant du privilège système SYSDBA, indiquez un rôle qui comprend ce privilège. Pour les instances ASM, utilisez le rôle SYSDBA ou SYSASM.
   8. Cochez Show remote log monitoring options si vous surveillez des journaux d'alertes Oracle distants à partir de cette instance d'agent ; sinon, passez à l'étape 5k.
   9. Entrez le chemin d'accès au fichier journal des alertes Oracle ou utilisez Browse pour le sélectionner.
      Chemins d'accès complets des fichiers journaux d'alertes mappés des instances distantes de cette connexion de la base de données. L'agent surveille les journaux d'alertes en lisant ces fichiers. Ils se trouvent généralement à l'emplacement $ORACLE_BASE/diag/rdbms/NOM_BDD/ID_SYS/trace/alert_ID_SYS.log. Par exemple, si NOM_BDD et ID_SYS sont définis sur db11g et ORACLE_BASE est défini sur /home/dbowner/app/oracle, le journal des alertes figure à l'emplacement /home/dbowner/app/oracle/diag/rdbms/db11g/db11g/trace/alert_db11g.log.

      Si l'Agent Oracle Database s'exécute et lit les fichiers journaux d'alerte via le réseau, le chemin de fichier distant doit suivre la convention de dénomination universelle des systèmes Windows. Par exemple, \\tivx015\path\alert_orcl.log.

      

      Important : Entrez à la fois le chemin d'accès et le nom du fichier journal des alertes. Aucun pilote de réseau mappé n'est pris en charge pour les chemins des journaux d'alertes.

      Si l'Agent Oracle Database se trouve sur un serveur distant, un système de fichiers monté en local est requis pour surveiller ses journaux d'alertes distants.

      Séparez plusieurs fichiers par un point-virgule (;).

      Plusieurs fichiers sont séparés par un signe deux-points (:).

      Chaque fichier est mis en correspondance avec une instance de base de données en utilisant le modèle de nom de fichier alert_instance.log. S'il n'existe pas de correspondance, il est ignoré.

      Les fichiers journaux des alertes de l'instance locale de la base de données sont reconnus automatiquement.

   10. Sélectionnez ou saisissez le jeu de caractères du fichier journal des alertes Oracle. Il s'agit de la page de codes des fichiers journaux des alertes mappés.
       Si ce paramètre est vide, les paramètres régionaux en cours du système sont utilisés, par exemple :

       • ISO8859_1, ISO 8859-1 Europe occidentale
       • UTF-8, UTF-8 Unicode
       • GB18030, chinois simplifié GB18030
       • CP950, chinois traditionnel
       • EUC_JP, japonais
       • EUC_KR, coréen

       Pour la liste complète des pages de codes, voir Pages de codes prises en charger ICU.

   11. Cliquez sur Apply pour sauvegarder les paramètres de cette instance de connexion à la base de données dans la section Database connections.
   12. (Facultatif) Testez la connexion à la nouvelle base de données.
       1. Sélectionnez la nouvelle connexion à la base de données dans la section Database connections.
       2. Cliquez sur Tester la connexion.
       3. Observez les résultats dans la fenêtre Tester la connexion.
          • Exemple de résultat au test réussi :

            Testing connection config1 ...
            Success

          • Exemple de résultat au test échoué :

            Testing connection config1 ...
            KBB_RAS1_LOG; Set MAXFILES to 1
            ORA-12514: TNS:listener does not currently know of service requested in connect descriptor 
            Failed

   13. Cliquez sur Suivant.
6. Lisez les informations contenues dans le panneau Summary de la fenêtre Configure ITCAM Extended Agent for Oracle Database, puis cliquez sur OK pour terminer la configuration d'une instance d'agent.
7. Dans la fenêtre IBM Performance Management, cliquez avec le bouton droit de la souris sur Monitoring Agent for Oracle Database, puis cliquez sur Start.