Zabbix Documentation 4.0

3.04.05.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.24.4Guidelines

User Tools

Site Tools


manual:installation:install_from_packages:mac_pkg

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

manual:installation:install_from_packages:mac_pkg [2019/10/07 06:35]
manual:installation:install_from_packages:mac_pkg [2019/06/06 07:53] (current)
martins-v numbering fix
Line 1: Line 1:
 +==== 4 Mac OS agent installation from PKG ====
  
 +=== Overview ===
 +
 +Zabbix Mac OS agent can be installed from PKG installer packages available for [[https://​www.zabbix.com/​download_agents#​tab:​40LTS|download]]. Versions with or without encryption are available.
 +
 +=== Installing agent ===
 +
 +The agent can be installed using the graphical user interface or from the command line, for example:
 +
 +  sudo installer -pkg zabbix_agent-4.0.7-macos-amd64-openssl.pkg -target /
 +
 +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:
 +
 +  sudo launchctl start com.zabbix.zabbix_agentd
 +
 +To stop the agent manually:
 +
 +  sudo launchctl stop com.zabbix.zabbix_agentd
 +
 +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:
 +
 +  ps aux | grep zabbix_agentd
 +
 +See if Zabbix agent has been installed from packages:
 +
 +  $ pkgutil --pkgs | grep zabbix ​
 +  com.zabbix.pkg.ZabbixAgent
 +
 +See the files that were installed from the installer package (note that the initial ''/''​ is not displayed in this view):
 +
 +  $ 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
 +
 +Stop Zabbix agent if it was launched with ''​launchctl'':​
 +
 +  sudo launchctl unload /​Library/​LaunchDaemons/​com.zabbix.zabbix_agentd.plist
 +
 +Remove files (including configuration and logs) that were installed with installer package:
 +
 +  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
 +
 +Forget that Zabbix agent has been installed:
 +
 +  sudo pkgutil --forget com.zabbix.pkg.ZabbixAgent