Configuration via Group Policy

July 9, 2024

Contributed by:

Platforms: Windows only

Overview

To configure uberAgent via Group Policy, follow these steps:

Copy the Group Policy AMDL/ADMX templates included in the uberAgent download package to your PolicyDefinitions directory.
Create a new GPO that applies to the computers uberAgent is installed on.
Import the default configuration from the directory uberAgent components\Group Policy\GPO backup of the download package, choosing either the default configuration or the version optimized for data volume.
Adjust the imported default configuration as required.
Local configuration files on the endpoints are ignored, and policy settings are used exclusively. If an additional configuration file is set via Group Policy, the settings of that file overwrite Group Policy settings.

Detailed Description

Preparation

In order to have the uberAgent settings show up in Group Policy Management Editor, you need to add uberAgent’s Group Policy template (ADMX and ADML files) to your PolicyDefinitions directory. If you are using a Central Store for Group Policy administrative template files, then the location of the PolicyDefinitions directory is:

\\FQDN\SYSVOL\FQDN\policies\PolicyDefinitions

If you are not using a Central Store, administrative templates reside on the machines that are used to manage Group Policy in:

%Systemroot%\PolicyDefinitions

In any case, copy all files from this location in uberAgent’s download package to your PolicyDefinitions directory:

uberAgent components\Group Policy\Administrative template (ADMX)

That directory should contain at least:

uberAgent.admx
en\uberAgent.adml

Configuration

Once the administrative template files are in the correct location, choose a Group Policy Object (GPO) you want to configure uberAgent’s settings in. uberAgent’s configuration settings are located in Computer Configuration > Policies > Administrative Templates > uberAgent.

Settings Import

The easiest way to get a working configuration is to import the settings from the GPO backup included in the uberAgent download package.

To import the default configuration, follow these steps:

In Group Policy Management Console (GPMC), navigate to the node Group Policy Objects (import is not available on a GPO link).
Right-click the GPO you want to import the settings into.
Select Import Settings....
When asked for the Backup location from which settings will be imported select the directory uberAgent components\Group Policy\GPO backup from uberAgent’s download package.
Complete the Import Settings wizard.
Open the GPO you imported the settings into in Group Policy Management Editor.
Navigate to Computer Configuration > Policies > Administrative Templates > uberAgent> Receivers > Receiver 01.
Adjust the setting Servers (required) according to your requirements.

Manual Configuration

As an alternative to importing the default configuration (as described above), you can configure uberAgent’s settings from scratch. Here are some recommendations:

Enable on-demand metrics: On-demand metrics > On-demand metrics.
Configure and enable a receiver: Receivers > Receiver 01.
Configure and enable at least one timer: Timers > Timer 01.
Do not forget to enable the setting Configuration through Group Policy.

Troubleshooting

Verify in the registry that the machines running uberAgent have received the correct Group Policy settings. uberAgent’s settings are stored in HKEY_LOCAL_MACHINE\SOFTWARE\Policies\vast limits.

Verify that uberAgent is processing the settings correctly:

Restart the uberAgent service.
Open the log file.
Right after the service starts uberAgent logs in detail how it processes its configuration and what source (Group Policy, config file) is being used.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Configuration via Group Policy

July 9, 2024

Contributed by:

July 9, 2024

Contributed by:

Configuration via Group Policy

Overview

Detailed Description

Preparation

Configuration

Settings Import

Manual Configuration

Troubleshooting

In this article