Installing
the 2X VDS Agent
2X VDS
Agent System requirements
- Windows
XP, Windows Vista, Windows 2000 Server, Windows 2003 Server or Windows 2008
Server or Advanced Server.
- The
same hardware requirements as specified by your virtualization software will
apply.
- One
of the supported virtualization software
technology.
- If
you are planning to use VMware on Windows, make sure the VMware VmCOM Scripting
API is installed. The following error will be displayed if VmCOM Scripting API
is not detected:
”’VMware VmCom Scripting API’ is not
installed on the host.
Please install this client component from the VMware
installer.”
- If
you are planning to use VMware on Linux, make sure the VMware VIX API for Linux
is installed. The following error will be displayed if VIX API for Linux is not
detected:
”’VMware VIX API for Linux’ is not installed on
this host.
Please download this component from
http://www.vmware.com”
Installing
the 2X VDS Agent remotely from 2X Console
2X VirtualDesktopServer offers the facility to install
the 2X VDS Agent on each Virtual Desktop Host remotely from the 2X Console. This
feature gives you the facility to control each Virtual Desktop Host from one
central place.
In order to be able to install the 2X VDS 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 Virtual Desktop Host where you
intend to install the 2X VDS 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 VDS Agents
remotely.
- Launch
the 2X VirtualDesktopServer Console and select the Virtual Desktop Hosts
tab.
Figure 15 – Virtual Hosts page to add VDS
agents
- You
can use a similar method to that of installing the 2X Terminal Server Agent or
you can click on ‘Check
Agent’ where a new dialog will load showing you the information
about the 2X VDS Agent on the host you
selected.
Figure 16 – 2X VDS Agent Information
- Click
‘Install’ to start
installing the 2X VDS Agent on the selected host.
- Enter
administrative credentials to access the remote
server.
Figure 17 - Enter administrative credentials to install the
2X VDS agent
- Click
‘Install’ after you’ve
checked and possibly entered the administrative
credentials.
- Click
‘Done’ when finished.
Installing the 2X VDS 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 Virtual Host
- Run
the 2X VirtualDesktopServer 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 VirtualDesktopServer 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 VDS Agent and click
‘Next’.
Figure 21 – Choosing the location where 2X VDS Agent
will be installed.
- First
select the
‘Custom’ radio
button as the Installation type.
Figure 22 – Select Installation type:
Custom.
- Select
‘2X VDS Agent’ only as shown
in the figure below and click
‘Next’.
Figure 23 – Select only the 2X VDS Agent for
installation.
- 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 VDS Agent’ service listed under
‘Services’ on the server where the agent has been installed.
Figure 26 – The 2X VDS Agent Service
NOTE:
The Virtual Desktop Hosts do not require configuration. The agent will collect
the information required by the 2X Publishing Agent. Subsequently, the 2X VDS
Agent will forward the necessary information to the 2X Publishing Agent using
the information collected. To ensure connectivity between 2X Publishing Agent
and the virtual host, after installing the 2X VDS Agent, go to the Console GUI
and on the ‘Virtual Desktop Hosts’ tab make sure you add all your
Virtual Desktop Hosts. Once you have finished this step, select a virtual host
(one at a time) and press the
‘Check
Agent’ button. If the 2X
Publishing Agent can communicate with the 2X VDS Agent running on the Virtual
Desktop Host, you will receive this message:
Figure 27 – Checking for 2X VDS Agent on a Virtual
Desktop Host.
