Administration

These settings control administrative functions such as delegation, user statistics, and change logging.


Users

This page displays statistics about your Workspace Environment Management installation.

Statistics

This page displays a summary of users whose agent hosts have connected to the database.

Users Summary. Displays a count of total users who have reserved a Workspace Environment Management license, for both the current site (configuration set) and all sites (configuration sets). Also displays a count of new users in the last 24 hours and in the last month.

Users History. This displays connection information for all the users associated with the current site (configuration set), including the last connection time (in Coordinated Universal Time, UTC), the name of the machine from which they last connected and the session agent type (UI or CMD) and version. You can use Find to filter the list by name or ID against a text string.


Agents

This page displays statistics about the agents in your Workspace Environment Management installation.

Statistics

This page displays a summary of the Workspace Environment Management agents recorded in the Workspace Environment Management database.

Agents Summary. Displays a count of total agents who have reserved a Workspace Environment Management license, for both the current site (configuration set) and all sites (configuration sets). It also reports agents added in the last 24 hours and in the last month.

Agents History. This displays connection information for all agents registered with this site (configuration set), including the last connection time, the name of the device from which they last connected and the agent version. You can use Find to filter the list by name or ID against a text string.

In the Synchronization State column, the following icons indicate when the agent last uploaded statistics to the infrastructure service.

localized image

Note:

These icons do not indicate that the agent cache is synchronized with the Workspace Environment Management database.

In the Profile Management Health Status column, you can view the health status of Profile Management on your deployment.

Profile Management health status performs automated status checks on your agent hosts to determine whether Profile Management is configured optimally. You can view the results of these checks to identify specific issues from the output file on each agent host (%systemroot%\temp\UpmConfigCheckOutput.xml). The feature performs status checks every day or each time the WEM agent host service starts. To perform the status checks manually, right-click the selected agent in the administration console, then select the Refresh Profile Management Configuration Check in the context menu. Each status check returns a status. To view the most recent status, click Refresh. The icon in the Profile Management Health Status column provides general information about the health status of Profile Management:

  • Good (check mark icon). Indicates that Profile Management is in good shape.

  • Warning (triangle exclamation point icon). Informs about a suboptimal state of Profile Management. The suboptimal settings might affect the user experience with Profile Management in your deployment. This status does not necessarily warrant action on your part.

  • Error (X icon). Indicates that Profile Management is configured incorrectly, which causes Profile Management not to function properly.

  • Unavailable (question mark icon). This icon appears when Profile Management is not found, or not enabled, or the WEM agent is not the latest version.

If the status checks do not reflect your experience or if they do not detect the issues you are having, contact Citrix Technical Support.

To refresh agents

When you refresh an agent it communicates with the infrastructure server. The infrastructure server validates the agent host identity with the Workspace Environment Management database.

  1. Click Refresh to update the list of agents.
  2. In the context menu select Refresh Workspace Agent(s).

Options in the context menu

Refresh Cache. Triggers a refresh of the agent offline cache database. To optimize Windows performance, WEM has an offline cache database that includes a per-machine cache that stores non-user parameters (Microsoft USV, Citrix Profile Management), and a per-user cache that stores user parameters (assigned actions, start menu settings, etc.).

Refresh Agent Host Settings. Triggers an immediate update of the WEM agent host settings.

Refresh Workspace Agent(s). Applies the settings to the agent(s) running on your machine(s).

Upload Statistics. Uploads statistics to the infrastructure service.

Reset Profile Management Settings. Clears the registry cache and updates the associated configuration settings. If Profile Management Settings are not applied to your agent, click Reset Profile Management Settings, and then click Refresh.

Note:

If the settings are not applied to the agent after configuring Reset Profile Management Settings from the WEM administration console, see CTX219086 for a workaround.

Reset Vmware Persona Settings. Clears the registry cache and updates the associated configuration settings. If VMware Persona Settings are not applied to your agent, click Reset Vmware Persona Settings, and then click Refresh.

Reset Microsoft Usv Settings. Clears the registry cache and updates the associated configuration settings. If Microsoft USV Settings are not applied to your agent, click Reset Microsoft Usv Settings, and then click Refresh.

Refresh Profile Management Configuration Check. Performs status checks on your agent host(s) to determine whether Profile Management is configured optimally.

Delete Record. Enables deletion of the agent record from the database. If the agent is still active, this option is grayed out.

Reset Actions. Lets you reset all actions you assigned by purging all action-related registry entries on the applicable machine.

Registrations

This page shows the registration status of the Workspace Environment Management agents recorded in the database.

Important:

Agents must only be registered with one configuration set.

The following information is reported:

Machine Name. Name of computer on which the agent is running.

State. Registration status of agent on the agent host computer, indicated by icons and the following description giving more information about registration success or failure:

Agent is not bound to any site. The infrastructure server cannot resolve any site (configuration set) for this agent because the agent is not bound to any site (configuration set).

Agent is bound to one site. The infrastructure server is sending the necessary machine-dependent settings to the agent for that site (configuration set).

Agent is bound to multiple sites. The infrastructure server cannot resolve a site (configuration set) for this agent because the agent is bound to more than one site (configuration set).

To resolve registration errors

Either

  • edit the Active Directory hierarchy (relations between computers, computer groups, and OUs)

OR

  • edit the Workspace Environment Management hierarchy (in the Active Directory Objects section of the administration console) so that a computer binds to only one site (configuration set).

After making these changes, refresh agents with the infrastructure server.


Logging

Administrative

This tab displays a list of all changes made to the Workspace Environment Management settings in the database. By default, the log is unpopulated until the log is refreshed manually.

Filtering Options. These options allow you to filter the log by site (configuration set), and date range.

Export Log. Exports the log in XLS format.

Refresh Log. Refreshes the log.

Clear Log. Clears the log for all configuration sets. This cannot be undone. Clearing the log adds one event in the new log indicating this has been done. This option is only available to Global Full Access administrators.

Agent

This tab lists all changes made to your Workspace Environment Management agents. The log is unpopulated until you click Refresh.

Filtering Options. These options allow you to filter the log by site (configuration set), and date range.

Export Log. Exports the log in XLS format.

Refresh Log. Refreshes the log.

Clear Log. Clears the log for all configuration sets. This cannot be undone. Clearing the log adds one event in the new log indicating this has been done. This option is only available to Global Full Access administrators.