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:

Red Hat

rpm –ev <package name>

SUSE

rpm –ev <package name>

IBM AIX

rpm –ev <package name>

Ubuntu

sudo dpkg –r <package name>

Solaris

Pkgrm RESagent

For example:

  • rpm -ev res-one-automation-agent (for Agents from version 2015 SR3 and higher)
  • rpm -ev res-am-agent (for Agents from version 2015 and lower)

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:

    Red Hat

    /etc/init.d/resamad stop

    SUSE

    /etc/init.d/resamad stop

    IBM AIX

    /etc/rc.d/rc2.d/K90resamad stop

    Ubuntu

    /etc/init.d/resamad stop

    Solaris

    svcadm disable resamad

  2. Uninstall the Agent.
  3. Install the new version.
  4. Start the new Agent.