Manuals 

Proxy Server for WireLess TelNet

1 Introduction
2 General scheme
3 Installation process
4 "Proxy Server for WireLess TelNet" administration as Windows service
5 Web administration console
6 Server configuration
7 Client configuration
8 Remote Hosts By Wizard (PsHosts.cfg)
9 License

1 Introduction

Mobile devices are capable of setting a terminal emulation session (Telnet/SSH) with a remote server and resetting it correctly even after being suspended or getting out of Access Point coverage area. Even though this function works correctly most of the time, it might happen that the session established with the remote server can't be reset or that you want to redirect all the traffic from the mobile devices towards a central server in order to monitor the activity.  

Facing this problem, SofToGo introduces “Proxy Server for WireLess TelNet”, which consists on a software that functions as intermediary between mobile devices -which execute a "WireLess TelNet" version 4 client or subsequent- and remote servers. “Proxy Server for WireLess TelNet” includes the following features:

• Simple installation: After installed, the software is immediately incorporated as a Windows Service that is automatically started when starting the PC.
• Ease of use: "Proxy Server WireLess TelNet" is able to be used right after installation.
• Customized service: For those users that want more detailed control of the server configuration, this application includes a group of options such as the port where connection requests from terminals will be listened to or the reject criteria of incoming connection requests, among others. 
• Remote administration through a web browser: This product has a web server in order to provide a simple and handy  administration tool.
• Auto-Discovery by wizard allowing to have no configured addresses in the PDA clients.

2 General scheme

The following scheme resumes "Proxy Server for WireLess TelNet" installation topology.

Terminals get connected to one or several Access Points through a Wi-Fi network. Access Points get connected to Proxy Server, which gets connected to hosts, which can be part of a LAN or accessible through a bigger network such as the Internet.

3 Installation process

In order to install "Proxy Server for WireLess TelNet", execute the application "WPs_V100.exe", that will display the following screen:
Press "Next". The application will show the license agreement. Select "I accept the terms in the license agreement" if you agree, then press "Next" again.
On the following screen, enter the license owner's username and the name of the organization that she is a part of. Select whether you want "Proxy Server for WireLess TelNet" to be installed for all users or only for the current user. Press "Next" again.
Select the complete installation on the setup step, then press "Next" to continue:
The system will show you a screen indicating that the product is ready to be installed. Press "Install" to begin the installation process:
If the installation process is successful, the following screen will be displayed:

Press "Finish" to end the installation process.

4 Proxy Server for WireLess TelNet administration as Windows service

The administration process for "Proxy Server for WireLess TelNet" is performed through the Windows Services panel, that can be accessed through Start -> Settings -> Control Panel -> Administrative Tools -> Services. When the product is installed, it gets automatically registered on the system services list. From that moment, "Proxy Server for WireLess TelNet" can be administrated as any other Windows Service, which means it can be started, stopped, or restarted. To perform one of these options, select "Proxy Server for WireLess TelNet" from the Windows services list and make a click with the right button. The system will show a screen similar to the one displayed below, where you'll will able to choose the option you want to perform:

5 Web administration console

"ProxyServer for WiresLess TelNet" includes an integrated web administration console, which allows to monitor the current sessions between terminals and remote servers. There's a shortcut to the web administration console -which will automatically open a web browser- inside the "WireLess TelNet" group on Start menu. This shortcut is only valid for those servers that are listening on the default port (45053). In other case, the console can be accessed via a web browser by writing the name of the host where "Proxy Server for WireLess TelNet" is being executed, followed by the character ':' and the number of the port set for listening connection requests. For example, if "Proxy Server for WireLess TelNet" is executing on a host named "spark", and the integrated web server is listening to requests on port number 24568, the administration console can be reached at the following address: http://spark:24568.

When opening the web administration console, a login screen is displayed, where you must enter the administrator's username and the associated password, as on the following example:

If the login process is successful, the system displays the main administration screen, where the server status and other relevant information is displayed. The green circle located on the left superior corner indicates that the server is active for listening to new connection requests from terminals:

The server can be configured for keeping the current sessions active, while denying the access to new ones. In order to activate this option, press "Block incoming connections". The green circle will immediately turn into red, indicating the new status of the server:

If Proxy Server is back again accepting incoming connection requests and a terminal establishes a connection with it, the web based administrator will display a screen similar to the following one:

To refresh the list, press "Refresh"; to get more details about a session, select the telescope icon, which will display a screen like the following:

To return to main page, press "Return". You can force the termination process of established sessions by selecting them and clicking the "Close sessions" button at the bottom of the table:

To logout from the current administration session, press the "Logout" button and the login screen will appear again.

6 Server configuration

"Proxy Server for WireLess TelNet" has only one configuration file: "config.cfg", which contains a group of parameters that define how the application works. You can access this file through Start ->Programs ->WireLess TelNet -> Proxy Server -> Configuration. Modifications to this file can be made with IniEditor. The configuration file is read when starting the service, so you must restart the service for the modifications to come into effect.

ProxyServerListenPort = (Integer number higher than 1024 and lower than 65536)
Defines the port number where the server will listen connection requests from terminals. If this option is not defined, the port 45621 will be set by default. WARNING: Do not select a port number used by another application nor the one that corresponds to WebServerListenPort. 

WebServerListenPort = (Integer number higher than 1024 and lower than 65536)
Defines the port number where will be located the web server provided by the administration console. If this option is not defined, the port 45622 will be set by default. WARNING: Do not select a port number used by another application nor the one that corresponds to ProxyServerListenPort. 

