Manuales 

Proxy Server for Wireless TelNet

1 Introducción
2 Diagrama general
3 Proceso de instalación
4 Administración de Proxy Server for WireLess TelNet como servicio de Windows
5 Consola de administración web
6 Configuración del servidor
7 Configuración del cliente
8 Hosts remotos por asistente (PsHosts.cfg)
9 Licencia


 

1 Introducción

Los dispositivos móviles actuales cuentan con la capacidad de iniciar una sesión de emulación de terminales (Telnet/SSH) con un servidor remoto y de reestablecerla correctamente aún después de haber sido suspendidos por el usuario o de salirse fuera del radio de cobertura provisto por los Access Points. Si bien este mecanismo funciona correctamente en la mayoría de los casos, puede ocurrir que la sesión con el servidor remoto no pueda ser reestablecida o bien que se desee redirigir todo el tráfico proveniente de los dispositivos móviles hacia un sitio centralizado con el fin de realizar un monitoreo de la actividad realizada.

Frente a esta problemática, SofToGo propone “Proxy Server for WireLess TelNet”, que consiste en un software que actúa de intermediario entre dispositivos móviles -que se encuentran ejecutando un cliente "WireLess TelNet" versión 4 o posterior- y los servidores remotos y que cuenta con las siguientes características:


 

2 Diagrama general

El siguiente esquema resume la topología de una instalación que hace uso de "Proxy Server for WireLess TelNet":

Las terminales se conectan a uno o más Access Points por medio de la red inalámbrica Wi-Fi. Los Access Points se conectan al servidor Proxy y éste, finalmente, se conecta a los servidores remotos, los cuales pueden encontrarse en una red local LAN o bien ser accesibles a través de una red más grande como Internet.


 

3 Proceso de instalación

Para instalar "Proxy Server for WireLess TelNet", ejecute el programa de instalación "WPs_V100.exe", el cual desplegará la siguiente pantalla:

 

Al presionar "Next", el programa mostrará el acuerdo de licencia. Seleccione la opción "I accept the terms in the license agreement" si está de acuerdo con la misma y, a continuación, presione nuevamente el botón "Next".

 

Seleccione en la siguiente pantalla el nombre del usuario dueño de la licencia del producto seguido del nombre de la organización a la cual pertenece. Elija también si desea que "Proxy Server for WireLess TelNet" sea instalado para todos los usuarios del equipo (all users) o sólo para el usuario actual y, a continuación, presione el botón "Next":

 

Seleccione el modo de instalación completa y presione nuevamente el botón "Next":

 

El sistema desplegará una pantalla indicando que el producto se encuentra listo para ser instalado. Presione el botón "Install" para comenzar el proceso de instalación:

 

Si el resultado del proceso de instalación resultó satisfactorio, el sistema presentará la siguiente pantalla de información:

 

Presione el botón "Finish" para concluir con el proceso de instalación.


 

4 Administración de Proxy Server for WireLess TelNet como servicio de Windows

El proceso de administración de "Proxy Server for WireLess TelNet" se realiza por medio del panel de servicios de Windows, el cual puede ser accedido mediante Inicio -> Configuración -> Panel de control -> Herramientas administrativas -> Servicios. Al instalar el producto, éste se registra automáticamente en el listado de servicios del sistema. A partir de ese momento, "Proxy Server for WireLess TelNet" puede ser administrado como cualquier otro servicio de Windows, esto es, puede ser iniciado (start), detenido (stop) o reiniciado (restart). Para elegir alguna de estas opciones, seleccione "Proxy Server for WireLess TelNet" de la lista de servicios de Windows y realice un click con el botón derecho del mouse. El sistema mostrará una pantalla similar a la que se muestra a continuación, donde podrá elegir la opción deseada:

 


 

5 Consola de administración web

