GSW ConnectBot Android Client for SSH/Telnet

 

 

 

 

Text Box: GSW ConnectBot and 
Licensing and Deployment Server (LADS)
 

 

 

 

 

 

 

 

 

 


User’s Guide

 

 

Logo

Description automatically generated

 


 


 

 

 

 

 

THIS PAGE INTENTIONALLY LEFT BLANK


Georgia SoftWorks

Public Square

17 Hwy 9 South, PO Box 729

Dawsonville Georgia 30534

Telephone +1 706.265.1018 * Fax +1 706.265.1020

Visit Georgia SoftWorks web site

 

Copyright © Georgia SoftWorks, 2021 All Rights Reserved.

Google, Android, Google Play, ConnectBot, are trademarks of their respective companies.

GSW DOC UGECB001006082021

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.

LICENSE:

YOU ARE LICENSED FOR AN INSTANCE OF THE GSW CONNECTBOT CLIENT SOFTWARE ON A SINGLE SPECIFIC DEVICE. ANY ATTEMPT TO DUPLICATE THE LICENSE IS IN VIOLATION OF THIS AGREEMENT.  THE GSW CONNECTBOT SOFTWARE MAY BE INSTALLED ON A SINGLE ANDROID DEVICE.


 

Table of Contents

Terms, Icons and Conventions. 1

Overview.. 3

Quick Start SSH Configuration. 4

Installation. 5

Installation from Google Play. 5

Installation from Download. 6

Enable “Unknown Sources”. 7

Copy and Install APK to Device - Sideloading. 10

Launching GSW ConnectBot 12

Registration of the GSW ConnectBot License. 13

Check the License Status. 13

Registration by GSW Licensing and Deployment Server (LADS) 18

Manual Registration. 21

Update the GSW ConnectBot software. 29

Updating Software by Licensing and Deployment Server (LADS) 30

Updating Software by manually obtaining gsw-connectbot.apk. 34

Updating Software by URL. 35

GSW ConnectBot Host Configuration and Connections. 38

Create new Host Connection Configuration. 38

Host Connection Operations. 41

Initiate Connection. 42

Session Menu. 42

2-Tap Screenshot 43

Host Connection Menu. 44

Disconnect 44

Edit Host 44

Edit Port Forward. 44

Edit auto response fields. 45

Delete Host Connection. 46

Security Information. 47

Global Settings. 48

Remember keys in memory. 50

Persist connections. 50

Keep Wi-Fi active. 50

Backup pubkeys. 50

Emulation mode. 50

Scrollback size. 50

Rotation mode. 50

Auto hide title bar. 50

Full screen. 50

Page up/down gesture. 50

Volume keys change font size. 50

Keep Screen awake. 50

Fast updates. 50

Collect Business Intelligence data. 51

Use GSW keyboards. 51

Use GSW keyboard skins. 51

Special keys always visible. 51

Shift+num are F-keys. 51

Hide Soft Keyboard. 51

Ctrl+num are F-Keys. 51

Sticky modifiers. 51

Directory shortcuts. 51

Camera shortcut 51

Bumpy arrows. 51

Audible Bell 51

Bell Volume. 51

Vibrate on bell 52

Background notification. 52

Upload screenshots to GWS LADS. 52

Show screenshot message. 52

Using Answerback with the GSW SSH/Telnet Server. 53

Answerback Example Configuration. 54

SSH Configuration. 56

Configure a Host Connection Example 1. 56

SSH with Password Authentication. 56

Save host connection configuration. 57

Connect to the new configured connection. 57

Configure a Host Connection Example 2. 58

SSH with Public/Private Key Authentication. 58

Using a Public/Private key pair. 59

Configuring the Host (Public) key on a GSW UTS SSH Server. 64

Creating a Public Private Key Pair for Distribution to Multiple Clients. 67

Generate a Key Pair using PuTTY. 67

Installing Private Key to GSW ConnectBot Android Client 70

Adding the Public Key to the GSW UTS Server using the GSW SSH Shield Certificate Mapping Tool 75

Telnet Configuration. 79

Configure a Telnet Host Connection. 79

Managing Host Configuration with the GSW LADS. 83

Uploading an Existing Configuration. 83

Downloading an existing configuration. 86

Client Lockdown. 88

Lockdown (Pinning the app) on Android 7.0+. 89

Admin mode vs Work mode. 94

Device Telemetry Data Variables. 95

Macros. 95

Environment Variables. 96

GSW Licensing and Deployment Server (GSW LADS) for Windows. 97

Installing the Georgia SoftWorks Licensing and Deployment Server. 98

Registering the Georgia SoftWorks Licensing and Deployment Server. 101

GSW LADS Operation. 104

GSW ConnectBot LADS XML Configuration File. 104

Manage Licensing. 106

LADS Table Utility. 108

Upload / Download GSW ConnectBot Configuration. 110

Zero Touch Configuration. 111

