HowTo: Update Citrix Workspace Environment Management from 4.x to 4.4 (v4.04.00.00)

A short HowTo about the Citrix WEM Upgrade process for version 4.4

Download Citrix WEM 4.4 (v4.04.00.00) here:

What’s new:

  1. If you load balance your WEM Infrastructure Services Broker, consider disabling the broker you update. Otherwise it’s no big problem, the agents cache the configuration.

  2. Check your Broker Service Configuration and write it down. My upgrade dropped the entire configuration. Better stay safe!

  3. Update your existing Broker through: Citrix Workspace Environment Management Infrastructure Services v4.04.00.00 Setup.exe
    The setup is straight forward, no details from me here.
  4. Update your existing Administration Console: Citrix Workspace Environment Management Administration Console v4.04.00.00 Setup.exe
    The setup is straight forward, no details from me here.
  5. Start the WEM Database Management Utility from the Start Menu, choose Upgrade Database. Make sure you have a current backup of your database! I needed it!

  6. Keep caution, the following Citrix Document states, that the SQL vuemUser needs temporary SQL sysadmin permissions. Otherwise the upgrade will fail. If your upgrade fails, you find the log file in -> “C:\Program Files (x86)\Norskale\Norskale Infrastructure Services\Citrix WEM Database Management Utility Debug Log.log”
  7. Enter all the information you wrote down during step 3 -> Press Upgrade.
    Remember, you only have to do this once, not on all your brokers. 

  8. Check Broker Service Configuration if your connections details were dropped, if not, you are half way through!
    If your settings vanished, enter them again and click Save configuration
  9. You should now be able to open the WEM Administration Console once again!

  10. If you have multiple WEM Broker, it’s time to switch the active Service Group Members and repeat Steps 3 & 4.
    If not, it’s time to update the agents.
  11. Either you deploy them manually on each server. The setup is straight forward, no details from me here.
    Or you deploy the agent silent with your favorite software distribution tool:
    Citrix Workspace Environment Management Agent Host v4.04.00.00 Setup.exe /s /v"/qn /norestart"

  12. After the Agent upgrade, you have to execute the following commands according to the official upgrade guide:
    C:\Windows\Microsoft.NET\Framework64\v4.0.30319\ngen.exe update
    C:\Windows\Microsoft.NET\Framework64\v4.0.30319\ngen.exe eqi 3
    or for 32bit operating systems:

  13. You can verify your Agent <-> Broker connection through the following command the Brokername has to be a FQDN:
    "C:\Program Files (x86)\Norskale\Norskale Agent Host\AgentCacheUtility.exe" -refreshcache

  14. And last but not least you have to replace the ADMX definition files in your central store. If there are any older ADMX oder ADML files, delete them.

  15. Congratulations, your Citrix Workspace Environment Management is now on version 4.4!

Author: Marco

Marco is an IT-System administrator and IT-Consultant with 10+ years experience. He is specialized in the delivery of virtual Apps and Desktops with Citrix solutions. In 2017 he has been awarded Citrix Technology Advocate by Citrix for his community work (#CTA). His second core area is availability & performance monitoring with Zabbix, a leading open-source solution. His employer is the German IT-Company ANAXCO, which is developing a Transport Management Software (TMS) based on Microsoft Dynamics AX. More about Marco

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.