URL: www.2x.com E-mail: [email protected]
Information in this document is subject to change without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of 2X SOFTWARE Ltd.
2X ApplicationServer and 2X Cloud Portal are copyright of 2X SOFTWARE Ltd. 1999-2013 2X SOFTWARE Ltd. All rights reserved.
Contents
2X HTML 5 Gateway - Introduction 4
Quick Installation Procedure 5
Using the 2X HTML5 Gateway Connection 8
Advanced Installation Procedure 11
Troubleshooting and Support 13
Introduction ... 13
Knowledgebase... 13
Request Support via E-mail ... 13
Request Support via Phone ... 13
2X HTML5 Gateway - Introduction• 4
2X
HTML
5
G
ATEWAY
-
I
NTRODUCTION
Quick Installation Procedure• 5
Q
UICK
I
NSTALLATION
P
ROCEDURE
2X HTML5 Gateway 2X Proxy Gateway SSL (443) Client
The Quick Installation Procedure explains how to set up the 2X HTML5 Gateway in a standard scenario where one 2X HTML5 Gateway serves one 2X Secure proxy Gateway. It is assumed that no HTTP forwarding is set on the 2X Secure Proxy Gateway.
1. Download the setup file 2XHTML5GatewaySetup.exe on the machine where you have the 2X Secure Proxy Gateway installed.
2. Open 2X ApplicationServer and confirm the following settings are set in the 2X Gateway where we have installed the 2XHTML5 Gateway:
HTTP Server(s) is set to localhost:81
Quick Installation Procedure• 6
SSL is enabled on port 443 and a valid certificate is in use.
2X HTML5 Client – Enable SSL on port 443
If these settings were changed please follow the Advanced Installation Procedure.
Ensure that TCP port 81 is not being used by an other application
Confirm this by running netstat -an -p TCP command
Check that there is no listening state which is using local port 81 such as 0.0.0.0:81.
2X HTML5 Client – Identifying if another application is already listening on port 81
3. Deploy the setup file which will extract and install the necessary file needed to run the 2X HTML5Gateway. Follow on screen instructions.
Quick Installation Procedure• 7 4. Please verify that the 2X HTML5 Gateway service is running. If the service is not
running you need to deploy 2X HTML5 Gateway using Advanced Installation Procedure since the above checks were not valid.
Using the 2X HTML5 Gateway Connection• 8
U
SING THE
2X
HTML5
G
ATEWAY
C
ONNECTION
Open an HTML5 enabled browser and go to the link https://gatewayname or IP as shown below.
2X HTML5 Client – Main page
On the left hand side you can see the connections pane. A default connection is preset, simply click on the connection to start using the client. You can add additional more 2X connections or direct RDP Connections.
If you need to clear all the settings please select “Clear All data” from the Tasks pane. This will permanently delete all the connections settings you have.
From the Settings pane, you can enable settings for:
Auto Reconnect – To reconnect automatically to the connection which might have disconnected.
Using the 2X HTML5 Gateway Connection• 9 To start your session please do the following:
1. Click on the “Default Connection” under 2X Connections.
2. Insert credentials when prompted to authenticate to the Default Connection for 2X HTML5 Gateway and click login.
2X HTML5 Client – Connection Logon
3. If authentication was successful, the applications are listed as shown below.
Using the 2X HTML5 Gateway Connection• 10 4. Select any application you want to start such as MS excel.
Advanced Installation Procedure• 11
A
DVANCED
I
NSTALLATION
P
ROCEDURE
2X Proxy Gateway 2X HTML5 Gateway SSL (443) 2X Pass Gateway SSL (444) Client SSL (443)
When the Quick Installation is not an option due to conflicting settings or different scenario requirements then that of the Quick Installation, you can modify the 2X HTML5 Gateway settings as explained below. You still need to run the setup and then modify the settings as required.
In the installation folder of the 2X HTML5 Gateway you can find the file “config.ini”, from which you can control the settings of the gateway. Please note that when changing any settings in this file you need to restart the 2X HTML5 Gateway service.
The default file content is as follows:
port = 81
Advanced Installation Procedure• 12 You can have any of the following options:
Option Name Default Value Description
port 81 Port on which the 2X HTML5 Gateway service listens for connections
ssl n/a Full pathname for the SSL certificate. Note that a sample certificate is distributed with the system. If the certificate is going to be used it is recommended to change the certificate file. If the 2X HTML5 Gateway is installed behind the 2X Secure Proxy Gateway (Basic Installation), this option is not required.
interface 127.0.0.1 IP on which the 2X HTML5 Gateway listens. To listen on all available IPs please use 0.0.0.0. If the 2X HTML5 Gateway is installed behind the 2X Secure Proxy Gateway (Basic Installation), it is recommended to set this option to 127.0.0.1 so that only connections from the 2X Secure Proxy Gateway are serviced.
createdefaults true When set to true, every new client will have a “Default Connection” available on startup. This is recommended for basic Installation.
Troubleshooting & Support • 13
T
ROUBLESHOOTING AND
S
UPPORT
Introduction
The troubleshooting chapter explains how you should go about resolving issues you may have. The main sources of information available to users are:
The manual – most issues can be solved by reading and referring to the manual.
The 2X support site – accessible from the 2X website. It includes a knowledge base with the most frequently asked questions.
Contacting the 2X support department by email at [email protected]
Contacting our support department by telephone.
Knowledgebase
2X maintains a knowledgebase, which includes answers to most commonly asked problems. If you have a problem, please consult the knowledgebase first. The knowledgebase is continuously updated and contains the-most-up-to-date listings of support questions and patches.
The knowledgebase can be found at http://www.support.2x.com
Request Support via E-mail
If you are unable to resolve your issue after using the knowledgebase and referring to this manual, please contact the 2X support department.
Contact us via e-mail, and attach any references or examples of the issue you are experiencing. This will enable us to solve your issue quickly and
efficiently.
You may be asked to collect some information and you may be asked a number of questions. Please take your time to answer these questions accurately. Without the proper information it will not be possible to diagnose your problem.
We will answer your inquiry within 24 hours or less, depending on your time zone.
Request Support via Phone
A
BOUT
2X
ABOUT 2X | 2X Software Ltd - 2X - is a company developing software for the booming server-based computing market. Thin client computing controls skyrocketing PC management costs, centralizes application and desktop management, improves security and performance and allows users to work remotely. The company’s product line includes: 2X ApplicationServer for Windows Terminal Services, 2X ApplicationServer, 2X LoadBalancer for Terminal Services/Citrix and 2X ThinClientServer. 2X is a privately held company with offices in the USA, Germany, France, UK, Australia and Malta. Its management team is backed by years of experience in developing and selling network infrastructure software. 2X is a Microsoft, VMware, IBM and RedHat partner. For more information visit: http://www.2x.com. All product and company names herein may be trademarks of their respective owners.
