Title Page Previous Next Contents Index | Installing the 2X Terminal Server Agent

Installing the 2X Terminal Server Agent

2X Terminal Server Agent System requirements

Windows 2000 Server, 2003 Server or 2008 Server or Advanced Server with Terminal Services enabled (in Application Mode if using Windows 2000 Server).
The same hardware requirements as specified by Microsoft when deploying a terminal services environment will apply.

Installing the 2X Terminal Server Agent remotely from 2X Console

2X VirtualDesktopServer offers the facility to install the 2X Terminal Server Agent on each Terminal Server remotely from the 2X Console. This feature gives you the facility to control each Terminal Server from one central place.

In order to be able to install the 2X Terminal Server Agents remotely, you must make sure that:

You have administrative credentials to be able to install the required service.
The service ‘server’ is running on the Terminal Server where you intend to install the Terminal Server agent. This service is offered by MS Windows and is used for file, print, and named-pipe sharing over the network. This service is used to install the 2X Terminal Server Agents remotely.

Launch the 2X VirtualDesktopServer Console and select the Terminal Servers category.

Figure 15 - Terminal Server page to add additional Terminal Server agents

Click the ‘Find...’ button to find the available Terminal Servers or Citrix Servers. All Terminal Servers and Citrix Servers within your domain will appear on the list of available servers to your farm. The ‘Agent’ status column gives the ability to identify whether the 2X Terminal Server Agent is installed or not. Therefore ‘Agent OK’ indicates that the 2X Terminal Server Agent is installed on the particular Server while ‘Agent not found’ indicates that the 2X Terminal Server Agent is not installed and you‘ll need to install it if you intend to use this particular server in your farm.

Figure 16 - Choose a Terminal Server to install agent

Select the Terminal Server where you would like to install the 2X Terminal Server Agent and click ‘Install Agent’.

Enter administrative credentials to access the remote server.

Figure 17 - Enter administrative credentials to install the 2X Terminal Server agent

Click ‘Install’ after you’ve entered the administrative credentials. You should note that service is installed successfully if the installation is done completely.

Figure 18 - 2X Terminal Server agent Installation process

Click ‘Done’ when finished.

Installing the 2X Terminal Server Agent Manually

Before starting the installation procedure, please make sure that you are logged on with administrator rights, and that the system requirements are met.

Log on to the Terminal Server or Citrix Server
Run the 2X Terminal Server Agent setup program by double clicking on the ‘2XAppServer-LoadBalancer.msi’ file. A welcome dialog will appear. Close other Windows programs and click ‘Next’.

Figure 19 – 2X Terminal Server Agent Setup Program welcome screen.

Accept the License Agreement and click ‘Next’.

Figure 20 – The EULA.

Select the location where you want to install the 2X Terminal Server Agent and click ‘Next’.

Figure 21 – Choosing the location where 2X Terminal Server Agent will be installed.

First select the ‘Custom’ radio button as the Installation type.

Figure 22 – Select Installation type: Custom.

Select ‘2X Terminal Server Agent’ only as shown in the figure below and click ‘Next’.

Figure 23 – Select Installation type: Custom - 2X Terminal Server Agent.

To start the actual installation process, simply click ‘Install’.

Figure 24 – Starting the installation program.

Setup will copy the required files and will create the service on the machine. After finishing you will see the status screen.

Figure 25 – Post-Installation status screen.

After the installation is complete (remotely or manual), you should see the ‘2X Terminal Server Agent’ service listed under ‘Services’ on the server where the agent has been installed.

Figure 26 – The 2X Terminal Server Agent Service

NOTE: The terminal servers do not require configuration. The agent will collect the information required by the 2X Publishing Agent. Subsequently, the 2X Terminal Server Agent will forward the necessary information to the 2X Publishing Agent using the information collected. To ensure connectivity between 2X Publishing Agent and the terminal servers, after installing the 2X Terminal Server Agent, go to the Console GUI and on the Terminal Servers tab make sure you add all your terminal servers. Once you have finished this step, select a terminal server (one at a time) and press the ‘Check Agent’ button. If the 2X Publishing Agent can communicate with the 2X Terminal Server Agent running on the terminal server, you will receive this message:

Figure 27 – Checking for 2X Terminal Server Agent on a terminal server.