Rapid 2-Tap Screen Shot Upload to GSW LADS. 112

Public/Private Key Import/Export 113

Custom Keyboards. 115

Standard GSW Keyboards. 115

Business Intelligence (BI) 117

Screen Recognition / Custom Keyboard association. 118

Custom GSW Keyboards. 119

GSW Standard Keyboards. 121

Technical Support 132

 

 

 


 

Table of Figures

Figure 1: Overflow menu. 2

Figure 2: Where to obtain GSW ConnectBot 3

Figure 3: SSH Quick Start 4

Figure 4: First time installation Android 8+. 5

Figure 5: First time installation Android 7.x and lower. 5

Figure 6: Android device listed in Windows Explorer. 6

Figure 7: Unknown Apps popup. 7

Figure 8: App specific Allow from Source Setting. 7

Figure 9: Enable App specific Allow from this source. 7

Figure 10: Terse Alert Message Writing to SDCard. 8

Figure 11: Locate GSW ConnectBot in the app Info. Opens GSW ConnectBot app settings. 8

Figure 12: Tap Advanced. 8

Figure 13: Tap Install unknown apps. 8

Figure 14: Tap Allow from this source. 8

Figure 15: Allow from this source is enabled. 8

Figure 16: Set Unknown Sources. 9

Figure 17: APK on device. 10

Figure 18: Install screen. 10

Figure 19: Installation progress bar. 11

Figure 20: Installation complete. 11

Figure 21: Admin and Work Modes. 12

Figure 22: Hosts - More Options. 13

Figure 23: Hosts - Licensing. 13

Figure 24: Check License Info. 14

Figure 25: Tap Continue to see License Info. 14

Figure 26: Free Trial License Found. 15

Figure 27: Trial License Expired. 15

Figure 28:  Subscription Expired. 16

Figure 29: Permanent License - Manual Registration. 17

Figure 30: Temporary License Applied. 17

Figure 31: Register Using GSW LADS. 18

Figure 32: Automatically Locate GSW LADS. 18

Figure 33: GSW LADS Server is Located. 19

Figure 34: Get License for GSW LADS. 19

Figure 35: Product License retrieved from GSW LADS. 19

Figure 36: Return GSW ConnectBot License from device. 20

Figure 37: Notification that the License was successfully released. 20

Figure 38: Permanent License – Serial Number. 21

Figure 39: Permanent License - Continue. 21

Figure 40: Create Product ID.. 22

Figure 41: Allow access if needed. 22

Figure 42: Close Dialog. 23

Figure 43:  Product ID created. 24

Figure 44: request.c2g placed in root/android/data/com.gsw.connectbot/files. 24

Figure 45: Request .c2g placed in root - v2.7.067 and lower. 24

Figure 46: Copy serial.g2c to main storage root 26

Figure 47: Apply Serial Number from file. 26

Figure 48: Locate the serial.g2c file. 27

Figure 49: Serial Number Applied Successfully. 27

Figure 50: All Done, Tap Continue. 27

Figure 51: Paste Serial Number. 28

Figure 52: Tap APPLY after pasting serial number. 28

Figure 53: Admin Mode - Update software. 29

Figure 54: Work Mode - Update Software. 29

Figure 55: Hosts - More Options - Update. 30

Figure 56: Tap Update. 30

Figure 57: Update TAP GSW LADS. 31

Figure 58: TAP Continue. 31

Figure 59: Check for Update. 31

Figure 60: Use GSW LADS Update Screen. 31

Figure 61: Locate GSW LADS. 31

Figure 62: GSW LADS - Update Found. 32

Figure 63: GSW LADS - running latest version. 32

Figure 64: Install Update. 33

Figure 65: May be prompted to allow access to photos. 33

Figure 66:  Update is downloading. 33

Figure 67: Install Update. 33

Figure 68: Tap Open to launch. 33

Figure 69: Select version to install 34

Figure 70: Tap install 34

Figure 71: Tap the overflow menu. 35

Figure 72: Tap Update. 35

Figure 73: Select Use URL. 35

Figure 74: Tap Continue. 36

Figure 75: Tap Check For Updates. 36

Figure 76: Update Found - Tap OK. 36

Figure 77: Install Update button highlighted. 37

Figure 78: You may a security prompt - tap Allow.. 37

Figure 79: Tap Install 37

Figure 80: Installed. 37

Figure 81: Creating a Host 38

Figure 82: Configuring a Host connection. 39

Figure 83: Host Connection Screen Display. 41

Figure 84: Session overflow menu. 42

Figure 85: Tap 1 - Tap overflow menu. 43

Figure 86: Tap 2 - Tap Screenshot 43

Figure 87: Success. This prompt can be disabled in the Global Settings. 43

Figure 88: Host List - Long Press Menu. 44

Figure 89: Create Auto-Response field. 45

Figure 90: Edit Auto Response Field. 45

