Georgia SoftWorks

Universal Terminal Server for Windows Server 2012-2022 and Windows 10/11

 

 

 

 

For GSW Telnet Server and GSW SSH Server

User’s Guide  


This Page Intentionally left blank
Georgia SoftWorks

Georgia SoftWorks Universal Terminal Server for Windows Server 2012-2022 and Windows 10/11

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Copyright ã 1997-2021, 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

https://www.georgiasoftworks.com


 

Reliable, Consistent, Full Featured while providing incredible performance!

 

 

Actual screen shot in the GSW Lab of 4999 sessions connected during testing!

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

User's Guide, Version 8.11.0012, December 29, 2021

Microsoft, Windows, Windows Pocket PC, Windows Mobile, Windows XP, Windows 2000, Windows Server 2003, Windows Server 2008/R2, Windows Server 2012/R2, Windows Server 2016, Windows Server 2019, Windows Server 2022, Windows VISTA, Windows 7,  Windows 8, Windows 10, Windows 11, Windows NT, Windows 98, Windows 95 are trademarks of Microsoft Corporation. SAP SAPConsole are trademarks of SAP AG. LXE, Intermec, Janam, Psion-Teklogix, Psion Teklogix Omni XT10, Symbol, PSC Falcon, Unitech, VMware, Honeywell, Honeywell Dolphin 6500, Honeywell Dolphin 9950, Honeywell LXE Thor, Intermec CK71, Intermec CN3, Motorola, Motorola MC9190, MobileDemand, MobileDemand xTablet T7000, Datalogic, Datalogic Elf, Datalogic Falcon X3,  Vangard Voice AccuSpeech, CipherLab, Keyence, Custom, Android 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 ITS OPERATION WILL BE UNINTERRUPTED 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 Server 2012-2022 and Windows 10/11 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.  TELNET SERVER SOFTWARE MAY BE INSTALLED ON A SINGLE WINDOWS SERVER 2012-2022 AND WINDOWS 10/11 SYSTEM. 

 


Table of Contents


The Real Pioneers - Often copied but never equaled 2

User’s Guide 4

Product Description 5

Server Software 6

Agent Process 6

Client Software 6

Georgia SoftWorks UTS Product Configurations 7

GSW UTS Components Overview 7

GSW UTS – Telnet Server 8

GSW UTS – SSH Server 8

Installation 9

GSW UTS 32-bit and 64-bit Editions 9

Server Installation 10

Registration 16

Software Registration 16

How to Register the Software. 16

Registration Using a Floating License – (Hardware Key) 20

Floating License – Hardware Key Installation Instructions. 21

Uninstall Floating License – (Hardware Key) 24

GSW UTS CLIENTS 25

GSW Clients and Operating Systems Diagram.. 26

GSW Client Support for Voice Enabled Control 27

GSW Desktop Clients 28

Installation Steps. 28

UN-Install 31

GSW Mobile Clients 32

GSW Universal Mobile Clients Overview.. 32

Universal Mobile Clients for Windows CE .NET 4.2/5/6+. 32

GSW Universal Mobile Clients for Windows Pocket PC, Windows Mobile 2003/WM5/WM6+. 32

GSW Enhanced Mobile Clients for Windows CE .NET 4.2/5/6+ Overview.. 32

Select the correct GSW Windows Mobile Client 33

Installation steps. 34

Enhanced GSW Windows Mobile Clients List 35

Extended Features for Windows CE .NET 4.2/5/6+ Devices. 43

Stay Connected. 44

Allow Suspend – Power Saving Feature. 44

Beep sound – Correct Operation. 44

Menu Accelerators / Shortcuts 44

Simplified Chinese Font Support 45

Select Configuration for Session. 46

Portable Session Configuration – A Real Time Saver! 46

Last Active Session Memory. 46

No Scrollbars Option. 47

Hide Status Bar and/or Task Bar 48

No Scrollbars Option. 49

Automatic Logon for Mobile Clients 50

Keyboard Macros 51

Break-Out Sequence. 52

Extended Features for Pocket PC 2003 and Windows Mobile 2003/WM5/WM6+ Devices. 52

Keyboard Macros 52

Free Function Keys 52

Application Launch Bypass 52

Simplified Chinese Font Support 53

Configuration and Application Persistence. 54

GSW Universal Mobile Client Persistence. 54

Mobile Client Configuration Persistence. 54

Mobile Client Application Persistence. 54

Mobile Client Persistence Instructions 55

