Installation

This chapter covers the installation of the Agent for macOS. Alternatively, it is also possible to install the Agent via the user interface by opening the package.

Installation

  1. Transfer the installation package of the Agent to the target machine.
  2. On the target machine, log in as root.
  3. Change the working directory to the location of the installation package by typing the following command in a Terminal window:
    cd /root
  4. Use the following command to install the Agent:
    installer -pkg <package-name-and-version>-target /
  5. Use the following command to configure the Agent to start automatically:
    launchctl load /Library/LaunchDaemons/com.ressoftware.resamad.plist
  6. After installation (via the user interface), a command prompt will open with an overview of all available Ivanti Automation environments. Select an environment and press Enter. You may have to provide your sudo password. Via the command line, use the following command:
    /usr/local/bin/resamad –dd<dispatcher IP or hostname>
  7. After this, the Agent will register itself in the node Topology > Agents of the Ivanti Automation Console.
  8. Stop the Agent and restart it via the official start/stop script, which correctly initializes the Agent:
    • launchctl unload /Library/LaunchDaemons/com.ressoftware.resamad.plist
    • launchctl load /Library/LaunchDaemons/com.ressoftware.resamad.plist

After this, the Agent will automatically start itself each time the machine on which it runs is booted. However, if you need to stop and start the Agent manually, please use the official start/stop commands.

NOTE: If the Agent is not started as a service, the stop service command will not work as this is by design on Linux/Unix systems.
This can cause issues when removing or updating the Agent, because the Agent process (resamad) will not be stopped if it was not started as a service. Make sure that the process it is not running after uninstalling the agent.

The configuration of the Agent is stored in /etc/res/resamad.xml. This file contains all necessary information for an Agent to connect to the Ivanti Automation environment. Instead of manual Agent configuration, you can also place a preconfigured resamad.xml file on each Agent.