Georgia SoftWorks

Universal Terminal Server for Windows NT/XP/VISTA/2000/2003

For GSW Telnet Server and GSW SSH2 Server

User Manual      


This Page Intentionally left blank
Georgia SoftWorks

Georgia SoftWorks Universal Terminal Server for                                            Windows NT/XP/VISTA/2000/2003

Copyright ã 1997-2007, Georgia SoftWorks, All Rights Reserved

Public Square

17 Hwy 9 South • PO Box 729

Dawsonville Georgia 30534

Telephone 706.265.1018 • Fax 706.265.1020

http://www.georgiasoftworks.com


 

 

 

 

 

 

 

Reliable, Consistent, Full Features while providing incredible performance!

 

 

Actual screen shot in the GSW Lab of 2450 sessions connected during pre-release testing!

Copyright © Georgia SoftWorks, 1997-2007 All Rights Reserved.

User's Manual, Version 7.01, Feb 28, 2007

Microsoft, Windows, Windows Pocket PC, Windows Mobile, Windows XP, Windows 2000, Windows 2003, Windows VISTA, Windows NT, Windows 98, Windows 95 are trademarks of Microsoft Corporation. SAP SAPConsole are trademarks of SAP AG. LXE, Intermec, Psion-Teklogix, Symbol, PSC Falcon, Unitech are trademarks of their respective companies.

 

THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

 

LICENSOR MAKES NO WARRANTIES OR REPRESENTATIONS, EXPRESS OR IMPLIED, ORAL OR WRITTEN, REGARDING THE PROGRAM OR DOCUMENTATION AND HEREBY EXPRESSLY DISCLAIMS ALL OTHER EXPRESS OR IMPLIED WARRANTIES, INCLUDING MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. LICENSOR DOES NOT WARRANT THE PROGRAM WILL MEET YOUR REQUIREMENTS OR THAT IT’S OPERATION WILL BE UNITERRUPTED OR ERROR FREE.

 

IN NO EVENT WILL GEORGIA SOFTWORKS BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE SUCH PROGRAMS.

 

COPYING:

WHILE YOU ARE PERMITTED TO MAKE BACKUP COPIES OF THE SOFTWARE FOR YOU OWN USE AND PROTECTION, YOU ARE NOT PERMITTED TO MAKE COPIES FOR THE USE OF ANYONE ELSE.

 

LICENSE:

YOU ARE LICENSED FOR A SPECIFIC NUMBER OF CONCURRENT OR SIMULTANEOUS CONNECTIONS TO A SINGLE WINDOWS NT/XP/VISTA/2000/2003 SYSTEM. THE NUMBER IS SPECIFIED IN YOUR PURCHASE AGREEMENT. ANY ATTEMPT TO INCREASE THE NUMBER OF SIMULTANEOUS OR CONCURRENT CONNECTIONS EITHER INTENTIONAL OR UNINTENTIONAL IS IN VIOLATION OF THIS AGREEMENT.  THE GEORGIA SOFTWORKS WINDOWS NT/XP/VISTA/2000/2003 TELNET SERVER SOFTWARE MAY BE INSTALLED ON A SINGLE WINDOWS NT/XP/VISTA/2000/2003/ SYSTEM. 

 

Table of Contents


The Real Pioneers - Often copied but never equaled 2

User Manual 3

Product Description 4

Server Software 5

Agent Process 5

Client Software 5

Georgia SoftWorks UTS Product Configurations 6

GSW UTS Components Overview 6

GSW UTS – Telnet Server 7

GSW UTS – SSH2 Server 7

Installation 8

GSW UTS 32-bit and 64-bit Editions 8

Server Installation 9

Registration 14

Floating License – (Hardware Key). 14

Floating License – Hardware Key Installation Instructions. 16

Uninstall Floating License – (Hardware Key). 20

Software Registration 21

How to Register the Software. 21

GSW UTS CLIENTS 25

GSW Clients and Operating Systems Diagram.. 26

GSW Desktop Clients 27

Installation Steps. 27

UN-Install 27

GSW Mobile Clients 28

GSW Universal Mobile Clients Overview.. 28

Universal Mobile Clients for Windows CE .NET 4.2/5.0. 28

GSW Universal Mobile Clients for Windows Pocket PC and Windows Mobile 2003/2005. 28

GSW Enhanced Mobile Clients for Windows CE .NET 4.2/5.0 Overview.. 28

Select the correct GSW Mobile Client 29

Installation steps. 30

Enhanced GSW Mobile Clients List 31

Universal GSW Mobile Clients Special Tips or Qualifications List 32

Extended Features for Windows CE .NET 4.2/5.0 Devices. 33