GSW Pocket PC 2003 Universal Mobile Client Persistence. 57

PPC 2003 Configuration Persistence. 57

PPC 2003 Application Persistence. 57

PPC 2003 Persistence Instructions 57

Tips for Intermec CK30 / CK31. 59

Tips for Intermec CV60. 61

Tips for PSION-TEKLOGIX WORKABOUT Pro, 7535 and 8525 devices. 62

Tips for SYMBOL MC 9060G / MC9090 devices. 63

Tips for LXE MX3X Devices. 64

Tips for PSC Falcon 4410. 66

Application Protection. 71

Backup and Restore the Georgia SoftWorks SSH/Telnet Server 73

How to use the GSW Universal Terminal Server for Windows 74

Georgia SoftWorks Client 74

Host 74

Login ID.. 75

Domain Name. 77

Georgia SoftWorks Desktop Client Command line options – Description. 78

GSW Telnet and SSH Client command line options - Usage. 81

Automatic Update of Georgia SoftWorks SSH2/Telnet Client 83

Application Title Display. 86

Desktop Client Display ‘X’ in Top Right Corner. 87

Answerback Text 88

Desktop Keyboard Macros 89

Terminating a session 90

Client Self-Terminate a Session. 90

Connecting using a 3rd Party Client 91

Feature Packs - Overview 92

Security Pack 93

Encrypted Data Stream – Telnet Server 94

Data Stream Encryption Client Parameters. 94

Data Stream Encryption Server Environment variable. 94

Enable Encryption Server Registry variable. 95

Proper Operating System DLL’s. 95

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

Encrypted Logon Sequence 96

Encryption Based on IP Address 97

Encryption – SSH Server 98

Encryption – FIPS 140-2 98

Connection Restrictions 99

Restrict access based on User ID.. 99

Restrict access based on IP Address. 99

Restrict users access to a specific application. 101

Restrict connections from 3rd Party Clients. 101

Restrict access based the number of connections. 102

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

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

Restrict connection to only encrypted sessions – Telnet 108

Expired Password Handling 109

Integrated with Windows Security 109

Performance Pack 110

Fast, Fast, Fast 110

Compression for slow link speeds 110

Slow link and Internet optimizations 110

Proprietary performance algorithms and code optimizations. 110

DOSBoss MSDOS Application performance booster. 110

Automatic Logon – Autologon 112

Autologon with GSW Windows Clients. 112

Automatic Logon 3rd Party Clients. 114

Automatic Logon Summary. 115

GSW UTS x64 Native 64-Bit 116

RF DTIO Interface 117

Team Services 118

Team Services General Operation 120

Overview.. 120

Dynamic non-cryptic text abbreviations for small screens. 123

Team Services Tasks 126

Transfer. 126

Swap. 128

Share. 130

Recover. 132

Session Information. 133

Open Team Services Tasks Menu 134

Strict Teams Configuration 135

Team Services Configuration and Security 138

Team Services Recovery. 139

Team Services Transfer. 140

Team Services Swap. 141

Team Services Share. 142

Team Services Left Justify. 143

Team Services HOT KEY. 144

Session Administrator support for Team Services 146

Session Administrator support Team Services - States. 146

System Administrator support for Team Services - Share. 147

Team Services Troubleshooting 148

Failure Detection and Recovery Pack 150

Session Saver 150

Session Reconnection Timeout 152

Reconnection based on User ID – Used for Unique User Logons. 152

Reconnection based on IP Address and User ID. 153

Session Saver Required Session License Count 153

Complete Session Cleanup 154

Complete NTVDM Cleanup 154

Server-Side Inactivity Timer 154

Server-Side Heartbeat Timer (Global) 156

Server-Side Heartbeat Timer (by User) 156

Server-Side Heartbeat for Third Party Clients 157

Client-Side Heartbeat Timer for GSW Windows Clients 157

Max Heartbeat Delay 158

Graceful Termination of DOS Applications 159

Termination Scripts 162

Termination of Child Processes 163

Legacy Pack 164

Mouse 164

DOS Character Mode Color Graphics 164

Function Keys 165

Special Characters 165

Screen Sizes other than 25 x 80 165

Alt Key Support for all emulations 165

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

Emulation Pack 167

3rd Party Clients 167

Terminal Emulation. 167

Graphic Characters. 169

Color or Monochrome Presentations. 171

Color Mapping for Monochrome. 171

Modification of Color Mapping for Monochrome. 172

