Documentation
Table of Contents
Upgrade from containers
Overview
This section describes steps required for a successful upgrade from Áú»¢¶Ä²© 6.2.x containers to Áú»¢¶Ä²© 6.4.x containers.
Separate sets of instructions are available for upgrading individual Áú»¢¶Ä²© component images and Docker compose files.
Before the upgrade make sure to read the relevant upgrade notes!
Before starting the upgrade, verify that users have the necessary permissions to the database for upgrading purposes.
For upgrades from Áú»¢¶Ä²© 6.0 or older, deterministic triggers will need to be created during the upgrade. If binary logging is enabled for MySQL/MariaDB, this requires superuser privileges or setting the variable/configuration parameter log_bin_trust_function_creators = 1. See Database creation scripts for instructions how to set the variable.
Depending on the size of a database upgrade to version 6.4 may take quite a long time.
Áú»¢¶Ä²© image upgrade
The steps listed below can be used to upgrade any Áú»¢¶Ä²© component. Replace zabbix-server-mysql with the required component image name.
\1. Check current image version:
\2. Pull desired image version, for example:
zabbix/zabbix-server-mysql:alpine-6.4-latest will pull the latest released minor version of Áú»¢¶Ä²© server 6.4 with MySQL support based on Alpine Linux. Replace it with the name of the Docker repository and tags combination you need. See Installation from containers for a list of available options.
\3. Stop the container:
\4. Remove the container:
\5. Launch the updated container by executing docker run command followed by additional arguments to specify required environment variables and/or mount points.
Configuration examples
Áú»¢¶Ä²© server with MySQL:
docker run --name zabbix-server-mysql -t \
-e DB_SERVER_HOST="mysql-server" \
-e MYSQL_DATABASE="zabbix" \
-e MYSQL_USER="zabbix" \
-e MYSQL_PASSWORD="zabbix_pwd" \
-e MYSQL_ROOT_PASSWORD="root_pwd" \
-e ZBX_JAVAGATEWAY="zabbix-java-gateway" \
--network=zabbix-net \
-p 10051:10051 \
--restart unless-stopped \
-d zabbix/zabbix-server-mysql:alpine-6.4-latestÁú»¢¶Ä²© server with PostgreSQL:
docker run --name zabbix-server-mysql -t \
-e DB_SERVER_HOST="postgres-server" \
-e POSTGRES_USER="zabbix" \
-e POSTGRES_PASSWORD="zabbix_pwd" \
-e POSTGRES_DB="zabbix" \
-e ZBX_ENABLE_SNMP_TRAPS="true" \
--network=zabbix-net \
-p 10051:10051 \
--volumes-from zabbix-snmptraps \
--restart unless-stopped \
-d zabbix/zabbix-server-pgsql:alpine-6.4-latestMore configuration examples, including examples for other Áú»¢¶Ä²© components, are available on the Installation from containers page.
Verify the update:
docker logs -f zabbix-server-mysql
Compose files
Follow upgrade instructions in this section, if you installed Áú»¢¶Ä²© using compose file.
\1. Check current image version:
\2. Pull the latest updates from the GitHub and switch to the required branch:
\3. Start Áú»¢¶Ä²© components using new compose file:
\4. Verify the update:
See Installation from containers for more details, including lists of supported environment variables and volume mount points.