[comment]: # translation:outdated

[comment]: # ({c041af18-bfa3f768})
# 5 从PKG安装MAC OS代理

[comment]: # ({/c041af18-bfa3f768})

[comment]: # ({e4dd7d74-5eec6c30})
#### 概述

Zabbix Mac OS代理可以使用PKG包进行安装，PKG包可以从如下地址下载
[下载](https://www.zabbix.com/download_agents#tab:44).
加密版本和不加密版本均可以下载.

[comment]: # ({/e4dd7d74-5eec6c30})

[comment]: # ({271d5d4b-50976b28})
#### 代理安装

代理可以使用图形用户界面方式或者命令行方式，例如:

    sudo installer -pkg zabbix_agent-4.4.1-macos-amd64-openssl.pkg -target /

请保证在命令行中使用正确版本的Zabbix安装包版本。在命令行中，pkg包的名字务必匹配所下载的安装包的名字。

[comment]: # ({/271d5d4b-50976b28})

[comment]: # ({feb90549-052e551c})
#### 代理运行

在安装完成或者系统重启后，代理会自动启动。

有需要的情况下，您可以编辑相关的配置文件`/usr/local/etc/zabbix/zabbix_agentd.conf`
。

如果需要人工启动代理，执行如下命令:

    sudo launchctl start com.zabbix.zabbix_agentd

如果需要人工停止代理，执行如下命令:

    sudo launchctl stop com.zabbix.zabbix_agentd

在升级过程中，现有的配置文件不会被覆盖，系统会生成一个新的配置文件，新的配置文件用于检查和更新现有的配置文件。在对配置文件作出任何修改后，必须重启代理才能够生效。

[comment]: # ({/feb90549-052e551c})

[comment]: # ({df09e3fa-3150eaf4})
#### 故障排除和删除代理

以下部分列出了许多非常有用的命令，这些命令可以用于故障排除和删除Zabbix代理。

查看Zabbix代理是否在运行:

    ps aux | grep zabbix_agentd

查看Zabbix代理是否使用PKG包方式进行安装:

    $ pkgutil --pkgs | grep zabbix 
    com.zabbix.pkg.ZabbixAgent

查看安装Zabbix代理后，有哪些文件被安装在系统中
(注意：每行开头的`/`并没在以下示例中进行显示):

    $ pkgutil --only-files --files com.zabbix.pkg.ZabbixAgent
    Library/LaunchDaemons/com.zabbix.zabbix_agentd.plist                                                                                                                                                                                                                           
    usr/local/bin/zabbix_get                                                                                                                                                                                                                                                       
    usr/local/bin/zabbix_sender                                                                                                                                                                                                                                                    
    usr/local/etc/zabbix/zabbix_agentd/userparameter_examples.conf.NEW                                                                                                                                                                                                             
    usr/local/etc/zabbix/zabbix_agentd/userparameter_mysql.conf.NEW                                                                                                                                                                                                                
    usr/local/etc/zabbix/zabbix_agentd.conf.NEW                                                                                                                                                                                                                                    
    usr/local/sbin/zabbix_agentd

如果Zabbix的代理使用`launchctl`方式启动，您可以使用如下命令停止Zabbix代理:

    sudo launchctl unload /Library/LaunchDaemons/com.zabbix.zabbix_agentd.plist

删除已安装文件 (包括配置文件和相关日志文件) ，使用以下命令:

    sudo rm -f /Library/LaunchDaemons/com.zabbix.zabbix_agentd.plist
    sudo rm -f /usr/local/sbin/zabbix_agentd
    sudo rm -f /usr/local/bin/zabbix_get
    sudo rm -f /usr/local/bin/zabbix_sender
    sudo rm -rf /usr/local/etc/zabbix
    sudo rm -rf /var/logs/zabbix

忘记已安装Zabbix代理，使用命令:

    sudo pkgutil --forget com.zabbix.pkg.ZabbixAgent

[comment]: # ({/df09e3fa-3150eaf4})