Alt Keys. 173

ESC Delay. 175

Enable NAWS. 176

Device Telemetry Data and Client Information – 3rd Party Clients. 176

Send Screen Size to 3rd Party Client 178

Enable Pseudoconsole. 179

Mouse – 3rd Party Mouse Support 181

Domain Specification using 3rd Party Clients. 181

Color Re-mapping – All Clients. 182

Automatic Logon 3rd Party Telnet Clients - AutoLogon. 184

Character Display Translation:  3rd Party Clients. 184

Terminal Initialization:  3rd Party Clients. 185

Backspace on Delete – For 3rd Party Clients. 186

Two Cells per Unicode Character – For 3rd Party Clients. 187

Power Features Pack 188

Session Administrator 188

Session Monitoring Privileges. 188

Starting the Session Administrator. 190

Observing SSH2/Telnet Sessions. 191

Monitoring. 194

Shadowing SSH/Telnet Sessions. 196

SSH FIPS 140-2 Sessions. 197

Terminating SSH2/Telnet Sessions. 198

Attach to a Suspended (Saved) Session. 199

Send a Broadcast Message to SSH2/Telnet Sessions. 200

Broadcast a message to ALL SSH2/Telnet Sessions. 200

Broadcast a message to A SINGLE Telnet Session. 203

Schedule a Broadcast Message. 206

Exiting the Session Administrator. 208

GS_ADMIN Command Line Options. 209

Session Monitoring Uses. 212

GSW Event Logging 213

Event Log Definition File: 213

Event Log File. 214

Modify the Log File Size. 215

GSW Session Logging 216

Modify the Session Log File Size. 216

Enable/Disable Session Long Format Logging. 217

Enable/Disable International Character Translation Logging - For Third Party Clients. 218

Logon Scripting 219

USER Logon Scripts. 219

Global Logon Scripts. 221

IP Address Based Logon Scripts. 221

Programmatic Access to the SSH/Telnet Server 226

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

Default Printing. 227

Enhanced Printing. 227

Open Printing. 227

Setting up True Client-Side Printing. 228

Create a virtual printer on the server. 228

Set virtual printer redirection commands in logon script. 230

Enhanced Print Method. 231

Open Print Method. 237

Passthrough Print Method. 242

Client Identity and Uniqueness 244

Compatibility Pack 245

RF Terminals – Bar Code Scanners 245

RF Devices using Power Save or Sleep Mode. 246

TCP Receive Windows Size. 247

TCP Maximum Retransmission Count 247

Create User Profile. 248

Custom Shell Path. 250

Refresh Character. 251

Unicode – UTF-8 Encoding. 252

Unicode Character Support with the GSW Windows SSH2/Telnet Client 253

UTF-8 Encoding with 3rd party telnet/SSH clients. 256

Telnet IP Protocol 257

SSH IP Protocol 258

UTS Protocol 259

Utility Pack 260

Change Password command line utility 260

Connection Banner 261

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

File Transfer command line Utility 266

GS_PUT - Transfer from Server to Client 266

GS_GET - Transfer from Client to Server. 271

GS_PUT Error Values. 272

GS_GET Error Values. 274

Reboot Windows Server computer command line utility. 277

Shutdown command line utility for Windows 278

Remote Registration Utility 279

Special Bell Processing 280

GSWBELL - Special Bell Processing for SAPConsole 281

TTY Name 282

Client Scroll Bars 282

Setting a Default Domain 283

3rd Party Client - Default Domain Override 284

Setting the Telnet Port or Multiple Ports 285

Use an Alternative Telnet Port. 285

Configure Multiple Telnet Ports 285

Georgia SoftWorks Java Telnet Applet 287

Required Java support 288

Required Files for the GSJC. 288

Required Files. 288

Client-Side Printing - All Browsers. 288

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

Client-Side Printing Capabilities: 288

GSJC Applet parameters 289

Optional Parameter:  port 289

Optional Parameter: user 289

Optional Parameter: password. 289

Optional Parameter: domain. 289

Optional Parameter: address. 289

Optional Parameter: useTopLeftLocation. 289

Optional Parameter: useMSDOSFrame. 289

Optional Parameter: useBorders. 290

Optional Parameter: useBoldFont 290

Optional Parameter: bkgColor 290

Optional Parameter: HBTime. 290

Optional Parameter: useEncryption. 290

Optional Parameter: printCommand. 290

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

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

Sample web page for systems with Netscape Communicator. 293

