uberAgent - agent 7.4.1 running in integration mode due to a licensing issue

book

Article ID: CTX695907

calendar_today

Updated On:

Description

There is no data available in Splunk from the affected machine.

 

uberAgent.log located in C:\Windows\temp shows:

 

InitializeLogFile,Starting uberAgent.exe

LicenseCheck,Starting license verification

Finished license verification for component <User experience monitoring>. Result: unlicensed

InitializeApp,Start reading configuration

ReadConfiguration,No valid uberAgent license found. Switching to integration mode.

 

 

*Integration Mode - only Citrix-Director-uberAgent-Integration receiver is in use.

Cause

Timing issue - Citrix policy applied after agent startup.

Even if correct license was detected later - there is no automatic restart / switch to full mode.

Resolution

Solutions:

  • Upgrade VDA 2507 to 2507 CU1 which includes uberAgent 7.4.2.
  • Upgrade uberAgent to 7.4.2 version.

 

Workarounds:

  • Cache license file on the image (%ProgramData%\vast limits\uberAgent\License cache)
  • Specify the license path in the configuration file (LicenseFilePath)
  • Restart uberAgent service

 

What is new in 7.4.2:

 

uberAgent now supports Citrix CVAD licensing on Windows and macOS. This means that uberAgent automatically detects when it’s executed on a Citrix Virtual Delivery Agent (VDA), and therefore get’s licensed automatically. When such a license is available, it takes precedence over the uberAgent license file. Note: when installed on a Citrix Delivery Controller (DDC), uberAgent requires a license. [B1135, B1138]

Issue/Introduction

uberAgent 7.4.1 was installed as part of the Citrix Virtual Apps and Desktops (CVAD) installation (2507).

AppLayering was used for image creation (no policies cached on the image).

Non persistent MCS machines created from the image.

 

CVAD policy was configured: uberAgent License Path.

 

Policy validation:

  • Correct path specified
  • Correct license placed on the network share
  • Network share was accessible from the VDA with user and system account
  • Policy applied on the VDA

Additional Information

7.4.2 Documentation: https://docs.citrix.com/en-us/uberagent/7-4-x/whats-new/7-4-2.html

 

Additional licensing related changes (LAS):

7.5.1 Documentation: https://docs.citrix.com/en-us/uberagent/7-5-x/whats-new

 

With uberAgent 7.5.1, uberAgent switches to utilizing the Citrix License Activation Service (LAS) for all types of deployments. This means that the product will no longer work with legacy uberAgent license files (e.g., uberAgent.lic). While uberAgent versions 7.4.2 and later are automatically licensed on Citrix Virtual Delivery Agent (VDA) deployments, an activation file issued from your Citrix Cloud account is required for all non-VDA installations. Please consult the uberAgent license guide for more details.

To ensure uberAgent is able to communicate with the LAS backend, verify that your endpoints are able to connect to the license servers listed here.

If uberAgent cannot contact the LAS backend, the license verification may fail and uberAgent does not start. Note, this may require uberAgent to use a proxy, depending on your environment. For instructions on how to configure uberAgent to use a system proxy follow this guide. Please also review the upgrade instructions and update your deployment process.[B1143]