Figure 91: Auto Response Field completed. 45

Figure 92:  Auto Response created. 46

Figure 93: Secure Algorithms. 47

Figure 94: Un-Secure Algorithms. 47

Figure 95: Menu to access Global configuration. 48

Figure 96: Accessing Settings. 48

Figure 97: Select Settings. 48

Figure 98: Global Settings menu. 52

Figure 99: Answerback Settings. 53

Figure 100: Creating a Host 56

Figure 101: Enter Host Information. 57

Figure 102: Saving the Connection. 58

Figure 103: Host Screen for Key Generation. 59

Figure 104: Manage Pubkeys menu item.. 59

Figure 105: Create SSH Key Pair. 60

Figure 106: Generate Randomness for Keys. 61

Figure 107: Generate Randomness until 100%.. 61

Figure 108: Unlocking a Key Pair. 62

Figure 109: Copy Public Key. 64

Figure 110: Certificate Mapping Tool 65

Figure 111: Installing Public Key. 65

Figure 112: Key Installed. 66

Figure 113: Restart SSH Service. 66

Figure 114: Open PuTTYgen. 67

Figure 115: Generate Randomness. 68

Figure 116: Enter Passphrase. 69

Figure 117: GSW ConnectBot Admin Icon. 70

Figure 118: Tap "overflow menu". 70

Figure 119: Manage Pubkeys. 71

Figure 120: Select Folder Icon. 71

Figure 121: Navigate to Downloads. 72

Figure 122: Select Key. 73

Figure 123: Tap Key and Enter Passphrase. 73

Figure 124: Access the Options Menu. 74

Figure 125: GSW Certificate Mapping Tool 75

Figure 126: Enable Mapping. 76

Figure 127: Created Mappings. 77

Figure 128: Restart the SSH Shield. 77

Figure 129: Creating a Host 79

Figure 130: Defining a Telnet Host 80

Figure 131: Enter Configuration Information. 81

Figure 132: Connection Settings. 82

Figure 133: Saving the Connection. 82

Figure 134: Tap Upload configuration from the overflow menu. 83

Figure 135: Locate GSW LADS. 83

Figure 136: Upload Configuration. 84

Figure 137: Upload Complete. 84

Figure 138: Copy upload configuration to download folder. 84

Figure 139: GSW LADS Config File shortcut 85

Figure 140: Tap Download Configuration. 86

Figure 141: Select Configuration. 86

Figure 142: Tap download configuration. 87

Figure 143: Configuration download in progress. 87

Figure 144: Configuration download successful 87

Figure 145: Two Modes of Connection. 88

Figure 146: Create Host(s) 89

Figure 147: Settings Icon. 90

Figure 148: Tap Security Setting. 90

Figure 149: Pin Windows Option. 91

Figure 150: Ask for PIN before unpinning. 92

Figure 151: Pinning the Window.. 93

Figure 152: GSW ConnectBot - Admin Mode. 94

Figure 153: GSW ConnectBot Work Mode. 94

Figure 154: LADS components. 97

Figure 155: GSW LADS setup program.. 98

Figure 156: User Account Control Dialog. 98

Figure 157: Setup progress bar. 98

Figure 158: Welcome. 99

Figure 159: Installation Location. 99

Figure 160: Install folder. 100

Figure 161: Setup Complete. 100

Figure 162: LADS Registration UAC dialog. 101

Figure 163: GSW LADS registration tool opens. 101

Figure 164: Registration Tool with completed information. 102

Figure 165: Registration Tool - Serial Number Entered. 103

Figure 166: Registration Successful 103

Figure 167: GSW License Manager tool 106

Figure 168: Release License - Notice Available License Count 107

Figure 169: Enter Android ID, Click Release License. 107

Figure 170: License Released Confirmation. 107

Figure 171: Release License - Notice Available License Count Incremented. 107

Figure 172: LADSTble.exe folder. 108

Figure 173: Output of LADSTbl.exe utility. 108

Figure 174: GSW LADS - Software Updates. 109

Figure 175: Apk and .json located in the GSW LADS files folder. 109

Figure 176: GSW LADS Config Upload/Download folders. 110

Figure 177: Easy access to the Config Files via Windows Start Menu. 110

Figure 178: Hosts List - Select Upload Configuration. 111

Figure 179: Set Tag field to "Default". 111

Figure 180: Tap Upload Configuration. 111

Figure 181: Upload Progress bar. 111

Figure 182: Uploaded Successfully. 111

Figure 183: GSW LADS Screen Shot storage location. 112

Figure 184: Examples of stored Screen shots. 112

Figure 185: Public/Private Hosts screen. 113

Figure 186: Public/Private Key - Manage Pubkeys. 113

Figure 187: Pubkeys - Right Click on Key. 114

Figure 188: Swipe - Qwerty Customer Keyboard. 115

Figure 189: Swipe - Special Characters Customer Keyboard. 115

