2X HTML5 Gateway v10.6
URL: www.2x.com E-mail: info@2x.com 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. Version 10.6 Last updated October 30, 2013
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 About 2X 14
2X HTML 5 GATEWAY - INTRODUCTION The 2X HTML5 Gateway is an add-on which can be used with 2X ApplicationServer XG version 10.x only to enable connections from an HTML5 enabled browser. Higher versions of 2X ApplicationServer XG version 11.x include an HTML5 gateway with every 2X ProxyGateway component. The HTML5 Gateway Client is developed using only HTML5 technologies. 2X HTML5 Gateway - Introduction 4
QUICK INSTALLATION PROCEDURE 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 2X HTML5 Client HTTP Server(s) set to forward HTTP requests to localhost:81 Quick Installation Procedure 5
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. 2X HTML5 Client Running 2XHTML5Gateway Setup Quick Installation Procedure 6
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. 2X HTML5 Client 2X HTML5 Gateway Service Quick Installation Procedure 7
USING THE 2X HTML5 GATEWAY CONNECTION 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. Keyboard Compatibility Mode When switched ON this will give full keyboard functionality (Note that this uses US keyboard layout only). Using the 2X HTML5 Gateway Connection 8
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. 2X HTML5 Client Application listing Using the 2X HTML5 Gateway Connection 9
4. Select any application you want to start such as MS excel. 2X HTML5 Client An opened published application Using the 2X HTML5 Gateway Connection 10
ADVANCED INSTALLATION PROCEDURE SSL (443) 2X Proxy Gateway 2X HTML5 Gateway SSL (444) 2X Pass Gateway 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 interface = 127.0.0.1 createdefaults = true Advanced Installation Procedure 11
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. In this mode you can add multiple 2X Secure Proxy Gateways behind the 2X HTML5 Gateway. The client needs to setup a connection with the host name or IP of which 2X Secure Proxy Gateways will connect to. A typical example would be a 2X HTML5 Gateway which serve multiple farms. Please keep in mind that every connection done via the 2X HTML5 gateway is tunneled though it. Advanced Installation Procedure 12
TROUBLESHOOTING AND SUPPORT Introduction The troubleshooting chapter explains how you should go about resolving issues you may have. The main sources of information available to users are: Knowledgebase 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 support@2x.com Contacting our support department by telephone. 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-upto-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 You can also contact 2X by phone for technical support. Please check our support website for the correct numbers to call, depending on where you are located, and for our hours of operation. Troubleshooting & Support 13
ABOUT 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. 2011 2X Software Ltd. All rights reserved. The information contained in this document represents the current view of 2X on the issues discussed as of the date of publication. Because 2X must respond to changing market conditions, it should not be interpreted to be a commitment on the part of 2X, and 2X cannot guarantee the accuracy of any information presented after the date of publication. 2X MAKES NO WARRANTIES, EXPRESS OR IMPLIED, IN THIS DOCUMENT. 2X ApplicationServer for Windows Terminal Services, 2X ApplicationServer, 2X LoadBalancer for Terminal Services/Citrix and 2X ThinClientServer and their product logos are either registered trademarks or trademarks of 2X Software Ltd. in the United States and/or other countries. All product or company names mentioned herein may be the trademarks of their respective owners.