"ProxyServer for WiresLess TelNet" cuenta con una consola de administración web integrada, la cual permite al usuario administrador el monitoreo de las sesiones establecidas entre los terminales y los servidores remotos.  Se ofrece un acceso directo a la consola de administración web -el cual abrirá automáticamente un navegador web- dentro del grupo "WireLess TelNet" del menú Inicio para aquellos servidores que se encuentren atendiendo en el puerto por defecto (45053). Si éste no fuera el caso, la consola puede ser accedida abriendo un navegador web e ingresando el nombre del host donde se encuentra ejecutando Proxy Server for WireLess TelNet, seguido del caracter ':' y el número de puerto establecido (WebServerListenPort). Por ejemplo, si "Proxy Server for WireLess TelNet" se encontrara ejecutando en el host "spark" y el servidor web integrado se encontrara atendiendo pedidos en el puerto 24568, la dirección a ingresar será http://spark:24568.

Al acceder a la consola de administración web, el sistema mostrará una pantalla de login donde deberá ingresar el nombre de usuario o "username" del administrador (AdminUsername) seguido de su contraseña (AdminPassword), tal como se muestra a continuación:

 

Si los datos ingresados son correctos, el sistema desplegará la pantalla de administración principal, indicando el estado del servidor e información asociada al mismo. El círculo verde en la sección superior izquierda indica que éste se encuentra habilitado para recibir nuevos pedidos de conexión por parte de las terminales:

 

El servidor puede ser configurado de forma tal que mantenga activas las sesiones ya establecidas, denegando el acceso a nuevas sesiones. Para habilitar esta opción, presione el botón "Block incoming connections" e, inmediatamente, el círculo verde cambiará su color a rojo, indicando el nuevo estado del servidor:

 

Si el servidor Proxy se encontrara aceptando pedidos de conexión nuevamente y un terminal iniciara una sesión con éste, el sistema desplegaría una pantalla como la siguiente:

 

Para actualizar el listado, seleccione el botón "Refresh" y para obtener un mayor detalle sobre alguna sección seleccionar el ícono asociado con forma de catalejo, el cual desplegará una pantalla tal como la que se muestra a continuación:

 

Seleccione el botón "Return" para volver a la pantalla principal. Puede forzar el cierre de sesiones ya establecidas marcándolas tal como se muestra en la siguiente imagen y presionando a continuación el botón "Close sessions":

Para cerrar la sesión de administración actual, presionar el botón "Logout", el cual provocará que se despliegue nuevamente la pantalla de login.


 

6 Configuración del servidor

"Proxy Server for WireLess TelNet" cuenta con un único archivo de configuración: "config.cfg", el cual define una serie de parámetros que ajustan el comportamiento del servicio. Se accede a este archivo a través del menú Inicio ->Programas ->WireLess TelNet -> Proxy Server -> Configuration. Las modificaciones a este archivo se realizan con IniEditor. El archivo de configuración es leído en el momento en que se inicia el servicio, por ende, se ha de reiniciar el servicio para hacer surtir los efectos de cualquier modificación a la configuración.

ProxyServerListenPort = (Número entero mayor que 1024 y menor que 65536)
Determina el número de puerto donde el servidor "escuchará" los pedidos de conexión de las terminales. De no definir esta opción, se establecerá como puerto por defecto el 45621. ADVERTENCIA: no seleccionar un número de puerto que ya se encuentre en uso por otra aplicación ni el que corresponde a WebServerListenPort.

WebServerListenPort = (Número entero mayor que 1024 y menor que 65536)
Define el número de puerto donde se alojará el servidor web que proveerá la consola de administración. De no definir esta opción, se establecerá como puerto por defecto el 45622. ADVERTENCIA: no seleccionar un número de puerto que ya se encuentre en uso por otra aplicación ni el que corresponde a ProxyServerListenPort.

AdminUsername = (Cadena de texto)
Establece el nombre del usuario administrador autorizado para acceder a la consola de administración web. Esta línea es OBLIGATORIA y debe poseer un valor asociado válido. De lo contrario, "Proxy Server for WireLess TelNet" no se iniciará.

AdminPassword = (Cadena de texto)
Establece la contraseña asociada al usuario autorizado para acceder a la consola de administración web. Esta línea es OBLIGATORIA y debe poseer un valor asociado válido. De lo contrario, "Proxy Server for WireLess TelNet" no se iniciará.

