Skip to main content
Skip table of contents

Windows Proxy Agent - Automatic Agent Upgrade

LAST UPDATED: OCT 22, 2024

Introduction

We are pleased to announce the release of the automatic upgrading feature for the Windows Proxy Agent. Starting from version 16.8.206.0, the feature enables customer agents to update to the latest available version automatically, ensuring that ongoing tasks remain undisturbed. This capability better ensures operational continuity and timely access to new features and security patches.

The Upgrading Process

Agent Management Foundations

The automatic upgrading process assumes pre-existing version 16.8.206.0+ Windows Proxy Agent installation. You can download the latest agent at Configuration > Agent Management. For detailed installation instructions, please refer to our installation guide.

Group 3.png

READER NOTE

  • As of July 2024:

    • Agent versioning aligns with the D3 vSOC versioning

    • Downgrading to a lower version is not permitted

  • To enable automatic agent updates, it is mandatory that your D3 vSOC is upgraded to version 16.8.206.0 or higher first.

    • For questions regarding D3 vSOC upgrade, please contact the D3 Support Team.

Agent Upgrade Workflow

Through a built-in task manager, D3 vSOC periodically monitors a status indicator in agents to determine whether any updates are necessary. Upon the release of a new agent version, the built-in task manager within D3 vSOC will pause all currently active tasks linked to the agent to avoid interference. In addition, new tasks are held until the upgrade completes.

Agent Upgrade Status

  1. Ensure that your Windows Proxy Agent is version 16.8.206.0 or higher.

    1. If it is not, refer to the Windows Proxy Agent installation guide to upgrade.

    2. If your Windows Proxy Agent is already version 16.8.206.0 or higher, the auto-upgrading process will take effect after your vSOC upgrade.

  2. Observe your agent Version and Upgrade State on the Agent Management page. These can be found under the Agent Details section.

    Group 2.png

    The Upgrade State can any of the following:

N/A

Indicates the agent upgrade is complete. Verify that the version is 16.8.206.0 or higher to confirm a successful upgrade.

Requesting

Indicates that the upgrade process has been initiated.

Upgrading

Indicates that the upgrade is currently in progress.

Error

Indicates the agent upgrade has failed.

Ready

Indicates that the agent has completed all tasks and is prepared for an upgrade.

Done

Indicates that the agent upgrade is complete, and the system is restarting to connect to D3 vSOC.

READER NOTE

  • If an agent upgrade fails:

    • An Upgrade button will render on the top-right hand side.

    • The Upgrade State will have an "Error" value.

    • An additional Upgrade Message field will appear, providing detailed upgrade messages.

      • For questions regarding these messages, please contact the D3 Support Team.

Manually click on the button to retry the upgrade process should the auto-upgrade process fail.

READER NOTE

The Save button remains unaffected by upgrade failures since it is used solely for saving the agent name and description. Therefore, it will always be visible.

If all upgrade attempts fail, please contact D3 for assistance. Our support team is here to help resolve issues and ensure your agents are updated.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.