WEM Upgrade Process

WEM Upgrade Process

Upgrading citrix WEM


With the latest release of WEM 4.5, I figured I would take the chance to document a how to guide on upgrading the WEM Components in the safest fashion.

It is critical that you disable Mirroring of the Database prior to any WEM upgrades.

Step 1. Backup your Environment. A simple SQL backup job is fine for the WEM DB.


And I like to snapshot my broker server/s.


Step 2. Document your WEM Infrastructure Service Configuration. This is wiped after an upgrade (Note this is the last time you will need to do this via the GUI, moving forward you can use PowerShell)

Launch the Infrastructure Service Configuration:

C:\Program Files (x86)\Norskale\Norskale Infrastructure Services\Norskale Broker Service Configuration Utility.exe

Take note of the following Settings in particular Database, Network Settings (if you customised ports), Advanced Settings, Licencing. DB Maintenance most people leave as defaults


Database Settings Node


Network Settings Node


Advanced Settings Node

Step 3. Once you have completed your preparation steps, you can run through the simple upgrade.

Start with the Console:

\Workspace-Environment-Management-v-4-05-00\Citrix Workspace Environment Management Console Setup.exe


Follow the defaults, there is nothing of concern here.

Next we move to the infrastructure services

\Workspace-Environment-Management-v-4-05-00\Citrix Workspace Environment Management Infrastructure Services Setup.exe


Leave as the defaults, this just updates the actual services and we will configure shortly Once complete, launch the DB Management Utility (This can be done via PowerShell moving forward from this release)


Select to Upgrade the Database


Make sure here to specify the Correct DB as noted in your first steps - if you have multiple (Unlikely however I do) make sure you run through this for all DB’s


Once DB has been upgraded we can move on


C:\Program Files (x86)\Norskale\Norskale Infrastructure Services\Norskale Broker Service Configuration Utility.exe

Repopulate with all values that you took note off in the initial tests and allow the services to restart


Repeat for each node in your environment Launch the console and confirm access and versions


As mentioned, you can now view your service configuration via PowerShell using the Get-WemInfrastructureServiceConfiguration Commandlet


Now it’s time to update your Target Agents. Note that there is no urgency here, the older agents will report into upgraded WEM with no issues

Follow whatever unsealing process for whatever provisioning technology you use Run the updated installer program - this can be run as an in place upgrade:

\Workspace-Environment-Management-v-4-05-00\Citrix Workspace Environment Management Agent Setup.exe

Accept defaults, there is no magic here


Your WEM Services will stop and restart during the process. Once installed, you can confirm your version


Once installed it is always important to run the ngen drain tasks.

I personally use BIS-F for any sealing work, but the manual process is outlined below. C:\Windows\Microsoft.NET\Framework\v4.0.30319\ngen.exe update C:\Windows\Microsoft.NET\Framework64\v4.0.30319\ngen.exe update C:\Windows\Microsoft.NET\Framework\v4.0.30319\ngen.exe eqi 1 C:\Windows\Microsoft.NET\Framework64\v4.0.30319\ngen.exe eqi 1 C:\Windows\Microsoft.NET\Framework\v4.0.30319\ngen.exe eqi 3 C:\Windows\Microsoft.NET\Framework64\v4.0.30319\ngen.exe eqi 3


Once completed you can reseal your image, when the WEM agent reports in, you should now see the new version


And you are good to go