The new docs.trellix.com offers a modernized UI and AI-powered features like conversational searches. Content is currently available only in English. Other languages will be available in mid-October 2026. We hope you enjoy the new experience.

Press CTRL+K to open search

Resolve issues blocking analysis by Endpoint Upgrade Assistant

  • Published on Sep 13, 2026
  • 1 minute(s) read
Prev Next

To see a full picture of environmental readiness, resolve issues that are blocking endpoints from being analyzed for their upgrade needs by Endpoint Upgrade Assistant.

Note

For the Intel architectures, you can directly upgrade to version 26.x from version 10.7.0 (November 2022) or later. For the ARM architectures, the upgrades are not supported and upgrade section is not applicable, refer 000014791 for details.

Blocked endpoints are categorized as unmanaged, incompatible, or excluded. Endpoints can appear in multiple categories.

  • Unmanaged endpoints must be put under management before being analyzed.

  • Incompatible endpoints have issues related to hardware, memory, or operating system compatibility that block the analysis.

  • Currently excluded endpoints have Trellix products installed on them that the tool does not support.

You can tag endpoints that require the same solution, then deploy products using a deployment task in ePO - On-prem.

Exporting the analysis details allows you to search, sort, and filter the information more readily; for example, to identify endpoints that need client properties updated (which requires refreshing the ePO - On-prem database).

  1. In ePO - On-prem, select Menu → Software → Endpoint Upgrade Assistant.

  2. Analyze upgrade requirements for your environment.

    1. Select Trellix Endpoint Security 26.x as the version to upgrade to.

    2. Select the endpoints to analyze. The time required to analyze your selection depends on the size of the ePO - On-prem database and the number of endpoints selected.

    3. Click Analyze Environment.

    When the analysis is done, you can view it in the Environment Overview chart.

  3. To see endpoints that can't be analyzed, check Blocked from upgrading on the Overview tab.

    Endpoints with similar issues are grouped, so that you can tag them. Each time you tag a group of endpoints, Endpoint Upgrade Assistant creates a tag called UA_<timestamp> in the ePO - On-prem Tag Catalog.

  4. To resolve the problems, click More Info to display details about the blocked endpoints, then follow these steps:

    For this type of endpoint...

    When this issue is present...

    Do this...

    Unmanaged

    Trellix Agent is not installed.

    Install a supported version.

    Unmanaged

    An unsupported version of Trellix Agent is installed.

    Install a supported version.

    Unmanaged

    Trellix Agent is not in managed mode.

    Enable managed mode.

    Incompatible

    Hardware, memory, or operating system does not meet minimum requirements.

    Upgrade system components as needed.

    Excluded

    Products that the tool doesn't support.

    Deploy those products outside of the tool.

  5. Click Re-Analyze Environment.

    Endpoints that are no longer blocked are moved to one of the other tables.

Once all endpoints have been analyzed, you can install other products that are required before upgrading to Trellix ENS 26.x.

Related articles