Installing
2X ApplicationServer & LoadBalancer Client for Windows
2X
ApplicationServer & LoadBalancer Client System requirements
- Windows
2000, XP, Vista.
- The
same hardware requirements as specified by Microsoft when using any of these
workstation OSs
- Some
features (like high color, sound, etc) will only be available if your
workstation has the appropriate hardware installed and properly
configured.
Installing
2X ApplicationServer and LoadBalancer Client
Before you run the installation procedure please make
sure that you are logged on as Administrator and the system requirements are
met.
1. Run the 2X ApplicationServer & LoadBalancer Client
setup program by double clicking on the
‘2XAppServer-LoadBalancer-Client.msi’
file on the client machine. A welcome dialog will appear. Close other Windows
programs and click
‘Next’.
Figure 114 – 2X ApplicationServer & LoadBalancer
Client Setup Program welcome screen.
2. Accept the License
Agreement and click
‘Next’.
Figure 115 – The EULA.
3. Select the location where you want to install the 2X
ApplicationServer & LoadBalancer Client and click
‘Next’.
Figure 116 – Choosing the location where the 2X
ApplicationServer & LoadBalancer Client will be installed.
4. To start copying files click
‘Install’.
Figure 117 – Starting the installation program.
5. Click ‘Yes’ to install the ‘Single
Sign-On’ component. This component will use your credentials to connect
with the 2X ApplicationServer.
Figure 118 - Installing Single Sign-On
6. Setup will copy the required files. After finishing
you will see the status screen.
Figure 119 – Post-Installation status screen.
Installing
the 2X ApplicationServer Client silently
By using the MSI format, administrators can now deploy
the 2X ApplicationServer & LoadBalancer client remotely by using Group
Policies or any other deployment tool that accepts the MSI format. This greatly
simplifies the amount of work to install the 2X ApplicationServer &
LoadBalancer Client on all remote computers and reduces the chances of user
error during the installation process.
The MSI can be deployed in many different ways (Group
Policies, SMS, Altiris and even a simple login script). It is not the scope of
this administration guide to cover every single option available. Make sure you
consult your application manual for more information about deploying MSI
packages remotely.
Using
Active Directory
There are two different ways that you can deploy an
application through the Active Directory. You can either publish the application
or you can assign the application. You can only publish applications to users,
but you can assign applications to either users or to computers. The application
is deployed in a different manner depending on which of these methods you use.
In this case we do recommend administrators assigning the application to
COMPUTERS. The main reason for that is in this case the application is actually
installed the next time the computer reboots. When assigning to users, the
application is not installed until the user actually clicks on the icons created
for the application.
To assign an application to certain computers simply do
the following on your Active Directory:
- Open
the Group Policy Editor.
- To
assign an application to a computer, navigate through the group policy console
to Computer Configuration | Software Settings | Software Installation. Now,
right click on the Software Installation container and select the New | Package
commands from the shortcut menu. Select the appropriate MSI file and click Open.
You are now asked whether you want to publish or assign the application. Select
assign and click OK.
NOTE:
When doing a silent installation, the MSI can be deployed using the following
syntax (one single line):
msiexec /qn /i
2XAppServer-LoadBalancer-Client.msi SERVER=”X.X.X.X”
BACKUPSERVER=”X.X.X.X” SERVERPORT=Y COLORDEPTH=COLORS
USERNAME="username" CLEARPASSWORD="UserPassword" DOMAIN="YourDomainName"
Detailed explanation of 2X
ApplicationServer & LoadBalancer Client options
General Settings
ALLOWRECONNECT:
Enable the client to reconnect automatically to a session in the event of
a network error.
- 0
– Disable automatic reconnection
- 1
– Enable automatic
reconnection
AUTOHIDE: Hide
Launcher when application is launched
- 0
– Auto hide is disabled
- 1
- Auto hide is
enabled
ALWAYSONTOP:
2X ApplicationServer & LoadBalancer Client behavior to stay on top of
other applications.
- 0
– Always on top behavior is disabled
- 1
– Always on top behavior is
enabled
AUTOLAUNCH:
Launch automatically at Windows startup
- 0
– Disable auto launch
- 1
– enable auto launch
CHECKUPDATELAUNCH:
To enable or disable the checking of updates of client on launch.
- 0
– Do Not Check for updates on startup
- 1
– Check for updates on
startup
UPDATECLIENTXML:
The URL which contains information about the latest 2X ApplicationServer
client.
VIEWMODE: The
mode in which to view the listed applications.
- 0
– Icons View
- 1
– Tile View
- 2
– List View
- 3
– Tile List View
- 4
– Details
View
DNSLBENABLED: To
enable DNS load balancing if the 2X Client Gateway specified on the client has
more than one IP assigned for the same host.
For example in such a case where the host name
‘roundrobinhost.company’ is configured with the following IP
addresses ‘192.168.0.5; 192.168.0.6; 192.168.0.7’, the 2X Client
will use a different IP each time it makes a new connection if this option is
enabled.
CONNTIMEOUT: The
amount of time before the client time out the connection if a connection is not
successful. The default setting is 20 seconds and the option can be increased
for connections with high latency.
SSLNOWARNING: Do
not warn if server certificate is not verified.
- 0
– Display warning message
- 1
– Do not display warning
message
IGNORERESCHECK:
Option to ignore the resolution check.
DISABLEOPTIONS:
To disable the Options button and hide the options to configure the
client settings. This option can be applied to users without administrative
rights.
- 0
– Options are enabled
- 1
– Options are disabled
DISABLEOPTIONSADMIN:
To disable the Options button and hide the options to configure the
client settings. This option can be applied to users with administrative
rights.
DISABLESAVEPASSWORDADMIN:
To disable the clients from saving the password even if they have
administrative rights.
- 0
– Option to save password is
enabled
- 1
– Option to save Password is
disabled
DISABLESAVEPASSWORD:
To disable the clients from saving the password. This option is ignored
with users with administrative rights.
- 0
– Option to save password is
enabled
- 1
– Option to save Password is
disabled
SHOWFOLDERS: Show
Folders page.
- 0
– Do not show Folders page
- 1
– Show Folders page
SPANDESKTOPS:
Span Published desktops on all monitors.
- 0
– Do not span desktops on all monitors
- 1
– Span desktops on all
monitors
LANGUAGE: Specify
the language.
- 0
– Default Language
- 1
– English
- 2
– German
- 3
– Japanese
- 4
–
Russian
DONTPROMPTAUTOADDFARM:
Don’t Show prompt message when adding auto farms.
- 0
– Show prompt messages
- 1
– Do not show prompt
messages
AUTOADDFARM: Add
farm automatically when starting web or shortcut items.
- 0
– Do not add farm automatically
- 1
– Add farm automatically
MINIMIZETOTRAYONCLOSE:
Minimize to tray on close or escape.
- 0
– Close 2X Client
- 1
– Minimize 2X Client to tray
AUTOREFRESHFARMS:
Option to automatically refresh the farms listed in the client.
- 0
– Do not automatically refresh farms
- 1
– Automatically refresh
farms
AUTOREFRESHTIMER:
The time taken to refresh the farms if the ‘AUTOREFRESHFARMS’
is enabled. The time should be specified in minutes and default value is 60
minutes.
SMARTSIZING:
Enable desktop smart sizing.
- 0
– Disable Smart Sizing
- 1
– Enable Smart
Sizing
PRINTFORMAT:
Format of printing
data.
PRINTOPTION:
Default client settings on client for 2X Universal Printing.
- 0
- Print to default printer
- 1
– Select printer before printing
- 2
– Use printer specified in the ‘PRINTERNAME’ field
- 3
– View document to
print
PRINTERNAME:
String value of the default printer to be used
Farm Settings - Connection
CONNECTIONMODE:
Connection Mode Settings.
- 0
- Regular Gateway
- 1
- Direct Mode
- 2
- SSL Mode
SERVERPORT:
TCP port number in use for the 2X ApplicationServer application list
retrieval. You must enter the number in use. E.g. 80.
SAVEPASSWORD: To
save password in the logon options
- 0
– Do not save Password
- 1
– Save Password
ENABLEAUTOLOGON:
- 0
– Auto Logon disabled
- 1
– Auto Logon enabled
SSO: To enable
Single Sign-On
- 0
– Do not use System Credentials (SSO)
- 1
– Use System Credentials
(SSO)
SERVER:
IP address or name of the 2X ApplicationServer & LoadBalancer [the
location of 2X client Gateway Service].
BACKUPSERVER:
IP address or name of a secondary 2X ApplicationServer &
LoadBalancer. (2X Client Gateway Service).
ALIAS:
Create rename Alias for UI purpose
USERNAME2X:
The username to be used when logging in to your terminal servers and the
username to retrieve the list of applications.
DOMAIN: The
domain name used for authentication.
Farm Settings – Advanced Settings
COLORDEPTH: The
number of color bits to be used.
- 0
- 256 colors
- 1
- High Color 15bit
- 2
- High Color 16bit
- 3
- True Color 24bit
USECLIENTCOLORS:
Use client system colors.
- 0
- Do Not Redirect Client Colors
- 1
- Redirect Client
Colors
USECLIENTSETTINGS:
Use client system settings (border size, fonts, etc).
- 0
– Do not redirect system settings
- 1
– Redirect Client System
settings
CREATESHORTCUTS:
Create shortcuts configured on server
- 0
– Do not create shortcuts configured on server
- 1
– Create shortcuts configured on
server
REGISTEREXT:
Register file extensions associated form the server
- 0
– Disable registration of file extensions associated from the
server
- 1
– Enable registration of file extensions associated from the
server
URLREDIRECTION:
Redirect URLs to client
- 0
– Do not redirect URL to clients
- 1
– Redirect URL to clients
MAILREDIRECTION:
Redirect MAIL to client
- 0
– Do not redirect MAIL to clients
- 1
– Redirect MAIL to clients
ENABLERECONNECTION:
Reconnect if
connection drops
- 0
– Do not connect
- 1
– Reconnect
Farm Settings – Local
Resources
KEYBOARD: Where
to apply key combinations.
- 0
– On the local Computer
- 1
– On the remote Computer
- 2
– In full screen mode only
AUDIOMODE:
Options for Remote computer sound.
- 0
- Bring to this computer
- 1
- Do not play
- 2
- Leave at remote computer
REDIRECTCOMPORTS:
To redirect local serial ports on to the remote computer.
- 0
– Redirect Serial Ports OFF
- 1
– Redirect Serial Ports
ON
REDIRECTDRIVES:
To redirect local disk drives on to the remote computer.
- 0
– Redirect drivers OFF
- 1
– Redirect drivers ON
REDIRECTPRINTERS:
To redirect local printers on to the remote computer.
- 0
– Printer redirection OFF
- 1
– Printer redirection ON
REDIRECTSMARTCARDS:
To redirect smart cards on to the remote computer
- 0
– Smart Card redirection OFF
- 1
– Smart Card redirection ON
Farm Settings – Experience
EXP_DESKTOPBG: Desktop background
EXP_FONTSMOOTHING: Font smoothing
EXP_WINDOWMENUANIMATION: Menu and window animation
EXP_DESKTOPCOMPOSITION: Desktop composition
EXP_SHOWCONTENT: Show contents of Windows while dragging
EXP_THEMES: Themes
EXP_BMPCACHING: Bitmap caching
Farm Settings – Proxy
USERNAME:
Proxy credential details
HOSTNAME:
Proxy hostname
PORT:
Proxy port
TYPE:
Proxy type can be one of the following:
- 0
– SOCKS4
- 1
– SOCKS4A
- 2
– SOCKS5
- 3
– HTTP
1.1
USEPROXYSERVER:
Enable if you want to use proxy
USEAUTHEN:
If proxy type is HTTP1.1 or SOCKS5, user can enable authentication.
CLEARPROXYPASSWORD:
Clear password for the user. When the client is launched for the first
time, the password will be encrypted and saved.
CLEARPASSWORD:
Clear password for the user. When the client is launched for the first
time, the password will be encrypted and saved.
OVERRIDEUSERSETTINGS:
To override the user settings with client MSI settings.
- 0
– Client settings are not
overridden
- 1
– Client settings are overridden with the new settings of the Client MSI
setup.
NOTE:
If using Group Policies to deploy the 2X ApplicationServer client, you will need
to edit the MSI in order to pre-configure some of the settings you may want to
change like the server IP address and port. To do this we recommend using
Microsoft ORCA, a free utility that is part of the Windows Platform SDK.
Alternatively you can download it from
http://astebner.sts.winisp.net/Tools/Orca.zip.
Using
ORCA to change the MSI
After downloading and installing ORCA, all you need to do
is launch ORCA and open the
‘2XAppServer-LoadBalancer-Client.msi’
package.
Once you open the MSI package, on the LEFT hand side
(Tables column) you will see
‘Property’. Click on it.
Figure 120 – Using ORCA to open the MSI
package.
Some of the properties (like SERVERPORT for example) may
be already available in the MSI package. If a certain property is not available,
simply click on ‘Tables’ | ‘Add Row...’.
Figure 121– Adding a new row.
Now click on ‘Property’ and type in the name
of the property you want to add. After adding the property, click on
‘Value’ and type the value you want. Make sure you enter the right
property name and its value. Once you finish click
Ok.
The properties you can change/add for the 2X
ApplicationServer & LoadBalancer Client are
ALWAYSONTOP; AUDIOMODE; AUTOHIDE; BACKUPSERVER;
CHECKUPDATELAUNCH; CLEARPASSWORD; COLORDEPTH; DOMAIN; DISABLEOPTIONS;
DISABLESAVEPASSWORD; ENABLEAUTOLOGON; KEYBOARD; MODE; OVERRIDEUSERSETTINGS;
REDIRECTCOMPORTS; REDIRECTDRIVES; REDIRECTPRINTERS; SAVEPASSWORD; SERVER;
SERVERPORT; SSLNOWARNING; USECLIENTCOLORS; USELCIENTSETTINGS; UPDATECLIENTXML;
USERNAME2X (all explained above). Note these properties are case
sensitive.
Figure 122 – Adding a new property/value.
After adding all the properties you want simply go to
File | Save As... and type a new name for your customized MSI file. This file
can now be used with Active Directory to perform a completely silent and
automated installation.
NOTE:
Make sure that you enable “Copy embedded streams during ‘Save
As’” in Orca Database Options.
