Other options

Tracing

To start the Agent in trace mode, start resamad with option –v 3. All trace information will be logged in the file /var/log/resamad.log.

The default trace level is 0 (FATAL).
This level can be changed by editing the TraceLevel node from the /etc/res/resamad.xml file (<TraceLevel>0</TraceLevel>). The available TraceLevels are FATAL = 0, ERROR = 1, INFO = 2, and DEBUG = 3.

Example: If you specify <TraceLevel>2</TraceLevel> in the config file, the agent should log only traces of type FATAL, ERROR and INFO. If all the traces are needed, use <TraceLevel>3</TraceLevel>.

  • Fatal errors will always be logged, irrespective of the debug level. Currently, these are errors that may occur due to the communication id or in SSL connections.
  • Log files can have a maximum size of 4MB, after which they will be truncated.

Uninstallation

To uninstall an installation package, use the following command on the target machine:

launchctl unload /Library/LaunchDaemons/com.ressoftware.resamad.plist
rm -f /Library/LaunchDaemons/com.ressoftware.resamad.plist
rm -f /usr/local/bin/resamad
rm -f /etc/res/resmad.xml

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.

Upgrading

To upgrade Agents to a newer version, please uninstall your current version first. This needs to be done manually for each machine:

  1. Stop the currently-installed Agent using the following command:
    launchctl unload /Library/LaunchDaemons/com.ressoftware.resamad.plist
  2. Uninstall the Agent.
  3. Install the new version.
  4. Start the new Agent.