Figure 190: BI example charts. 117

Figure 191: More BI example charts. 117

Figure 192: Screen Recognition/Custom Keyboards. 118

Figure 193: Numeric Only Keys - Customer Keyboard. 119

Figure 194: Five Key Only - Custom Keyboard. 120

Figure 195: GSW Keyboard Special Key Definition. 121

Figure 196: 3 dot, overflow menu for show keyboard. 122

Figure 197: Select Show Keyboard. 122

Figure 198: Qwerty keyboard – Black-Green skin. 123

Figure 199: Special Keys keyboard – Stone Skin. 123

Figure 200: Numeric keyboard - Stone skin. 123

Figure 201: Landscape Symbols/Numeric Keyboard Anchored to Right Edge. 124

Figure 202: Landscape – Alpha Numeric keyboard – Yellow – Black skin. 125

Figure 203: Landscape Special Keys keyboard – Stone Skin. 126

Figure 204: Landscape Symbols/Numeric keyboard - Stone skin. 127

Figure 205: QWERTY keyboard – Vista Sky Blue skin. 128

Figure 206: QWERTY keyboard – Black Green Skin. 128

Figure 207: QWERTY keyboard - Black White skin. 128

Figure 208: QWERTY keyboard - Black Yellow skin. 128

Figure 209: QWERTY keyboard - Cinnamon skin. 129

Figure 210: Function keyboard – Stone White skin. 129

Figure 211: QWERTY keyboard – Vista Amber skin. 129

Figure 212: QWERTY keyboard – Vista Green skin. 129

Figure 213: Numeric keyboard – Stone skin. 130

Figure 214: QWERTY keyboard – Android Green skin. 130

Figure 215: QWERTY keyboard – Plum Crazy skin. 130

Figure 216: Qwerty keyboard – White Stone skin. 130

Figure 217: QWERTY keyboard – Caution Yellow skin. 131


Terms, Icons and Conventions

GSW ConnectBot – Admin Mode launcher Icon

GSW ConnectBot – Work Mode launcher Icon

 

Hand Pointer Icon – used when requested to “tap” or select a location on the screen with your finger, stylus, mouse, etc.

Hosts    - Host is used when identifying the SSH or Telnet Server to establish a connection

Host Connection and Host Configuration are used interchangeably when referring to the “Configuration that provides GSW ConnectBot with the information to establish a connection to a Host”. Typically used to refer to the list in the Hosts Screen.


Sideloading – Installing an application package in APK format on the Android device.

Vertical Ellipses Icon

Figure 1: Overflow menu

On Window Operation System menu item navigation

Arrows or Pipes will be used

Start->Georgia SoftWorks Licensing and Deployment Server

Or

Start|Georgia SoftWorks Licensing and Deployment Server

 


Overview

 

Thank you for purchasing the GSW ConnectBot.

 

GSW ConnectBot is a simple to use but a commercial grade Secure Shell (SSH) and Telnet client for Android. GSW ConnectBot is a feature rich client that both system administrators and users will appreciate. It is well suited to the demands of industrial environments.

 

When coupled with the GSW License and Deployment Server (LADS), Licensing is automatic, Zero Touch configuration is available, and you can spend more time working than administering. See page 97.

 

For the system administrator that has many devices to manage, the GSW ConnectBot comes with GSW LADS that manages licensing, configuration updates, software updates, and deployments. A light weight, easy-to-use tool that is a major time saver for the administrator as well as all the people working the devices.

 

Next to correct operation and usability, security is paramount.  GSW ConnectBot is the most cryptographically secure, commercially supported SSH client for Android available.  GSW set out to make sure the default security algorithms are current and considered safe via peer review. No propriety algorithms, no – non-safe algorithms.  Don’t be the next headline about a security breach.

 

 

Obtaining GSW ConnectBot

GSW ConnectBot can be obtained from the Google Play Store or the Georgia SoftWorks web site. For upgrades you can also obtain from your local GSW LADS (page 97).

Figure 2: Where to obtain GSW ConnectBot

When first obtained and installed the GSW ConnectBot will operate in a fully functional 30-day trial mode. 

 


 

Quick Start SSH Configuration

For those wanting to get started fast, here is a quick start step guide to get that first connection up.

Figure 3: SSH Quick Start

Note: Telnet is similar, just be sure to change the Protocol in the Host Configuration from SSH to Telnet.

Installation

 

Installation can be done directly from Google Play Store or by downloading from Georgia SoftWorks website. The figure below is an overview of the steps.

 

Figure 4: First time installation Android 8+

 

Figure 5: First time installation Android 7.x and lower

 

Installation from Google Play

To install from Google Play your device must have internet access. 

            On your Android device, open Google Play Store. 

            Search for GSW ConnectBot.

            Select GSW ConnectBot (free trial) – Telnet/SSH Client.

 

            Select Install.

 

 

Installation from Download

 

