You are viewing documentation for the development version, it may be incomplete.
Join our translation project and help translate Zabbix documentation into your native language.

3 Compilant l'agent Zabbix sobre macOS

Vista general

Aquesta secció ensenya com crear binaris d'agent Zabbix macOS a partir de fonts amb o sense TLS.

Prerrequisits

Us caldran les eines de desenvolupament de línia de comandes (no cal Xcode), Automake, pkg-config i PCRE (v8.x) o PCRE2 (v10.x). Si voleu crear binaris d'agent amb TLS, també haureu de menester OpenSSL o GnuTLS.

Per instal·lar Automake i pkg-config us caldrà el gestor de paquets, Homebrew disponible a https://brew.sh/. Per instal·lar-lo, obriu el terminal i executeu l'ordre següent:

 $ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Tot seguit, instal·leu Automake i pkg-config:

 $ brew install automake
        $ brew install pkg-config

La preparació de les biblioteques PCRE, OpenSSL i GnuTLS depèn de com s'enllaçaran a l'agent.

Si teniu intenció d'executar binaris d'agent en una màquina macOS que ja té aquestes biblioteques, podeu emprar biblioteques precompilades proporcionades per Homebrew. Normalment són màquines macOS que empren Homebrew per crear binaris d'agent Zabbix o amb altres finalitats.

Si els binaris d'agent s'empren a màquines macOS que no tenen la versió compartida de les biblioteques, haureu de compilar les biblioteques estàtiques des de la font i enllaçar l'agent Zabbix amb elles.

Construir binaris d'agent amb les biblioteques compartides

