An agent needs updates to support the latest features, bug fixes, and performance enhancements. It is recommended that the agent be updated to the latest version.

Based on the type of versions, agents are categorized as G1 or G2:

  • G1 Agents contain lesser than version 3.9.9-1 for Linux and version 5.99.0022 for Windows, respectively.
  • G2 Agents contain greater than version 3.9.9-1 for Linux and version 5.99.0022 for Windows, respectively.

Prerequisites

The agent is online and communicates with the cloud.

Considerations

When you update an agent version from G1 to G2, note the following considerations:

  • You cannot update an agent version G1 to G2 for unsupported Windows versions.
  • Agent-based SNMP Monitor and SNMP Trap Monitor in G2 agent are not supported. Instead, you can use gateway-based SNMP Monitors and Trap Monitor.
  • When you update an agent to the G2 version, all the features (Remote Command, Patch Management, Automation, Remote Console) are enabled by default.
  • If you have created any custom monitor that uses the Vistara path, you need to change the path for branding changes. No change is required for the custom monitors developed by OpsRamp.

Constraints

The following remote commands are not supported on Linux and Windows after updating the agent to version G2:

  • SNMP WALK
  • OpsRampAgent Modules

Update Agents

Follow the steps below to update the agent to the latest version:

  1. Go to Setup > Monitoring, and click Update Agents.
    App/Integration that discovered the resource
  2. Do one of the following options to update the agent:
    • Scheduled Update: Select the required agent devices from the list and click Allow to allow the devices for the scheduled update.

      Every six hours, the agents will check the OpsRamp Cloud for the latest available updates and if the latest version is available, all allowed devices will be automatically updated.
      App/Integration that discovered the resource
    • On-demand Update: If you want the devices to be forced updates, select the required agent devices from the list, click Allow, and then click Update Now.

      The Agents update is immediately triggered and the selected devices are updated to the latest version within a few minutes.
      App/Integration that discovered the resource

The following are additional options on the same page:

  • Refresh: Click the Refresh button to get the most recent device list.
  • Allow: To allow multiple devices for updates at once, select the devices from the list and click the Allow option from the top row.
  • Do Not Allow: Click Do Not Allow to remove the allowed devices from the list.
  • Update Now: If you want to update multiple allowed devices from the list, click Update Now from the top row.
  • Export: Use this option to export the entire device list in CSV format.
App/Integration that discovered the resource

Additional Details

During the agent update process, OpsRamp displays the following message in the Status column. When you hover your mouse over the status message, you will see more information.

  • Update Success: Indicates the Agent updated to the latest version without any issue. Example: Update Success - Timestamp (UTC): , Successfully Agent updated to .

  • Download Failed: indicates the file required for agent update failed to download. Example: Download Failed - Timestamp (UTC): , Difference in downloaded patch size, Downloaded size - , Actual size - .

  • Update Failed: Indicates the required file to update the agent was downloaded successfully, but the update process failed. Example: Update Failed - Timestamp (UTC): , Agent update failed while running the update/package file.

In case of failures, the above reasons will help understand the problem instead of verifying the Agent log files.