The GSW ConnectBot is a standard Android Package Kit (APK).  Download GSWConnectBot.apk from the GSW website.  If your device has a browser and internet access you can download and install on the device. Otherwise use another computer to download the APK and then copy the APK to the device and execute.

 

Once installed, configure the connections with the features desired. Please keep in mind that device settings may vary between Manufacturers and Android versions. GSW ConnectBot has been tested on multiple devices, and Android versions 4.4.2 through 11.00

 

Following are instructions on how to install GSW ConnectBot on your device. Installation is a simple process. To summarize:

 

·       Enable Allow Unknown Sources

·       Copy APK to Device

·       Run APK installation

 

Example 1. Using a USB Connection

To begin, connect the device to your workstation via a USB cable. The device should appear in the Windows Explorer navigation pane.

Figure 6: Android device listed in Windows Explorer

Enable “Unknown Sources”

Android security requires that “Install Unknown Apps/Allow from this source” be enabled in order to sideload updates or write to local storage from some applications.

Android versions prior to version 8 used a global setting to control sideloading, and must be enabled prior to the installation of the application.

This became a per-application setting for Android versions 8 and higher, and the setting can only be changed after the application has been installed.

Each manufacturer's devices setting location can differ, please see devices manual for further instructions on sideloading. See generalized examples below. 

Android Version 8 and higher

Permissions on Android versions 8+ are set on a per-application basis. Regardless of whether you install from the Google Play Store or sideload the APK from www.georgiasoftworks.com, you must enable “Unknown Sources” for the GSW ConnectBot application to be able to sideload GSW ConnectBot updates from GSW LADS, and other instances where GSW ConnectBot needs to write to internal storage of device.  Not all manufacturer implementations are the same.  Some will offer a popup menu to dynamically set/allow unknown sources, and some will emit a terse error message about the inability to write data.  In most cases, this security setting can be found under the target application (GSW ConnectBot) in the “Apps” settings menu. 

Example: Generalized example of popups to “allow from this source”. 

Figure 7: Unknown Apps popup

Figure 8: App specific Allow from Source Setting

Figure 9: Enable App specific Allow from this source

 

Generalized terse messages that require enabling from unknown sources.

The example below with GSW ConnectBot shows permission error to write to the device. In the device settings, locate the App Info.  Tap on the GSW ConnectBot and navigate to “Allow from this source” as shown in Figure 15.              

Figure 10: Terse Alert Message Writing to SDCard

Figure 11: Locate GSW ConnectBot in the app Info. Opens GSW ConnectBot app settings

Figure 12: Tap Advanced

Figure 13: Tap Install unknown apps

Figure 14: Tap Allow from this source

Figure 15: Allow from this source is enabled

 

 


Android Versions Prior to 8

On the device, make sure that “Unknown Sources” is turned ON under “Security” menu in “Settings”. This allows applications to be installed from outside the Google Play Store. The name of the “Security” menu may vary from device to device.

 

Figure 16: Set Unknown Sources

 

 

 


 

Copy and Install APK to Device - Sideloading

Copy the GSW ConnectBot APK to the device using Windows Explorer, download or by whatever method you choose, preferably to the “Download” folder, as some device File Managers limit access to files at the root of storage. The name of the actual GSW ConnectBot APK is gsw-connectbot.apk or gsw-connectbot-version.apk, where version is the version number of the release.

Next, Tap the GSW ConnectBot APK shown in   Figure 17  and the screen in Figure 18 is displayed.

 

 

Copy APK to the Device

Installation Screen

   Figure 17: APK on device

              Figure 18: Install screen

 

 

Next, tap the “INSTALL” button as shown below in Figure 18.

 


Installation continues and completes.

Figure 19: Installation progress bar

Figure 20: Installation complete

 

Tap “OPEN” to immediately begin configuration of GSW ConnectBot. The App will open into Administrative mode by default, as described in the next section.

 

 

Launching GSW ConnectBot

 

The GSW ConnectBot, built for commercial environments has administrator mode and a user (work) mode.  This provides a clean and distinct division of roles where the worker can focus on their activities without concern for the administration details. The Administrative mode is a superset of Work mode, meaning the Administrator can do everything the Worker can do plus more.

Administrative mode includes:

·       Licensing

·       Creation/Deletion and configuration and use of connections

·       Manage Pubkeys

·       Background/Foreground color translation

·       Locking the Work mode to an application.

 

The Work mode is used for:

·       Launching preconfigured connections

·       Updating the software

·       Downloading configuration

·       Licensing

 

The Administrator can preconfigure many connections to multiple host computers. Multiple connections can be active simultaneously and the user can easily navigate between connections.   The Work mode is a restricted, lockable version for the end users that the administrator controls.

 

Work mode users can launch preconfigured connections created by the Administrator. This allows workers to use preconfigured connections reducing errors and saving time.  Additionally, the Work mode user can be limited to running only GSW ConnectBot, using a process call “App Pinning”, which we will discuss later in this manual (page 89).

 