Stay Connected. 33

Allow Suspend – Power Saving Feature. 33

Beep sound – Correct Operation. 33

Menu Accelerators / Shortcuts. 34

Select Configuration for Session. 34

Portable Session Configuration – A Real Time Saver! 34

Last Active Session Memory. 35

No Scrollbars Option. 36

Automatic Logon for Mobile Clients. 37

Keyboard Macros. 38

Break-Out Sequence. 39

Extended Features for Pocket PC 2003 and Windows Mobile 2003/2005 Devices. 39

Free Function Keys. 39

Configuration and Application Persistence. 40

GSW Universal Mobile Client Persistence. 40

Configuration Persistence. 40

Application Persistence. 41

Persistence Instructions. 41

GSW Pocket PC 2003 Universal Mobile Client Persistence. 44

Configuration Persistence. 44

Application Persistence. 44

Persistence Instructions. 44

Tips for Intermec CK30. 46

Tips for Intermec CV60. 48

Tips for PSION-TEKLOGIX WorkAbout Pro, 7535 and 8525 devices. 49

Tips for SYMBOL MC 9060G devices. 50

Tips for LXE MX3X Devices. 51

Tips for PSC Falcon 4410. 53

Application Protection. 58

Backup and Restore the Georgia SoftWorks SSH2/Telnet Server 60

How to use the GSW Universal Terminal Server for Windows 61

Georgia SoftWorks Client 61

Host 61

Login ID.. 62

Domain Name. 64

Georgia SoftWorks Desktop Client Command line options – Description. 65

GSW Telnet and SSH2 Client command line options - Usage. 67

Automatic Update of Georgia SoftWorks SSH2/Telnet Client 68

Application Title Display. 71

Answerback Text 72

Terminating a session 73

Connecting using a 3rd Party Client 73

Feature Packs - Overview 74

Security Pack 75

Encrypted Data Stream – Telnet Server 76

Data Stream Encryption Client Parameters. 76

Data Stream Encryption Server Environment variable. 76

Enable Encryption Server Registry variable. 77

Proper Operating System DLL’s. 77

Georgia SoftWorks Telnet Server SE: 128-bit Strong Complete Data Stream Encryption. 78

Encrypted Logon Sequence 78

Encryption Based on IP Address 79

Encryption – SSH2 Server 80

Connection Restrictions 81

Restrict access based on User ID.. 81

Restrict access based on IP Address. 81

Restrict users access to a specific application. 83

Restrict connections from 3rd Party Clients. 83

Restrict access based the number of connections. 84

Restrict Number of connections by a Specific User ID.. 85

Restrict Number of connections from a Specific IP-Address. 87

Restrict connection to only encrypted sessions - Telnet 90

Expired Password Handling 91

Integrated with Windows NT/XP/VISTA/2000/2003 Security 91

Performance Pack 92

Fast, Fast, Fast 92

Compression for slow link speeds 92

Slow link and Internet optimizations 92

Proprietary performance algorithms and code optimizations. 92

DOSBoss MSDOS Application performance booster. 93

Automatic Logon – Autologon 94

Autologon with GSW Clients. 94

Automatic Logon 3rd Party Clients. 96

Automatic Logon Summary. 97

GSW UTS x64 Native 64-Bit 98

RF DTIO Interface 98

Failure Detection/Recovery Pack 100

Session Saver 100

Session Reconnection Timeout 101

Reconnection based on User ID. 102

Reconnection based on IP Address and User ID. 102

Complete Session Cleanup 104

Complete NTVDM Cleanup 104

Server Side Inactivity Timer 104

Server Side Heartbeat Timer 106

Client Side Heartbeat Timer 107

Graceful Termination of DOS Applications 108

Termination Scripts 111

Termination of Child Processes 112

Legacy Pack 113

Mouse 113

DOS Character Mode Color Graphics 113

Function Keys 113

Special Characters 113

Screen Sizes other than 25 x 80 113

Alt Key Support for all emulations 114

Control-C Configuration Support for all SSH2/Telnet Clients 114

Emulation Pack 115

3rd Party Clients 115

Terminal Emulation. 115

Graphic Characters. 117

Color or Monochrome Presentations. 119

Color Mapping for Monochrome. 119

Modification of Color Mapping for Monochrome. 120

Alt Keys. 121

ESC Delay. 123

Enable NAWS. 124

Domain Specification using 3rd Party Clients. 124

Color Re-mapping – All Clients 125

Automatic Logon 3rd Party Clients - AutoLogon 127

Character Display Translation:  3rd Party Clients 127

Terminal Initialization:  3rd Party Clients 128

Power Features Pack 129

Session Administrator 129

