All workstations or devices that will be shown in the Applixure Analytics service require an agent installation ("Analytics Agent" or "Agent"), without which we are unable to display any information regarding that device or its associated software. To receive a complete view of your workstation environment, make sure that the agent has been installed on 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 are also detailed installation instructions for different software deployment scenarios available.
1. Prerequisites
Operating system prerequisites
The Agent requires a minimum of Apple OS X 10.14.4 (Mojave) operating system to function, either on Intel x64 or Apple Silicon architecture.
Apple OS or other Apple mobile operating systems are not supported for agent installation.
Networking / firewall prerequisites
To operate correctly and for the service to receive data, the 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 have been installed are allowed to open HTTPS traffic to *.applixure.com domain addresses. At a 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 Analytics service may prevent Agent from communicating with our service.
2. Installation
Acquiring Agent
You can download Agent installation packages for your environment from the Analytics UI, from the Deploy -tab:
The Agent installer package is distributed as DMG disk-image file containing installer package (InstallApplixureAgent.pkg) and uninstaller package (UninstallApplixureAgent.pkg).
When downloaded, Analytics Agent's installer image will be named according to the following format:
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".
If the "Applixure" is not automatically opened as a new window containing the installer/uninstaller icons, double-click on the drive to open it.
To install Analytics Mac Agent into your computer, double-click on the "InstallApplixureAgent.pkg" file to begin setup procedure.
Note for installation on macOS Catalina and newer versionsDue 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 Analytics 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 Analytics 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 an existing Analytics 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 Analytics Web 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 Analytics environments and that the Agent installer package must be run from the mounted DMG image as installer is accessing a 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 mounted will result in 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, please refer to our Applixure Mac Agent mass-deployment considerations article.
0 Comments