Note: When switching between Admin and Work Mode you must force stop the application, then launch the desired mode. 

 

The launcher icon with the gear is the Administrator. The icon without the gear is for Work mode users which is a restricted, lockable version for end users.

 

GSW ConnectBot – Admin Launcher Icon

Figure 21: Admin and Work Modes

GSW ConnectBot – Work Launcher Icon

Table 1: Admin and Work Launcher Icons

Registration of the GSW ConnectBot License

 

The GSW ConnectBot will operate in a fully functional trial mode for 30 days.  To enable permanent operation, a software license needs to be applied.  Registering the software is the process to obtain and apply a valid license for the GSW ConnectBot.

 

There are two options available to license the GSW ConnectBot

 

·       Fast Registration - Use the Georgia SoftWorks Licensing and Deployment Server (LADS) See page 18

·       Manual Registration - Send product identification code to GSW and a serial number is returned and applied. See page 21

 

Registration - This entails sending a product identification code to GSW and we will return a Serial Number.  Apply the serial number and this activates the license for GSW ConnectBot.

Check the License Status

To determine the status of your GSW ConnectBot license, navigate to the GSW ConnectBot Licensing screen.

Tap on the Admin Launcher Icon.

Tap on the overflow menu as shown in Figure 22.

The overflow menu opens. Now tap on Licensing as shown in Figure 23, and the licensing screen opens as shown in Figure 24

 

Figure 22: Hosts - More Options

Figure 23: Hosts - Licensing

 


Tap on Check License Info, followed by CONTINUE

Figure 24: Check License Info

Figure 25: Tap Continue to see License Info

 

The type of license assigned to GSW ConnectBot is dependent on the installation and registration process. The software can have three types of licenses:

·       Trial - When installed via the Google Play store or an .apk from the GSW website, a fully functional 30 days trial license is installed. No registration is required.

·       Permanent - The manual registration process installs a Permanent license. The permanent license never expires. Note: if the device is destroyed, factory reset, or the application is uninstalled, the license will be lost and a replacement license will need to be requested. 

 

·       Temporary - GSW LADS leases licenses to GSW ConnectBot clients. This leased license is termed temporary and will expire at a pre-set time, default of 3 days. GSW ConnectBot will automatically renew the lease and workflow will not be interrupted.

The GSW ConnectBot License information shows the license status, the registration process, the subscription expiration date and other relevant information to the license status.

 

Expiration date

Trial License: Date that the software will stop operating

Permanent: Not Set; the software will not stop operating

Temporary: The date that GSW LADS will renew the Lease for the license.

 

Subscription until – The date that the subscription expires. The software will continue to operate with entitled versions. Versions released after the subscription date will not operate unless the subscription is renewed.  In addition to access to free version upgrades, premium technical support is also included for the duration of the subscription.

 

Android_ID – This is an Android Identifier string

 

GSW CB Version – The GSW ConnectBot Version installed

 

GSW CB build date – The GSW ConnectBot build date.

 

Examples of the GSW ConnectBot licensing information are shown on the following pages.

 

 If the software is operating using the Trial license the status will be similar as shown in Figure 26.

Trial Version

Trial Version Expired – No License

Figure 26: Free Trial License Found

 

Figure 27: Trial License Expired

Expired Trial or Expired subscription license status is show in Figure 27 and Figure 28.

Subscription Expired – New software version not allowed with expired subscription

Figure 28:  Subscription Expired

When a permanent license is applied using a Manual registration, it will be displayed similar as shown in Figure 29

If the software was licensed via GSW LADS (License and Deployment Server) the License information will look as described in Figure 30.

Permanent License – Manual Registration

Temporary License – GSW LADS Registration

Figure 29: Permanent License - Manual Registration

The date that the subscription expires is shown as well.

Figure 30: Temporary License Applied

Free version updates and support are available through the “Subscription Until” date.

 

 

Registration by GSW Licensing and Deployment Server (LADS)

If you have the Georgia SoftWorks Licensing and Deployment Server (LADS) installed, obtaining a license for GSW ConnectBot is a breeze.

See your system administrator to determine if GSW LADS is installed or use the GSW ConnectBot Locate GSW LADS “button” to try and locate a GSW LADS.

To lease a license, GSW ConnectBot locates the GSW LADS and requests a license.

Navigate to the Georgia SoftWorks Licensing screen. Select “Use Georgia SoftWorks License Server” radio button and TAP “Continue” as shown in  

Figure 31.

The screen in   Figure 32 is opened.

 

 

  

Figure 31: Register Using GSW LADS

 

Figure 32: Automatically Locate GSW LADS

 

 

 

1.       If the Host is not already populated then you must Locate GSW LADS. If it is populated then you can skip this step.

 

