Product Documentation

System requirements

Software prerequisites

.NET Framework 4.5.2 or later. This is the required by all Workspace Environment Management components.

Microsoft SQL Server Compact 3.5 SP2: SQL Server Compact is used by Workspace Environment Management to cache settings, primarily for use in offline mode. It must be installed on the infrastructure server. Install SQL Server Compact on any agent environment to allow the agent to cache settings and run when it is in offline mode. If SQL Server Compact is not already installed, it is installed during infrastructure services installation.

Microsoft Sync Framework 2.1. This is necessary for all Workspace Environment Management components. If not already installed, this prerequisite is installed during installation.

Microsoft SQL Server 2008 R2 or later: Workspace Environment Management requires sysadmin access to a SQL Server instance to create its database, and read/write access to this database to use it. The SQL Server instance must use case-insensitive collation, otherwise database creation or upgrade will fail.

Microsoft Active Directory: Workspace Environment Management requires read access to your Active Directory to push configured settings out to users. Administrative access is required to configure the agent.

Citrix License Server 11.14: Workspace Environment Management requires a Citrix license. Citrix licenses are managed and stored on Citrix License Servers.

Citrix XenApp and XenDesktop. Any supported version of XenApp or XenDesktop is required for this release of Workspace Environment Management.

Citrix Receiver for Windows. To connect to Citrix StoreFront store resources that have been configured from the Workspace Environment Management administration console, Citrix Receiver for Windows must be installed on the administration console machine and on the agent host machine. The following versions are required:

  • on administration console machines the following Citrix Receiver for Windows versions are supported: 4.9 LTSR or later, and 4.10 or later
  • on agent host machines the following Citrix Receiver for Windows versions are supported: 4.4 LTSR CU5, 4.7, 4.9, 4.9 LTSR CU1, and 4.10

For Transformer kiosk-enabled machines, Citrix Receiver for Windows must be installed with single sign on enabled, and configured for pass-through authentication. For more information, see Citrix Receiver documentation.

Operating system prerequisites

Infrastructure services

  • Windows Server 2008 R2 SP1
  • Windows Server 2012
  • Windows Server 2012 R2
  • Windows Server 2016

Note

Running Workspace Environment Management infrastructure services on a pool of servers (infrastructure servers) with different operating system versions is supported. To upgrade the operating system of an infrastructure server, first install the infrastructure service on a different machine with the new operating system, manually configure it with identical infrastructure service settings, then disconnect the ‘old’ infrastructure server.

Administration console

  • Windows Vista SP2 32-bit and 64-bit
  • Windows 7 SP1 32-bit and 64-bit
  • Windows 8.x 32-bit and 64-bit
  • Windows 10 32-bit and 64-bit
  • Windows Server 2008 SP2
  • Windows Server 2008 R2 SP1
  • Windows Server 2012
  • Windows Server 2012 R2
  • Windows Server 2016

Agent

  • Windows Vista SP2 32-bit and 64-bit
  • Windows 7 SP1 32-bit and 64-bit
  • Windows 8.x 32-bit and 64-bit
  • Windows 10 32-bit and 64-bit
  • Windows Server 2008 SP2*
  • Windows Server 2008 R2 SP1*
  • Windows Server 2012*
  • Windows Server 2012 R2*
  • Windows Server 2016*

* The Transformer feature is not supported on server operating systems.

Note

Citrix Workspace Environment Management agents running on server operating systems cannot operate correctly when Microsoft’s Dynamic Fair Share Scheduling (DFSS) is enabled. For information about how to disable DFSS, see CTX127135.

SQL Server Always On

Workspace Environment Management supports Always On availability groups for database high availability based on Microsoft SQL Server. Citrix has tested this using Microsoft SQL Server 2017.

Always On availability groups allows databases to automatically fail over if the hardware or software of a principal or primary SQL Server fails, which ensures that Workspace Environment Management continues to work as expected. The Always On availability groups feature requires that the SQL Server instances reside on the Windows Server failover Cluster (WSFC) nodes. For more information, see http://msdn.microsoft.com/en-us/library/hh510230.

To use Workspace Environment Management by using Always On availability groups:

  1. Create an empty SQL database on your primary SQL Server and back up it.
  2. Create the Workspace Environment Management database. Take care to:
    • choose option Set vuemUser SQL user account password and type a password for the vuemUser SQL user account. You need to provide this password when you add the database to the availability group.
    • for “Server and instance name”, type the name of the availability group listener.
  3. Add the Workspace Environment Management database to an availability group.

Before upgrading a Workspace Environment Management database which is deployed in an SQL Server Always On availability group, remove it from the availability group.

Hardware prerequisites

Infrastructure services (for up to 3,000 users): 4 vCPUs, 8 GB RAM, 80 MB of available disk space.

Administration console: minimum dual core processor with 2 GB RAM, 40 MB of available disk space (100 MB during install).

Agent: average RAM consumption is 10 MB, but we recommend that you provide 20 MB to be safe. 40 MB of available disk space (100 MB during installation).

Database: minimum 75 MB of available disk space for the Workspace Environment Management database.

Service dependencies

Netlogon. The agent service (“Norskale Agent Host service”) is added to the Netlogon Dependencies list to ensure that the agent service is running before logons can be made.

By default, the agent service runs as local SYSTEM, and changing this is not supported.

Antivirus exclusions

Workspace Environment Management agent and infrastructure services are installed in the following default directories:

  • C:\Program Files (x86)\Norskale\Norskale Agent Host (on 64-bit OS)
  • C:\Program Files\Norskale\Norskale Agent Host (on 32-bit OS)
  • C:\Program Files (x86)\Norskale\Norskale Infrastructure Services

On-access scanning must be disabled for the entire “Norskale” installation directory for both the Workspace Environment Management agent and infrastructure services. When this is not possible, the following processes must be excluded from on-access scanning:

In the infrastructure services installation directory

  • Norskale Broker Service.exe
  • Norskale Broker Service Configuration Utility.exe
  • Norskale Database Management Utility.exe

In the agent installation directory

  • Norskale Agent Host Service.exe
  • VUEMUIAgent.exe
  • Agent Log Parser.exe
  • AgentCacheUtility.exe
  • AppsMgmtUtil.exe
  • PrnsMgmtUtil.exe
  • VUEMAppCmd.exe
  • VUEMAppCmdDbg.exe
  • VUEMAppHide.exe
  • VUEMCmdAgent.exe
  • VUEMMaintMsg.exe
  • VUEMRSAV.exe