New product names and version numbers were introduced in Workspace Environment Management service 1807. That information is retained in this article for reference. For more information, see New product names and New product and component version numbers in this article.
A goal of Citrix is to deliver new features and product updates to Workspace Environment Management service customers when they are available. New releases provide more value, so there is no reason to delay updates. Updates are rolled out to the service release approximately every three weeks.
This process is transparent to you. Updates are applied to Citrix internal sites initially, and are then applied to customer environments gradually. Delivering updates incrementally in waves helps ensure product quality and maximize availability.
For information about the service level goal for the Workspace Environment Management service for cloud scale and service availability, see Service Level Goals. To monitor service interruptions and scheduled maintenance, see the Service Health Dashboard.
Citrix optimizer is now available in Workspace Environment Management (WEM). You can use the feature to optimize user environments for better performance. Citrix optimizer runs a quick scan of user environments and then applies template-based optimization recommendations. You can optimize user environments in two ways:
- You can use built-in templates to perform optimizations. To do so, select a template applicable to the operating system.
- Alternatively, you can create your own custom templates with specific optimizations you want and then add them to WEM.
For more information, see Citrix optimizer.
Automatic agent upgrade
This release introduces the automatic agent upgrade feature, which lets you schedule automatic upgrades for the Workspace Environment Management (WEM) agent. This feature facilitates regular agent upgrades without the need to roll out agent upgrades manually. The feature also provides flexibility in upgrading your WEM agents:
- You can specify a time period for which you want WEM to automatically roll out the upgrade to all agent machines in a configuration set.
- Alternatively, you can choose to enable users to upgrade the agent manually.
For more information, see Agent upgrade.
The user interface of the administration console has changed:
- In System Optimization, there is a new Citrix Optimizer pane. In the pane, there is a Citrix Optimizer tab for configuring optimization-related settings.
- In the Advanced Settings > Configuration pane, there is a new Agent Upgrade tab. The tab lets you configure settings associated with the agent upgrade.
Attempts to import registry files might fail with the following error message: Error “Import from Registry file” - Import Completed with Errors. The issue occurs when a registry file to be imported contains two or more values that have the same name. [WEM-6232]
You might encounter the following action group issues:
- Attempts to unassign an action group might fail with the following error message: “Error while unassigning the selected item: The specified item is not already assigned.” The issue occurs when you unassign an action group that was imported from a different configuration set.
- Attempts to rename an action group might fail with the following error message: “Action Group name cannot be same as existing one.” The issue occurs if you change the name of the action group and later rename it to the original name. [WEM-6250]
The administration console might exit unexpectedly when you scroll down the assignment list in the Edit Rule window of the Administration Console > Security pane. The issue occurs when you assign the same rule to multiple users and/or user groups. [WEM-6502]
Replacing Microsoft SQL Server Compact (SQL CE) with SQLite
The Workspace Environment Management (WEM) agent can work in offline mode. In earlier releases, the agent relied on Microsoft SQL Server Compact to synchronize with SQL Server to facilitate offline mode. Microsoft SQL Server Compact 3.5 Service Pack 2 is the last version that supports this functionality. Versions 4.0 and later do not support synchronization with SQL Server. However, SQL Server Compact 3.5 Service Pack 2 reached End of Life (EOL) in 2018. Starting with this release, the agent relies on SQLite for offline mode to work.
How this change impacts you
If you do not want to use Microsoft SQL Server Compact 3.5 Service Pack 2, upgrade to the latest agent version. For information about upgrading the agent, see Upgrade.
If you choose not to upgrade to this agent version, this replacement does not require action on your part.
Workspace Environment Management agent
Starting with this release, the Workspace Environment Management (WEM) agent no longer supports Microsoft .NET Framework versions 4.5.2, 4.6, 4.6.1, 4.6.2, and 4.7.
If you install or upgrade the agent to the latest version
The WEM agent installer automatically installs .NET Framework 4.7.1 if it is not already installed or if the installed version is older than version 4.7.1. After the installation completes successfully, you are prompted to restart your machine. Run the agent installer again after the restart.
If you choose not to upgrade the agent
You do not need to upgrade to .NET Framework version 4.7.1 or later. The previous version of the WEM agent supports .NET Framework 4.5.2 and later.
Option to reset actions
Starting with this release, WEM supports resetting assigned actions (purging action-related registry entries in the user environment). The feature also provides the flexibility to reset assigned actions. You can reset all assigned actions by using the administration console or let users decide what to reset in their environment. The feature might be useful in scenarios where actions you assign to users or user groups do not take effect. For more information, see Advanced settings.
The administration console user interface has changed:
- The Advanced Settings > UI Agent Personalization > UI Agent Options tab introduces an “Allow Users to Reset Actions” option. Use that option to control whether to let current users specify what actions to reset in their environment.
The Restore wizard might take a long time to load the Active Directory (AD) objects after you select Machines as the type of AD objects you want to restore and click Next. The issue occurs when there is a large number of OUs (for example, 4,000). [WEM-5169]
The Use Cache Even When Online option on the Administration Console > Advanced Settings > Configuration > Agent Options tab might not work. [WEM-6118]
Support for exporting and importing configuration sets
Starting with this release, Workspace Environment Management (WEM) service supports exporting and importing configuration sets using the administration console. To export configuration sets, use the Backup wizard, where the Configuration set option is available on the Select what to back up page. To import configuration sets, use the Restore wizard, where the Configuration set option is available on the Select what to restore page. You can export and import only one configuration set at a time. For more information, see Ribbon.
Support for importing registry files
Starting with this release, you can import registry files that contain your registry settings to the Workspace Environment Management service. For more information, see Import registry files.
After you migrate your on-premises WEM database to the WEM service, you must reinstall the WEM service agent even if the latest version is installed on your machine. This is necessary because the agent cache cannot synchronize with the WEM service database unless you reinstall the WEM service agent. [WEM-2396]
In Transformer (kiosk) mode, and with Log Off Screen Redirection enabled, WEM might fail to redirect the user to the logon page after logging off. [WEM-3133]
When you enable the process launcher on the Administration Console > Transformer Settings > Advanced > Process Launcher tab to launch the Windows built-in application (for example, calc.exe) as entered in the process command line field, the agent host might keep opening the application after you refresh Citrix WEM Agent. [WEM-3262]
Agent proxy configuration
This release adds support for configuring an HTTPS proxy for the Workspace Environment Management (WEM) agent to communicate with Citrix Cloud using Group Policy. As a result, you no longer need to configure the Citrix WEM Agent Service.exe.config (formerly Norskale Agent Host Service.exe.config) file. Instead, you can simply specify a proxy server for the agent to communicate with Citrix Cloud using the Agent proxy configuration policy. Doing so simplifies the agent proxy configuration. For details, see Step 3: Configure group policies (optional).
Workspace Environment Management now supports all versions of Profile Management through 1909. The following new options are now available on the tabs in the Administration Console > Policies and Profiles > Citrix Profile Management Settings pane:
- Migrate user store. Available on the Main Citrix Profile Management Settings tab, this option lets you migrate your user store without losing any data.
- Automatic migration of existing application profiles. Available on the Profile Handling tab, this option lets you automatically migrate existing application profiles.
- Outlook search index database – backup and restore. Available on the Advanced Settings tab, this option ensures the stability of the Enable search index roaming for Outlook feature.
For more information, see Citrix Profile Management Settings.
Workspace Environment Management service upgrade notifications
This release introduces an email notification service that lets you get notifications about upcoming upgrades to your Workspace Environment Management (WEM) service. By default, you will get notification emails when Citrix provides upgrades to your WEM service. You can choose to unsubscribe if you do not want to receive such emails in the future. To do so, go to the WEM service Downloads tab and then click Unsubscribe in the Service Upgrade Notifications section.
An “Auto Prevent CPU Spikes” option is provided on the System Optimization > CPU Management > CPU Management Settings tab. You can use this option to automatically reduce the CPU priority of processes that overload your CPU. For more information, see CPU Management.
Support for migrating Group Policy Objects (GPOs)
Starting with this release, you can migrate a zip backup of your GPOs to Workspace Environment Management (WEM). To do so, click Migrate in the ribbon of the WEM administration console. The Migrate wizard provides the flexibility to migrate your GPOs. You can select Overwrite mode or Convert mode for your migration. The Overwrite mode overwrites existing WEM settings (GPOs) when there are conflicts. The Convert mode converts your GPOs to XML files. Then you can manually import the XML files to WEM using the Restore wizard. Doing so gives you granular control over settings to be imported. For more information, see Ribbon.
On the Active Directory Objects tab of the administration console , using Add Object and Check Name to search and add objects allows only one object to be added at a time. You must close and then reopen the Select Computers or Groups dialog to add another object. (The on-premises version of Workspace Environment Management allows multiple objects to be identified and added without closing the dialog each time.) [WEM-1620]
The Workspace Environment Management administration console might unexpectedly exit if you edit the application security rules. The issue occurs when there is a long list of users and user groups present in the Edit Rule window and you scroll down to view them. [WEM-4960, LD1818]
When you log on to a Workspace Environment Management agent machine, the logon process might take longer to complete. The issue occurs because the Workspace Environment Management agent logon service (Citrix.Wem.Agent.LogonService.exe) delays the logon process for several seconds even though the Endpoint Management group policy processing is disabled. [WEM-5237]
Workspace Environment Management agent installer
This release provides a brand-new, unified Workspace Environment Management (WEM) agent installer. The installer bundles the WEM on-premises and service agents into a single executable. It eliminates the need to configure the ADMX templates and edit group policies. You can choose to install the agent interactively or using the command line. For more information, see Install and configure.
Support for exporting and importing Active Directory (AD) objects
As of this release, Workspace Environment Management service adds support for exporting and importing AD objects using the administration console. To export AD objects, use the Backup wizard, where the Active Directory (AD) objects option is provided on the Select what to back up page. To import AD objects, use the Restore wizard, where the Active Directory (AD) objects option is provided on the Select what to restore page. You can specify which type of AD objects to back up and restore. For more information, see Ribbon.
VMware Persona settings deprecation
Support for VMware Persona settings has been deprecated. All VMware Persona settings content will be removed from the documentation in the next release.
The agent splash screen can persist for a long time when there is a large amount of data associated with user statistics. [WEM-4674, LD1167]
You might find that there are two Citrix Components nodes in the left pane of the Group Policy Management Console. [WEM-5012]
Action Groups functionality has been added to the administration console Actions pane. This functionality lets you configure a group of actions that you want to assign to a user or user group. For more information, see Action Groups.
The administration console user interface has changed:
- In Actions, there is a new Action Groups pane. In the Actions > Action Groups pane, there is a new Action Group List tab for configuring a group of actions that you want to assign to a user or user group.
The Windows theme of the agent host might revert to the default if you use GPO to customize your Windows theme. The issue occurs when you enable the WEM agent to process environmental settings without selecting Set Specific Theme File and Set Background Color on the Policies and Profiles > Environmental Settings > Start Menu tab of the administration console. As a result, the WEM agent deletes the registry settings associated with the Windows theme. [WEM-4044, LD1246]
The Windows desktop background of the agent host might revert to the default if you use GPO to customize your Windows desktop background. The issue occurs when you enable the WEM agent to process environmental settings without selecting Set Specific Theme File and Set Background Color on the Policies and Profiles > Environmental Settings > Start Menu tab of the administration console. As a result, the WEM agent deletes the registry settings associated with the Windows desktop background. [WEM-4217, LD1408]
Support for communications over TLS 1.2
Workspace Environment Management (WEM) service secures communications by utilizing the Transport Layer Security (TLS) 1.2 protocol. TLS 1.2 provides a higher level of security than earlier TLS versions.
How this change impacts you
To enable TLS 1.2, you must use the latest version of the WEM service agent. The latest WEM service agent allows only TLS 1.2 communications.
What to do
If you want to enable only TLS 1.2, upgrade your agent to the latest version. For information about upgrading the WEM service agent, see Upgrade.
Workspace Environment Management service now supports all versions of Profile Management through 1903. The following new option is now available on the Administration Console > Policies and Profiles > Citrix Profile Management Settings > Synchronization tab:
- Enable Profile Container (option for eliminating the need to save a copy of the folders to the local profile)
Workspace Environment Management integration with Endpoint Management
This release includes the following enhancement to the Workspace Environment Management integration with Endpoint Management:
- The machines on which the WEM service agent is running are associated with a configuration set automatically. There is no need to manually add the machines (agent hosts) to a configuration set in the WEM service administration console. As a result, you can now directly configure WEM settings (group policies) using the Endpoint Management console after you install the service agent on the applicable machines. For more information, see Windows GPO Configuration device policy.
An “Enable Notifications” option is provided on the Advanced Settings > Configuration > Agent Options tab. You can use this option to control whether the agent displays notification messages on the agent host when the connection to the infrastructure service is lost or restored.
When you click Apply Filter or Refresh Report on the Administration Console > Monitoring > User Trends > Devices Types tab, you might not be able to view the report. Instead, you are returned to the Administration Console > Actions > Applications > Application List tab. [WEM-3254]
On Windows 10 version 1809 and Windows Server 2019, Workspace Environment Management fails to pin the applications to the task bar. [WEM-3257]
After WEM upgrades to the latest version, if you still use the earlier versions of the agent, the agent fails to work properly in offline mode. This issue occurs because of the scope changes of the agent local cache file in the latest release. As a workaround, delete the old agent local cache file, and then restart the WEM Agent Host Service (Norskale Agent Host service). [WEM-3281]
On the Security tab of the administration console, if you create an AppLocker rule for a file with an .exe or a .dll extension using a file hash condition, the rule does not work. This issue occurs because WEM calculates the hash code of that file incorrectly. [WEM-3580]
On the Security tab of the administration console, if you create an AppLocker rule for a file using a publisher condition, the rule does not work. This issue occurs because WEM resolves the file name incorrectly. [WEM-3582]
The Enable AutoEndTasks option on the Policies and Profiles > Environmental Settings > SBC / HVD Tuning tab of the administration console does not work. [WEM-3749, LD0876]
If you click Add OU on the administration console, WEM might not display anything on the Organizational Units window. The issue occurs when a forest (current or trusted) contains a large number of OUs. As a workaround, you might need to click Cancel and then click Add OU multiple times. [WEM-3818, UCOHELP-1211]
The Application Security feature does not work on Windows servers that use non-English Windows operating systems. This issue occurs because WEM fails to start the Application Identity service in non-English language environments. [WEM-3957, LD1185]
- Attempts to migrate your WEM database into the WEM service can fail. The issue occurs when the entries in the VUEMTasksHistory table of your on-premises WEM database contain special characters. As a workaround, delete those entries from your on-premises WEM database, and then restart the migration process. [WEM-3817, UCOHELP-1567]
Workspace Environment Management integration with Endpoint Management
As of this release, Workspace Environment Management service supports configuring group policies through the Endpoint Management console. To configure group policies from the Endpoint Management console, make sure that you are running the latest version of the Workspace Environment Management service agent. For more information about the integration, see Windows GPO Configuration device policy.
The following issues have been fixed in the current release:
With language packs installed, options in the Start menu > User Account menu might not be displayed in the language you selected. [WEM-1176, LC8811]
Attempts to access the administration console from the Workspace Environment Management service Manage tab fail. As a workaround, refresh your browser window and try again. [WEM-2401]
After your WEM service is upgraded to version 1811, the administration console might exit unexpectedly when you click OK if WEM does not display anything on the Organizational Units window. [WEM-3612, UCOHELP-655]
Attempts to migrate your on-premises WEM database into the WEM service might fail after uploading your SQL file. The issue occurs because database creation in Azure times out. [WEM-3783, UCOHELP-983, UCOHELP-987]
A new process allows you to migrate an on-premises Workspace Environment Management database to the Workspace Environment Management service. The process is provided on the WEM service’s Downloads tab. For more information, see Migrate.
The administration console user interface changes:
An “Everyone” default group is provided on the Assignments > Action Assignment tab. To simplify assigning actions for all users in Active Directory, you can use the “Everyone” default group to assign the actions.
A Profile Management health status column is provided on the Administration > Agents > Statistics tab. As of this release, Workspace Environment Management supports performing automated status checks on your agent hosts to determine whether Profile Management is configured optimally. You can view the status in the column.
As of this release, Workspace Environment Management service supports configuring all settings for Citrix Profile Management 1808. The following new options are now available in the administration console on the service’s Manage tab:
- Enable application profiler (option for defining application-based profile handling)
- Enable search index roaming for Microsoft Outlook users (option for improving the user experience when searching mail in Microsoft Outlook)
- Enable Large File Handling (option for eliminating the need to synchronize large files over the network)
New product names
If you’ve been a Citrix customer or partner for a while, you’ll notice new names in our products and in this product documentation. If you’re new to this Citrix product, you might see different names for a product or component.
The new product and component names stem from the expanding Citrix portfolio and cloud strategy. Articles in this product documentation use the following names.
Citrix Virtual Apps and Desktops: Citrix Virtual Apps and Desktops offers a virtual app and desktop solution, provided as a cloud service and as an on-premises product, giving employees the freedom to work from anywhere on any device while cutting IT costs. Deliver Windows, Linux, web, and SaaS applications or full virtual desktops from any cloud: public, on premises or hybrid. Virtual Apps and Desktops was formerly XenApp and XenDesktop.
Citrix Workspace app: The Citrix Workspace app incorporates existing Citrix Receiver technology as well as the other Citrix Workspace client technologies. It has been enhanced to deliver additional capabilities to provide end users with a unified, contextual experience where they can interact with all the work apps, files, and devices they need to do their best work. For more information, see this blog post.
Citrix Provisioning: The Citrix Provisioning is a solution for managing virtual machine images, combining previous technologies known as Machine Creation Services (MCS) and Citrix Provisioning Services (PVS). Citrix Provisioning was formerly Provisioning Services.
Here’s a quick recap:
|Citrix Virtual Apps and Desktops||XenApp and XenDesktop|
|Citrix Workspace app||Citrix Receiver|
|Citrix Provisioning||Provisioning Services|
Implementing this transition in our products and their documentation is an ongoing process.
In-product content might still contain former names. For example, you might see instances of earlier names in console text, messages, and directory/file names.
It is possible that some items (such as commands and MSIs) might continue to retain their former names to prevent breaking existing customer scripts.
Related product documentation and other resources (such as videos and blog posts) that are linked from this product’s documentation might still contain former names.
Your patience during this transition is appreciated. For more detail about our new names, see https://www.citrix.com/about/citrix-product-guide/.
New product and component version numbers
In this release, product and component version numbers are displayed in the format: YYMM.c.m.b.
- YYMM = Year and month when the features are finalized. For example, if the features are finalized in August, a release in September 2018 appears as 1808.
- c = Maintenance version (if applicable).
- m = Citrix Cloud release number for the month.
- b = Build number. This field is shown only on the About page of the product, and in the OS’s feature for removing or changing programs.
For example, Workspace Environment Management service 1808.0.1 indicates that the released product with features finalized in August 2018 is associated with Citrix Cloud release 1 in that month, and is not a maintenance version. Some UI elements display only the version’s year and month, for example, Workspace Environment Management service 1808.
The following issues have been fixed in the current release:
In the Security tab, when you clear the option Process DLL Rules, the rule count reported next to the “DLL Rules” collection is set to zero, regardless of the actual number in the WEM database. [WEM-425]
The Workspace Environment Management Agent Host screen capture feature allows end users to take screenshots of error messages in their environment. They can then send the screenshots to the administrator via Microsoft Outlook for support. However, when end users click the Send to Support button, the following error message appears: “Error encountered while sending email.” [WEM-1123]
Attempts to upgrade the WEM database using the command line might fail. [WEM-1410]
The on-premises version of WEM lets you use Active Directory security groups as containers for WEM agents. However, the WEM service does not support using Active Directory security groups as agent containers. The on-premises infrastructure service also supports using direct and indirect OUs as agent containers. For example, suppose WEM agent AGENT1 belongs to OU2, and OU2 belongs to OU1 (OU1>OU2>AGENT1). The on-premises infrastructure service recognizes AGENT1 as a member of both OU1 and OU2. However, the WEM service does not support indirect OUs. In the example above, the WEM service recognizes AGENT1 only as a member of OU2. [WEM-1619]
In the WEM administration console’s Assignments section, when you use the Modeling wizard for a global view of WEM actions assigned to a specific user, the User Groups tab in the Actions Modeling wizard displays the groups to which the user belongs. However, in WEM service, the User Groups tab in the Actions Modeling wizard does not display the groups to which the user belongs. [WEM-1632]
After you apply a percentage of the CPU’s processing power for a process on the System Optimization > CPU Management > CPU Clamping tab of the administration console for the first time and configure a different percentage for the same process later, the change does not take effect. [WEM-1993, LD0110]
After you upgrade the WEM agent to Version 4.7, if you select Enable Intelligent CPU Optimization and/or Enable Intelligent I/O Optimization on the System Optimization > CPU Management > CPU Management Settings tab of the administration console, error messages about Error 87 frequently appear in Windows Event logs. This issue does not affect the user experience, thus you can dismiss these error messages. [WEM-2051]
When the Citrix WEM agent starts, a Citrix WEM Agent Init file (.log) and a Citrix WEM Agent file (.log) are created separately in the root of the current user’s Users folder. However, while WEM agent switches from the Citrix WEM Agent Init file to the Citrix WEM Agent file, some logs might be missing. [WEM-2233]
Agent group policy template: This template allows you to specify a list of Citrix Cloud Connectors. You must do this before you install the agent. See Install and configure.
Workspace Environment Management service agent: A service-specific agent is provided which has the ability to connect to the Workspace Environment Management service. You must deploy Citrix Cloud Connector in your user domain before you install the agent. See Install and configure.
Workspace Environment Management administration console: A web-based administration console is provided to manage your WEM installation from the service’s Manage tab using your web browser. This provides the same functionality as the on-prem version of the administration console.
Search index roaming for Microsoft Outlook users: A new option is provided to improve the user experience when searching mail in Microsoft Outlook. See Citrix Profile Management Settings.