ReplaceIncCnxMatchIP = (yes/no)
E
stablece que todo intento de conexión desde una terminal reemplazará a una que ya se encuentre en la lista y tenga la misma dirección IP de origen y destino.

ReplaceIncCnxMatchUser = (yes/no)
Establece que todo intento de conexión desde una terminal reemplazará a una que ya se encuentre en la lista y tenga el mismo nombre de usuario (Owner).

DumpTrafficLog = (yes/no)
Determina si el servidor generará un archivo de log con el contenido de cada una de las sesiones que sean establecidas. El valor por defecto es "no". El nombre de los archivos está dado por la siguiente regla:

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

"User ID" es un número asignado a la terminal por el servidor Proxy que la identificará unívocamente del resto. 
"IP origen" es la dirección IP de la terminal, 
"Owner" el dueño establecido en la configuración de la terminal y 
"CTP" y "STP" son siglas que identifican si el archivo de log corresponde a la comunicación entre la terminal y el servidor Proxy (CTP) o entre el servidor remoto y el servidor Proxy (STP), respectivamente.

TrafficLogFilename = (Cadena de texto)
Determina el prefijo del nombre de los archivos de log generados por cada una de las sesiones establecidas con terminales. El valor asociado a esta entrada será ignorado si DumpTrafficLog ="no" o bien si ésta hubiera sido omitida del archivo de configuración.

TrafficLogFileExtension = (Cadena de texto)
Determina la extensión de los archivos de log generados por cada una de las sesiones establecidas con terminales. El valor asociado a esta entrada será ignorado si DumpTrafficLog= "no" o bien si ésta hubiera sido omitida a lo largo del archivo de configuración.

NamingCritHistFiles = (NONE/IP/OWNER)
Determina si los archivos de log generados por cada una de las sesiones establecidas con terminales deben contener, al final de su nombre, la dirección IP de la terminal (opción IP), el nombre del dueño (Owner) de dicha terminal (opción OWNER) o ninguna de las dos (opción NONE).

ProxyMode = (Passive/Active)
En modo Activo, el Proxy Server envía regularmente pings hacia la terminal.

TraceDir=(Cadena de texto)
Ruta absoluta de los archivos de registro. Este nombre se completa con la fecha (YYMMDD) para crear una carpeta que contiene los registros del día.

TraceName=(Cadena de texto)
Raíz del nombre de los archivos de registro. El nombre se completará con el "Número de Tarea" para cada cliente que inicie sesión en el servidor, lo que generará un archivo "WSServerXXX.log" por cada cliente conectado. Este archivo contiene las acciones llevadas a cabo por el cliente.

TraceLevel=(Número entero entre 0 y 99)
Nivel de registro predeterminado. El valor 0 registra la menor cantidad de información. El valor 99 determina el nivel de almacenamiento más detallado posible. Este valor puede ser modificado dinámicamente por el administrador.
Nivel 10 registra las acciones principales y errores fatales.
Nivel 50 registra advertencias (warnings).
Nivel 99 registra todos los eventos. Esta opción tornará al servidor notablemente más lento y generará archivos de registro de muy gran volumen. No utilice este nivel en modos de operación normales.

TraceDays=
Cantidad máxima de registros diarios que se almacenarán en la PC. Cuando se alcanza este límite las carpetas se eliminan automáticamente.


 

7 Configuración del cliente

