The Freshservice Discovery Agent for Mac can be installed on all Mac-OS devices, which helps the Agent keep track of the assets by updating the device information in Freshservice.
Installing the Agent in a single machine (Without Proxy)
In your Freshservice instance, go to Admin > Global Settings > Asset Management > Discovery Hub. Click Configure Agent and Probe in the Basic discovery section, and download the Mac Discovery Agent file.
Extract the downloaded tarball file and change the current directory to the extracted folder.
Double-click the FS-Agent.pkg file and follow the on-screen instructions to install the Agent.
Installing the Agent in a single machine (With Proxy)
- Extract the downloaded tarball file into a new folder.
- Create a new file named AdditionalConfiguration.json with the following contents in it.
{ “ProxyServer”:””,
“ProxyUserName”:””,
“ProxyPassword”:””,
“ProxyPort”:””
} - Enter the required information within the double quotes. Leave the parameters empty if you do not need to provide values for a parameter.
- Double-click the FS-Agent.pkg and follow the on-screen instructions to install the Agent.
Note: For Mac version 5.1.0 and Linux version 4.0.0, the Discovery Agent will run using the .Net 6 runtime. Ensure that the below URLs are whitelisted in your network.
- https://dotnetcli.azureedge.net/dotnet
- https://dotnetbuilds.azureedge.net/public
- https://dotnetcli.blob.core.windows.net/dotnet
- https://dotnetbuilds.blob.core.windows.net/public
Installing the Agent on multiple Mac devices using Remote Install Tool
- Go to Admin > Global Settings > Asset Management > Discovery Hub. Click Configure Agent and Probe in the Basic discovery section, and download the Mac Discovery Agent file.
- Rename the downloaded agent, if required. For example, FS-Mac-Agent.tar.gz.
- Download the Remote Installer file attached in this solution article and extract the contents.
- Switch to the Freshservice/RemoteInstaller folder.
- Create a text file (for example, COMPUTERS.TXT) in the same folder.
- Edit the COMPUTERS.TXT file to enter the list of Mac device names or IP addresses on which you need to install the Agent (one entry per line).
- Copy the renamed agent (for example, FS-Mac-Agent.tar.gz) to the same folder.
- Open the Terminal and change the working directory to the folder Freshservice/RemoteInstaller
. - Run the ./setup.sh command only once (you can skip this step if it's already done on your machine before). This will prompt you to install command line developer tools (which requires internet connection).
- Run the python Install.py “./FS-Mac-Agent.tar.gz” “./COMPUTERS.TXT” command. It will prompt you for common admin credentials for all your listed computers. Enter the username and password to install the Agent.
- Once done, the Remote Installer will start installing the Agent on all the computers in your list.
- If you wish to uninstall the existing Agent from the remote machine and reinstall the agent again, use the option -f to forcefully install the agent. If this option is not used and there is an agent already installed on the device, then the agent installation will fail. For example: python Install.py “./FS-Mac-Agent.tar.gz” “./COMPUTERS.TXT” -f
Note:
- The remote machine should be enabled with Remote Login access.
- The remote installer script uses SSH and SFTP to complete the installation.
Support for OS Imaging and Disk Swapping (v 3.2.0 onwards)
- The Mac Agent supports OS Imaging and Disk Swapping (for versions 3.2.0 and above) and it can be deployed across your organization, as part of the OS Image.
- Even when the HD is swapped, the Mac agent will intelligently identify that the HD is swapped and will update the correct device information without creating duplicate assets or overwriting the incorrect assets in Freshservice.
More information on the Agent (supported OS, prerequisites, and download instructions) can be found here.
