Installazione dai sorgenti

Panoramica

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

Panoramica dei file

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

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

Il file JAR di Java gateway vero e proprio.

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 richiamato dagli script di avvio e arresto sopra indicati.

Configurazione ed esecuzione di Java gateway

Per impostazione predefinita, Java gateway resta in ascolto sulla porta 10052. Se si prevede di eseguire Java gateway su una porta diversa, è possibile specificarlo nello script settings.sh. Per informazioni su come specificare questa e altre opzioni, vedere la descrizione del file di configurazione di Java gateway.

La porta 10052 non è registrata presso IANA.

Una volta definite le impostazioni desiderate, è possibile avviare Java gateway eseguendo lo script di avvio:

./startup.sh

Allo stesso modo, quando Java gateway non è più necessario, eseguire lo script di arresto per fermarlo:

./shutdown.sh

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

Configurazione del server per l'utilizzo con Java gateway

Con Java gateway attivo e 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 è necessario specificare i parametri di connessione nel file di configurazione del proxy.

JavaGateway=192.168.3.14
JavaGatewayPort=10052

Per impostazione predefinita, il server non avvia alcun processo relativo al monitoraggio JMX. Tuttavia, se si desidera utilizzarlo, è necessario specificare il numero di istanze pre-fork dei Java poller. Questo si fa nello stesso modo in cui si specificano i normali poller e trapper.

StartJavaPollers=5

Non dimenticare di riavviare il server o il proxy una volta completata la configurazione.

Debug di Java gateway

Nel caso in cui si verifichino problemi con Java gateway oppure il messaggio di errore che vedi relativo 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 disporre di informazioni al 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 rilevate automaticamente. Quando hai terminato il debug, puoi riportare il livello di logging a "info".

Se desideri registrare i log in un file diverso o in un supporto completamente differente come un database, adatta il file logback.xml alle tue esigenze. Consulta il manuale di Logback per maggiori dettagli.

A volte, per scopi di debug, è utile avviare Java gateway come applicazione console anziché come demone. 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 sì che Logback utilizzi invece il file lib/logback-console.xml, che non solo registra sulla console, ma ha anche il livello di logging "debug" abilitato.

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. Consulta il manuale di SLF4J per maggiori dettagli.

Monitoraggio JMX

Vedi la pagina JMX monitoring per ulteriori dettagli.