Installing and Using CTERA Agent in VDI Mode
  • 3 Minutes to read
  • Dark
  • PDF

Installing and Using CTERA Agent in VDI Mode

  • Dark
  • PDF

Article Summary

The CTERA Agent VDI enables you to utilize existing VDI infrastructures, both persistent and non-persistent, by mapping a network drive to the user's data located on the CTERA Portal. CTERA Agent VDI mode enables the user to access all of their data located on the CTERA Portal over the network, without any need to store the data locally, therefore allowing the virtual dynamic desktops to remain lightweight.

Enabling VDI Mode

In order to enable VDI on the machine that will run the agent, it is necessary to load an administrative template (ADM) in the Windows Group Policy Management Editor running on Windows Active Directory.


The following procedure describes installation using a Windows 2012 Active Directory domain. It is similar for other Windows Server versions.

To enable VDI mode:

  1. Obtain the ctera-vdi.adm file from the Download Center.
  2. Open the Windows Group Policy Management console.
  3. Create a new GPO or edit an existing GPO for which you would like to enable VDI mode.
  4. Right-click the policy and select Edit.
    The Group Policy Management Editor is displayed
  5. In the navigation pane, expand Computer Configuration > Policies > Administrative Templates, right-click Administrative Templates and select Add/Remove Templates.
    The Add/Remove Templates window is displayed.
  6. Click Add, browse to the ctera-vdi.adm file, select it and click Open.
    The ctera-vdi.adm file is displayed in the Add/Remove Templates window.
  7. Click Close.
  8. In the navigation pane, expand Computer Configuration > Policies > Administrative Templates > Classic Administrative Templates and click the CTERA Agent Settings node.
  9. Double-click Enable CTERA Agent VDI mode.
    The Enable CTERA Agent VDI mode window is displayed.
  10. Choose the Enabled option.
  11. Click OK.

VDI mode is enabled.

Installing the CTERA Agent

The CTERA Agent can be installed manually or deployed remotely from a centralized location. The following procedure explains how to install the CTERA Agent manually.

To install CTERA Agent:

  1. Double-click the CTERA Agent installation file. The CTERA Agent Setup wizard opens.
  2. Select one of the following:
    Agent per User – The Agent is installed separately for each user the first time the user logs in to the computer.
    • Each user has an independent Agent configuration and can connect to a different CTERA Portal than the other users.
    • Each user has permission to manage their own Agent and can perform backup and restore operations for any files for which they have read/write permissions.
    • Each user’s Agent remains connected to the cloud and continues to perform its scheduled backups and synchronizations in the background, even when the user is not logged in.
    • Each user will have their own cache, not shared with other users.

    Since each user has an independent agent, the agents are displayed as separate agent objects when connected to a portal. Each user is licensed separately.

    Shared Agent for all Users – A single Agent configuration can be shared by all users of the computer. Only users who have Backup Operator permission can configure the agent and perform backup and restore operations.
  3. Click Next.
  4. Read and agree to the End User License Agreement and then continue to click Next and enter relevant information until the installation starts.
  5. When the installation is complete, click Close.
    The CTERA Agent icon, image.png, is installed in the Windows taskbar. The Welcome to CTERA Agent window is displayed.
  6. Enter the CTERA Portal IP address.
  7. Click Continue.
    The CTERA Agent connects to the portal and the window to specify the username and password is displayed.
  8. In the Username and Password fields type your user name and password for accessing the portal and click Sign in.

The CTERA Agent connects to the portal and the icon in the taskbar changes to image.png.

The CTERA Agent maps a local drive on the desktop to the portal.

Once connection and mapping are completed successfully, the CTERA Agent window displays the Cloud Drive's status as Connected.

If the portal is not accessible, the Cloud Drive's status is Not connected to Portal.

The security certificate installed on the portal must be trusted by the PC. If it is not trusted, the Cloud Drive's status will be Not connected to Portal.

Using the CTERA Agent in VDI Mode

Managing the CTERA Agent from the user interface uses WebDAV, which is supported only when two user processes are not running concurrently. That is, only one user is allowed to be logged in to the Windows server concurrently.

To use CTERA Agent to access data on the CTERA Portal:

  • In the CTERA Agent window, click on Open Drive.
    The mapped drive opens in Windows File Explorer and you can work directly with your data on the portal.

Was this article helpful?