3 Installazione dai sorgenti

Panoramica

Se installato dai sorgenti, le seguenti informazioni ti aiuteranno a configurare il Java gateway di Zabbix.

Panoramica dei file

Se hai ottenuto Java gateway dai sorgenti, dovresti ritrovarti con una raccolta di script shell, file JAR e file di configurazione sotto $PREFIX/sbin/zabbix_java. Il ruolo di questi file è riassunto di seguito.

bin/zabbix-java-gateway-$VERSION.jar

Il file JAR di Java gateway stesso.

lib/logback-core-1.5.16.jar
lib/logback-classic-1.5.16.jar
lib/slf4j-api-2.0.16.jar
lib/android-json-4.3_r3.1.jar

Dipendenze di Java gateway: libreria Logback, SLF4J e Android JSON.

lib/logback.xml  
lib/logback-console.xml

File di configurazione per Logback.

shutdown.sh  
startup.sh

Script di utilità per avviare e arrestare Java gateway.

settings.sh

File di configurazione utilizzato dagli script di avvio e arresto sopra indicati.

Configurazione ed esecuzione di Java gateway

Per impostazione predefinita, Java gateway ascolta sulla porta 10052. Se prevedi di eseguire Java gateway su una porta diversa, puoi specificarlo nello script settings.sh. Consulta la descrizione del file di configurazione di Java gateway per sapere come specificare questa e altre opzioni.

La porta 10052 non è registrata presso IANA.

Una volta che hai familiarità con le impostazioni, puoi avviare Java gateway eseguendo lo script startup.sh:

./startup.sh

Allo stesso modo, quando non hai più bisogno di Java gateway, esegui lo script shutdown.sh per arrestarlo:

./shutdown.sh

Nota che, a differenza di server o proxy, Java gateway è leggero e non richiede un database.

Configurazione del server per l'uso con Java gateway

Con Java gateway in esecuzione, è necessario indicare a Zabbix server dove trovare Zabbix Java gateway. Questo si fa specificando i parametri JavaGateway e JavaGatewayPort nel file di configurazione del server. Se l'host su cui è in esecuzione l'applicazione JMX è monitorato da Zabbix proxy, allora i parametri di connessione vanno specificati nel file di configurazione del proxy.

JavaGateway=192.168.3.14
JavaGatewayPort=10052

Per impostazione predefinita, server non avvia alcun processo relativo al monitoraggio JMX. Se tuttavia si desidera utilizzarlo, è necessario specificare il numero di istanze pre-forked dei Java poller. Lo si fa nello stesso modo in cui si specificano i poller e i trapper standard.

StartJavaPollers=5

Non dimenticare di riavviare server o proxy, una volta terminata la configurazione.

Debugging Java gateway

Nel caso ci siano problemi con Java gateway oppure il messaggio di errore che vedi riguardo a un item nel frontend non sia sufficientemente descrittivo, potresti voler dare un'occhiata al file di log di Java gateway.

Per impostazione predefinita, Java gateway registra le proprie attività nel file /tmp/zabbix_java.log con livello di log "info". A volte queste informazioni non sono sufficienti ed è necessario avere informazioni con livello di log "debug". Per aumentare il livello di logging, modifica il file lib/logback.xml e cambia l'attributo level del tag <root> in debug:

<root level="debug">
  <appender-ref ref="FILE" />
</root>

Nota che, a differenza di Zabbix server o Zabbix proxy, non è necessario riavviare Zabbix Java gateway dopo aver modificato il file logback.xml - le modifiche in logback.xml verranno applicate automaticamente. Quando hai terminato il debugging, puoi riportare il livello di logging a "info".

Se desideri registrare i log in un file diverso o in un supporto completamente diverso, come un database, modifica il file logback.xml in base alle tue esigenze. Per maggiori dettagli, consulta il Manuale di Logback.

A volte, per scopi di debugging, è utile avviare Java gateway come applicazione console invece che come daemon. Per farlo, commenta la variabile PID_FILE in settings.sh. Se PID_FILE viene omessa, lo script startup.sh avvia Java gateway come applicazione console e fa in modo che Logback utilizzi il file lib/logback-console.xml invece, che non solo registra i log nella console, ma ha anche abilitato il livello di logging "debug".

Infine, nota che poiché Java gateway utilizza SLF4J per il logging, puoi sostituire Logback con il framework che preferisci inserendo un file JAR appropriato nella directory lib. Per maggiori dettagli, consulta il Manuale di SLF4J.

Monitoraggio JMX

Vedere la pagina Monitoraggio JMX per maggiori dettagli.