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:
https://www.citrix.com/downloads/xenapp-and-xendesktop/components/workspace-environment-management-44.html

What’s new:
https://docs.citrix.com/en-us/workspace-environment-management/current-release/whats-new.html

  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:
    C:\Windows\Microsoft.NET\Framework\v4.0.30319\ngen.exe

  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 -brokername:citrix-wem.int.anaxco.de

  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

Gelernter Fachinformatiker für Systemintegration (2010) CCA für XenServer 5.0 (2009) CCA für XenApp 5.0 (2011) CCA für XenApp 6.5 (2013) CCAA für XenApp 6.5 (2013) CCA für XenDesktop 5 (2013) Dell Wyse ThinOS Select Techniker (2011) Igel Authorized Partner (2009-2014) Intensivkurs “Group Policy Administration” Windows 7, 8.x sowie Windows Server 2008-R2 / 2012-R2 bei NT Systems, Dipl.-Ing. T. Pham (2014) Zu Gast auf der E2EVC Virtualization Conference in Berlin (2015) Zu Gast auf der Citrix Technology Exchange in Berlin (2016) Citrix Certified Associate – Networking (CCA – N) (2016) Citrix Certified Professional – Networking (CCP – N) (2017)

Leave a Reply

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