Product Documentation

Administration

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


Administrators

These options allow you to define Workspace Environment Management administrators (users or groups) and give them permissions to access sites (configuration sets) via the administration console.

Configured Administrators List

A list of configured administrators showing their permission level (Full Access, Read Only or Granular Access, see details below). You can use Find to filter the list by name or ID against a text string.

To add an administrator

  1. Use the context menu Add command.
  2. Enter details in the Select Users or Groups dialog, then click OK.

Name. The name of the user or group you are currently editing.

Description. Additional information about the user or group.

Global Administrator. Select to specify that the selected user/group is a Global Administrator. Clear to specify that the selected user/group is a Site Administrator. Global Administrators have their permissions applied to all sites (configuration sets). Site Administrators have their permissions configured on a per-site basis.

Permissions. This allows you to specify one of the following levels of access to the selected user/group. Note: Administrators can only view settings which they have access to.

Full Access administrators have full control over every aspect of the specified sites (configuration sets). Only Global Administrators with Full Access can add/delete Workspace Environment Management administrators. Only Global Full Access and Global Read Only administrators can see the Administration tab.

Read Only administrators can view the entire console, but cannot modify any settings at all. Only Global Full Access and Global Read Only administrators can see the Administration tab.

Granular Access indicates that the administrator has one or more of the following permission sets:

Action Creators can create and manage actions.

Action Managers can create, manage, and assign actions. They cannot edit or delete actions.

Filter Managers can create and manage conditions and rules. Rules that are in use on assigned applications cannot be edited or deleted by Filter Managers.

Assignment Managers can assign resources to users or groups.

System Utilities Managers can manage the System Utilities settings (CPU, RAM and process management).

Policies and Profiles Managers can manage Policies and Profiles settings.

Configured Users Managers can add, edit, and remove users or groups from the configured users list. Users or groups with assigned actions cannot be edited or deleted by Configured Users Managers.

Transformer Managers can manage Transformer settings.

Advanced Settings Managers can manage advanced settings (enabling or disabling action processing, cleanup actions, and so on).

Security Managers can access all controls in the Security tab.

State. This controls whether the selected user/group is enabled or disabled. When disabled, the user/group is not considered to be a Workspace Environment Management administrator and cannot use the administration console.

Type. This field is read only and indicates whether the selected entity is a user or a group.

If the Global Administrator is cleared, the following controls are enabled:

Site Name. All Workspace Environment Management sites (configuration sets) belonging to the database this infrastructure service is connected to.

Enabled. Select to enable this administrator for the specified Workspace Environment Management site (configuration set). When disabled, the user/group is not considered to be an administrator for that site and cannot access it.

Permissions. Select a permission level for the selected user/group for each Workspace Environment Management site (configuration set) attached to this infrastructure service.


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, 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 in 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, and 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). 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.

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.

Version

Administration