4 Instalación y ficheros
4.1 Ubicación de los ficheros#
Una instalación estándar usa estas rutas:
| Ruta | Contenido |
|---|---|
/opt/trustserver/sbin/databbix |
Ejecutable del demonio. |
/opt/trustserver/lib64 |
Bibliotecas de Trustserver y cliente de Oracle. |
/opt/trustserver/modules/databbix |
Módulos (motores de consultas, lenguajes, motores de autenticación). |
/etc/databbix/databbix.conf |
Configuración global del demonio. |
/etc/databbix/dbs/ |
Un fichero .conf por monitor. |
/etc/databbix/query*.xml |
Ficheros de definición de consultas. |
/etc/databbix/tnsnames.ora |
Alias de conexión de Oracle. |
/etc/databbix/odbc.ini |
Fuentes de datos ODBC. |
/etc/sysconfig/databbix |
Variables de entorno para el servicio. |
/var/log/databbix/ |
Ficheros de log. |
4.2 Ficheros de consultas incluidos#
La distribución incluye varios ficheros XML de ejemplo listos para usar:
| Fichero | Uso |
|---|---|
query.xml |
Oracle (fichero por defecto). |
query-mt.xml |
Oracle multitenant (CDB/PDB). |
query-ora-9.xml |
Oracle 9. |
query-pg.xml |
PostgreSQL. |
query-pg-9.xml, query-pg-10.xml |
Consultas específicas de versiones de PostgreSQL. |
query-pg-bareos.xml |
Catálogo de Bareos en PostgreSQL. Se usa siempre junto con query-pg.xml*. |
query-mssql.xml |
Microsoft SQL Server (vía ODBC). |
query-db-jde.xml |
Base de datos de JD Edwards (Oracle, DB2/400 o SQL Server). Si se configura JDEDB, se usa junto con el fichero que declara el contexto de ContextName*. |
query-jde.xml, query-ais.xml |
Servicios REST de JD Edwards y AIS. |
query-soap.xml |
Ejemplo de servicio SOAP. |
query-mqtt.xml |
Broker MQTT. |
query-emcunity.xml, query-sagex3.xml |
Otros servicios web. |
zabbix_templates.xml |
Plantillas de Zabbix asociadas. |
*Ficheros que dependen de otro. query-pg-bareos.xml no declara el contexto Database que usa: lo declara query-pg.xml. Del mismo modo, query-db-jde.xml usa el contexto indicado en la variable ContextName (Container por defecto, declarado en query-mt.xml; Database, en query-pg.xml o query-mssql.xml). Como un contexto tiene que estar declarado antes de que se use, el fichero que lo declara debe ir antes en las líneas QueryFile:
[General]
QueryFile = /etc/databbix/query-pg.xml # declara el contexto Database
QueryFile = /etc/databbix/query-pg-bareos.xml # lo usa4.3 Variables de entorno#
El servicio lee /etc/sysconfig/databbix. Estas son las variables habituales:
TNS_ADMIN=/etc/databbix # directorio de tnsnames.ora
ODBCINI=/etc/databbix/odbc.ini # fichero de fuentes ODBCLa unidad de systemd añade además LD_LIBRARY_PATH=/opt/trustserver/lib64.