TAP “LOCATE GSW LADS” as shown in Figure 32 to locate the GSW License and Deployment Server.  Notice that the Host does not need to be manually filled in unless GSW LADS cannot be located. Also, the default port 12574 should not be changed without a good reason.

 

When located, the screen is updated. The Host address of the GSW LADS server as shown in Figure 33.  Note: Your host IP address will be different than the one displayed in the example.

 

2.       TAP “GET LICENSE” as show in Figure 34

 

Figure 33: GSW LADS Server is Located

Figure 34: Get License for GSW LADS

 

If a license is available for distribution, GSW ConnectBot will be licensed. This is confirmed by GSW LADS that the product license has been retrieved. TAP “Continue” to finish licensing.

Figure 35: Product License retrieved from GSW LADS

Return License to License and Deployment Server (LADS)

 

 If a device is being de-commissioned; return the license to GSW LADS so the license can be reused with another device. Navigate to Georgia SoftWorks Licensing and Deployment Server as described starting in  

Figure 31.

Locate GSW LADS as shown in Figure 32 and  Figure 33

 

TAP “Return License” (Figure 36)button to unregister the device and return the license to the pool to be distributed again.

 

Figure 36: Return GSW ConnectBot License from device

Figure 37: Notification that the License was successfully released.

Your license has been returned to GSW LADS. Please note that at this point GSW ConnectBot will no longer operate on this device.  

 

Note 1: Only licenses obtained from GSW LADS may be returned to GSW LADS.

Note 2: Licenses are not portable between GSW LADS instances.

 


 

Manual Registration

 

In brief, the Manual registration entails creating a Product ID, sending it to GSW. GSW will use the Product Id to generate a device specific Serial number and send it to you. The Serial Number is used to apply a permanent license.

 

When GSW ConnectBot (version 2.8.010 and higher) generates the Product Id, it saves it in a file named “request.c2g”[1] and places it at the {root}/Android/data/com.gsw.connectbot/files.

 

Note: if using GSW ConnectBot version 2.7.067 or lower, the “request.c2g” file will store at the root of main storage.

 

That file is sent to GSW to generate and GSW sends a file back with the name “request.g2c”[2] that contains the serial number.

 

Step by step instructions follow.

 

Navigate to the Licensing screen to Manually register the software. This is described as shown in the “check the license status” on page 13.

 

Tap on Serial Number radio button as show in Figure 38, then tap on continue.

 

Permanent License – Manual Registration

 

Figure 38: Permanent License – Serial Number

Figure 39: Permanent License - Continue

 

The screen to create the Product ID is opened as show in Figure 40.

Example: Create Product ID

Step 1. Tap “CREATE PRODUCT ID” to generate a product id as shown Figure 40.  A popup indicating that the creation of the product id was successful as shown

 

Create Product ID

 

Figure 40: Create Product ID

Figure 41: Allow access if needed

 

 

Figure 42: Close Dialog

 

The Product ID is displayed as shown in Figure 43. Additionally, a file “request.c2g” is created and placed in {root}/Android/data/com.gsw.connectbot/files when using GSW ConnectBot versions 2.8.010 and higher as shown in Figure 44.

 

Create Product ID

 

Figure 43:  Product ID created

Figure 44: request.c2g placed in root/android/data/com.gsw.connectbot/files

Figure 45: Request .c2g placed in root - v2.7.067 and lower

 

 

 

 

Step 2. Copy the file “request.c2g” to a location either on the device or another computer where you can send it to GSW.

 

Step 3. Go to the GSW Support Page  (preferred and fastest method) to initiate a registration ticket and attach the “request.c2g file. You may need to move the file from the root of main storage to another folder (Download) to be able to copy it via USB or another method to make it available for sending to GSW.

A few alternate methods exist to send the Product ID to GSW to the 3 steps above.

·       Alternatively email the file to registration@georgiasoftworks.com 

OR

·       Copy and paste the Product ID from the Serial Number screen and send it to GSW as in Step 3 above. To copy the Product ID – Press and hold your finger on the Product ID, a Copy/Paste dialog will appear.  Tap “Copy” to send the product ID to the Android clipboard, and paste it to a location where you can send it to GSW via the GSW Support Page  or email as described above

 

Georgia SoftWorks will take the Product ID and generate a serial number that is device specific and send it back to you via the GSW Registration ticket system. Simply apply the Serial Number to activate the permanent license.


 

Apply Serial Number

GSW will return a “serial.g2c file that contains the Serial Number to activate the permanent license.

 

Step 1: Copy this file to a folder on your device as shown using the Android file manager in Figure 46.

 

Figure 46: Copy serial.g2c to main storage root

Figure 47: Apply Serial Number from file

 

Step 2: Apply Serial Number from File

Navigate to Manual Serial Number screen (as shown in Figure 38 and Figure 39) and TAP on APPLY SERIAL NUMBER FROM FILE as shown in Figure 47.  