Session Monitoring Privileges. 129

Starting the Session Administrator. 131

Observing SSH2/Telnet Sessions. 132

Monitoring SSH2/Telnet Sessions. 134

Shadowing SSH2/Telnet Sessions. 136

Terminating SSH2/Telnet Sessions. 137

Attach to a Suspended (Saved) Session. 138

Send a Broadcast Message to SSH2/Telnet Sessions. 139

Broadcast a message to ALL SSH2/Telnet Sessions. 139

Broadcast a message to A SINGLE Telnet Session. 142

Schedule a Broadcast Message. 145

Exiting the Session Administrator. 147

GS_ADMIN Command Line Options. 148

Session Monitoring Uses. 151

GSW Event Logging 152

Event Log Definition File: 152

Event Log File. 153

Modify the Log File Size. 154

Logon Scripting 155

USER Logon Scripts. 155

Global Logon Scripts. 157

IP Address Based Logon Scripts. 157

Programmatic Access to the SSH2/Telnet Server 162

True Client Side Printing - Printing the way you want it! 163

Default Printing. 163

Enhanced Printing. 163

Open Printing. 163

Setting up True Client Side Printing. 164

Create a virtual printer on the server. 164

Set virtual printer redirection commands in logon script. 166

Enhanced Print Method. 167

Open Print Method. 173

Passthrough Print Method. 178

Client Identity and Uniqueness 179

Compatibility Pack 180

RF Terminals – Bar Code Scanners 180

RF Devices using Power Save or Sleep Mode. 181

TCP Receive Windows Size. 182

TCP Maximum Retransmission Count 182

Refresh Character. 184

Unicode – UTF-8 Encoding. 185

Unicode Character Support with the GSW SSH2/Telnet Client 186

UTF-8 Encoding with 3rd party telnet/SSH2 clients. 189

Utility Pack 191

Change Password command line utility 191

Connection Banner 192

Execute Application on Client from within a SSH2/Telnet Session 193

File Transfer command line Utility 197

GS_PUT - Transfer from Server to Client 197

GS_GET - Transfer from Client to Server. 198

GS_PUT Error Values. 199

DESCRIPTION.. 199

Example - Utilities: GS_PUT Errorlevel Usage in batch file. 199

GS_GET Error Values. 201

DESCRIPTION.. 201

Launch GUI Application on Server 204

Reboot Windows Server computer command line utility. 205

Shutdown command line utility for Windows NT/XP/VISTA/2000/2003 206

Remote Registration Utility 207

Special Bell Processing 208

TTY Name 209

Client Scroll Bars 209

Setting a Default Domain 210

3rd Party Client - Default Domain Override 211

Setting the Telnet Port or Multiple Ports 212

Use an Alternative Telnet Port. 212

Configure Multiple Telnet Ports 212

Georgia SoftWorks Java Telnet Applet 214

Required Java support 215

Required Files for the GSJC. 215

Required Files. 215

Client Side Printing - All Browsers. 215

Required Files for Client Side Printing with Internet Explorer 4.0+.. 215

Client Side Printing Capabilities: 215

GSJC Applet parameters 216

Optional Parameter:  port 216

Optional Parameter: user. 216

Optional Parameter: password. 216

Optional Parameter: domain. 216

Optional Parameter: address 216

Optional Parameter: useTopLeftLocation. 216

Optional Parameter: useMSDOSFrame. 216

Optional Parameter: useBorders 217

Optional Parameter: useBoldFont 217

Optional Parameter: bkgColor. 217

Optional Parameter: HBTime. 217

Optional Parameter: useEncryption. 217

Optional Parameter: printCommand. 217

Sample web page for systems with Java Plug-In installed. 218

Sample web page for systems with MS IE 4.0 and higher. 219

Sample web page for systems with Netscape Communicator. 220

Sample web page for systems with other browsers. 221

Applet size 221

Georgia SoftWorks Java Telnet Client 222

Required Java Support 222

Required Files for the GSJC. 222

Invoking the GSJC 222

Encryption 222

Frequently Asked Questions 224

My MSDOS applications execute very slow, even on a high performance system. Is there anything I can do?  224

Can I use a port other than port 23 for the Telnet Server. 224

Can I SSH2/Telnet to the SSH2/Telnet server and then SSH2/Telnet to another server?. 224

I can't logon fromSSH2/Telnet, what should I do?. 224

I am the Administrator but gs_admin.exe says I do not have permission to run Session Administrator. 225

I want to set the background color on the client Window and make it distinct from the standard MSDOS Windows?  225

I want to change the size of the window. The client is set to 80x40 but when it connects to the server it reverts back to 80x25. 225