Administration console
Install the administration console
Note:
If you intend to assign resources published in Citrix StoreFront stores as application shortcuts in Workspace Environment Management from the administration console, ensure that Citrix Workspace app for Windows is installed on the administration console machine and on the agent host machine. For more information see System requirements.
Run Citrix Workspace Environment Management Console.exe on your administrator console environment.
You can choose a silent installation or upgrade of the infrastructure services. For example:
-
.\Citrix Workspace Environment Management Console.exe
/quiet ConsoleLocation="C:\test\Administration Console" /log "C:\test\test.log" -
/quiet ConsoleLocation="C:\test\Administration Console" /log "C:\test\test.log"-
/quiet. Indicates silent mode. -
/log. Indicates logging file location. -
ConsoleLocation. Indicates the installation path for the administration console.
-
Create an infrastructure server connection
In the Start menu select Citrix®>Workspace Environment Management™>WEM Administration Console. By default, the administration console launches in a disconnected state.
In the ribbon, click Connect to open the New Infrastructure Server Connection window.

Enter the following values and click Connect:
Infrastructure server name. The name of the Workspace Environment Management infrastructure server. It must resolve from the administration console environment exactly as you type it.
Administration port. The port on which the administration console connects to the infrastructure service.
The first time you connect to a new database, you see the following message because a Citrix License Server with valid licenses is not yet configured:

Configure the database with a license server
To configure the database with a license server, in the administration console ribbon, click About, then click Configure License Server and enter your Citrix License Server details. The Citrix License Server address must resolve from the administration console environment exactly as entered.

Note:
To activate Workspace Environment Management (WEM) using the License Activation Service (LAS), accept its security certificate by clicking Accept in the dialog box that appears after you click OK to save changes.
Troubleshoot LAS licensing issues
If you encounter LAS licensing issues, check the license server status in Citrix Cloud. If the status is not green, review activation details to identify the cause.
-
Sign in to Citrix Cloud with your account.
-
Go to Licensing > Licensed Deployments > License Servers.
-
Expand Workspace Environment Management to view the list of activations:
- ID: Machine SID
- License Server connectivity: Connected or Lost connection
-
Last successful connection: Time of the most recent successful connection

-
Click … > View Details for an activation to review detailed information:
-
Product & Version: Product_Edition_Model and BurnInDate used when activating with LAS. BurnInDate is usually the product release date
-
WEM Deployment: Deployment ID
-
WEM Instance: Machine SID
-
HostID: Machine SID
-
LasUniqueEnvID: Unique ID of the instance for which LAS provides activation

-
Import quickstart settings
Workspace Environment Management includes XML files which you can use to pre-configure your Workspace Environment Management database so that it is proof-of-concept-ready out of the box. The XML files are provided in the folder “Configuration Templates” in the Workspace Environment Management installer package.
To import the quickstart setting files, in the Home ribbon click Restore:

In the Restore Wizard, select Settings and click Next.

In the Restore Wizard, select the folder “Configuration Templates” containing the quickstart setting files, and then select all Setting Types.