Readme.htm

Features:

• Compatible with 3rd party Telnet clients such as Microsoft Telnet, CRT from Van Dyke Technologies, Inc. or POWER TERM from Ericom Software.
• Screen mode and line mode with scroll buffer support  
• Full Function Keys support (including F%,CTRL-F%,SHIFT-F%,ALT-F%)
• Color support
• Graphics support (Edit.com, FCW.exe, etc.)
• Client printing: Allows telnet user to print locally
• Alternate command shell support such as 4NT from JP Soft
• Automatic support for screen sizes other than 25*80
• Logon scripting: Allows user to automatically run a specific application/script upon connection
• Logon directory: Allows user to specify home directory upon connection
• Graceful termination upon abnormal termination of client (link or computer failure)
• Support for Terminal emulations DEC VT100,DEC VT220
• Remote Monitoring of existing Telnet connections and users logged in
• Remote disabling/enabling new connections to host
• Remote shutdown of Telnet Server
• Remote stopping of user session
• Timeout parameters to control user login/session idle time
• Support for ALT keys (example ALT-F = CTRL+A+F)
• Support for CTRL-C
• Connection restriction based on host or IP address
• Connection restriction based on number of users
• Administration from the web
• Disable/Enable Domain name during login
• Customized welcome message

Installation:

1. Unzip the Telnetd zip file to your installation directory on one of your local drives. (Installation on a network drive is not supported)
2. Run install.exe to install GoodTech Telnet server version 4.0

Note: The GoodTech Telnet Server service starts automatically every time you reboot your machine.

New Features Help:

• Connection Restriction based on Host or IP Address

  You may optionally restrict connections via telnet based upon the host or IP address. Remote access may be limited only to specific hosts or IP addresses. Restrictions based on host or IP are enforced when the file GT_IPF.DAT exists in your installation directory. The first line in this file can be ONE of the keywords, INCLUDE or EXCLUDE. When the first line contains the INCLUDE keyword, then all hosts or IP addresses listed on the following lines are the only hosts/IP addresses that have the permission to access the server machine via telnet. (All other hosts or IP addresses are not allowed). If the first line contains the keyword EXCLUDE, then all hosts/IP addresses listed after this line do not have permission to access the server machine via telnet. (All other hosts or IP addresses are allowed.)

• Connection restriction based on number of users

  You may optionally restrict the maximum number of concurrent telnet users allowed to connect the host machine. The system environment variable that controls this is gt_max_users.

  Valid values: 0 < gt_max_users <= License limit

  gt_max_users - specifies the maximum number of concurrent users allowed to connect the host machine.

  For example, if you have a 10 concurrent connections license, and you set gt_max_users to 5, then 5 users at the most can be concurrently connected to the host. 

• Administration from the web

  Administration commands can be performed via a web browser. This feature gives you a Graphic interface to administrate the Telnet Server product. You can always use the command line interface to get the same results. In order to use this option, you should open a web browser with the following URL: http://name or IP address of machine that runs Telnet Server:2380

• Disable/Enable Domain name during login

  You can disable the domain prompt during login phase, by setting the system environment variable gt_domain_disable to 'yes'.

• Customized welcome message

  You can customized the welcome message that appears during login phase by creating a file named gt_welcome_message.dat in your telnet server installation directory. You can put your personal welcome message in this file and it will be displayed during the login phase.

  Other Features Help:

• Screen mode and line mode:

  In full screen applications, such as MS edit, VI, FCW. Etc., the cursor can be located anywhere on the screen. Screen mode applications are displayed properly only if you are in screen mode.

  In Line mode, the cursor is always located on the last line of your telnet session window. In this mode you can use the scroll buffer.

  You can easily switch between modes while in a telnet session. There is no need to re-login any time you change the mode.

  The default mode is screen mode. If you want to switch to line mode, type the command:

  set gt_mode=line

  Please make sure to type the above command in lower case letters and with no extra spaces. This command creates a new DOS session. You are now ready to start working in line mode. The scroll buffer is now available. If the cursor does not move to the next line any time you press the enter key, you need to set up your telnet client to do so. Make sure that the option new line mode is enabled in your telnet client. Otherwise, the carriage return does not work properly when you are in line mode. In MS Telnet Client, this option is the default. In CRT, for example, you have to enable this option under Emulation/Modes.

  If you want to switch back to screen mode, type the command:

  set gt_mode=screen

  Please make sure to type the above command in lower case letters and with no extra spaces. This command creates a new DOS session. You are now ready to start working in screen mode. The scroll buffer is not available any more.

• Client Printing:

  Telnet Server Configuration:

  You need to Follow the steps below if you want to allow users to print locally on their printers:

  1) Enable Client Printing

