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.
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.
Áú»¢¶Ä²© prend en charge deux types d'identifiants de connexion (m¨¦thodes de connexion)?:
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?:
<connect_identifier> peut ¨ºtre sp¨¦cifi¨¦ sous la forme "Net Nom du service" ou sous la forme "Easy Connect".
Easy Connect utilise les param¨¨tres suivants pour se connecter ¨¤ la base de donn¨¦es :
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):
Cha?ne de connexion utilis¨¦e par Áú»¢¶Ä²© pour ¨¦tablir la connexion :
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 :
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';
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 :
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 :
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) :
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 :
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 :
To improve performance, you can convert the field types from nclob to nvarchar2, see known issues.