Áú»¢¶Ä²©

This is a translation of the original English documentation page. Help us make it better.

12 Configuration de la base de donn¨¦es Oracle

Aper?u

Cette section contient des instructions pour cr¨¦er une base de donn¨¦es Oracle et configurer les connexions entre la base de donn¨¦es et le serveur Áú»¢¶Ä²©, le proxy et l'interface.

Cr¨¦ation de la base de donn¨¦es

Nous supposons qu'un utilisateur de base de donn¨¦es zabbix avec le mot de passe password existe et dispose des autorisations n¨¦cessaires pour cr¨¦er des objets de base de donn¨¦es dans le service ORCL situ¨¦ sur l'h?te du serveur de base de donn¨¦es Oracle. Áú»¢¶Ä²© n¨¦cessite un jeu de caract¨¨res de base de donn¨¦es Unicode et un jeu de caract¨¨res national UTF8. V¨¦rifiez les r¨¦glages actuels :

sqlplus> select parameter,value from v$nls_parameters where parameter='NLS_CHARACTERSET' or parameter='NLS_NCHAR_CHARACTERSET';

Pr¨¦parez maintenant la base de donn¨¦es?:

shell> cd /path/to/zabbix-sources/database/oracle
       shell> sqlplus zabbix/password@oracle_host/ORCL
       sqlplus> @schema.sql
       # arr¨ºtez-vous ici si vous cr¨¦ez une base de donn¨¦es pour le proxy Áú»¢¶Ä²©
       sqlplus> @images.sql
       sqlplus> @data.sql

Veuillez d¨¦finir le param¨¨tre d'initialisation CURSOR_SHARING=FORCE pour de meilleures performances.

Etablissement de la connexion

Áú»¢¶Ä²© prend en charge deux types d'identifiants de connexion (m¨¦thodes de connexion)?:

  • Easy Connect
  • Net Service Name

Les param¨¨tres de configuration de connexion pour le serveur Áú»¢¶Ä²© et le proxy Áú»¢¶Ä²© peuvent ¨ºtre d¨¦finis dans les fichiers de configuration. Les param¨¨tres importants pour le serveur et le proxy sont DBHost, DBUser, DBName et DBPassword. Les m¨ºmes param¨¨tres sont importants pour l'interface Web : $DB["SERVER"], $DB["PORT"], $DB["DATABASE"], $DB["USER"], $DB["PASSWORD"].

Áú»¢¶Ä²© utilise la syntaxe de cha?ne de connexion suivante?:

{DBUser/DBPassword[@<connect_identifier>]}

<connect_identifier> peut ¨ºtre sp¨¦cifi¨¦ sous la forme "Net Nom du service" ou sous la forme "Easy Connect".

