Files
offline_kubespray/collection/community/zabbix/docs/UPGRADE.md
ByeonJungHun 360c6eef4a offline 작업
2024-02-19 16:02:29 +09:00

195 lines
7.0 KiB
Markdown

__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
```