SOFTWARE VERSION 1.9
TABLE OF CONTENTS TGX 1.9... 1 Welcome... 2 Terminology... 3 Auto Logon... 3 Collaborator... 3 Credentials... 3 Cross-Platform... 3 Desktop Layout... 3 Desktop Session... 3 Desktop Owner... 3 DPI... 3 MiniMap... 3 Multiple Client SESSION... 3 Receiver... 3 Sender... 4 TGX Session... 4 Connect to a Remote Desktop... 5 Help menu... 6 Get Logs... 6 Enable/Disable Debug Logging... 6 Documentation... 6 About... 6 Display Configuration Settings... 7 Window Mode Settings... 7 Remote Displays Settings... 8 Image Quality Slider... 9 Connection GUI Stored settings... 9 TGX Toolbar... 10 P a g e i
Framerate Control... 10 Resolution... 10 Full Resolution... 11 Scaled To Fit... 12 USB (Windows to Windows Only)... 12 Connect USB... 12 Disconnect USB... 13 Minimize... 13 View Mode... 14 Restore... 14 Windowed... 14 Full Screen... 14 Full Desktop... 14 Disconnect... 14 Options Menu... 15 Ctrl+Alt+Del... 15 Hide/Show MiniMap... 15 Disable/ENABLE Input... 15 Disable/ENABLE Screensaver... 15 Stats Log... 15 About... 16 Volume Control... 16 Disconnect Remote Desktop... 16 Disconnect... 16 Log Out... 16 Cancel... 16 Collaborate with Remote Colleagues... 17 Connection Requests... 17 Collaborators List... 18 P a g e ii
Grant Permissions... 18 Disconnect Collaborator... 18 Other Items... 19 Security... 19 Remote clipboard... 19 Audio... 19 Keyboard and Mouse... 19 Technical Support... 20 Acknowledgements... 21 P a g e iii
TABLE OF FIGURES Figure 1: TGX Launcher... 5 Figure 2: TGX Login... 5 Figure 3: TGX Help Menu... 6 Figure 4: Display Configuration Settings... 7 Figure 5: Window Mode Settings... 8 Figure 6: Remote Displays Settings... 8 Figure 7: Image Quality Slider... 9 Figure 8: White Chevron Expand Toolbar... 10 Figure 9: White Chevron Hide Toolbar... 10 Figure 10: Framerate Control... 10 Figure 11: Resolution... 10 Figure 12: Full Resolution Mode... 11 Figure 13: Scaled to Fit Mode... 12 Figure 14: USB Connection... 12 Figure 15: USB Selection Window... 13 Figure 16: Successful Connection... 13 Figure 17: System Tray Icons... 13 Figure 18: USB Connection... 13 Figure 19: Minimize TGX... 13 Figure 20: View Mode... 14 Figure 21: Disconnect/Logout TGX... 14 Figure 22: Options Menu... 15 Figure 23: Disconnect Remote Desktop... 16 Figure 24: Disconnect Prompt... 16 Figure 25: Collaboration Permissions... 17 Figure 26: Duplicate User... 17 Figure 27: Collaborators List... 18 P a g e iv
DOCUMENT REVISION HISTORY Version Description of Changes Author Date 1.0 Updated formatting; removed What s New section. C. Joyner 03/20/2017 1.1 Updated Copyright to 2017; removed formatting bar on cover page. 1.2 Updated for 1.8.2 release launcher window mode added. C. Joyner 03/27/2017 C. Joyner 04/28/2017 1.3 Updated for 1.9.0 release USB. C. Joyner 06/21/2017 1.4 Updated 1.9.0 images and other formatting. C. Joyner 07/06/2017 1.5 Removed Troubleshooting section. C. Joyner 07/26/2017 P a g e v
TGX USER GUIDE 1.9 Copyright 2017 Mechdyne Corporation, 11 East Church Street, Marshalltown, IA 50158, USA. All Rights Reserved. Purchasers of TGX licenses are given limited permission to reproduce this manual, provided the copies are for their use only and are not sold or distributed to third parties. All such copies must contain the title page and this notice page in their entirety. The TGX software program and accompanying documentation described herein are sold under license agreement. Their use, duplication, and disclosure are subject to the restrictions stated in the license agreement. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. This publication is provided as is without warranty of any kind, either express or implied, including, but not limited to, the implied warranties of merchantability, fitness for a particular purpose, or noninfringement. Any Mechdyne Corporation publication may include inaccuracies or typographical errors. Changes are periodically made to these publications, and changes may be incorporated in new editions. Mechdyne may improve or change its products described in any publication at any time without notice. Mechdyne assumes no responsibility for and disclaims all liability for any errors or omissions in this publication. Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply. TGX is a trademark of Mechdyne Corporation. Microsoft, Windows and Surface are trademarks of Microsoft Corporation. NVIDIA, Kepler, Maxwell, Pascal are trademarks of NVIDIA Corporation. P a g e 1
WELCOME TGX is the highest performing, most efficient remote desktop application on the market. It was created with one goal: to enable users to visualize graphics intensive data from a remote location, in high resolution without sacrificing image quality or user experience. As IT architecture evolves from distributed to centralized equipment, users can remotely access powerful applications in data centers and on workstations with thin clients or laptops. As the market s most powerful remote desktop, TGX maintains storage, compute, network, and remote visualization standards for graphics intensive applications on both Microsoft and Linux platforms. Utilizing a remote desktop to access information on a workstation or in a data center requires two TGX components: a TGX Sender and a TGX Receiver. The TGX Sender resides on a remote machine a workstation, a blade server in a data center, or a virtual machine that runs powerful applications. The TGX Receiver application resides on the user s laptop, desktop computer, Surface tablet, or thin client. The confidence of high quality images and speed empowers users to access company workstations or virtual computers remotely. Whether users collaborate with others or work on their own, they experience applications in real-time while enjoying high quality graphics and a fluid user interface. P a g e 2
TERMINOLOGY AUTO LOGON TGX will use the receiver user's credentials on the local device to automatically authenticate the TGX connection and initiate (log on) or reconnect to a desktop session. COLLABORATOR Users other than the desktop owner that are connected to the sender via TGX. CREDENTIALS The information (Domain, Username, and Password) required by TGX to authenticate the user and initiate (log on) or reconnect to a desktop session. CROSS-PLATFORM If the sender operating system is different than the receiver operating system, it is considered a cross-platform connection. DESKTOP LAYOUT The number, resolution, and relative position of the logical displays comprising the desktop session. DESKTOP SESSION The displays, environment, and applications managed by the operating system for a user. DESKTOP OWNER The user that owns the current desktop session, typically the first user to login to the sender either directly through the sender console or indirectly, via a TGX connection. DPI The "dots per inch" measurement of a display or desktop. Note: some operating systems, e.g. Win 8+, support automatic adjustment of the DPI for large resolution displays. MINIMAP If the sender s remote desktop resolution is larger than the receiver s TGX window or displays, the MiniMap will appear allowing the user to select the visible region of the remote desktop. MULTIPLE CLIENT SESSION The period where the desktop owner and one or more collaborators are concurrently connected to the desktop session of the sender. RECEIVER The local computer that displays and interacts with the remote desktop of the sender via TGX. P a g e 3
SENDER The remote workstation whose desktop and applications are shared by TGX to a receiver. TGX SESSION The period where at least one user (desktop owner or collaborator) is connected to the sender s active desktop session. P a g e 4
CONNECT TO A REMOTE DESKTOP Connecting to a remote desktop with TGX allows you to view and interact with the remote desktop on your local device. Keyboard and mouse input from the local device (the receiver) will be relayed to the remote desktop (the sender), which in turn sends all graphics and audio to the receiver. The hostname or IP address of the sender is required for connection. 1. Launch TGX. The TGX icon should be available on your local desktop after installation. You may also launch via the Start menu. o Windows 7: Start All Programs Mechdyne TGX 1.9 TGX o Windows 8 or 10: Start All apps Mechdyne TGX 1.9 TGX 2. Enter the hostname or IP address for the remote desktop. 3. Select the desired option under Settings: Window Mode see Display Configuration Settings/Window Mode for more details. Remote Displays see Display Configuration Settings/Remote Displays for more details. Image Quality see Display Configuration Settings/Image Quality for more details. 4. Click Connect to connect to the host server. Figure 1: TGX Launcher 5. Enter the login credentials required to access the remote desktop. 6. Click OK. Figure 2: TGX Login P a g e 5
HELP MENU The Help menu can be accessed at connection, by clicking the question mark. The following options will display: GET LOGS Requests and downloads the logs from the sender and combines with the local receiver logs (user authentication for sender required). User will be prompted to save a copy of the combined log. A notification will appear to confirm success and provide a link to the software_support@mechdyne.com email address for the user to send the log. ENABLE/DISABLE DEBUG LOGGING Enables/disables debug logs until the launcher is closed or the option is changed. This is typically enabled when more information about the reported error is needed. The support team will advise the user to enable this option when necessary. If debug logging is enabled, the option will read Disable Debug Logging and vice versa for Enable Debug Logging. DOCUMENTATION Launches the folder that contains the user documentation for TGX. User can select the documentation needed. ABOUT Provides the software version and product support contact information. Figure 3: TGX Help Menu P a g e 6
DISPLAY CONFIGURATION SETTINGS The sender s desktop layout (number of displays, resolutions, and positions) can be reconfigured to match the configuration of the physical displays connected to the receiver. The display configuration options can be set on the TGX Launcher, under Settings. To modify display configuration, the following is required: 1. The user is the desktop owner connecting to a new or previously disconnected session. 2. The sender is configured to enable display configuration (the default). 3. The sender hardware is a NVIDIA Quadro, GRID, or Tesla graphics card. WINDOW MODE SETTINGS Figure 4: Display Configuration Settings WINDOWED The Windowed mode displays the remote desktop within a window on the receiver. The window may be moved and resized on the local desktop. FULL SCREEN The Full Screen mode fills your primary display with the remote desktop, removing the native operating system title bar and window decorations. FULL DESKTOP The Full Desktop mode, available only if the receiver has more than one physical display connected, fills the span of the physical displays with the remote desktop, removing the native operating system title bar and window decorations. Full Desktop mode is currently disabled in the Linux and Mac receivers. P a g e 7
REMOTE DISPLAYS SETTINGS Figure 5: Window Mode Settings USE REMOTE DISPLAYS AS IS This setting will not attempt to configure the displays. The existing configuration on the remote system will be used. MATCH ALL LOCAL DISPLAYS (WINDOWS ONLY) This option will replicate the receiver s entire display configuration on the sender. MATCH DISPLAY # : WIDTH X HEIGHT These options allow selecting a single display s configuration from the receiver to be replicated on the sender. There will be one selection option per receiver display. Figure 6: Remote Displays Settings P a g e 8
IMAGE QUALITY SLIDER The Image Quality slider is a performance indicator. TGX outperforms other remote desktop applications by minimizing bandwidth through efficient compression, therefore, it is typically unnecessary to change the performance. The default value of 68 on the slider is highly recommended to produce great image quality at good frame rates for the majority of use cases and network conditions. However, if the sender-to-receiver inherent network bandwidth is limited, it may be necessary for the user to move the slider left to select a lower image quality (which will reduce the bandwidth requirements). On a wired LAN, the user may move the slider right to increase image quality (which will increase the bandwidth requirements). The maximum TGX image quality is approximately that of a Blu-ray video. TGX will adjust performance accordingly to fit within the available network bandwidth and latency conditions. Currently, the Image Quality can only be adjusted when initiating a new TGX session; however, this function will be available from the toolbar of the TGX window in a future release. CONNECTION GUI STORED SETTINGS Figure 7: Image Quality Slider The hostname dropdown box will store the most recent sender connections (up to 20). Typing on the hostname text field will autocomplete from the list of stored senders. Each stored sender item has an X to delete the sender from the list. With each sender, the following preferences are also stored: Username (no password information is stored), Image Quality setting, and Remote Displays selection. P a g e 9
TGX TOOLBAR The TGX toolbar can be accessed by clicking the white chevron at the top center of the TGX window on Windows and Linux receivers (the toolbar is hidden default). The Mac OS X TGX receiver utilizes the standard Mac menu bar. The TGX toolbar allows for changing the frame rate, view mode and resolution, disconnecting from the remote desktop, and accessing the options menu. The TGX toolbar can be hidden by clicking the chevron again. Figure 8: White Chevron Expand Toolbar Figure 9: White Chevron Hide Toolbar FRAMERATE CONTROL The target framerate can be adjusted by selecting the chevron next to the bandwidth/framerate statistics. The default target is 48 Hz, but it can be set as low as 24 Hz or as high as 60 Hz. Note: Lower frame rates will use less bandwidth compared to higher frame rates for the same Image Quality setting. The number to the right of the slider bar indicates the current selection. Figure 10: Framerate Control RESOLUTION The resolution options are Full Resolution and Scaled to Fit. Figure 11: Resolution P a g e 10
FULL RESOLUTION The Full Resolution mode displays the sender s remote desktop at a one-to-one (1:1) pixel mapping. TGX sessions initially open in Full Resolution mode. If the resolution of the remote desktop is greater than the available space in the receiver s TGX window (in Windowed mode) or displays (in Full Screen or Full Desktop mode), the MiniMap will be displayed. Left click in the MiniMap to select the visible region of the remote desktop. Right click and drag to move the MiniMap within the TGX window. Figure 12: Full Resolution Mode P a g e 11
SCALED TO FIT The Scaled to Fit mode scales the sender s remote desktop to fit within the receiver s TGX window or displays. The aspect ratio of the remote desktop is preserved and if the aspect ratio of the receiver s TGX window or displays are different, horizontal or vertical black bars will appear. Figure 13: Scaled to Fit Mode USB (WINDOWS TO WINDOWS ONLY) TGX supports forwarding HID USB devices from the receiver to the sender during a remote connection session. This feature allows USB devices connected to the receiver (local machine), to be available for use on the sender (remote machine). If this option is utilized, the selected USB device will no longer be available for use on the receiver. CONNECT USB 1. Click the USB icon from the TGX toolbar. The USB Selection window will display. Figure 14: USB Connection P a g e 12
2. Select the desired USB device from the list. 3. Click Connect. A plug icon will indicate if the connection was successful. Figure 15: USB Selection Window Figure 16: Successful Connection DISCONNECT USB Select the device from the USB Selection window, and Click Disconnect. Select the TGX icon in the system tray on the sender machine and Click the red X next to the sender USB connection. Figure 17: System Tray Icons Figure 18: USB Connection MINIMIZE The Minimize icon will minimize the TGX toolbar to the taskbar. Figure 19: Minimize TGX P a g e 13
VIEW MODE The view mode options are available from the Maximize icon and are as follows: Restore, Windowed, Full Screen, and Full Desktop. Note: For the Mac receiver, use the standard Mac title bar buttons to switch between windowed and full screen modes. Full Desktop mode is not available on Mac and Linux receivers. RESTORE Figure 20: View Mode The Restore mode restores the window to the previous window size. WINDOWED The Windowed mode displays the remote desktop within a window on the receiver. The window may be moved and resized on the local desktop. FULL SCREEN The Full Screen mode fills your primary display with the remote desktop, removing the native operating system title bar and window decorations. FULL DESKTOP The Full Desktop mode, available only if the receiver has more than one physical display connected, fills the span of the physical displays with the remote desktop, removing the native operating system title bar and window decorations. Full Desktop mode is currently disabled in the Linux and Mac receivers. DISCONNECT The X icon in the upper right corner prompts the user to Disconnect or Log Out of the TGX session as described in Disconnect from a Remote Desktop section. Figure 21: Disconnect/Logout TGX P a g e 14
OPTIONS MENU The three parallel lines ( ) on the left of the TGX toolbar opens the options menu. CTRL+ALT+DEL Figure 22: Options Menu Send the Ctrl+Alt+Delete key sequence to the sender in order to access the Windows lock screen or task manager on the sender s remote desktop. HIDE/SHOW MINIMAP Toggle the visibility of the MiniMap when the resolution of the sender s remote desktop is greater than the receiver s TGX window or displays. DISABLE/ENABLE INPUT Disable/Enable Input will block/allow keyboard and mouse input from your receiver to the sender s remote desktop. In a collaboration session, input is disabled for collaborators unless the desktop owner allows input. See instructions in the Collaborate with Remote Colleagues section. Note: A receiver s input selection may be overridden by the desktop owner during a collaboration session. DISABLE/ENABLE SCREENSAVER The local screen saver is automatically disabled when selecting full-screen or full-desktop mode. The Disable/Enable Screensaver allows the user to override that behavior and to disable the screensaver in window mode. STATS LOG TGX can record the frame rate and bandwidth usage in a given timeframe and export the data to a spreadsheet for reference and analysis. P a g e 15
ABOUT Details of the version information for this release of TGX is presented. VOLUME CONTROL This slider adjusts the receiver's local volume level for audio received from the sender. This is a separate menu on the menu bar on a Mac. This option is only displayed if the sender has the necessary hardware to support audio. DISCONNECT REMOTE DESKTOP 1. Click the white chevron at the top center of the TGX window to reveal the TGX toolbar. 2. Click the X in the top right of the toolbar to reveal the disconnect prompt. 3. Click Disconnect, Log Out, or Cancel as appropriate. Note: The keyboard shortcut Ctrl+Alt+X can also be used to reveal the disconnect prompt. Figure 23: Disconnect Remote Desktop DISCONNECT Figure 24: Disconnect Prompt By disconnecting a TGX session, the user will remain logged in on the remote desktop, all applications will remain open, and the sender screen will be locked. The user can later reconnect to the remote desktop and resume in the preserved state. LOG OUT By logging out of a TGX session, the user will be logged out of the remote desktop, all applications will close, and the sender will return to its login screen. CANCEL Cancel this process and return to the TGX session. P a g e 16
COLLABORATE WITH REMOTE COLLEAGUES TGX allows up to four users to simultaneously view and interact with the same remote desktop. The desktop owner has administrative privileges over the session with the ability to disconnect collaborators at any time and to allow or deny keyboard and mouse input from each collaborator. CONNECTION REQUESTS When a new collaborator connects, a notification requesting permission for the collaborator to join will display for the desktop owner. Select Allow to permit the collaborator to connect Select Deny to prevent the connection. If no response is selected, the connection will be denied. Check Enable input for this collaborator to automatically enable input options. Figure 25: Collaboration Permissions Exception: A desktop owner may have a need to connect from another machine while an existing session is active. In this scenario, the notification will advise that a user with the same credentials is attempting to connect. If no option is selected, the original session will be terminated and the new connection becomes the desktop owner. Figure 26: Duplicate User P a g e 17
COLLABORATORS LIST To view a list of collaborators, click on the TGX icon in the system tray. GRANT PERMISSIONS To allow or deny a collaborator s mouse and keyboard input to control the remote desktop, click the mouse icon toggle next to their name. DISCONNECT COLLABORATOR To disconnect a collaborator, click the X next to their name. Note: If the desktop owner disconnects the TGX session, all collaborators will be disconnected. Figure 27: Collaborators List P a g e 18
OTHER ITEMS SECURITY TGX encrypts all network traffic using Secure Sockets Layer (SSL) encryption. This protection ensures the privacy of display, keyboard, mouse, and audio information between the sender and receiver. REMOTE CLIPBOARD TGX supports copy/paste of plain text, formatted text, Excel tables, and images as part of the Clipboard function. TGX does not support copy/paste of an entire file as part of the Clipboard function. The desktop owner is able to access the Clipboard of both the sender and the receiver and has bi-directional control between both clipboards. Collaborators have one-way copy/paste functionality from the receiver to the sender, if the desktop owner enabled their input. For cross-platform Clipboard operation, only plain text, formatted text, and images are supported. AUDIO Audio output from a sender is shared with the receiver(s). The volume of the audio from the sender is controlled using the volume control slider in the TGX toolbar on each receiver. If the TGX window is minimized, the sound is paused on the receiver until the TGX window is restored. KEYBOARD AND MOUSE When the receiver s mouse cursor is over the TGX window, the cursor icon of the sender s mouse will be displayed. The mouse cursor of a collaborator that does not have mouse/keyboard control will be indicated by an X. The following system key combinations will be transferred from the receiver to the sender: ALT + TAB, any Windows key combinations, and menu key combinations. The following system key combinations will not be transferred: CTRL+ALT+DELETE (this capability is provided in the TGX toolbar), Windows + L, and multi-media keys. Using a non-standard US or international keyboard layout, e.g. Dvorak or any 102-key keyboard, requires configuring the sender desktop to the desired keyboard layout. P a g e 19
TECHNICAL SUPPORT Mechdyne is available for additional technical support. Please submit queries through our support portal on the web. WEB http://www.mechdyne.com/software-support.aspx EMAIL software_support@mechdyne.com P a g e 20
ACKNOWLEDGEMENTS The TGX software package uses several third-party technologies, including, but not limited to: OpenSSL: This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/). This product includes software written by Tim Hudson (tjh@cryptsoft.com). This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). The license details are provided as part of the installation package in the file ThirdPartyLicensesSupportingTGX.pdf. The Qt Company: This product includes Qt Version 5 under the LGPL (Version 3). The license details are provided as part of the installation package in the file ThirdPartyLicensesSupportingTGX.pdf. In addition, license details for all third-party products contained as part of QT are provided as part of the installation package in the file entitled ThirdPartyLicensesCarriedWithQT.pdf. Intel: This product uses the Media SDK and Performance Primitives from Intel. The TGX license agreement prohibits disassembly and reverse engineering of the Redistributables per requirement by Intel. Scalable Graphics: This product includes technology developed by Scalable Graphics as provided to Mechdyne for use with TGX and other products through a specific licensing agreement. NVIDIA: This product uses NVIDIA provided software libraries to harness the full potential of hardware and software optimizations made possible by NVIDIA graphics cards. Mechdyne is part of the NVIDIA Partner Network as a Preferred Solution Provider for Professional Visualization and GRID. P a g e 21