Upgrading Agent Control and Managed Agents

Overview

Agent Control provides a seamless and centralized way to manage the entire lifecycle of your agents, including updates. Instead of manually updating agents on each host or cluster, you define your desired state in Fleet Control, and Agent Control automatically handles the rest.

The update process for both Agent Control and the agents it manages is designed to be non-disruptive and automated.

Key benefits of the update process with New Relic Control

• Centralized Control: Manage all agent versions for your entire fleet from a single location.
• Non-disruptive: Updates are performed using rolling update strategies to prevent downtime.
• Automated: Once you define a new version, the entire deployment and reconciliation process is handled automatically.
• Resilient: The system is designed to be resilient to failed updates and can fall back to the last known good state if an issue occurs.

Updating your managed Agents

You can update any agent managed by Agent Control by simply changing its version in the remote configuration within Fleet Control. This declarative approach ensures consistency and reliability across your entire fleet.

• Edit the Configuration: Navigate to the configuration for your fleet in Fleet Control.
• Update the Version: Locate the agent you want to update (for example, infrastructure) and change the chart_version value to the new version number.
• Deploy the Changes: Save and deploy the updated configuration.

Agent Control will automatically detect the change and perform a non-disruptive rolling update, ensuring that your new agents are running and healthy before replacing the old ones.

Example: Upgrading the New Relic infrastructure agent

This example shows how to upgrade the infrastructure agent to a new version.

$
# Remote configuration for a single agent
$
chart_version: "5.0.109"  # Change this value
$
chart_values:
$
  newrelic-infrastructure:
$
    enableProcessMetrics: true

Upgrading Agent Control

Kubernetes

The following instructions apply to Agent Control running on a Kubernetes cluster.

Agent Control is capable of updating itself remotely. This ensures that the supervisor running on your cluster is always up to date with the latest features, performance improvements, and security patches.

The process for updating the Agent Control supervisor is the same as for any other managed agent: you specify the new version in the configuration and deploy the changes from Fleet Control.

1. Edit the Agent Control configuration: In Fleet Control, access the configuration for Agent Control itself.
2. Update the chart_version: Change the chart_version to the new desired version.
3. Deploy the Changes: Save and deploy the configuration.

This process triggers a rolling update of the Agent Control pods on your cluster. Kubernetes' built-in health checks ensure the new version is healthy before the old one is terminated for a non-disruptive upgrade.

Linux hosts

$
sudo apt-get update && sudo apt-get install --only-upgrade newrelic-agent-control -y

$
sudo zypper -n update newrelic-agent-control

$
sudo yum update newrelic-agent-control -y

Windows hosts

Agent Control on Windows is upgraded by re-running the installation script provided in the guided install. The script downloads the latest version and replaces the existing executable while preserving your configuration files.

1. Open PowerShell with Administrator privileges.

2. Run the installation script from the guided install for the new version.

3. Verify the upgrade by checking the service status:

   Get-Service -Name newrelic-agent-control
   Invoke-WebRequest -Uri "http://localhost:51200/status" -UseBasicParsing

   コピー

Managed agents (Infrastructure Agent, NRDOT) are upgraded through Fleet Control the same way as on other platforms — update the desired agent version in your fleet configuration and deploy the changes.

Start, stop, and restart Agent Control

Agent Control starts automatically after you run the installation script.

Linux

For Linux, ensure you use the correct command for your init system. Select start, stop, restart, or status as appropriate.

Here's an example for systemd:

$
sudo systemctl <start|stop|restart|status> newrelic-agent-control

Windows

Run these commands in PowerShell with Administrator privileges:

Start-Service -Name newrelic-agent-control
Stop-Service -Name newrelic-agent-control
Restart-Service -Name newrelic-agent-control
Get-Service -Name newrelic-agent-control