Skip to main content
Version: 7.7

RSRemote Troubleshooting

Incorrect Components Shown in RSRemote Administration

Symptom

RSRemote Administration shows all components under Resolve Component Status regardless of which RSRemote instance is selected.

Probable Cause

Actions Pro uses the IP address data to filter components depending on the selected instance. If all your RSRemote instances have LOCATION set to 127.0.0.1 in their Blueprint, then all components will always be shown for all instances.

Possible Resolution

In the RSRemote Blueprint file, set the LOCALHOST property to the actual IP address of the node instead of 127.0.0.1:

  1. Go to the Blueprint file location:

    • Linux: <actions-pro-home>/bin/config/blueprint-rsremote.properties
    • Windows: <actions-pro-home\rsmgmt\config\blueprint-rsremote.properties
  2. Make a backup of the Blueprint file.

  3. Stop RSRemote:

    • Linux:

      <actions-pro-home>/bin/stop.sh rsremote
    • Windows:

      C:\Program Files\Resolve Systems\bin\stop.bat rsremote
  4. Edit and save blueprint-rsremote.properties.

  5. Reconfigure RSRemote:

    • Linux:

      <actions-pro-home>/bin/config.sh
    • Windows:

      C:\Program Files\Resolve Systems\bin\config.bat
  6. Start RSRemote:

    • Linux:

      <actions-pro-home>/bin/run.sh rsremote
    • Windows:

      C:\Program Files\Resolve Systems\bin\run.bat rsremote

RSRemote Consumes Too Much Resources

Symptom

When running multiple RSRemote instances on the same host, RSRemote overconsumes processes.

Probable Cause

All RSRemote instances are configured to log information to the same location.

Possible Resolution
  1. Stop the services:

    1. Linux:

      <install dir>/bin/stop.sh all -k
    2. Windows:

      <install-dir>\bin\stop.bat all -k
  2. For all RSRemote instances other than the default instance, do the following:

    1. Open <install-dir>/<instance-dir>/config/log4j2.xml for editing.
      Where instance-dir is the name of the directory where you duplicated the rsremote directory.

    2. Find the following line:

      <RollingFile filePattern="rsremote/log/$${date:yyyy-MM}/rsremote-%d{MM-dd-yyyy}-%i.log.zip" fileName="rsremote/log/rsremote.log" name="RSREMOTE">
    3. Replace it with the following line:

      <RollingFile filePattern="<instance-dir>/log/$${date:yyyy-MM}/rsremote-%d{MM-dd-yyyy}-%i.log.zip" fileName="<instance-dir>/log/rsremote.log" name="<instance-dir>">

      Where instance-dir is the name of the directory where you duplicated the rsremote directory.

    4. Save the file.

  3. Reconfigure the RSRemote deployment:
    <install dir>/bin/config.sh -r
    The -r option forces all local components to reset their GUID values, including the original instance, ensuring that the new RSRemote instance does not share a GUID with the original instance.

  4. Restart the services:
    <install dir>/bin/run.sh all

Performance Troubleshooting

Automations Execute with a Long Delay or Even Time Out

Symptom

Automations fail to start immediately and eventually time out.

Probable Cause

When too many automations are trying to run at the same time, some of them might be delayed because of the Maximum Execution Events setting, which specifies the maximum number of execution events an instance can take from RSMQ at any one time. If delayed for too long, an automation might reach the system’s execution timeout and drop execution.

Possible Resolution

Consider increasing the value of the Maximum Execution Events setting in the Blueprint file. On each cluster node running RSControl, change the following Blueprint property:

rscontrol.esb.maxexecutionevents