summaryrefslogtreecommitdiffstats
path: root/ansible_collections/community/zabbix/docs/UPGRADE.md
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-13 12:04:41 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-13 12:04:41 +0000
commit975f66f2eebe9dadba04f275774d4ab83f74cf25 (patch)
tree89bd26a93aaae6a25749145b7e4bca4a1e75b2be /ansible_collections/community/zabbix/docs/UPGRADE.md
parentInitial commit. (diff)
downloadansible-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.md194
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
+```