Submit a ticketCall us

AnnouncementsSystem Monitoring for Dummies

Tired of monitoring failures disrupting the system, application, and service? Learn the key monitoring concepts needed to help you create sophisticated monitoring and alerting strategies that can help you save time and money. Read the eBook.

Get your free eBook.

Home > Success Center > Log & Event Manager (LEM) > LEM - Knowledgebase Articles > How to install the Mac Agent for LEM 6.4 and later

How to install the Mac Agent for LEM 6.4 and later

Updated October 31, 2018

Overview

This article describes how to install the Mac Agent on an Apple system running LEM 6.4 and later.

Environment

  • LEM 6.4+ 
  • Supported Apple Macintosh system

Steps

  1. Enable root credentials on the Apple Mac system.
    See How to enable the root user on your Mac or change your root password for details (© 2018 Apple Corporation, available at https://support.apple.com, obtained on October 31, 2018).
  2. Disable System Intrusion Protection on the Mac system.
    See System Integrity Protection (SIP) is preventing install of LEM Agent on Mac OS X 10.x and later for details.
  3. Download the SolarWinds-LEM-v#.#.#-MacOSAgentInstaller.zip file from the Customer Portal.
  4. Decompress or unzip the file to a local drive--not a network drive.
  5. Navigate to the correct directory path using finder in the GUI.
    If you are logged in as root, enter:
    cd /Users/<username>/SolarWinds-LEM-v#.#.#-MAcOSAgentInstaller/MacOS
    If you are not logged in as root, enter: 
    cd /private/var/root/SolarWinds-LEM-v#.#.#-MAcOSAgentInstaller/MacOS Agent/       
  6. Log in as root or as your current user.
  7. Double click the Setup.app file on the Macintosh system.
  8. Follow the installer instructions. During the installation, add Manager IP (IP of LEM), leave all ports default. and click next until finished.
  9. Open Terminal.
  10. Copy the LEM Agent to the correct startup path to have it initialize upon reboot.
    If the installer was run with the root account, run the following command to copy the folder: 
    cp -rp /private/var/root/Applications/SWLEMAgent /System/Library/StartupItems/
    cp -rp /private/var/root/Applications/SWLEMAgent /Applications/
    If the installer was not run as the root, run the following commands 
    cp -rp /Users/<username>/Applications/SWLEMAgent /System/Library/StartupItems/
    cp -rp /Users/<username>/Applications/SWLEMAgent /Applications/
  11. Navigate to the PLIST file packaged with the installed Agent by executing the following command:
    cd /System/Library/StartupItems/SWLEMAgent/StartupFiles/SWLEMAgent
  12. Copy the PLIST file to the LaunchDaemons folder.
    cp -rp com.solarwinds.swlemagent.plist /Library/LaunchDaemons/
  13. If necessary, change the permissions on the PLIST file. This only needs to be completed if the PLIST file is moved with a non-root account.
    chown root:wheel   /Library/LaunchDaemons/com.solarwinds.swlemagent.plist
  14. Restart the computer.
  15. Verify that the agent is running by running the following command:  
    launchctl list | grep swlemagent

Start and stop the MAC Agent Service

To start the Mac Agent Service, execute: 
launchctl load /Library/LaunchDaemons/com.solarwinds.swlemagent.plist

To stop the Mac Agent Service, execute:
launchctl unload /Library/LaunchDaemons/com.solarwinds.swlemagent.plist

Verify that the agent service is running  

Run the following command:
launchctl list | grep swlemagent 

If the Agent Service is running, the output is below:

Mac-mini:~ root# 865     0       com.solarwinds.swlemagent

If the Agent Service is not running, the output is blank

Mac-mini:~ root#

 

 

Disclaimer: Please note, any content posted herein is provided as a suggestion or recommendation to you for your internal use. This is not part of the SolarWinds software or documentation that you purchased from SolarWinds, and the information set forth herein may come from third parties. Your organization should internally review and assess to what extent, if any, such custom scripts or recommendations will be incorporated into your environment.  You elect to use third party content at your own risk, and you will be solely responsible for the incorporation of the same, if any.

 

 

 

 

Last modified

Tags

Classifications

Public