• The following system environment variable is used to control client printing:
• gt_print_monitor - controls whether client printing is enabled or disabled.
• Set this variable to Y to enable client printing.
• If this variable is not defined, or if it has a value other than Y, client printing is disabled.

  2) Create a Virtual Printer

• Go to Control panel/printers/add printer.
• Select any available port for the printer (lpt1, lpt2 or lpt3).
• Select manufacturer as Generic and printer as Generic/Text Only.
• Name the printer gt_printer.
• Define it as a shared printer and name the share gt_printer.

  3) Pause the printer

• Go to Control panel/printers
• Select gt_printer
• Right click the mouse and enable pause printing.

  Telnet Client Configuration:

  1) Make sure that your Telnet Client supports direct path through printing to port. Some Telnet Clients support it (e.g. CRT), and some don't (e.g. MS telnet client).

  2) Enable the option direct path through printing to port and select the port that your printer is connected to.

  3) You need to issue the following command from the telnet session any time you telnet to the server:

  NET USE lpt(n): \\ServerName\gt_printer

  lptn: lpt1, lpt2 or lpt3 depending on what port you are printing to. lpt1 is the default port for printing.

  ServeName: The remote host you are connected to.

  Example: NET USE lpt1: \\YourHostName\gt_printer

  This command redirects printing from the server printing port to the virtual printer, so GoodTech Telnet Server can read from the virtual printer and send the printing to the client for print out.

• Color Support:

  In order to get all colors properly displayed by GoodTech Telnet Server, use a telnet client that supports colors. Choose the ANSI color option in the telnet client setup menu.

• Kill Telnet Client Session:

  "telnetd kill <sid>" - Kills the client session identified by sid.

  To get the client sid, use the command "telnetd status".

• Login/Session Timeout:

  Define system environment variables:

  gt_login_idle_time (value in seconds)

  gt_session_idle_time (value in minutes)

  To define the variables go to the control panel, system, environment, select the system variable scrolling list, then enter the parameter (e.g. gt_login_idle_time) in the variable text box, enter the value in the value box, and press Set. Reboot your system.

• Function Keys:

  The key maps expected by GoodTech Telnet Server are listed in the HELP.DOC file.

• KBDMAP.EXE utility:

  This utility stores key mapping information in a file called gt_kbd.map Use this utility ONLY if you use keyboard other than U.S and some of the keys or special characters in your language don't work properly.

Troubleshooting:

1. Encounter error 1073 while trying to install GoodTech Telnet Server?

This error means that a service with a name telnetd (the internal name of GoodTech Telnet Server service) is already in use in your system. You have to uninstall the existing service before you install GoodTech Telnet server.

2. Port #23 is already in use?

The default telnet port is port number 23. However, in case port 23 is used by another application, you can set up the GoodTech Telnet Server to use a different port.

You can set a different port by doing the following:

1. Click on the start button and run the REGEDIT program.
2.OpenHKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\TELNETD
3. Highlight TELNETD and right click on the mouse.
4. Select the option "New Key" and name the key "parameters".
5. Highlight the new key "parameters" and right click on the mouse.
6. Select the option "New DWORD Value" and name it "port".
7. Double click the "port" and set the base to "Decimal".
8. Enter your port number in the "Value Data" and click OK.

This method works for both, automatic and Manual startup of GoodTech Telnet Server.

Another way to do this is to specify the port number to be used by the Telnet Server in the Startup parameters input box when starting the Telnet Server service. This method works only if you start and stop the Telnet Server manually.

The Telnet client program must be set up to use the same port as the Telnet Server. If you set up the Telnet Server to use a port different than the default (#23), you have to also set up the telnet client to use the same port.

3. Unauthorized for the letnetd commands?

In Order to use the telnetd commands you should log in as telnetd user, which is the telnet administrator user. You have to create an account for the telnetd user. No special privileges are required.

4. Have troubles logging in to the server?

• Check the user privileges. Users must have "log on locally" access permission. To grant privileges to user, use the UserManager program.
• When prompt for the domain, leave it blank for local authentication or provide the domain name for remote authentication. Don't type the name of the host machine.

   

telnetd commands: (from a telnet session using 'telnetd' user)

• telnetd status : Shows all user connections
• telnetd disable : Disables new connections to host machine
• telnetd enable : Enables connections to host machines
• telnetd kill <SID> : Kill user session
• telnetd shutdown : Shutdown TELNET SERVER

  Note: All telnetd commands can run on the host machine, or remotely using telnetd user.

Contact Information:


1. Email:

support@goodtechsys.com

sales@goodtechsys.com

comments@goodtechsys.com

2. Address: P.O.BOX 885 EL CERRITO CA 94530

3. Home page: http://www.goodtechsys.com

Thank you for Choosing GoodTech Telnet Server for Windows NT/2000