Product Documentation

Upgrade a deployment

May 22, 2017

Introduction

You can upgrade certain deployments to newer versions without having to first set up new machines or Sites; this is called an in-place upgrade. You can upgrade:

  • From Workspace Experience Manager version 4.2 to the latest released (current) version
  • From Workspace Experience Manager version 4.1 to the latest released (current) version
  • From Workspace Experience Manager version 4.0 to the latest released (current) version

The Workspace Environment Management components must be upgraded in the following order:

  1. Infrastructure services
  2. Database
  3. Administration console
  4. Agent

Step 1: Upgrade the infrastructure services

To upgrade the Workspace Environment Management infrastructure services, run the new Workspace Environment Management infrastructure services setup on your infrastructure server. The upgrade procedure is otherwise identical to the installation procedure.

Note: Remember to reconfigure the Workspace Environment Management infrastructure services after the database upgrade completes.

Step 2: Upgrade the database

Important

The database upgrade process is not reversible. Ensure that you have a valid database backup before launching the upgrade process.

To upgrade the database, use the Norskale Database Management Utility. This utility is installed on your Workspace Environment Management infrastructure server during the infrastructure services installation process.

Note: If you are using Windows authentication for your SQL Server, run the database upgrade utility under an identity that has sysadmin permissions.

1. From the Start menu select Citrix>Workspace Environment Management>Database Management>Database Management Utility.

2. Click Upgrade Database.

localized image

Server and instance name. Address of the SQL Server\instance on which the database is hosted. It must be reachable exactly as entered from the infrastructure server.

Database name. Name of the database to be upgraded.

Infrastructure service uses Windows authentication.

When this option is cleared (the default) the database expects the infrastructure service to connect to it using the vuemUser SQL user account. The vuemUser SQL user account is created by the installation process. This requires Mixed-Mode Authentication to be enabled for the SQL instance.

When this option is selected, the database expects the infrastructure service to connect to it using a Windows account. In this case the Windows account you select must not already have a login on the SQL instance. In other words, you cannot use the same Windows account to run the infrastructure service as you used to create the database.

The option Use integrated connection is selected by default. It allows the wizard to use the Windows account of the identity it is running under to connect to SQL and create the database. If this Windows account does not have sufficient permissions to create the database, you can either run the database management utility as a Windows account with sufficient privileges, or you can clear this option and provide an SQL account with sufficient privileges instead.

Click Upgrade to start the database upgrade process. Once you are notified that the database upgrade has completed successfully, you can exit the application.

If there are errors during the database upgrade, please check the VUEM Database Management Utility Log file in your Workspace Environment Management infrastructure services installation directory.

Step 3: Upgrade the administration console

Note

All Workspace Environment Management settings you have configure with the Administration Console are stored in the database and are preserved during upgrade.

To upgrade the administration console, run the administration console setup executable. The procedure is otherwise identical to the installation procedure.

Step 4: Upgrade the agent

Note

Before upgrading an agent host machine, make sure there are no users logged in. This ensures that the upgrade process can modify the files on that machine.

To upgrade the agent, run the new agent setup executable on the target machine.

After upgrading the agent (via installer or private patch) run the following two commands to ensure that the Agent .dll files are correctly precompiled:

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\ngen.exe update

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\ngen.exe eqi 3

(Please note that for 32-bit operating systems, the path is instead
C:\Windows\Microsoft.NET\Framework\v4.0.30319\ngen.exe).

By design, agents are backward-compatible within the same major release version.