Zabbix Documentation 5.0
Sidebar
Table of Contents
Сборка Zabbix агента на macOS
Обзор
Этот раздел демонстрирует как собрать бинарные файлы Zabbix macOS агента из исходного кода с или без TLS.
Предварительные требования
Вам потребуются средства разработки командной строки (Xcode не потребуется), Automake, pkg-config and PCRE (v8.x). Если вы хотите собирать бинарные файла агента с TLS, вам также понадобится OpenSSL или GnuTLS.
Чтобы установить Automake и pkg-config, вам потребуется менеджер пакетов Homebrew с https://brew.sh/. Чтобы его установить, откройте терминал и выполните следующую команду:
Затем установите Automake и pkg-config:
Подготовка библиотек PCRE, OpenSSL и GnuTLS зависит от того, каким образом они будут скомпонованы с агентом.
Если вы намереваетесь запускать бинарные файлы агента на компьютере MacOS, на котором уже имеются эти библиотеки, вы можете использовать уже скомпилированные библиотеки, которые поставляются Homebrew. Обычно это машины macOS, которые используют Homebrew для сборки бинарных файлов Zabbix агента или для других целей.
Если бинарные файлы агента будут использоваться на компьютерах macOS, на которых отсутствуют разделяемые версии библиотек, вам потребуется скомпилировать статические версии этих библиотек из исходных кодов и скомпоновать Zabbix агента с ними.
Сбора бинарных файлов агента с разделяемыми библиотеками
При сборке с TLS, установите OpenSSL и / или GnuTLS:
Загрузите исходный код Zabbix:
Соберите агента без TLS:
Соберите агента с OpenSSL:
Соберите агента с GnuTLS:
Сборка бинарных файлов агента со статическими библиотеками без TLS
Давайте предположим, что статическая библиотека PCRE будут установлены в $HOME/static-libs . Мы будем использовать PCRE 8.42.
Загрузите и соберите PCRE с поддержкой Юникод свойств:
Загрузите исходный код Zabbix и соберите агента:
Сборка бинарных файлов агента со статическими библиотеками с OpenSSL
После успешной сборки OpenSSL рекомендуется выполнить make test . Даже, если сборка прошла успешно, тесты иногда завершаются с ошибками. Если это как раз ваш случай, тогда проблемы необходимо исследовать и решить перед тем как продолжить.
Давайте предположим, что статические библиотеки PCRE и OpenSSL будут установлены в $HOME/static-libs . Мы будем использовать PCRE 8.42 и OpenSSL 1.1.1a.
Давайте собирать статические библиотеки в static-libs-source :
Загрузите и соберите PCRE с поддержкой Юникод свойств:
Загрузите и соберите OpenSSL:
Загрузите исходный код Zabbix и соберите агента:
Сборка бинарных файлов агента со статическими библиотеками с GnuTLS
GnuTLS зависит от крипто серверной библиотеки Nettle и арифметической библиотеки GMP. Вместо использования полной библиотеки GMP, в этом руководстве используется mini-gmp, которая включена в Nettle.
После успешной сборки GnuTLS и Nettle рекомендуется выполнить make check . Даже, если сборка прошла успешно, тесты иногда завершаются с ошибками. Если это как раз ваш случай, тогда проблемы необходимо исследовать и решить перед тем как продолжить.
Давайте предположим, что статические библиотеки PCRE, Nettle и GnuTLS будут установлены в $HOME/static-libs . Мы будем использовать PCRE 8.42, Nettle 3.4.1 и GnuTLS 3.6.5.
Давайте собирать статические библиотеки в static-libs-source :
Загрузите и соберите Nettle:
Загрузите и соберите GnuTLS:
Загрузите исходный код Zabbix и соберите агента:
Zabbix Documentation 4.2
Sidebar
Table of Contents
Building Zabbix agent on macOS
Overview
This section demonstrates how to build Zabbix macOS agent binaries from sources with or without TLS.
Prerequisites
You will need command line developer tools (Xcode is not required), Automake, pkg-config and PCRE (v8.x). If you want to build agent binaries with TLS, you will also need OpenSSL or GnuTLS.
To install command line developer tools, open terminal and run svn command. Instead of printing short help message, it will display informative message about missing command line developer tools and open new GUI window for installing them. Press “Install” in the dialog window.
To install Automake and pkg-config, you will need a Homebrew package manager from https://brew.sh/. To install it, open terminal and run the following command:
Then install Automake and pkg-config:
Preparing PCRE, OpenSSL and GnuTLS libraries depends on the way how they are going to be linked to the agent.
If you intend to run agent binaries on a macOS machine that already has these libraries, you can use precompiled libraries that are provided by Homebrew. These are typically macOS machines that use Homebrew for building Zabbix agent binaries or for other purposes.
If agent binaries will be used on macOS machines that don’t have the shared version of libraries, you should compile static libraries from sources and link Zabbix agent with them.
Building agent binaries with shared libraries
When building with TLS, install OpenSSL and/or GnuTLS:
Download Zabbix source:
Build agent without TLS:
Build agent with OpenSSL:
Build agent with GnuTLS:
Building agent binaries with static libraries without TLS
Let’s assume that PCRE static libraries will be installed in $HOME/static-libs . We will use PCRE 8.42.
Download and build PCRE with Unicode properties support:
Download Zabbix source and build agent:
Building agent binaries with static libraries with OpenSSL
When building OpenSSL, it’s recommended to run make test after successful building. Even if building was successful, tests sometimes fail. If this is the case, problems should be researched and resolved before continuing.
Let’s assume that PCRE and OpenSSL static libraries will be installed in $HOME/static-libs . We will use PCRE 8.42 and OpenSSL 1.1.1a.
Let’s build static libraries in static-libs-source :
Download and build PCRE with Unicode properties support:
Download and build OpenSSL:
Download Zabbix source and build agent:
Building agent binaries with static libraries with GnuTLS
GnuTLS depends on the Nettle crypto backend and GMP arithmetic library. Instead of using full GMP library, this guide will use mini-gmp which is included in Nettle.
When building GnuTLS and Nettle, it’s recommended to run make check after successful building. Even if building was successful, tests sometimes fail. If this is the case, problems should be researched and resolved before continuing.
Let’s assume that PCRE, Nettle and GnuTLS static libraries will be installed in $HOME/static-libs . We will use PCRE 8.42, Nettle 3.4.1 and GnuTLS 3.6.5.
Let’s build static libraries in static-libs-source :
Zabbix Documentation 4.2
Sidebar
Table of Contents
4 Установка Mac OS агента с PKG
Обзор
Установка агента
Агента можно установить с использованием графического интерфейса пользователя или через командную строку, например:
Убедитесь, что используете в команде корректную версию Zabbix пакета. Имя файла должно совпадать с именем загруженного пакета.
Запуск агента
Агент автоматически запустится после инсталляции или перезапуска.
Вы можете отредактировать файл конфигурации в /usr/local/etc/zabbix/zabbix_agentd.conf , если требуется.
Чтобы запустить агента вручную, вы можете выполнить:
Чтобы остановить агента вручную:
В процессе обновления существующий файл конфигурации не перезаписывается. Вместо этого создается новый zabbix_agentd.conf.NEW файл, который можно использовать для проверки и обновления существующего файла конфигурации, если требуется. Не забудьте перезапустить агента после изменений в файле конфигурации.
Устранение неполадок и удаление агента
Этот раздел перечисляет некоторые полезные команды, которые можно использовать для поиска неполадок и удаления инсталляции Zabbix агента.
Просмотр, запущен ли Zabbix агент:
Просмотр, установлен ли Zabbix агент из пакетов:
Просмотр списка файлов, которые установлены пакетом установщика (обратите внимание, начальный символ / не отображается в выводе ниже):
Остановка Zabbix агента, если он запущен при помощи launchctl :
Удаление файлов (включая конфигурацию и журналов), которые установлены пакетом установщика:
Zabbix Documentation 5.0
Sidebar
Table of Contents
5 Mac OS agent installation from PKG
Overview
Installing agent
The agent can be installed using the graphical user interface or from the command line, for example:
Make sure to use the correct Zabbix package version in the command. It must match the name of the downloaded package.
Running agent
The agent will start automatically after installation or restart.
You may edit the configuration file at /usr/local/etc/zabbix/zabbix_agentd.conf if necessary.
To start the agent manually, you may run:
To stop the agent manually:
During upgrade, the existing configuration file is not overwritten. Instead a new zabbix_agentd.conf.NEW file is created to be used for reviewing and updating the existing configuration file, if necessary. Remember to restart the agent after manual changes to the configuration file.
Troubleshooting and removing agent
This section lists some useful commands that can be used for troubleshooting and removing Zabbix agent installation.
See if Zabbix agent is running:
See if Zabbix agent has been installed from packages:
See the files that were installed from the installer package (note that the initial / is not displayed in this view):
Stop Zabbix agent if it was launched with launchctl :
Remove files (including configuration and logs) that were installed with installer package:
Forget that Zabbix agent has been installed: