[comment]: # translation:outdated

[comment]: # ({5380e993-5380e993})
# - Setup a partir de fontes

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

[comment]: # ({8d0f220e-8d0f220e})
#### Visão Geral

Se instalado [installed](/manual/installation/install#installing_java_gateway)
a partir de fontes, as seguintes informações irão ajudá-lo a configurar
o Zabbix [Java gateway](/manual/concepts/java).

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

[comment]: # ({305c7876-305c7876})
#### Visão Geral dos Arquivos 

Se você obteve o Java gateway a partir das fontes, você deve ter acabado com uma coleção de scripts shell, JAR e arquivos de configuração em $PREFIX/sbin/zabbix\_java. O papel desses arquivos é resumido abaixo.

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

O próprio arquivo JAR do Java gateway.
    lib/logback-core-0.9.27.jar
    lib/logback-classic-0.9.27.jar
    lib/slf4j-api-1.6.1.jar
    lib/android-json-4.3_r3.1.jar

Dependências do Java gateway: Bibliotecas [Logback](http://logback.qos.ch/),
[SLF4J](http://www.slf4j.org/), e [Android
JSON](https://android.googlesource.com/platform/libcore/+/master/json).

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

Arquivos de configuração para Logback.

    shutdown.sh  
    startup.sh

Scripts de conveniência para iniciar e parar Java gateway.

    settings.sh

Arquivo de configuração que é fonte para os scripts de inicialização e desligamento acima.

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

[comment]: # ({efe41890-571dbbe2})
#### Configurando e executando o Java gateway

Por padrão, o  Java gateway escuta na porta 10052. Se você planeja executar o Java gateway em uma porta diferente, você pode especificar isso no script settings.sh. Consulte a descrição do arquivo de configuração do Java gateway [Java gateway configuration
file](/manual/appendix/config/zabbix_java) para especificar esta e outras opções.

::: notewarning
A porta Port 10052 não está registrada [IANA
registered](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt).
:::

Uma vez que você esteja confortável com as configurações, pode iniciar o Java gateway executando o script de inicialização:

    ./startup.sh

Da mesma forma, uma vez que você não precise mais do Java gateway, execute o script de desligamento para pará-lo:

    ./shutdown.sh

Observe que, ao contrário do servidor ou do proxy, o  Java gateway é leve e não precisa de um banco de dados.

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

[comment]: # ({81ca4902-81ca4902})
#### Configurando os servidor para usar o Java gateway

Com o Java gateway funcionando, você precisa informar ao servidor Zabbix onde encontrar o Java gateway do Zabbix. Isso é feito especificando os parâmetros JavaGateway e JavaGatewayPort no arquivo de configuração do servidor [server configuration
file](/manual/appendix/config/zabbix_server). Se o host no qual a aplicação JMX está sendo executada estiver sendo monitorado por um proxy Zabbix, então você especifica os parâmetros de conexão no arquivo de configuração do proxy [proxy configuration
file](/manual/appendix/config/zabbix_proxy).

    JavaGateway=192.168.3.14
    JavaGatewayPort=10052

Por padrão, o servidor não inicia nenhum processo relacionado ao monitoramento JMX. Se você deseja usá-lo, no entanto, você precisa especificar o número de instâncias predefinidas dos pollers Java. Você faz isso da mesma forma que especifica os pollers e trappers regulares.

    StartJavaPollers=5

Não se esqueça de reiniciar o servidor ou o proxy assim que terminar de configurá-los.

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

[comment]: # ({d86274ab-d86274ab})
#### Debugando Java gateway

Caso haja algum problema com o Java  gateway ou uma mensagem de erro que você vê sobre um item no frontend não seja descritiva o suficiente, você pode dar uma olhada no arquivo de log do Java gateway.

Por padrão, o Java gateway registra suas atividades no arquivo /tmp/zabbix_java.log com nível de log "info". Às vezes, essa informação não é suficiente e há necessidade de informações no nível de log "debug". Para aumentar o nível de registro, modifique o arquivo lib/logback.xml e altere o atributo de nível da tag <root> para "debug":

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

Observe que, ao contrário do servidor ou do proxy Zabbix, não é necessário reiniciar o Java gateway do Zabbix após alterar o arquivo logback.xml - as alterações no logback.xml serão automaticamente reconhecidas. Quando terminar a debugging, você pode retornar o nível de log para "info".

Se desejar registrar em um arquivo diferente ou em um meio completamente diferente, como um banco de dados, ajuste o arquivo logback.xml para atender às suas necessidades. Para mais detalhes, consulte o manual 
[Logback
Manual](http://logback.qos.ch/manual/).

Às vezes, para fins de debugging, é útil iniciar o  Java gateway como um aplicativo de console em vez de um daemon. Para fazer isso, comente a variável PID_FILE em settings.sh. Se o PID_FILE for omitido, o script startup.sh inicia o  Java gateway como um aplicativo de console e faz com que o Logback use o arquivo lib/logback-console.xml, que não apenas registra no console, mas também tem o nível de log "debug" ativado.

Finalmente, observe que, como o Java  gateway usa o SLF4J para registro, você pode substituir o Logback pelo framework de sua escolha colocando um arquivo JAR apropriado no diretório lib. Para mais detalhes, consulte o manual [SLF4J
Manual](http://www.slf4j.org/manual.html).

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

[comment]: # ({4332cfb8-4332cfb8})
#### Monitoramento JMX 

Para mais detalhes, consulte a página [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring).

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