El cliente WireLess TelNet debe ser configurado en la PDA para poder usar "Proxy Server for WireLess TelNet" (ver la sección 6.VI [SESSION_X] en http://www.sof2go.net/man/wtn/wtnce52/es/Cha_6_Frame.htm para WTn5250, o en   http://www.sof2go.net/man/wtn/wtncevt/es/Cha_6_Frame.htm para WTnVT).

[SESSION_0]

HostIP=83.206.234.188
Dirección IP del host remoto o ".NOMBRE" (punto y nombre) para usar la traducción del nombre del host (ver Sección 8 para el uso de  PsHosts.cfg).
Ejemplo:
HostIP=83.206.234.188 -> Se conecta al host 83.206.234.188 à través de ProxyServer
HostIP=.1 -> Se conecta al host indicado por el número "1" en PsHosts.cfg à través de ProxyServer

Port=23
Puerto del host.

ProxyMode=0
0= No usar ProxyServer
1= Usar ProxyServer en modo pasivo (recomendado)
2= Usar ProxyServer en modo activo (para redes lentas únicamente)

ProxyIP=10.10.10.15
URL/dirección del sistema ProxyServer o "." para utilizar el asistente de descubrimiento automático para conectarse a cualquier ProxyServer.
Ejemplo:
ProxyIP=10.10.10.15 -> Se conecta directamente al host a la dirección IP 10.10.10.15
ProxyIP=. -> Busca cualquier ProxyServer en la red local y se conecta a él

ProxyPort=45621
Puerto del ProxyServer.


 

8 Hosts remotos por asistente (PsHosts.cfg)

"Proxy Server for WireLess TelNet" permite conectarse a hosts remotos por traducción de nombres de hosts.
El sistema necesita: 

Funcionamiento:

Configure la opción HostIP en la PDA como .NOMBRE (un punto y a continuación un nombre de asistente).
Si el sistema recibe un nombre que comienza con un punto, lo procesa como un "identificador de asistente" en vez de procesarlo como un nombre de host. Entonces, ProxyServer buscará este identificador en el archivo de configuración PsHosts.cfg para obtener el host remoto al cual conectarse.

Si tiene diferentes hosts para conectarse, configúrelos con diferentes identificadores para permitir la conexión con diferentes nombres.

El archivo PsHosts.cfg es un archivo de texto. Cada línea contiene un identificador de un asistente y un nombre de host separados por el signo "=". Por ejemplo: WizId=HostName

Ejemplo de PsHosts.cfg:

1=83.206.234.188
2=bbs.montelnet.com

Configure la opción HostIP de la configuración de la PDA con ".1" como nombre de host Telnet (ver HostIP en http://www.sof2go.net/man/wtn/wtnce52/es/Cha_6_Page.htm#6.VI para WTn5250 o en http://www.sof2go.net/man/wtn/wtncevt/es/Cha_6_Page.htm#6.VI para WTnVT), el ProxyServer traducirá la ID del asistente "1" como "83.206.234.188".


 

9 Licencia

Para hacer un uso pleno de "Proxy Server for WireLess TelNet" es necesario tener una licencia. En caso de no tener licencia, será posible conectar una sola terminal.

Para poder utilizar "Proxy Server for WireLess TelNet" con varias terminales, deberá realizar un pedido de licencia. Es posible acceder al formulario de pedido de licencias a través del menú Inicio -> Programas -> WireLess TelNet -> Proxy Server -> License.

Aparecerá la siguiente ventana:

 

La aplicación ofrece dos modos de registro: on-line o vía mail. 
Para realizar el pedido de licencia on-line, ingrese su código de registro en el campo llamado "Registration Code". El código de registro es un número proporcionado junto con la compra del producto. Luego de ingresar su "Registration Code" presione el botón "Request License On-Line". Si obtiene una "Activation Key" (clave de activación), su licencia ha sido activada.

 



Si el código ingresado es incorrecto, aparecerá un mensaje de error que comunica que el código no es válido y la licencia no se habrá generado.

El registro también puede realizarse manualmente, efectuando un pedido de licencia vía mail.
Luego de haber ingresado su código de registro, presione el botón "Request License by eMail". Aparecerá un formulario con la información que debe enviar a license@softogo.com para efectuar su pedido de licencia. NO MODIFIQUE EL CONTENIDO DE ESTE FORMULARIO.
El botón "Open Mail", abre el programa de envío de correo configurado en su PC.
El botón "Print this Page", imprime la información que aparece en pantalla. 

Recibirá una clave de activación ("Activation Key"). Ingrésela en el campo "Activation Key" y presione el botón "OK" para validar la nueva licencia.