community.zabbix.zabbix_javagateway role

Table of Contents

Overview
- Operating systems
- Zabbix Versions
Role Variables
- Main variables
Dependencies
Example Playbook
Molecule
License
Author Information

Overview

Operating systems

This role will work on the following operating systems:

Red Hat
Debian
Ubuntu

So, you'll need one of those operating systems.. :-)

Zabbix Versions

See the following list of supported Operating systems with the Zabbix releases.

Zabbix	7.4	7.2	7.0	6.0
Red Hat Fam 9	V	V	V	V
Red Hat Fam 8	V	V	V	V
Ubuntu 24.04 noble	V	V	V	V
Ubuntu 22.04 jammy	V	V	V	V
Debian 12 bookworm	V	V	V	V
Debian 11 bullseye	V	V	V	V
Suse Fam 15	V	V	V	V

You can bypass this matrix by setting enable_version_check: false

Role Variables

Main variables

The following is an overview of all available configuration default for this role.

Overall Zabbix

The zabbix_javagateway_version is optional. The latest available major.minor version of Zabbix will be installed on the host(s). If you want to use an older version, please specify this in the major.minor format. Example: zabbix_javagateway_version: 6.0.

zabbix_repo_yum: A list with Yum repository configuration.
zabbix_repo_yum_schema: Default: https. Option to change the web schema for the yum repository(http/https)
zabbix_javagateway_disable_repo: A list of repos to disable during install. Default epel.
zabbix_javagateway_package_state: Default: present. Can be overridden to latest to update packages when needed.
zabbix_javagateway_conf_mode: Default: 0644. The "mode" for the Zabbix configuration file.
zabbix_repo_deb_url: The URL to the Zabbix repository. Default http://repo.zabbix.com/zabbix/{{ zabbix_agent_version }}/{{ ansible_distribution.lower() }}
zabbix_repo_deb_component: The repository component for Debian installs. Default main.
zabbix_repo_deb_gpg_key_url: The URL to download the Zabbix GPG key from. Default http://repo.zabbix.com/zabbix-official-repo.key.
zabbix_repo_deb_include_deb_src: True, if deb-src should be included in the zabbix.sources entry. Default true.
zabbix_manage_repo: Have the collection install and configure the Zabbix repo Default true.

Java Gatewaty

zabbix_javagateway_pidfile: Default: /run/zabbix/zabbix_java_gateway.pid. The location for the pid file.
zabbix_javagateway_listenip: Default: 0.0.0.0. The IP address to listen on.
zabbix_javagateway_listenport: Default: 10052. The port on which Java Gateway is listening on.
zabbix_javagateway_startpollers: Default: 5. The amount of pollers to start.

proxy

When the target host does not have access to the internet, but you do have a proxy available then the following properties needs to be set to download the packages via the proxy:

zabbix_http_proxy
zabbix_https_proxy

Dependencies

The java gateway can be installed on either the zabbix-server or the zabbix-proxy machine. So one of these should be installed. You'll need to provide an parameter in your playbook for using the javagateway.

When using the zabbix-server:

  roles:
    - role: community.zabbix.zabbix_server
      zabbix_server_javagateway: 192.168.1.2

or when using the zabbix-proxy:

  roles:
    - role: community.zabbix.zabbix_proxy
      zabbix_proxy_server: 192.168.1.1
      zabbix_proxy_javagateway: 192.168.1.2

Example Playbook

Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:

    - hosts: zabbix-server
      sudo: yes
      roles:
        - role: community.zabbix.zabbix_server
          zabbix_server_javagateway: 192.168.1.2
        - role: community.zabbix.zabbix_javagateway

Molecule

This role is configured to be tested with Molecule. You can find on this page some more information regarding Molecule:

http://werner-dijkerman.nl/2016/07/10/testing-ansible-roles-with-molecule-testinfra-and-docker/
http://werner-dijkerman.nl/2016/07/27/extending-ansible-role-testing-with-molecule-by-adding-group_vars-dependencies-and-using-travis-ci/
http://werner-dijkerman.nl/2016/07/31/testing-ansible-roles-in-a-cluster-setup-with-docker-and-molecule/

With each Pull Request, Molecule will be executed via travis.ci. Pull Requests will only be merged once these tests run successfully.

License

GNU General Public License v3.0 or later

See LICENCE to see the full text.

Author Information

Please send suggestion or pull requests to make this role better. Also let us know if you encounter any issues installing or using this role.

Github: https://github.com/ansible-collections/community.zabbix

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

pFad - (p)hone/(F)rame/(a)nonymizer/(d)eclutterfier! Saves Data!