HowTo: Update Citrix Workspace Environment Management (WEM) from 4.x to 4.7 (v4.07.00.00)

A HowTo about the Citrix Workspace Environment Management (WEM) Update process for version 4.7

On July 18th 2018 Citrix released version 4.7 of Workspace Environment Management (WEM). This is an update guide.
Customer Success Services / Software Maintenance eligibility date: May 18, 2018

Download Citrix WEM 4.7 (v4.07.00.00) here:
https://www.citrix.com/downloads/xenapp-and-xendesktop/components/workspace-environment-management-47.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

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.

  2. Check your WEM Infrastructure Service Configuration and write it down. Especially the passwords. The database upgrade drops the entire configuration. Better stay safe!

  3. Update your existing Broker through: Citrix Workspace Environment Management Infrastructure Services Setup.exe
    The setup is straight forward, no details from me here.

  4. Update your existing Administration Console: Citrix Workspace Environment Management Console 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 once in the past!

  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 2, if the fields aren’t filled in -> Press Upgrade.
    Remember, you only have to do this once, not on all your brokers.

  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.

  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.

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:

  2. After the Agent upgrade, you have to execute the following commands according to the official upgrade guide:

    or for 32bit operating systems:

  3. 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 yet how to interpret them.

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

    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

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

     

  6. 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.

  7. Congratulations, your Citrix Workspace Environment Management is now on version 4.7!

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/blog/howto-update-citrix-wem-from-4.x-to-4.7

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.