Instal·leu PCRE2 (canvieu pcre2 per pcre a les comandes d'aquí sota, si cal):

$ brew install pcre2

Quan es compili amb TLS, instal·leu OpenSSL i/o GnuTLS:

$ brew install openssl
       $ brew install gnutls

Descarregueu les fonts de Zabbix :

$ git clone https://git.zabbix.com/scm/zbx/zabbix.git

Compileu l'agent sense TLS :

$ cd zabbix
       $ ./bootstrap.sh
       $ ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6
       $ make
       $ make install

Compileu l'agent amb OpenSSL :

$ cd zabbix
       $ ./bootstrap.sh
       $ ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-openssl=/usr/local/opt/openssl
       $ make
       $ make install

compileu l'agent amb GnuTLS :

$ cd zabbix-source/
       $ ./bootstrap.sh
       $ ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-gnutls=/usr/local/opt/gnutls
       $ make
       $ make install

Compilar els binaris d'agent amb biblioteques estàtiques sense TLS

Suposem que les biblioteques estàtiques PCRE siguin installades a $HOME/static-libs. Emprarem PCRE2 10.39.

$ PCRE_PREFIX="$HOME/static-libs/pcre2-10.39"

Descarregueu i creeu PCRE amb el suport de les propietats d'Unicode:

$ mkdir static-libs-source
       $ cd static-libs-source
       $ curl --remote-name https://github.com/PhilipHazel/pcre2/releases/download/pcre2-10.39/pcre2-10.39.tar.gz
       $ tar xf pcre2-10.39.tar.gz
       $ cd pcre2-10.39
       $ ./configure --prefix="$PCRE_PREFIX" --disable-shared --enable-static --enable-unicode-properties
       $ make
       $ make check
       $ make install

Descarregueu les fonts Zabbix i compileu l'agent :

$ git clone https://git.zabbix.com/scm/zbx/zabbix.git
       $ cd zabbix
       $ ./bootstrap.sh
       $ ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX"
       $ make
       $ make install

Compilar els binaris de l'agent amb les biblioteques estàtiques emprant OpenSSL

Quan es construeix OpenSSL, es recomana executar "make test" després d'una compilació correcta. Fins i tot si la compilació és correcta, les proves de vegades fallen. Si és així, els problemes s'han d'investigar i resoldre abans de continuar.

Suposem que les biblioteques estàtiques PCRE i OpenSSL s'instal·laran a $HOME/static-libs. Farem servir PCRE2 10.39 i OpenSSL 1.1.1a.

$ PCRE_PREFIX="$HOME/static-libs/pcre2-10.39"
       $ OPENSSL_PREFIX="$HOME/static-libs/openssl-1.1.1a"

Poseu les biblioteques estàtiques a static-libs-source :

$ mkdir static-libs-source
       $ cd static-libs-source

Descarregueu i creeu PCRE amb les propietats admeses d'Unicode:

$ curl --remote-name https://github.com/PhilipHazel/pcre2/releases/download/pcre2-10.39/pcre2-10.39.tar.gz
       $ tar xf pcre2-10.39.tar.gz
       $ cd pcre2-10.39
       $ ./configure --prefix="$PCRE_PREFIX" --disable-shared --enable-static --enable-unicode-properties
       $ make
       $ make check
       $ make install
       $ cd ..

Descarregueu i creeu OpenSSL :

$ curl --remote-name https://www.openssl.org/source/openssl-1.1.1a.tar.gz
       $ tar xf openssl-1.1.1a.tar.gz
       $ cd openssl-1.1.1a
       $ ./Configure --prefix="$OPENSSL_PREFIX" --openssldir="$OPENSSL_PREFIX" --api=1.1.0 no-shared no-capieng no-srp no-gost no-dgram no-dtls1-method no-dtls1_2-method darwin64-x86_64-cc
       $ make
       $ make test
       $ make install_sw
       $ cd ..

Descarregueu les fonts Zabbix i compileu l'agent:

$ git clone https://git.zabbix.com/scm/zbx/zabbix.git
       $ cd zabbix
       $ ./bootstrap.sh
       $ ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX" --with-openssl="$OPENSSL_PREFIX"
       $ make
       $ make install

Creeu binaris d'agent amb biblioteques estàtiques amb GnuTLS

GnuTLS depèn del backend de xifrat de Nettle i de la biblioteca aritmètica GMP. En lloc d'emprar la biblioteca GMP completa, aquesta guia emprarà mini-gmp que s'inclou amb Nettle.

Quan es construeix GnuTLS i Nettle, es recomana executar make check després d'una compilació correcta. Fins i tot si la compilació és correcta, les proves de vegades fallen. Si és així, els problemes s'han d'investigar i resoldre abans de continuar.

Suposem que les biblioteques estàtiques PCRE, Nettle i GnuTLS s'instal·laran a $HOME/static-libs. Farem anar PCRE2 10.39, Nettle 3.4.1 i GnuTLS 3.6.5.

$ PCRE_PREFIX="$HOME/static-libs/pcre2-10.39"
       $ NETTLE_PREFIX="$HOME/static-libs/nettle-3.4.1"
       $ GNUTLS_PREFIX="$HOME/static-libs/gnutls-3.6.5"

Copiem les biblioteques estàtiques a static-libs-source :

$ mkdir static-libs-source
       $ cd static-libs-source

Descarregueu i compileu Nettle :

$ curl --remote-name https://ftp.gnu.org/gnu/nettle/nettle-3.4.1.tar.gz
       $ tar xf nettle-3.4.1.tar.gz
       $ cd nettle-3.4.1
       $ ./configure --prefix="$NETTLE_PREFIX" --enable-static --disable-shared --disable-documentation --disable-assembler --enable-x86-aesni --enable-mini-gmp
       $ make
       $ make check
       $ make install
       $ cd ..

Téléchargez et compilez GnuTLS :

$ curl --remote-name https://www.gnupg.org/ftp/gcrypt/gnutls/v3.6/gnutls-3.6.5.tar.xz
       $ tar xf gnutls-3.6.5.tar.xz
       $ cd gnutls-3.6.5
       $ PKG_CONFIG_PATH="$NETTLE_PREFIX/lib/pkgconfig" ./configure --prefix="$GNUTLS_PREFIX" --enable-static --disable-shared --disable-guile --disable-doc --disable-tools --disable-libdane --without-idn --without-p11-kit --without-tpm --with-included-libtasn1 --with-included-unistring --with-nettle-mini
       $ make
       $ make check
       $ make install
       $ cd ..

Descarregueu les fonts de Zabbix i compileu l'agent:

$ git clone https://git.zabbix.com/scm/zbx/zabbix.git
       $ cd zabbix
       $ ./bootstrap.sh
       $ CFLAGS="-Wno-unused-command-line-argument -framework Foundation -framework Security" \
       > LIBS="-lgnutls -lhogweed -lnettle" \
       > LDFLAGS="-L$GNUTLS_PREFIX/lib -L$NETTLE_PREFIX/lib" \
       > ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX" --with-gnutls="$GNUTLS_PREFIX"
       $ make
       $ make install