@[[//]Host[:Port]/<service_name> | <net_service_name>]

Easy Connect

Easy Connect utilise les param¨¨tres suivants pour se connecter ¨¤ la base de donn¨¦es :

  • Host - le nom d'h?te ou l'adresse IP du serveur de la base de donn¨¦es (param¨¨tre DBHost dans le fichier de configuration).
  • Port - le port d'¨¦coute sur le serveur de base de donn¨¦es (param¨¨tre DBPort dans le fichier de configuration ; s'il n'est pas d¨¦fini, le port 1521 sera utilis¨¦ par d¨¦faut).
  • <service_name> - le nom de service de la base de donn¨¦es ¨¤ laquelle vous souhaitez acc¨¦der (param¨¨tre DBName dans le fichier de configuration).

Exemple:

Param¨¨tres de base de donn¨¦es d¨¦finis dans le fichier de configuration du serveur ou du proxy (zabbix_server.conf et zabbix_proxy.conf):

DBHost=localhost
       DBPort=1521
       DBUser=myusername
       DBName=ORCL
       DBPassword=mypassword

Cha?ne de connexion utilis¨¦e par Áú»¢¶Ä²© pour ¨¦tablir la connexion :

DBUser/DBPassword@DBHost:DBPort/DBName

Lors de l'installation de l'interface Áú»¢¶Ä²©, d¨¦finissez les param¨¨tres correspondants ¨¤ l'¨¦tape Configurer la connexion ¨¤ la base de donn¨¦es de l'assistant d'installation :

  • Database host: localhost
  • Database port: 1521
  • Database name: ORCL
  • User: myusername
  • Password: mypassword

Alternativement, ces param¨¨tres peuvent ¨ºtre d¨¦finis dans le fichier de configuration frontal (zabbix.conf.php):

$DB["TYPE"]                     = 'ORACLE';
       $DB["SERVER"]                   = 'localhost';
       $DB["PORT"]             = '1521';
       $DB["DATABASE"]                 = 'ORCL';
       $DB["USER"]                     = 'myusername';
       $DB["PASSWORD"]                 = 'mypassword';

Nom du service r¨¦seau

Depuis Áú»¢¶Ä²© 5.4.0, il est possible de se connecter ¨¤ Oracle en utilisant le nom du service r¨¦seau.

<net_service_name> est un nom simple pour un service qui se r¨¦sout en un descripteur de connexion.

Afin d'utiliser le nom de service pour cr¨¦er une connexion, ce nom de service doit ¨ºtre d¨¦fini dans le fichier tnsnames.ora situ¨¦ ¨¤ la fois sur le serveur de base de donn¨¦es et sur les syst¨¨mes clients. Le moyen le plus simple de s'assurer que la connexion r¨¦ussira est de d¨¦finir l'emplacement du fichier tnsnames.ora dans la variable d'environnement TNS_ADMIN. L'emplacement par d¨¦faut du fichier tnsnames.ora est :

$ORACLE_HOME/network/admin/

Un exemple simple de fichier tnsnames.ora :

ORCL =
         (DESCRIPTION =
           (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))
           (CONNECT_DATA =
             (SERVER = DEDICATED)
             (SERVICE_NAME = ORCL)
           )
         )

Pour d¨¦finir les param¨¨tres de configuration de la m¨¦thode de connexion "Nom du service r¨¦seau", utilisez l'une des options suivantes :

  • D¨¦finissez un param¨¨tre DBHost vide et d¨¦finissez DBName comme d'habitude :
DBHost=
       DBName=ORCL
  • D¨¦finissez les deux param¨¨tres et laissez les vides :
DBHost=
       DBName=

Dans le second cas, la variable d'environnement TWO_TAKS doit ¨ºtre d¨¦finie. Il sp¨¦cifie le service Oracle distant par d¨¦faut (nom du service). Lorsque cette variable est d¨¦finie, le connecteur se connecte ¨¤ la base de donn¨¦es sp¨¦cifi¨¦e ¨¤ l'aide d'un ¨¦couteur Oracle qui accepte les demandes de connexion. Cette variable est ¨¤ utiliser sous Linux et UNIX uniquement. Utilisez la variable d'environnement LOCAL pour Microsoft Windows.

Exemple :

Connectez-vous ¨¤ une base de donn¨¦es ¨¤ l'aide du nom de service r¨¦seau d¨¦fini sur ORCL et du port par d¨¦faut. Param¨¨tres de base de donn¨¦es d¨¦finis dans le fichier de configuration du serveur ou du proxy (zabbix_server.conf et zabbix_proxy.conf) :

DBHost=
       #DBPort=
       DBUser=myusername
       DBName=ORCL
       DBPassword=mypassword

Lors de l'installation de l'interface Áú»¢¶Ä²©, d¨¦finissez les param¨¨tres correspondants ¨¤ l'¨¦tape Configurer la connexion ¨¤ la base de donn¨¦es de l'assistant d'installation :

  • H?te de base de donn¨¦es :
  • Port de la base de donn¨¦es : 0
  • Nom de la base de donn¨¦es : ORCL
  • Utilisateur : myusername
  • Mot de passe : mypassword

Alternativement, ces param¨¨tres peuvent ¨ºtre d¨¦finis dans le fichier de configuration du frontend (zabbix.conf.php) :

$DB["TYPE"]                     = 'ORACLE';
       $DB["SERVER"]                   = '';
       $DB["PORT"]                     = '0';
       $DB["DATABASE"]                 = 'ORCL';
       $DB["USER"]                     = 'myusername';
       $DB["PASSWORD"]                 = 'mypassword';

Cha?ne de connexion utilis¨¦e par Áú»¢¶Ä²© pour ¨¦tablir la connexion :

DBUser/DBPassword@ORCL

Known issues

To improve performance, you can convert the field types from nclob to nvarchar2, see known issues.