Sample web page for systems with other browsers. 294

Applet size 294

Georgia SoftWorks Java Telnet Client 295

Required Java Support 295

Required Files for the GSJC. 295

Invoking the GSJC 295

Encryption 295

Frequently Asked Questions 297

Discussion: Orphaned NTVDM's and Windows SSH2/Telnet Servers 304

What are NTVDM's and why are they important for Windows SSH2/Telnet Servers? 304

When are NTVDM's created? 304

What are Orphaned NTVDM's? 304

Why is this a concern? 304

What types of events cause orphaned NTVDM when using SSH2/Telnet? 304

What can be done about Orphaned NTVDM's? 305

Discussion: PIFs and your MS-DOS application's Performance 306

Vangard Voice Systems AccuSpeech with the GSW UTS 308

GSW Mobile Client configuration for Vangard Voice AccuSpeech 309

Windows CE Configuration. 309

Windows Mobile Configuration. 313

GSW Desktop Client configuration for Vangard Voice AccuSpeech 315

SAPConsole with the Georgia SoftWorks Telnet/SSH Server 317

SAPConsole with the GSW Pocket PC 2003 SSH2/Telnet Client 318

Configuration Steps for the GSW Pocket PC 2003 SSH2/Telnet Client. 318

How to Automatically Launch SAPConsole from A SSH2/Telnet Session 322

SAP User Name displayed in GSW Session Administrator. 323

Mobile Device Printing with SAPConsole 324

SAPConsole Mobile Printing Components 325

Configuration Details 326

Steps To Configuration. 326

Install and Configure Georgia SoftWorks SSH2/Telnet Server. 327

Configure SSH2/Telnet Server for Mobile printing. 327

Configure each SAPConsole user for local printing. 327

Install and configure SAPLDP on SAPConsole machine. 327

Configure mobile printers in R/3. 329

Modify RF device configuration to allow printing. 329

Create sapscript form containing barcode label for mobile printer. 329

Determine or create R/3 printing logic. 330

SAPConsole and the GSW Rocket Terminal Engine. 331

Environment Variables Set by the User 332

Environment Variables Set by the Telnet/SSH Server 334

Registry Variables 335

Configuration Text Files used by the SSH2/Telnet Server 337

GSW UTS Configuration Tool 338

Overview 339

Launch the GSW Configuration Tool 340

UTS Configuration Tool ICONS. 341

GSW UTS Configuration Tool Right Click Operations. 342

Configuration Tool Tree View Hierarchy 344

UTS Configuration Tool - Root 344

Global – per system.. 345

Active Configuration. 346

UTS System Templates Configuration Root 347

UTS System Template. 348

User – per session. 350

Domains. 351

Domain Name. 353

Domain User - Specific. 354

Local Users. 355

Local User - Specific. 356

IP Address/Ranges. 357

Specific IP Address/Range. 358

Grandfathered Users. 359

Grandfathered User - Specific. 360

User Templates. 361

User Template - Specific. 362

GUI Migration for Existing Users 363

Common Questions about Migrating to the UTS GUI Configuration. 363

Logon Script Migration. 364

Registry Setting Migration. 364

Environment Variable Migration. 364

Scripts Folders 365

Domain Users 365

Local Users 365

Templates 365

Logon Scripts (Batch Files) 366

Registry Settings 366

Environment Variables 366

Text Files 366

Global – Active Configuration 367

Automatic Logon. 369

Security Summary. 370

Security - Telnet Encryption. 371

Security – Connection Restrictions. 372

Security – Connection Limits. 373

Security – FIPS Restrictions. 374

Restrict Access to GSW FIPS 140-2 Clients 374

Restrict Access to GSW SSH clients 375

Restrict Access to SSH clients 375

Allow all clients to connect 376

Failure Detection / Recovery. 377

Power Features Summary. 378

Power Features – Printing. 379

Power Features – Team Services. 380

Power Features – Event Logging. 381

Emulations Summary. 382

Emulations - Character Emulation. 383

Emulations – Default Domain. 384

Emulations – Negotiate Windows Size. 385

Emulations – GSW ConnectBot Device and Client Info (Strings) 386

Emulations – Send Screen Size to 3rd Party Clients. 388

Emulations – Pseudoconsole. 389

Emulations – 3rd Party Mouse Support 390

Emulations – Color Mappings. 391

Emulations – Character Translation. 392

Emulations – Terminal Initialization. 393

Bell Control 394

Protocols. 395

UTS System Templates