The GSW ConnectBot file manager opens that allows you to navigate the folder locations on the device.

 

Go to the location you placed the serial.g2c file in step 1.

TAP on the file serial.g2c.

The screen that the Serial Number was successfully set is displayed as shown in Figure 49.

 

Figure 48: Locate the serial.g2c file

 

Figure 49: Serial Number Applied Successfully

Figure 50: All Done, Tap Continue

 

You license is now permanent.  TAP Continue to launch the GSW ConnectBot.

 

Note: As an alternative to selecting a serial.g2c file, you can paste the Serial Number in the field “Paste serial number here” as shown in Figure 51. Once you paste it then Tap APPLY as shown in Figure 52

Figure 51: Paste Serial Number

Figure 52: Tap APPLY after pasting serial number

 

The serial number is applied and the license is permanent. Tap CONTINUE.


 

Update the GSW ConnectBot software

An important benefit of a GSW ConnectBot subscription is that it allows access to version upgrades at no cost. This is important to easily obtain new features that are introduced and problem resolutions that are rolled out.

Similar to licensing, updates can be obtained and installed either using the License and Deployment Server (LADS) or manually. GSW LADS make checking for updates and installation a breeze.

Administrator Mode or Work Mode can both perform software updates. Often it is easier for the user in Work mode perform the update rather than the system administration touching all the devices.

Figure 53: Admin Mode - Update software

Figure 54: Work Mode - Update Software

 


 

Updating Software by Licensing and Deployment Server (LADS)

 

Managing the GSW ConnectBot version can also be done from the server.

The administrator can place specific files on GSW LADS that allow GSW ConnectBot to get software updates (see page 109).

 

Note: Android 11 implemented new security changes that require modification of the GSW ConnectBot update procedure in certain situations.  On Android 11, if upgrading GSW ConnectBot version 2.7.067 or earlier, the .apk file must be manually placed on the Android device (not in the GSW LADS folder).

GSW ConnectBot 2.8.010 and later is updated using the normal process.

 

When the GSW ConnectBot client checks for an update, if a newer version has been placed in that location, it will confirm that an update is available and ask if you wish to perform the update.

Tap on the Admin or Work Launcher Icon (below is in Admin mode).

1.       Tap on the “over flow” menu in the upper right-hand corner of the client.

2.       Select “Update” from the menu.

3.       Tap “Use Georgia SoftWorks Licensing and Deployment Server”

4.       Tap “CONTINUE”

5.       Tap “CHECK FOR UPDATES”

Figure 55: Hosts - More Options - Update

Figure 56: Tap Update

 

 


Figure 57: Update TAP GSW LADS

Figure 58: TAP Continue

Figure 59: Check for Update

 

If the Host field (Figure 60) is not already populated then you must Locate the GSW LADS. If it is populated then you can skip this step.

 

Tap “LOCATE GSW LADS” as shown in Figure 61 to locate the GSW License and Deployment Server.  Notice that the Host does not need to be manually filled in unless the GSW LADS cannot be located. Also, the default port 12574 should not be changed without a good reason.

 


Figure 60: Use GSW LADS Update Screen

Figure 61: Locate GSW LADS

 

 

 

6.       If a different version of the GSW ConnectBot client is available the “Update Found!” message will be displayed as in Figure 62. (Go to step 8)

7.       If no update is available, you will receive a message that “You are running the latest available version:” as shown in Figure 63. No need to go further (swipe right/or back button to go to host screen)

 

Figure 62: GSW LADS - Update Found

Figure 63: GSW LADS - running latest version

 

8.       Click “OK”.

9.       Click “Install Update”

10.   A progress bar will be displayed to provide the status of the download.

11.   Once the download is complete, Android Security will ask for permission tap “Allow”

 

 


Figure 64: Install Update

Figure 65: May be prompted to allow access to photos

Figure 66:  Update is downloading

 

12.   A confirmation message will pop up asking if you wish to install the update.

13.   Click “INSTALL” to proceed with the update.

14.   When the download is complete, tap open to relaunch ConnectBot and connect to a session.

 

Figure 67: Install Update

Figure 68: Tap Open to launch

 

Updating Software by manually obtaining gsw-connectbot.apk

Note: Sideloading example on page 10

Copy the new version GSW ConnectBot APK to the device using Windows Explorer, download or by whatever method you choose, preferably to the “Download” folder, as some device File Managers limit access to files at the root of storage. The name of the actual GSW ConnectBot APK is gsw-connectbot.apk or gsw-connectbot-version.apk, where version is the version number of the release.

 

Figure 69: Select version to install

Figure 70: Tap install

 

The hosts configuration and licensing are not affected when the updated version of GSW ConnectBot has finished.


 

Updating Software by URL

URL Update allows you to update GSW ConnectBot directly from a web location. By default, the URL points to the GSW website[3]. You may also download the .apk and .json file and place them on your own intranet website for download.

Select “Update” from the overflow menu.