Workspace Environment Management

Configure Profile Management health check

Workspace Environment Management (WEM) can check whether Citrix Profile Management is configured optimally on your agent machine.

You might find that the health check returns a warning status in Web Console > Monitoring > Administration > Agents even if Profile Management works properly. The status indicates that not all Profile Management settings are set as recommended. The user experience might be degraded.

To address the issue, use either of the following methods:

  • Change settings in Profiles > Profile Management Settings under the relevant configuration set.

  • Configure the scope of settings to cover in the Profile Management health check report.

Prerequisites

Before you start, make sure that:

  • Profile Management is installed and enabled on the agent machine.

  • The path to the user store is valid.

  • The WEM agent version is 2205.1.0.1 or later.

Check Profile Management health

In the web console, go to Monitoring > Administration > Agents and check the Profile Management health column. For more information about the health statuses, see Administration.

To view the detailed health check report of an agent, select the agent and then select More > Profile > View Profile Management health check report.

View Profile Management health check report

The report includes issues found and fix recommendations. For each issue, go to Profiles > Profile Management Settings under the relevant configuration set and change the setting accordingly. To dismiss an issue, go to Advanced Settings > Monitoring Preferences and specify the scope of settings to cover in the report.

Profile Management health check report

When no issue is found, the health check returns a good status, indicating that Profile Management is in good shape.

Note:

If the issue is an error, you must fix it in Profiles > Profile Management Settings under the relevant configuration set. Otherwise, Profile Management cannot function properly.

Customize the scope of settings to cover in a report

To customize the scope of settings to cover in a health check report, go to Advanced Settings > Monitoring Preferences under the relevant configuration set.

By default, all settings are included. For more information, see Advanced Settings.

Profile Management health check scope

Run Profile Management health check on demand

To run Profile Management health checks on an agent machine on demand, perform the following steps:

  1. In the web console, go to Monitoring > Administration > Agents, select the agent, and select More > Profile > Run Profile Management health check.

    Run Profile Management health check

  2. In the wizard that appears, choose whether to change the scope of the settings that the health check report covers and then click Run.

    Note:

    The changes you make here affect only the health check report to be generated.

    Run Profile Management health check - scope settings

Configure Profile Management health check