Documentation forSolarWinds Service Desk

Agent installation for Mac

Prerequisites

Supported versions

macOS 10.6 and later versions

Firewall requirements

The following domains and ports must be allowed.

Purpose Destination IP TCP/UDP Destination Port Protocol
Report asset data to the SWSD platform

agt.samanage.com

+ agteu.samanage.com
(EU accounts only)

TCP 443 HTTPS
Obtain the external IP address for monitored devices opendns.com UDP 53 DNS

Installation

The first step in the installation process is to download the Discovery Agent. After downloading, you have the following options for installing it on a single computer:

  • Run the Discovery Agent Setup wizard.

  • Perform a silent installation using a command line.

You can deploy the Discovery Agent on Windows and macOS devices.

Download the agent setup for MacOS

  1. Navigate to Setup > Discovery & Assets > Installation.
  2. Next to Discovery Agent MacOS, select the processor relevant to you (Intel Mac or ARM Mac), and then click Download.

Run the Discovery Agent Setup wizard

  1. Double-click SolarWinds_Discovery_Agent_[VERSION]_installer.dmg file to launch the installer.

  2. At the Welcome screen, click Next to begin.

  3. Select I accept the agreement, and then click Next.

  4. In the Ready to Install dialog, click Next.

  5. When prompted, click Finish to complete the installation.

    When the installation is complete, the Discovery Agent runs an inventory scan for the first time. This may take several minutes to complete.

  6. When the scan is completed, the installer displays an Install Succeeded message. Click Close.

The agent then begins reporting on the preconfigured parameters (that is, hardware, software, etc.). It may take a few moments for the information to appear in your SWSD instance.

You can unmount the SolarWinds agent volume by clicking Eject or dragging the icon in to the trash.

Perform silent installation using a command line

To install the Discovery agent using a command line:

  1. Open Terminal.

  2. Navigate to /Volumes/SolarWinds Discovery Agent.

  3. Execute the installation using the following command line arguments.

    Copy
    sudo ./Solarwinds_Discovery_Agent_#{installer_version}_osx_installer.app/Contents/MacOS/installbuilder.sh --mode unattended

Error Message: Apple cannot check for malicious software

If you receive an error message stating that Apple cannot check for malicious software, follow the steps below.

  1. Navigate to Setup > Discovery > Installation.

  2. Download the new version of the MacOS Discovery Agent.

  3. Discard any old MacOS agents you have saved.

You can use an MSI file to deploy the agent to other computers. SolarWinds suggests that you use an MSI Wrapper tool to convert the Discovery Agent EXE file to an MSI file.

It is possible to convert the Discovery agent EXE file to an MSI and push the file using Micrsoft Endpoint Manager (Intune) or some other similar method. However, SolarWinds does not support this method.

You can convert the Discovery Agent EXE file to an MSI and push the file using Intune (part of Microsoft Endpoint Manager) or some other similar method. In this situation, SolarWinds recommends that you download the Discovery Agent EXE file and use an MSI Wrapper tool to convert the EXE file to an MSI file.

Several MSI wrappers are available online. They may provide instructions on how to convert an EXE file to an MSI file. For example, Getting started - MSI Wrapper Convert EXE to MSI package (exemsi.com) explains the process using a Firefox executable.

You can also use optional command line parameters for a silent installation.

Conversion tool settings

Follow the instructions included with the tool. In some wrapping tools you are not required to customize other properties, parameters, or actions.

The following settings may be useful in creating an MSI file:

  • Visibility of MSI Package: Visible

  • Visibility of wrapped installer: Hidden

  • Security context for launching the executable: Installing User

  • Elevation when launching the executable: Always elevate

  • MSI installation context: Auto

  • Application Id: Look up and then select SolarWinds Discovery Agent

  • Upgrade code: Create New

  • For an optional silent installation, set the parameter for Install arguments to: --mode unattended

After you build the MSI file using your selected tool, use the tool to distribute the Discovery Agent to all targeted computers in your environment.

Troubleshooting

Add the following code before the installation line to allow an installation to be completed from any location.

  • For BigSur and below: sudo spctl –master-disable

  • For Monterey: sudo spctl --global-disable

Add the following code after the installation line to undo the previous action and allow the installation to be completed from only the Mac App Store and identified developers:

  • sudo spctl –master-enable (or --global-enable)

Uninstall the Discovery Agent

To uninstall, execute the following commands in the command line:

Copy
sudo /Applications/Solarwinds\ Discovery\ Agent.app/Contents/Resources/uninstaller.sh

Force an inventory refresh for the new Discovery Agent

After you enable the Discovery Agent, the agent inventory automatically updates every 24 hours. The agent runs as a Windows service and triggers a refresh based on that schedule.

To optimize for outbound bandwidth utilization, the agents randomize the next inventory refresh within a 24-hour timeframe. This process prevents all agents from reporting at the same time.

Optionally, you can force the agent on a targeted machine to manually push an update. To push the update, open a Command Prompt window and run the following commands or copy the code into the prompt. If the prompt does not return an error message, the procedure completed successfully.

Copy
sudo /Applications/Solarwinds\ Discovery\ Agent.app/Contents/Resources/agent/ruby/bin/ruby  /Applications/Solarwinds\ Discovery\ \Agent.app/Contents/Resources/agent/src/mini_kernel/cmd.rb -f

Related topics

Discovery & Assets

Agent Installation for Windows

Agent installation for mass deployment

The scripts are not supported under any SolarWinds support program or service. The scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The risk arising out of the use or performance of the scripts and documentation stays with you. In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation.