Support Center

Welcome
Login  Sign up

Mac Deployment via Addigy RMM

Deployment via Addigy

This article explains the process of deploying the Mac Augmentt Agent via Addigy.

Addigy Setup 

Deploy Augmentt Agent

We will use Addigy Custom Software to prepare and deploy the Augmentt Agent to your fleet of macOS device


Download:
 
Download the Augmentt Mac Agent from the Augmentt App, found in Configuration > Data

 


Custom Software:
Next we build the Addigy Custom Software Install that will deploy Augmentt silently to your devices.
 

  • In Addigy navigate to Catalog -> Software
  • Select New and you are presented with

     
  • Click Select File(s)
  • Click Upload New
  • Select the 3 files from the downloaded Zip including:
    • AugmenttAgent.pkg
    • appsettings_tpl.json
    • appIcon256x256.png


Graphical user interface, application, table

Description automatically generated with medium confidence

  • Addigy Custom Software will automatically create most of the necessary PPPCs (Privacy Preference Profile Controls) for the software package you are creating to be able to run properly. 
    • When you see "Apps Found" next to an Installation File, it means Addigy has detected one or more apps that require PPPCs to function correctly. 
    • Under "PPPC Profiles", click in the list box and select an application and press "add".
      Graphical user interface, text, application, email

Description automatically generated

 

  • Addigy will create a PPPC and deploy it to every device that will receive this custom software
  • With applications selected:
     
  • We have included the Augmentt icon in the package, so you can add an easy visual queue for your deployments.


     

Installation Script:

  • Add the following Installation Script to the Custom Software you're creating. 

     

#!/bin/bash

# Augmentt Discovery Agent installer for macOS through Addigy 

 

LICENSEKEY="<License_Key>"

 

##Do not edit below this line##
 

CURRENT_FOLDER=`pwd`

ls -al "$CURRENT_FOLDER"

 

if [ "$LICENSEKEY" == "" ] || [ $# -gt 1 ]; then

        echo "Please provide 'License_key_id' as parameter, e.g. ./install_agent.sh 01abc-kladfhcd23-mkjds-3455"

        exit 0

fi;

 

sed   "s/LICENSE_KEY_PLACEHOLDER/$LICENSEKEY/g" "appsettings_tpl.json" > "/tmp/appsettings.json"

 

echo "Checking previous installation..."

if [ -f /Library/LaunchDaemons/com.augmentt.agent.daemon.plist ]; then 

  echo "Daemon exists: /Library/LaunchDaemons/com.augmentt.agent.daemon.plist"

  launchctl unload /Library/LaunchDaemons/com.augmentt.agent.daemon.plist &> /dev/null

  rm -f /Library/LaunchDaemons/com.augmentt.agent.daemon.plist &> /dev/null

 

  echo "Removing previous installation..."

  if [[ -d "$PREV_DST" || -d "$PREV_ALT_DST" ]]; then

    echo "- Location: $PREV_DST"

    echo "- Location: $PREV_ALT_DST"  

    rm -rf /Library/augmentt

    rm -rf /Library/AugmenttAgent

    if [[ $? -ne 0 ]]; then 

      echo "Failed to remove agent"; 

    else 

      echo "Removal was successful"; fi;

  fi;

 

fi;

 

echo "Installation started..."

/usr/sbin/installer -verbose -pkg "$CURRENT_FOLDER/AugmenttAgent.pkg" -target /Applications

 

echo "Installation finished."

 

 

  • In Augmentt, browse to the Configuration -> Data page
  • Copy the License Key for the appropriate company you are deploying.

Graphical user interface, application

Description automatically generated

  • Update the LICENSEKEY variable in the script, placing your copied License Key in between the quotes.

Uninstall Script:
 For easy remote uninstall, include the following Removal Script

#!/bin/bash

 

echo "Cleanup started..."

echo "Unloading daemon: com.augmentt.agent.daemon.plist"

launchctl unload /Library/LaunchDaemons/com.augmentt.agent.daemon.plist &> /dev/null

echo "Unloaded complete"

 

echo "Removing files" 

rm -rf /Library/LaunchDaemons/com.augmentt.agent.daemon.plist

rm -rf /Applications/Augmentt.app

rm -rf /Applications/AugmenttAgent.app

rm -rf /Applications/Augmentt.DiscoveryAgent.Agent.app

echo "Deamon has been successfully removed."

 

Save your new custom software.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.