Zabbix Documentation 4.4

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

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

Next revision
Previous revision
manual:installation:install_from_packages:mac_pkg [2019/05/28 08:06]
martins-v created; mac os precompiled agents
manual:installation:install_from_packages:mac_pkg [2019/07/24 06:39] (current)
martins-v numbering fix
Line 1: Line 1:
-==== Mac OS agent installation from PKG ====+==== Mac OS agent installation from PKG ====
  
 === Overview === === Overview ===
  
-Zabbix Mac OS agent can be installed from PKG installer packages available for [[https://​www.zabbix.com/​download_agents#​tab:​44|download]].+Zabbix Mac OS agent can be installed from PKG installer packages available for [[https://​www.zabbix.com/​download_agents#​tab:​44|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.4.1-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