Update Citrix Workspace Environment Management (WEM) from 4.x to 1811 (v1811.0.1.1)

An update guide for Citrix Workspace Environment Management (WEM) to the latest version 1811.

WEM version

On January 3rd 2019 Citrix released version 1811 of Workspace Environment Management (WEM). This is an update guide.
Customer Success Services / Software Maintenance eligibility date: Nov 14, 2018

Download Citrix WEM 1811 (v1811.0.1.1) here:
https://www.citrix.de/downloads/citrix-virtual-apps-and-desktops/components/workspace-environment-management-1811.html

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

Fixed issues:
https://docs.citrix.com/en-us/workspace-environment-management/current-release/fixed-issues.html

WEM setup files
WEM setup files

Changelog

  • 4 March 2019:
    • Rearranged blog post to prevent Google duplicates
    • Redirected (301) old versions of the post to the latest version
    • Update Citrix Workspace Environment Management (WEM) to 1811 (v1811.0.1.1)
  • 3 August 2018: Update Citrix Workspace Environment Management (WEM) to 4.7 (v4.07.00.00)
  • 18 September 2017: Update Citrix Workspace Environment Management to 4.4
  • 26 Februrary 2017: Update Citrix Workspace Environment Management to 4.2

Infrastructure Service Update

  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.
    WEM infrastructure load balancer
    WEM infrastructure load balancer
  2. Check your WEM Infrastructure Service Configuration and write it down. Especially the passwords. The database upgrade drops the entire configuration. Better stay safe!
    WEM Infrastructure Service Configuration
    WEM Infrastructure Service Configuration
  3. Update your existing Broker through: Citrix Workspace Environment Management Infrastructure Services Setup.exe
    The setup is straight forward, no details from me here.
    Citrix Workspace Environment Management Infrastructure Services Setup.exe
    Citrix Workspace Environment Management Infrastructure Services Setup.exe
  4. Update your existing Administration Console: Citrix Workspace Environment Management Console Setup.exe
    The setup is straight forward, no details from me here.
    Citrix Workspace Environment Management Console Setup.exe
    Citrix Workspace Environment Management Console Setup.exe
  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 once in the past!
    WEM Database Management Utility
    WEM Database Management Utility
  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”
    SQL vuemUser sysadmin
    SQL vuemUser sysadmin
  7. Enter all the information you wrote down during step 2, if the fields aren’t filled in -> Press Upgrade.
    Database Upgrade Wizard
    Database Upgrade Wizard
    Remember, you only have to do this once, not on all your brokers.
    Database Upgrade
    Database Upgrade
  8. After you upgrade the Infrastructure Services, you must reconfigure the Infrastructure Services using the WEM Infrastructure Service Configuration utility. Check WEM Infrastructure Service Configuration, if your connections details were dropped.
    If your settings vanished, enter them again and click Save configuration.
    WEM Infrastructure Service Configuration
    WEM Infrastructure Service Configuration
  9. You should now be able to open the WEM Administration Console once again!
    About WEM Administration Console
    About WEM Administration Console
  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.

Agent Update

  1. 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:
    PDQ Deploy - WEM install
    PDQ Deploy – WEM install
  2. After the Agent upgrade, you have to execute the following commands according to the official upgrade guide:

    or for 32bit operating systems:

    PDQ Deploy - ngen.exe
    PDQ Deploy – ngen.exe
    1. With WEM 4.3 & 4.4 step 12 worked for me without issues. I skipped WEM 4.5 as I had no time, and WEM 4.6 had a few issues, so I waited for WEM 4.7. This time I tried the steps, as the official Guide suggests, but it generated many errors. I don’t know how to interpret them, yet.

       

    2. When updating from a WEM version lower than 4.5, you might receive the following error:
      AgentCacheUtility.exe
      AgentCacheUtility.exe

       

      There is already a very detailed guide by Srinivasan Shanmugam at the mycugc Blogs, which describes a possible cause to this issue: WEM Agent v4.5 Upgrade Issues

    3. Example command line steps to push and automate stuff:
  3. You can verify your Agent <-> Broker connection through the following command. The Brokername has to be a FQDN:
    AgentCacheUtility.exe
    AgentCacheUtility.exe

     

     

  4. 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.
    ADMX files
    ADMX files

     

  5. Congratulations, your Citrix Workspace Environment Management is now on the latest version!
    WEM Agent statistics
    WEM Agent statistics

Additional Notes

If you should encounter further errors, check the Windows Eventlogs and consider enabling the WEM Agent Debug Log:
CTX219839: How to Enable Debug Logging on Workspace Environment Management Agent manually, if no connectivity to Broker exists

Source: Official Citrix Workspace Environment Management Upgrade Guide
https://docs.citrix.com/en-us/workspace-environment-management/current-release/upgrade.html

That’s it! Feel free to leave me a comment if you have any questions.

This blog article was previously published on mycugc.org:
https://www.mycugc.org/blogs/cugc-blogs/2018/07/20/how-to-update-citrix-workspace-environment-managem

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.