[comment]: # ({869698af-5380e993})
# 3 Einrichtung aus den Quellen

[comment]: # ({/869698af-5380e993})

[comment]: # ({c93259be-8d0f220e})
#### Übersicht

Wenn Sie aus den Quellen [installiert](/manual/installation/install#installing-java-gateway) haben, hilft Ihnen die folgende Information bei der Einrichtung des Zabbix [Java gateway](/manual/concepts/java).

[comment]: # ({/c93259be-8d0f220e})

[comment]: # ({931dace7-305c7876})
#### Übersicht der Dateien

Wenn Sie Java gateway aus den Quellen bezogen haben, sollten Sie unter `$PREFIX/sbin/zabbix_java` eine Sammlung von Shell-Skripten, JAR- und Konfigurationsdateien vorfinden.
Die Rolle dieser Dateien ist unten zusammengefasst.

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

Die eigentliche JAR-Datei des Java gateway.

    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

Abhängigkeiten des Java gateway: [Logback](http://logback.qos.ch/), [SLF4J](http://www.slf4j.org/) und die [Android JSON](https://android.googlesource.com/platform/libcore/+/master/json)-Bibliothek.

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

Konfigurationsdateien für Logback.

    shutdown.sh  
    startup.sh

Hilfsskripte zum Starten und Stoppen des Java gateway.

    settings.sh

Konfigurationsdatei, die von den oben genannten Startup- und Shutdown-Skripten eingelesen wird.

[comment]: # ({/931dace7-305c7876})

[comment]: # ({c5692cf9-571dbbe2})
#### Konfigurieren und Starten von Java gateway

Standardmäßig lauscht Java gateway auf Port 10052. Wenn Sie Java gateway auf einem anderen Port ausführen möchten, können Sie dies im Skript `settings.sh` angeben.
Siehe die Beschreibung der [Java gateway-Konfigurationsdatei](/manual/appendix/config/zabbix_java), um zu erfahren, wie Sie dies und andere Optionen festlegen.

::: notewarning
Port 10052 ist nicht bei [IANA registriert](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt).
:::

Sobald Sie mit den Einstellungen vertraut sind, können Sie Java gateway starten, indem Sie das Skript `startup.sh` ausführen:

    ./startup.sh

Ebenso können Sie, wenn Sie Java gateway nicht mehr benötigen, das Skript `shutdown.sh` ausführen, um es zu stoppen:

    ./shutdown.sh

Beachten Sie, dass Java gateway im Gegensatz zu Server oder Proxy leichtgewichtig ist und keine Datenbank benötigt.

[comment]: # ({/c5692cf9-571dbbe2})

[comment]: # ({d85c9798-81ca4902})
#### Konfiguration des Servers für die Verwendung mit Java gateway

Wenn Java gateway läuft, müssen Sie dem Zabbix Server mitteilen, wo das Zabbix Java gateway zu finden ist.
Dies geschieht durch Angabe der Parameter `JavaGateway` und `JavaGatewayPort` in der [Server-Konfigurationsdatei](/manual/appendix/config/zabbix_server).
Wenn der Host, auf dem die JMX-Anwendung ausgeführt wird, von einem Zabbix Proxy überwacht wird, geben Sie die Verbindungsparameter stattdessen in der [Proxy-Konfigurationsdatei](/manual/appendix/config/zabbix_proxy) an.

    JavaGateway=192.168.3.14
    JavaGatewayPort=10052

Standardmäßig startet der Server keine Prozesse, die mit der JMX-Überwachung zusammenhängen.
Wenn Sie sie jedoch verwenden möchten, müssen Sie die Anzahl der vorab erzeugten Instanzen der Java-Poller angeben.
Dies tun Sie auf dieselbe Weise, wie Sie reguläre Poller und Trapper angeben.

    StartJavaPollers=5

Vergessen Sie nicht, den Server oder Proxy neu zu starten, sobald Sie mit der Konfiguration fertig sind.

[comment]: # ({/d85c9798-81ca4902})

[comment]: # ({3cde3628-d86274ab})
#### Debugging Java gateway

Falls es Probleme mit Java gateway gibt oder eine Fehlermeldung, die Sie in Bezug auf einen Datenpunkt im Frontend sehen, nicht aussagekräftig genug ist, sollten Sie sich die Protokolldatei von Java gateway ansehen.

Standardmäßig protokolliert Java gateway seine Aktivitäten in die Datei `/tmp/zabbix_java.log` mit dem Protokollierungsgrad "info".
Manchmal reicht diese Information nicht aus, und es werden Informationen auf dem Protokollierungsgrad "debug" benötigt.
Um den Protokollierungsgrad zu erhöhen, ändern Sie die Datei `lib/logback.xml` und setzen Sie das Attribut `level` des `<root>`-Tags auf `debug`:

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

Beachten Sie, dass im Gegensatz zu Zabbix server oder Zabbix proxy kein Neustart von Zabbix Java gateway nach dem Ändern der Datei `logback.xml` erforderlich ist - Änderungen in `logback.xml` werden automatisch übernommen.
Wenn Sie mit dem Debugging fertig sind, können Sie den Protokollierungsgrad wieder auf "info" zurücksetzen.

Wenn Sie in eine andere Datei oder in ein völlig anderes Medium wie eine Datenbank protokollieren möchten, passen Sie die Datei `logback.xml` entsprechend Ihren Anforderungen an.
Weitere Details finden Sie im [Logback Manual](http://logback.qos.ch/manual/).

Manchmal ist es zu Debugging-Zwecken nützlich, Java gateway als Konsolenanwendung statt als Daemon zu starten.
Dazu kommentieren Sie die Variable `PID_FILE` in `settings.sh` aus.
Wenn `PID_FILE` weggelassen wird, startet das Skript `startup.sh` Java gateway als Konsolenanwendung und veranlasst Logback außerdem, die Datei `lib/logback-console.xml` zu verwenden, die nicht nur in die Konsole protokolliert, sondern auch den Protokollierungsgrad "debug" aktiviert.

Abschließend beachten Sie bitte, dass Java gateway für die Protokollierung SLF4J verwendet. Daher können Sie Logback durch ein Framework Ihrer Wahl ersetzen, indem Sie eine geeignete JAR-Datei im Verzeichnis lib ablegen.
Weitere Details finden Sie im [SLF4J Manual](http://www.slf4j.org/manual.html).

[comment]: # ({/3cde3628-d86274ab})

[comment]: # ({27e67930-4332cfb8})
#### JMX-Überwachung

Weitere Details finden Sie auf der Seite [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring).

[comment]: # ({/27e67930-4332cfb8})