offline_kubespray/collection/community/zabbix/docs/UPGRADE.md

Upgrade

Table of content

• 1.0.0
  • Roles
    • Proxy
    • Java Gateway
• 0.2.0
  • Roles
    • Agent
    • Server
    • Proxy
    • Web
    • Java Gateway

This document provides an overview of all the changes that are needed to be applied to have a correctly working environment per version. If a version is not part of this document, then there are no changes needed to apply.

1.5.0

Roles

Agent

The following properties are added in the zabbix_agent role.

• zabbix_api_timeout = 30
• zabbix_agent_tls_subject = "{{ zabbix_agent_tlsservercertsubject }}"
• zabbix_agent2_server = "{{ zabbix_agent_server }}"
• zabbix_agent2_serveractive = "{{ zabbix_agent_serveractive }}"
• zabbix_agent2_allow_key = "{{ zabbix_agent_allow_key }}"
• zabbix_agent2_deny_key = "{{ zabbix_agent_deny_key }}"
• zabbix_agent2_tls_subject = "{{ zabbix_agent2_tlsservercertsubject }}"

NOTE: The original properties can still be used but it's suggested to update to use the new ones.

The following properties are renamed in the zabbix_agent role.

From	To
zabbix_url	zabbix_api_server_url
zabbix_agent_server_url	zabbix_api_server_url
zabbix_http_user	zabbix_api_http_user
zabbix_http_password	zabbix_api_http_password
zabbix_api_user	zabbix_api_login_user
zabbix_api_pass	zabbix_api_login_pass
zabbix_validate_certs	zabbix_api_validate_certs
zabbix_create_hostgroup	zabbix_agent_hostgroups_state
zabbix_macros	zabbix_agent_macros
zabbix_inventory_mode	zabbix_agent_inventory_mode
zabbix_link_templates	zabbix_agent_link_templates
zabbix_proxy	zabbix_agent_proxy
zabbix_update_host	zabbix_agent_host_update
zabbix_create_host	zabbix_agent_host_state
zabbix_visible_hostname	zabbix_agent_visible_hostname

NOTE: the old parameters are still valid but it's suggested to update to use the new ones.

Proxy

The following properties are added in the zabbix_proxy role.

• zabbix_api_timeout = 30
• zabbix_proxy_tls_subject = "{{ zabbix_proxy_tlsservercertsubject }}"

The following properties are renamed in the zabbix_proxy role.

From	To
zabbix_server_host	zabbix_proxy_server
zabbix_server_port	zabbix_proxy_serverport
zabbix_proxy_localbuffer	zabbix_proxy_proxylocalbuffer
zabbix_proxy_offlinebuffer	zabbix_proxy_proxyofflinebuffer
zabbix_create_proxy	zabbix_proxy_state
zabbix_url	zabbix_api_server_url
zabbix_http_user	zabbix_api_http_user
zabbix_http_password	zabbix_api_http_password
zabbix_api_user	zabbix_api_login_user
zabbix_api_pass	zabbix_api_login_pass
zabbix_validate_certs	zabbix_api_validate_certs

NOTE: the old parameters are still valid but it's suggested to update to use the new ones.

1.0.0

Roles

Proxy

The following property is renamed in the zabbix_proxy role.

From	To
zabbix_version	zabbix_proxy_version

NOTE: The zabbix_version can still be used, but will be deprecated in later releases.

Java Gateway

The following properties are renamed in the zabbix_javagateway role.

From	To
zabbix_version	zabbix_javagateway_version
javagateway_package_state	zabbix_javagateway_package_state
javagateway_pidfile	zabbix_javagateway_pidfile
javagateway_listenip	zabbix_javagateway_listenip
javagateway_listenport	zabbix_javagateway_listenport
javagateway_startpollers	zabbix_javagateway_startpollers

NOTE: The zabbix_version can still be used, but will be deprecated in later releases.

0.2.0

Roles

Agent

A 1-on-1 copy of the Ansible role dj-wasabi.zabbix-agent to this collection. Due to naming of roles as part of a collection, some characters (Like the -) are not allowed anymore. This role is therefore renamed from zabbix-agent to zabbix_agent.

Example of using the role in this collection:

- hosts: all
  roles:
    - role: community.zabbix.zabbix_agent
      zabbix_agent_server: 192.168.33.30
      zabbix_agent_serveractive: 192.168.33.30

Server

A 1-on-1 copy of the Ansible role dj-wasabi.zabbix-server to this collection. Due to naming of roles as part of a collection, some characters (Like the -) are not allowed anymore. This role is therefore renamed from zabbix-server to zabbix_server.

Example of using the role in this collection::

- hosts: zabbix-server
  roles:
    - role: community.zabbix.zabbix_server
      zabbix_server_database: mysql
      zabbix_server_database_long: mysql
      zabbix_server_dbport: 3306

Proxy

A 1-on-1 copy of the Ansible role dj-wasabi.zabbix-proxy to this collection. Due to naming of roles as part of a collection, some characters (Like the -) are not allowed anymore. This role is therefore renamed from zabbix-proxy to zabbix_proxy.

Example of using the role in this collection::

- hosts: zabbix-proxy
  roles:
    - role: community.zabbix.zabbix_proxy
      zabbix_proxy_server: 192.168.1.1
      zabbix_server_database: mysql
      zabbix_server_database_long: mysql
      zabbix_server_dbport: 3306

Web

A 1-on-1 copy of the Ansible role dj-wasabi.zabbix-web to this collection. Due to naming of roles as part of a collection, some characters (Like the -) are not allowed anymore. This role is therefore renamed from zabbix-web to zabbix_web.

Example of using the role in this collection::

- hosts: zabbix-web
  become: yes
  roles:
    - role: geerlingguy.apache
    - role: community.zabbix.zabbix_web
      zabbix_url: zabbix.mydomain.com
      zabbix_server_hostname: zabbix-server
      zabbix_server_database: mysql
      zabbix_server_database_long: mysql
      zabbix_server_dbport: 3306

Java Gateway

A 1-on-1 copy of the Ansible role dj-wasabi.zabbix-javagateway to this collection. Due to naming of roles as part of a collection, some characters (Like the -) are not allowed anymore. This role is therefore renamed from zabbix-javagateway to zabbix_javagateway.

Example of using the role in this collection::

- hosts: zabbix-server
  roles:
    - role: community.zabbix.zabbix_server
      zabbix_server_database: mysql
      zabbix_server_database_long: mysql
      zabbix_server_dbport: 3306
      zabbix_server_javagateway: 192.168.1.1
    - role: community.zabbix.zabbix_javagateway