Implementing Software Reclaim

When deployed, Software Reclaim helps organizations reduce software licensing costs, minimize security exposure, and streamline software asset management.

Prerequisites

Before implementing Software Reclaim, ensure the following:

  • All target devices must have the 1E Client 24.5 (or later) installed. Reclaim capabilities are delivered with the Client.

  • If you were previously an AppClarity user, ensure Software Reclaim is in the license file.

  • Appropriate Enterprise Plus tier licensing must be enabled to activate Software Reclaim features.

  • Ensure that your Catalog and Inventory Insights components are correctly configured. Refer to Understanding Software Reclaim for further details.

DEX Pack Instruction set requirements

Download the Software Reclaim DEX Pack from TeamViewer DEX Hub. This is an optional pack and includes an instruction that is used to show a pop-up to the end user for Reclaim.

Configuration

Enabling Software Reclaim in the Client

Software Reclaim is disabled by default in the Client. To enable it, configure the following 1EClient.conf settings during installation or afterward.

Name in 1EClient.conf

Installer property

Default Value

Description

Module.Software.Reclaim.Enabled

MODULE.SOFTWARE.RECLAIM.ENABLED

false

Enables or disables the Software Reclaim module.

Module.Software.Reclaim.IntervalMinutes

MODULE.SOFTWARE.RECLAIM.INTERVALMINUTES

360

Defines the frequency (in minutes) at which endpoints poll for Reclaim instructions. Maximum is 10,080 minutes (one week). There is no minimum limit.

Module.Software.Reclaim.UserInteractionEnabled

MODULE.SOFTWARE.RECLAIM.USERINTERACTIONENABLED

true

Determines whether optional uninstall policies prompt the end user for confirmation.

You can set these properties using one of the following methods:

  • Specify the installer values listed in the table above during the Client installation.

  • Edit the 1E.Client.conf file, typically located in C:\Program Files\1E\Client\, and restart the Client service.

Configure Client settings:

Use the client instruction 1E-Explorer-TachyonAgent-Set1EClientAgentConfig.xml to update Client configuration settings.

This instruction is included with 1E-Explorer-TachyonAgent DEX Pack which is provided in the Platform installer zip file. Download the DEX Pack from TeamViewer DEX Hub, and use the 1E Product Pack Deployment Tool (PPDT) to upload it to your Platform.

The instruction updates Client configuration settings and restarts the service after a short random delay. This delay helps prevent large numbers of clients reconnecting to the DEX Platform at the same time.

  • %agentconfig% specifies the configuration property to update.

  • %agentconfigvalue% specifies the value to assign to the property.

Module.Interaction.TranslationFallbackLanguage is supported in Client 26.5 and later.

For fallback language details, refer to Localized 1E Client RTCC.

Role-Based Access Control (RBAC) for Software Reclaim

User access to Software Reclaim capabilities is controlled through the DEX Platform's Role-Based Access Control (RBAC) model. Permissions determine the following:

  • Who can create and manage Reclaim policies.

  • Who can execute configuration instructions.

  • Who can view reclaim results and reports.

For more information on detailed roles and privileges, refer to Permissions and Role-Based Access Control cmdlets.

Role name

Role description

Solutions Core

View only

Solutions Admin

View, edit and delete

Differences between Software Reclaim and AppClarity

Software Reclaim replaces selected AppClarity capabilities while introducing a simplified usage-focused approach. The following table summarizes the key differences.

Category

Software Reclaim

AppClarity

Primary purpose

Usage-based software reclamation and automated uninstall actions.

Full Software Asset Management capabilities including entitlement, License Demand Calculation (LDC), normalization, and compliance.

Deployment model

SaaS only.

On-premises.

Feature scope

Usage only. Does not include entitlement, compliance, or LDC.

Entitlement management, compliance calculations, and license optimization.

Language support

English only.

Multi-language support available.

RBAC roles

  • SoftwareReclaim.Reclaim

  • AppClarity.Compliance

  • AppClarity.Entitlement

  • Repository.Compliance

  • Repository.Entitlement

Repositories

Compliance repository renamed to Reclaim. Default is Default Reclaim.

Compliance repositories used for entitlement and license data.

Client components

SoftwareReclaimer.exe integrated into the 1E Client.

Reclaimer was separate; other components handled entitlement and compliance.

Uninstall method

Uses 1E Client and Reclaimer exclusively.

Custom Configuration Manager uninstall supported (now deprecated).

Policy management

Policies scheduled and managed via 1E Instructions.

Compliance-driven rule evaluation and entitlement-based actions.

Log location

Logs maintained through the 1E Client. (For Software Reclaim log details, refer to Software Reclaim logs.).

Logs generated by AppClarity components and various repositories.