Skip to main content

1E 23.11 (SaaS)

Implementing Software Reclaim

Everything you need to know about getting Software Reclaim configured and running.

In the license template file AppClarity must be renamed to Software Reclaim.


There are no specific instructions related to Software Reclaim, however you can use the following 1E Client instruction to modify the 1E Client configuration and update values related to the Software Reclaim module.


Description and readable payload


This instruction will modify 1E Client settings and restart service after a random number of seconds. This is to prevent overwhelming the 1E Platform with a flood of client reconnects.

Set 1E Client configuration property %agentconfig% to %agentconfigvalue% and restart the service after a short random delay.

Refer to 1E Exchange for more information about DEX Packs (formerly Product Pack) which are collections of 1E Simple Cross-platform Agent Language for Extensibility (SCALE) objects and automation rules that relate to a specific theme or use case.

To make sure you can run Software Reclaim:

  1. You will need to upgrade to 1E 23.11 platform including Software Reclaim.

  2. Ensure you have installed 1E Client for the 23.11 release on your end-points:

    • 1E Client integration is required for both authentication capabilities and for reclaim using instructions and policies

    • Integration simplifies deploying Reclaim because it is bundled with the 1E Client installer

    • The 1E Client allows you to reclaim software on a schedule by periodically querying the Reclaim web service. Client integration takes a user’s consent for optional policies and uninstalls them

    • The Reclaim web service is queried using the BackgroundChannel proxy, so there is no need to specify the web service URL. For authentication, the client certificate (with 1E Client connected to the Switch) is presented.

    • End-user consent is taken by launching the 1E.Client.Reclaimer.exe

  3. Create either an optional or mandatory reclaim policy using Software Reclaim to cover the devices and software titles in your inventory.

  4. On a device the 1E Client will poll optional and mandatory policies after the specified interval specified in 1EClient.conf file.

    1. Optional Policy - optional popup will appear and ask for end-user input.

    2. Mandatory Policy - product will be uninstalled in silent mode.

  5. You can track progress and errors in the 1E Client logs on your devices.


Once Software Reclaim is installed, you will need to run an Inventory sync or the Reclaim Usage Report (if an inventory sync is already completed). Once you have done this, data will be available on the Reclaim Usage summary screen and policies can be evaluated. Refer to Introducing Inventory Insights for more information.

Reclaim functionality is not included by default in the 1E Client. You can add it during, or post installation by configuring the following 1EClient.conf settings.

Name in 1EClient.conf

Installer Property

Default Value





Flag to enable or disable reclaim functionality.




Currently there is no minimum limit, the maximum is 10080 (1 week).




Flag to control honoring of “optional” reclaim policies which require interaction with the end-user.

Be aware that new Software Reclaim module settings are not included in the 1E.Client.conf file when you upgrade from older versions of the 1E Client. You can manually include them using the following methods.

  • Specify these installer properties during installation.




  • Use the Set 1E Client configuration property <agentconfig> to <agentconfigvalue> and restart the service after a short random delay instruction which is included by default with 1E.

  • Manually update the 1E.Client.conf located in C:/Program Files/1E/Client/ file by copying the settings at the end of the file and restarting the 1E Client service.

As an Administrator, you need to enhance security and access control, by using RBAC you can to provide a more granular level of access to features and data. This allows you to control user access based on their roles and responsibilities, improving security and ensuring that users have the appropriate level of access.

Table 9. Software Reclaim roles

Role name

Role description

Reclaim Administrator

Create, update, delete and view Software Reclaim - view and export Inventory - view, edit, delete and export Associations.

Reclaim Viewer

View Software Reclaim.

  • Software Reclaim is focused on usage, and does not include entitlement, LDC (License Demand Calculation) or compliance features

  • The Software Reclaim feature is only available as SaaS component

  • The AppClarity UI (including license information and consumer name) has been renamed to Software Reclaim

  • Software Reclaim does not include multi-language support

  • Compliance and Entitlement related roles and permissions have been removed:

    • AppClarity.Compliance

    • AppClarity.Entitlment

    • Repository.Compliance

    • Repository.Entitlement

  • AppClarity related roles are now called:

    • Repository.Reclaim

    • SoftwareReclaim.Reclaim

  • Compliance repository has been renamed to Reclaim, the default repository is Default Reclaim

  • SoftwareReclaimer.exe is integrated into the 1E Client

  • You can schedule policies using instruction changes

  • Custom Config Manager uninstall has been deprecated, Software Reclaim focuses on using Reclaimer through the 1E Client.