Technical instructions for installing Applixure Agents on Apple Mac

All workstations or devices that will be shown in the Applixure service require an agent installation ("Applixure Agent" or "Agent"), without which we are unable to display any information regarding that device or its associated software. To receive complete view of your workstation environment, make sure that agent has been installed to all of your Mac computers.

You can easily add new Agents to your environment by following the instructions below. At the end of this article there's also detailed installation instructions for different software deployment scenarios available.

1. Prerequisites

Operating system prerequisites

Agent requires a minimum of Apple OS X 10.10 (Yosemite) operating system to function.

Presently, Applixure does not support iOS or other Apple mobile operating systems for agent installation.

 

Networking / firewall prerequisites

To operate correctly and for the service to receive data, Agent requires computers to have a continuously or frequently available Internet–connection.

For all communication, Agent uses standard HTTPS (TCP port 443) outbound connection and should not in normal circumstances require any explicit firewall configurations.

Should your Mac computers, or network in-between Agents and public Internet, have outbound connection restrictions, please make sure that the devices where Agents has been installed are allowed to open HTTPS traffic to *.applixure.com domain addresses. At minimum, you should whitelist api.applixure.com and cert.applixure.com addresses for outbound HTTPS connections. Please refer to another Helpcenter article on addresses to whitelist for more information.

Please note, that any Man-in-the-middle (MITM) proxying of connections that intercepts Agent's HTTPS traffic in-between the devices and the Applixure service may prevent Agent from communicating with our service.

 

2. Installation

Acquiring Agent

You can download Agent installation packages for your environment from the Applixure UI, from the Agents -tab:

agents-tab.png

Agent installer package is distributed as DMG disk-image file containing installer package (InstallApplixureAgent.pkg) and uninstaller package (UninstallApplixureAgent.pkg).

When downloaded, Applixure Agent's installer will be named according to:

ApplixureMacAgent-EnvironmentName.dmg

 

Manual Agent installation

After Agent's DMG file has been downloaded into some directory on your Mac, you can double-click on it to mount it. After the DMG file has been mounted, there should be new drive icon on the desktop called "Applixure".

mac-dmg.png

If the "Applixure" is not automatically opened as new window containing the installer/uninstaller icons, double-click on the drive to open it.

To install Applixure Mac Agent into your computer, double-click on the "InstallApplixureAgent.pkg" file to begin setup procedure.

Note for installation on macOS Catalina

Due to Gatekeeper security restriction enhancements introduced in newer macOS versions, trying to run installation PKG file from DMG file downloaded from the Internet might lead to macOS blocking the attempt:

catalina-gatekeeper.png

This is currently known issue in Applixure Mac Agent installation package, which will be resolved in the future with notarization of the packages. To enable macOS to run the packages inside the DMG file, you can remove the downloaded file quarantine attribute from the DMG file with the following terminal command:

xattr -d com.apple.quarantine /Users/xxx/Downloads/ApplixureMacAgent-yyy.dmg

(please substitute the path to DMG file in the command with the actual location of your downloaded Applixure Agent's DMG file)

You will need to have DMG file unmounted and remounted after removing the attribute from it, before trying to re-run the PKG file.

To uninstall and remove existing Applixure Mac Agent installation from your computer, double-click on the "UninstallApplixureAgent.pkg" file to being removal setup procedure.

After installation or uninstallation has completed, you may unmount/Eject the Applixure drive from your desktop. 

Please note

The agent downloaded from the Applixure UI is already prepared (pre-configured) for the environment from which they were downloaded, and as such do not need any parameterization upon deployment.

This means that installation packages cannot be shared between different Applixure environments and that the Agent installer package must be run from the mounted DMG image as installer is accessing pre-configured initialization file specific to your environment during setup from the mounted /Volumes/Applixure directory.

Copying PKG file out from the DMG and running as-is without corresponding DMG mouted will result agent installation that does not work correctly.

 

Mass-deployment of Agent into multiple Mac computers

Steps outlined above requires manual attended installation of the Mac Agent into one computer at the time.

If you need to distribute the Agent into multiple Mac computers unattended, additional preparation steps will be needed, exact nature of those steps depending on the distribution mechanism and software being used for doing the mass-deployment.

As a general guidance for doing mass distribution of the Applixure Agent, you would need to either:

a) Make sure the Applixure Agent's DMG file is distributed as-is to the target Mac computers, mounted over there and installer PKG is executed in unattended manner. To run installer unattended, you can use following command:

sudo installer -pkg "/Volumes/Applixure/InstallApplixureAgent.pkg" -target /

or

b) Repackage the Applixure-provide PKG file as a self-contained PKG, replacing the installation logic of the original PKG file and including necessary initialization file from the DMG into installation set. This will enable distribution of just the [repackaged] PKG file without having to copy the original DMG image to each and every target Mac computer.

Applixure provides ready-made script for generating such repackaged PKG file, you can find more information from our Creating self-contained installation PKG file for Mac Agent deployment article.

 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk