A list containing the majority of Citrix Workspace Environment Management support articles collated to make this page a one stop place for you to search for and find information regarding any issues you have with the product and its related dependencies.
The page is updated daily with new support articles and information. Articles will change from time and if information here is outdated or incorrect please let me know using the comments. Links may also expire or change so if you find broken links, please again let me know. For each issue, known product versions affected are recorded however that does not mean product versions that aren’t listed are not affected.
There is a search box that you can use if looking for a specific fault. For example if you have an error code or error message, use that to perform a search. You can also use your browsers search feature which will perform a search against the whole page based on the words you enter.
Workspace Environment Management:
| wdt_ID | Brief Description of Issue | Brief Description of Fix | Applicable Product Versions Affected (if known) | Link to supplemental Support Article(s) |
|---|---|---|---|---|
| 1 | WEM 4.3 Infrastructure Service crashes intermittently. | There is a private hotfix, contact Citrix support. | Citrix Workspace Environment Management 4.3. | |
| 2 | Some security related settings such as hiding the run box may not be applied and the WEM Agent throws "exception denied" errors. | There are a couple of things to check such as making sure the VuemLocalUser account is not denied the right to log on locally and that the "Process Environmental Setting" options is checked. More steps are outlined in the CTX article. | https://support.citrix.com/article/CTX219088 | |
| 3 | Event Log reports "Error while changing IO priority to high for process" for processes related to anti-virus. | Antivirus software generally protects their related processes from adjustment by other processes in the operating system. Workspace Environment Management 4.1 contains updated code to identify when an anti-virus program prevents adjustment of a process priority so that the error is not logged in Event Viewer. Previous versions of WEM also correctly identified this behaviour but logged the event as an error. | https://support.citrix.com/article/CTX219492 | |
| 4 | The WEM SQL error log file grows to an abnormally large size. The log file is flooded with entries such as "Closed due to following error" and "Remote service has been dropped". | Check you have installed the relevant SQL hotfix as described in the CTX article. | https://support.citrix.com/article/CTX219087 | |
| 5 | The SQL database grows to over 20GB. | This can be caused by lack of purging/backing up of the SQL Transactions Logs, so they continue to grow. | https://support.citrix.com/article/CTX228057 | |
| 6 | Transformer does not auto-launch after user logon. | Make sure "Launch Agent at Reconnect" is applied within WEM under "Advanced Settings -> Main Configuration". | https://support.citrix.com/article/CTX228058 | |
| 7 | Links in "This PC" still point to local folders rather than the redirected folders that WEM is set to configure. | Upgrade to WEM 4.4. | Citrix Workspace Environment Management 4.3. | https://support.citrix.com/article/CTX228060 |
| 8 | After installing the WEM image on the Master VM, you cannot update the Machine Catalog with the new image via MCS. Error "Image Preparation did not complete. Status 'Not Set'" is shown. | Upgrade to XenDesktop 7.14. | Citrix XenDesktop 7.13. | https://support.citrix.com/article/CTX228003 |
| 9 | Profile settings take a long time to apply. | Check "Bypass ie4uinit Check" under "Advanced Settings -> Service Options". | https://support.citrix.com/article/CTX228669 | |
| 11 | The Agent does not synchronise correctly with a WEM broker after logging on. | Configure a system startup script to restart the "Norskale Agent Host Service" and refresh the WEM agent cache as described in the attached article. | http://www.jgspiers.com/citrix-workspace-environment-manager/#Troubleshooting |
Fabian
July 20, 2018Hi George, some question regarding WEM agent gets stuck on “processing filter”. The Description how to fix isn’t completely shown. Could please tell how to fix. Many thanks, Fabian
George Spiers
July 23, 2018Displays fine to me across two browsers. What browser are you using?
It reads “In this case the WEM agent was set to run under the “Userinit” string located under “HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon”.
Fabian
July 23, 2018Hi, I’am using Chrome and Edge. What does it means: WEM agent was set to run under the “Userinit”
What did I have to change to solve the problem?
George Spiers
July 23, 2018“Userinit” is a a registry string, so VUEMUIAgent.exe was specified under this string object. It is not going to apply to your case. If you have WEM 4.1, upgrade to a newer version as 4.1 also had a bug like this.
GoldBird
August 26, 2020Hi George,
We use WEM 1912, and the userinit, is on this reg key.
What do I change to solve this issue?
Azmi
July 25, 2018Hi George,
We have implimented WEM4.7, after a user logs in, his profile folders are duplicating; like desktop, my documents, favorites, are doubled.
Any idea?
George Spiers
July 25, 2018Are you using Citrix Profile Management? If so, do you mean they are doubled on the profile store or in C:\Users\%username% or doubled when viewed from Windows Explorer?
Azmi
July 26, 2018Yes they are Doubled in c:\users\%username%.
And profile mangmnt configrations using WEM.
And yes you can view it from windows explorer.
George Spiers
July 26, 2018Try the Profile Cleanser option against an affected profile to see if that brings things back to normal.
Also check if new profiles are affected.
Thomas
September 28, 2018Hello, George,
I have the following problem that the VUEMUIAgent.exe is not started automatically when I log on to the W10 desktop.
The environment looks like this.
Citrix WEM Agent 4.7 installed in Citrix platformlayer on Win10_1803 and distributed the finished image via Citrix MCS 7.18.08.02.
In the WEM Console you can see the Win10 machine as registered and it is fully manageable.
Unfortunately the agent is not shown in the taskbar if it is configured according to the WEM config.
If I start the VUEMUIAgent.exe by hand, it pulls the current config from the WEM server and appears in the taskbar.
Thank you and greetings
Thomas
George Spiers
September 28, 2018Have a read here: https://jgspiers.com/citrix-workspace-environment-manager/#Troubleshooting
Thomas
September 29, 2018Hello George,
I had already read and implemented the troubleshooting tips, but unfortunately they did not change anything.
Unfortunately I cannot find out how the VUEMUIAgent.exe is started automatically.
Do you have another idea?
Thank you and greetings Thomas
George Spiers
September 29, 2018Have you checked “Launch Agent at Logon” under “Configuration -> Main Configuration”?
Also if you have upgraded to W10 1803, there is a known issue: https://support.citrix.com/article/CTX231942
Anonymous
September 29, 2018Hi, Geroge,
the Agent service option “Launch on Logon” under the main menu was set correctly.
The OS version Win10 1803 was the base installation, not an update from a previous version. Security updates were installed of course.
Of course I can still uninstall and reinstall the WEM Agent in the Citrix Platformlayer, but what will change ?
Thank you and greetings
Thomas
George Spiers
October 8, 2018Sounds like you have everything correct. I would reinstall the Agent, double-check the script has been created correctly and configured to run via GPedit.msc, the “Launch Agent at Logon” is checked, and “Enable (Virtual) Desktop Compatibility” is checked.
Also make sure you have configured WEM to include the Organizational Unit of the VDA. The VDA must successfully bind to a Configuration Set in WEM.
Thomas
October 8, 2018Hi George,
I found the error, in the platform layer I only had to start the VuemagentMui.exe once and connect it to the WEM server and then finalize the layer.
Thank you and greetings
Thomas
George Spiers
October 8, 2018Thanks. Have included it in the fix list in case others come across the same issue.
Thomas
September 29, 2018Hi, Geroge,
the Agent service option “Launch on Logon” under the main menu was set correctly.
The OS version Win10 1803 was the base installation, not an update from a previous version. Security updates were installed of course.
Of course I can still uninstall and reinstall the WEM Agent in the Citrix Platformlayer, but what will change ?
Thank you and greetings
Thomas
Akant
October 24, 2018Hi George,
CItrix WEM 4.6 is interfering with the graphics in Citrix applications and causing black squares spread all over the app. Can you please help, thank you
George Spiers
October 24, 2018Personally I would firstly upgrade. WEM 4.6 had various bugs that have been addressed in the latest release.
Nick Panaccio
January 8, 2019Hi George,
With WEM 1808 installed in the Platform Layer, I’m running VUEMUIAgent.exe before finalizing. However, my cache is redirected to a drive that isn’t present until the vDisk is built. I do have an issue with WEM not launching at logon, but I think it’s unrelated to this, but wanted your opinion: would it be beneficial to also launch VUEMUIAgent.exe in the final vDisk (I have to crack it open anyway) and refresh the cache? The computer objects that are generated when I build the layers are not in any WEM configuration set, so I was thinking of adding my Master target device to a set if I went this route.
George Spiers
January 8, 2019Hi Nick
I personally don’t bother running the WEM agent before finalising. Another thing I don’t do is redirect the WEM cache to a persistent drive. There has been some discussions around this in the past regarding whether this should be done or not and there is really no benefit to redirecting the cache. However if you prefer to do that, that is fine.
However just to reclarify, I’ve not had any issues with not launching the agent before finalisation of a Platform Layer.
Regarding the agent not launching at logon, I would suggest three things:
1. Making sure your VDA Active Directory Organizational Unit is added to WEM under the Configuration Set of your choice.
2. Check the “Enable (Virtual) Desktop Compatibility” and “Launch Agent at logon” options in the WEM console.
3. On your VDAs, create the startup script mentioned under “Agent synchronisation failure when using PVS”, documented here: https://jgspiers.com/citrix-workspace-environment-manager/#Troubleshooting
Nick Panaccio
January 8, 2019Thanks, George. I’m doing everything you listed, right down to the startup script. The issue I’m seeing makes me think that it’s just timing. WEM appears to attempt to contact the broker baked into the registry before my GPO [setting the correct broker] applies. It’s entirely random, and Citrix’s suggestion was pulling the baked in registry key. I swear I started out that way with the same results, but I’ll find out tomorrow when I resume testing.
Ray
January 24, 2019Hey George,
Curious if you ever seen this before…….. We run WEM 4.5, WEM will apply fine most of the time, But then at times, it appears that it will not apply new settings. For example I will go and delete a regkey that I push through WEM. I then refresh the Agent on the VDA or from the WEM console. It will not put the key back. At that time I delete the key HKEY_CURRENT_USER\Software\VirtuAll Solutions\VirtuAll User Environment Manager\Agent\. Then the settings will apply again. Then it will work for a while, and happen again. I am kinda lost why?
George Spiers
January 26, 2019Have you checked the Agent logs under %UserProfile% to see if anything of use is logged? Have you enabled setting “Use Cache Even If Online”?.
Ray
February 5, 2019I had the Revert Registry values set. When would undo them . Boy I really need to pay attention.
On this note, I just got off the phone with Citrix. For 2 weeks I been having item not being pinned to the taskbar when the user logs back in. I have the Correct exclusions for it to follow the user. Upon troubleshooting when the WEM agent is stopped. Then the user logs in. Pinned Items then appear. When its running, no items. Curious if you ever seen this.
George Spiers
February 7, 2019Is WEM modifying the taskbar at all? You can pin programs to the taskbar via WEM for example. I typically modify the taskbar (W10/WS2016) using an XML file and the Group Policy setting “Start Layout”.
Christian
February 11, 2019Hi George,
there is a private fix about the issue.
“When creating an Application action and selecting an Icon File by browsing to C$ on the VDA that has the application installed, the file path remains pointed to the UNC path you browsed to rather than converting to the local path. This causes the application shortcut on the VDA to display a white icon.”
Refere to case number 78695850.
Regards,
Christian
George Spiers
February 12, 2019Thanks Christian, have updated the table.
Bård
October 19, 2020Hello. Thank you for a very nice article. Our company is currently having an issue where the WEM sessions crash immediately after start form Citrix Workspace APP, if we use more than 1 or 2 external screens.
I have written a lengthy article but have as of yet not received any answers on the Citrix forums, and was wondering if you might have heard of the problem, and know the reason for this happening.
Thank you so much in advance.
https://discussions.citrix.com/topic/409842-problem-with-workspace-app-when-using-more-than-2-screens/