AdminUsername = (String)
Defines the username associated to the administrator, i. e. the user authorized to access the web administration console. This line is MANDATORY and must have a valid value. Otherwise, "Proxy Server for WireLess TelNet" won't be started.

AdminPassword = (String)
Defines the password associated to the administrator, i. e. the user authorized to access the web administration console. This line is MANDATORY and must have a valid value. Otherwise, "Proxy Server for WireLess TelNet" won't be started.

ReplaceIncCnxMatchIP = (yes/no)
If this option is activated, all connection requests from a terminal should replace on the list the one that matching source IP and destination IP. 

ReplaceIncCnxMatchUser = (yes/no)
If this option is activated, all connection requests from a terminal should erase from the list the one that has matching username (Owner) and IP address. 

DumpTrafficLog = (yes/no)
Defines if the server generates a log file with the content of each session that is started. Default value is "no". The name of these files follows this rule:

TrafficLogFilename + User ID + (IP origen/Owner) + CTP/STP + "." + TrafficLogFileExtension.

"TrafficLogFilename" and "TrafficLogFileExtension" are parameters of the configuration file that will be explained later. "User ID" is a number provided by the proxy server that identifies the terminal from the rest. "Owner" is the name defined for the owner on the terminal configuration. "CTP" and "STP" identify if the log file belongs to the communication between the terminal and the proxy server (CTP) or to the communication between the remote server and the proxy server (STP).

TrafficLogFilename = (String)
Defines the prefix of the log files generated by each session started with the terminals. This parameter will be ignored if DumpTrafficLog="no" or if it has been erased from the configuration file.

TrafficLogFileExtension = (String)
Defines the extension of the log files generated by each session started with the terminals. The value associated to this parameter will be ignored if DumpTrafficLog="no" or if it has been erased from the configuration file.

NamingCritHistFiles = (NONE/IP/OWNER)
Defines if the names of the log files must end with the IP address of the terminal (IP option), the owner's name (OWNER option) or none (NONE option).

ProxyMode = (Passive/Active)
On Active mode, Proxy Server sends pings towards the terminal regularly.

TraceDir=.\
Absolute root path for trace files. This name is completed with the date (YYMMDD) in order to create a daily folder which contains the logs of the day.

TraceName=History
Root of the name of the log file. The name will be completed with the "Task Number" for each client that logs on the server, creating a "WSServerXXX.log" file for each client connection. This file contains the actions performed by the client.

TraceLevel=50
Default "log level". Level 0 (zero) keeps the least information log. Level 99 keeps the most detailed information. This value may be dynamically modified by the administrator.
Level 10 logs main actions and fatal errors.
Level 50 logs warnings.
Level 99 keeps full trace of all events. This option should dramatically slow the server performance and generate large log files. Do not use this level in normal working mode.

TraceDays=10
Top number of daily log folders that will be stored on the PC. After this number is reached the folders are automatically deleted.

7 Client configuration

The WireLess TelNet PDA client must be configured in order to use "Proxy Server for WireLess TelNet" (see 6.VI [SESSION_X] section on http://www.sof2go.net/man/wtn/wtnce52/en/Cha_6_Frame.htm for WTn5250, or on  http://www.sof2go.net/man/wtn/wtncevt/en/Cha_6_Frame.htm for WTnVT).

[SESSION_0]

HostIP=83.206.234.188
Remote host IP address or ".NAME" (a dot followed by the name) to use the host name translation (see Section 8 for PsHosts.cfg use).
Sample:
HostIP=83.206.234.188 -> Connects to host 83.206.234.188 through ProxyServer.
HostIP=.1 -> Connects to host denoted by "1" in PsHosts.cfg through ProxyServer.

Port=23
Host port.

ProxyMode=0
0= Do not use ProxyServer.
1= Use ProxyServer in Passive mode (recommended).
2= Use ProxyServer in Active mode (for slow networks only).

ProxyIP=10.10.10.15
Url/address of the ProxyServer system or "." to use the auto-discovery wizard to connect to any ProxyServer.
Sample:
ProxyIP=10.10.10.15 -> Connects directly to host at 10.10.10.15 IP address.
ProxyIP=. -> Look for any ProxyServer in local network and connects to it.

ProxyPort=45621
Proxy port.

8 Remote Hosts By Wizard (PsHosts.cfg)

"Proxy Server for WireLess TelNet" allows to connect to remote hosts by host name translation.
The system needs: 

• A wizard identifier in the PDA allowing translation to host name. 
• A configuration file (PsHosts.cfg) containing the wizard names and the associated hosts urls.

How it works:

Configure HostIP option on the PDA as ".NAME" (a dot followed by a name).
If the system receives a host name beginning with a dot, it is processed as a "wizard identifier" instead of processing it as a host name. Then, the ProxyServer looks for this identifier into the PsHosts.cfg configuration file to obtain the remote host to connect.

If you have different hosts to connect to, configure them with different identifiers to allow connection to different names.

The PsHosts.cfg file is a text file. Each line contains a wizard identifier and a host name separated by "=". For example: WizId=HostName

Sample of PsHosts.cfg:

1=83.206.234.188
2=bbs.montelnet.com

Configure HostIP configuration option of the PDA with ".1" (see HostIP on http://www.sof2go.net/man/wtn/wtnce52/en/Cha_6_Page.htm#6.VI for WTn5250, or on http://www.sof2go.net/man/wtn/wtncevt/en/Cha_6_Page.htm#6.VI for WTnVT) as Telnet host name and ProxyServer will translate the wizard ID "1" as "83.206.234.188".

9 License

"Proxy Server for WireLess TelNet" requires a license number. Without license, only one terminal may be connected.