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.
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.
You can download Agent installation packages for your environment from the Applixure UI, from the Agents -tab:
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:
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".
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 and newer
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 result in macOS blocking the attempt:
While Applixure Mac Agent installer has been properly signed and notarized, if the Mac computer cannot contact Apple's servers to verify data associated with the installation package at the time of running it, it might happen that macOS blocks the run of the package. In that case, you can try to run following command to remove quarantine attribute from the DMG file with the following terminal command:
(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.
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 /
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.