diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-13 12:04:41 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-13 12:04:41 +0000 |
commit | 975f66f2eebe9dadba04f275774d4ab83f74cf25 (patch) | |
tree | 89bd26a93aaae6a25749145b7e4bca4a1e75b2be /ansible_collections/community/zabbix/docs/UPGRADE.md | |
parent | Initial commit. (diff) | |
download | ansible-975f66f2eebe9dadba04f275774d4ab83f74cf25.tar.xz ansible-975f66f2eebe9dadba04f275774d4ab83f74cf25.zip |
Adding upstream version 7.7.0+dfsg.upstream/7.7.0+dfsg
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'ansible_collections/community/zabbix/docs/UPGRADE.md')
-rw-r--r-- | ansible_collections/community/zabbix/docs/UPGRADE.md | 194 |
1 files changed, 194 insertions, 0 deletions
diff --git a/ansible_collections/community/zabbix/docs/UPGRADE.md b/ansible_collections/community/zabbix/docs/UPGRADE.md new file mode 100644 index 000000000..7784f5842 --- /dev/null +++ b/ansible_collections/community/zabbix/docs/UPGRADE.md @@ -0,0 +1,194 @@ +__Upgrade__ + +Table of content + +- [1.0.0](#100) + * [Roles](#roles) + + [Proxy](#proxy) + + [Java Gateway](#java-gateway) +- [0.2.0](#020) + * [Roles](#roles-1) + + [Agent](#agent) + + [Server](#server) + + [Proxy](#proxy-1) + + [Web](#web) + + [Java Gateway](#java-gateway-1) + +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: +```yaml +- 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:: +```yaml +- 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:: +```yaml +- 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:: +```yaml +- 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:: +```yaml +- 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 +``` |