editran/tx

EDITRAN/TX
Windows/Unix
Manual de Usuario e Instalación
INDRA
15 de octubre de 2014
EDITRAN/TX Windows/Unix
Manual de Usuario e Instalación
ÍNDICE
1.
INTRODUCCION Y REQUERIMIENTOS. ............................................................................................... 1-1
2.
EDITRAN/TX ........................................................................................................................................ 2-1
2.1.
Instalación de EDITRAN/TX en UNIX ............................................................................................................ 2-1
2.2.
Instalación de EDITRAN/TX en Windows ..................................................................................................... 2-1
2.3.
Configuración de EDITRAN/TX...................................................................................................................... 2-3
2.4.
Arranque y parada Windows......................................................................................................................... 2-5
2.5.
Arranque y parada UNIX ............................................................................................................................... 2-5
2.6.
Arranque de EDITRAN/TX con traza ............................................................................................................. 2-6
2.2.1.
2.4.1.
3.
Guía de instalación en Windows ...................................................................................................................................................................................... 2-1
Arranque y parada EICON X25 en WINDOWS. ........................................................................................................................................................... 2-5
CONSULTAS A LA PASARELA EDITRAN/TX. ...................................................................................... 3-1
3.1.
Consulta desde EDITRAN .............................................................................................................................. 3-1
3.2.
Consulta Web ................................................................................................................................................. 3-1
3.2.1.
edihttplog.cfg .......................................................................................................................................................................................................................... 3-1
3.2.2.
Página de inicio ....................................................................................................................................................................................................................... 3-2
3.2.2.1.
Peticiones a la pasarela ......................................................................................................................................................................................... 3-3
3.2.2.2.
Peticiones de EDITRAN.......................................................................................................................................................................................... 3-3
3.2.2.3.
Peticiones del Servidor Web ................................................................................................................................................................................ 3-4
4.
ANEXO: ARRANQUE MÚLTIPLES EDITRAN/TX ................................................................................. 4-1
INDRA. Todos los derechos reservados.
EDITRAN/TX
EDITRAN/TX Windows/Unix
1.
Manual de Usuario e Instalación
1.INTRODUCCION Y REQUERIMIENTOS.
INTRODUCCION Y REQUERIMIENTOS.
EDITRAN/TX es el componente de EDITRAN que permite a entornos z/OS e iSeries
comunicar con remotos X25 sin necesidad de tener instalados software y hardware X25
específicos de esos entornos, como por ejemplo la controladora de comunicaciones IBM 3745.
Esta solución requiere los siguientes elementos:
 Pasarela EDITRAN/TX: Equipo Unix o Windows con acceso hardware a la red X25. Este
manual está enfocado a documentar la instalación y uso de este módulo.
 Equipo EDITRAN z/OS o iSeries con licencia para EDITRAN/TX. En el resto del manual
nos referiremos a éste equipo como HOST EDITRAN. Existen manuales para cada SO
que describen los requisitos de EDITRAN cuando se usa la pasarela EDITRAN/TX.
La Pasarela EDITRAN/TX tiene las siguientes características:
 Se requiere una plataforma UNIX o Windows con conectividad TCP/IP con el HOST
EDITRAN.
 Se contrata de forma independiente y sólo puede usarse para dar servicio a EDITRAN.
 Su uso no implica ningún cambio en los extremos remotos (a no ser que se cambie el
NRI local).
 No requiere que el remoto tenga instalada esta utilidad, puesto que para ese remoto
se continúa siendo X25.
 En llamadas salientes es el HOST EDITRAN el que le proporciona a la pasarela la
información X25 necesaria para la conexión. En llamadas entrantes, la pasarela
proporciona al HOST los datos X25 disponibles.
INDRA. Todos los derechos reservados.
EDITRAN/TX
Pág. 1-1
EDITRAN/TX Windows/Unix Manual de Usuario e Instalación
2.
2.EDITRAN/TX
EDITRAN/TX
Los elementos necesarios para el correcto funcionamiento del sistema EDITRAN/TX en los
entornos UNIX-Windows son:
 Adaptador y Software X25 instalado y configurado. Este paso es distinto
dependiendo del entorno de trabajo. En el Manual de Instalación EDITRAN UNIX/
Windows se describen los requisitos y ejemplos de configuración para cada entorno
soportado.
 Protocolo TCP/IP instalado.
 Software EDITRAN/TX instalado y con licencia de uso.
2.1.
Instalación de EDITRAN/TX en UNIX
En los entornos UNIX el Software EDITRAN/TX se distribuye como un fichero tar
comprimido con GNU Zip, que deberá descomprimir en un directorio específico con los
permisos necesarios para instalar el producto (por ejemplo, en /opt/editrantx).
Por ejemplo, si descarga el fichero de instalación EDITRANTX.tar.gz, una vez colocado en
el directorio de instalación elegido deberá ejecutar los siguientes comandos:
gunzip EDITRANTX.tar.gz
tar –xvf EDITRANTX.tar
2.2.
Instalación de EDITRAN/TX en Windows
En Windows se proporciona un programa de instalación. Para llevar a cabo la instalación se
ejecuta el instalador .exe con un usuario con permisos de administrador.
2.2.1. Guía de instalación en Windows
En este apartado vamos a ver los pasos de configuración para la instalación de EDITRAN/TX
en Windows:
 En las primeras ventanas hay que elegir en qué directorio instalar el producto y el
nombre que tendrá en la Carpeta Programas, y a continuación nos pide hasta 3 IPs y
puertos TCP locales de escucha para EDITRAN/TX, cuyo formato para definir es
[IP]:[Puerto]
INDRA. Todos los derechos reservados.
EDITRAN/TX
Pág. 2-1
EDITRAN/TX Windows/Unix Manual de Usuario e Instalación
2.EDITRAN/TX
 En la siguiente pantalla configuramos hasta 3 direcciones locales X25 donde
EDITRAN/TX atenderá peticiones de dicha conexión. Se puede definir con puerto (con el
formato [nº puerto].[NRI]), sólo con el puerto o sólo con la dirección NRI.
 En la última pantalla de configuración hay que configurar la IP y puerto TCP donde el
servidor EDITRAN estará escuchando. El formato es [IP]:[Puerto].
INDRA. Todos los derechos reservados.
EDITRAN/TX
Pág. 2-2
EDITRAN/TX Windows/Unix Manual de Usuario e Instalación
2.3.
2.EDITRAN/TX
Configuración de EDITRAN/TX
Para consultar la configuración actual ejecute el comando Txcfg sin parámetros
Si quisiera cambiar la configuración local de escucha TCP/IP y X25 debe utilizar el comando
Txcfg, cuyo modo de uso es:
Uso:
txcfg [-ip <ip1> [<ip2> <ip3>]]
<nri3>]]
Siendo :
-ip
: Direcciones IP locales.
-nri
: NRIs locales.
[-nri
<nri1>
[<nri2>
Con la opción –ip se establecen hasta tres direcciones IP y puertos de escucha.
Con la opción –nri se establecen hasta tres direcciones X25 locales
Por ejemplo, si queremos que EDITRAN/TX escuche por las IP 10.0.0.2 puerto TCP 7777, IP
10.0.0.3 puerto TCP 7778 y NRI 31516171 conectado al puerto 1 de la tarjeta de red X25
deberemos ejecutar:
Txcfg –ip 10.0.0.2:7777 10.0.0.3:7778 –nri 0.31516171
Cada instalación de EDITRAN/TX debe asociarse al menos a un HOST EDITRAN al que da
servicio. Para el correcto funcionamiento del producto es necesario configurar la IP y puerto al
que se pasarán las conexiones entrantes de los remotos X.25. Dependiendo del SO en que se
haya instalado debe modificar lo siguiente:
 En Windows:
Modificar el fichero Txstart.bat, en el parámetro –h:
EdiTx start %1 %2 –h[IP]:[Puerto]
 En UNIX:
Debe definir la variable IP_ROUTE_TX del script de arranque con la IP y el puerto de
EDITRAN con el formato [IP]:[Puerto]. Consulte el apartado 2.5 Arranque y parada
UNIX.
Si al arrancar EDTRAN/TX no estuviera definido este dato, el sistema no arrancaría y dejaría
en el fichero de log el siguiente mensaje:
20141010 165344 000000000-000000000-000000 EDItran/TX arrancado.
IP HOST - (undefined)
20141010 165344 000000000-000000000-000000 EDItran/TX finalizado
De forma adicional, se puede configurar la Pasarela EDITRAN/TX para que de servicio a
varios HOST EDITRAN. En estos casos, se definirán varias rutas de forma que las conexiones
X25 entrantes se pasen al HOST que corresponda al NRI local de la llamada. El fichero de rutas
es un fichero de texto que debe llamarse hosts.cfg y en el que cada línea es del tipo
<nri>;<ip>:<puerto>.
INDRA. Todos los derechos reservados.
EDITRAN/TX
Pág. 2-3
EDITRAN/TX Windows/Unix Manual de Usuario e Instalación
2.EDITRAN/TX
Suponiendo un escenario en que el cliente tenga una línea X25 y tenga dos entornos
EDITRAN, por ejemplo de real y pruebas, podría configurar la pasarela de forma que las
llamadas entrantes lleguen al entorno adecuado. En el esquema se representa el caso:
Red
X25
EDITRAN/TX
NRI:31516171
NRI:3151617102
EDITRAN
IP:10.0.0.101:8888
EDITRAN PRUEBAS
IP:10.0.0.102:8888
Para configurarlo adecuadamente deberá:
 Configurar la pasarela EDITRAN/TX para que acepte las llamadas X25 que lleguen a
ambos NRIs.
Txcfg –ip 10.0.0.2:7777 –nri 0.31516171 0.3151617102
 Crear el fichero hosts.cfg con el siguiente contenido para que las llamadas que
lleguen con la subdirección 02 se pasen al entorno de pruebas. El resto se pasarán al
HOST EDITRAN principal que se configuró en el bat o script de arranque.
3151617102;10.0.0.102:8888
INDRA. Todos los derechos reservados.
EDITRAN/TX
Pág. 2-4
EDITRAN/TX Windows/Unix Manual de Usuario e Instalación
2.4.
2.EDITRAN/TX
Arranque y parada Windows
El Servicio instalado de Windows para el control de EDITRAN/TX tendrá por defecto el
siguiente nombre y características:
Si se ha elegido la opción de instalar el servicio, el arranque se deberá hacer desde el mismo
servicio EDItran/TX.
También se puede instalar el servicio EDITRAN/TX con el siguiente comando:
serviciotx install
Y desinstalarlo con el siguiente comando:
serviciotx uninstall
Si no se eligió instalar el Servicio, se puede arrancar EDITRAN/TX desde un símbolo de
sistema (cmd) ejecutando el comando EdiTx, que tiene el siguiente modo de uso:
Editx start|stop [-s] [-t] [-h<ip host>]
start: Arranca el sistema EDItran/TX.
stop: Detiene el sistema EDItran/TX.
-t
: Traza.
-s
: Modo Silencioso.
-h
: Direccion IP de EDItran/TX remoto.
También mediante los batch Txstart.bat y Txstart.bat, que a su vez se pueden
ejecutar desde los accesos directos en el menú de Inicio, elegir Programas, EDITRAN-TX,
opciones Arrancar EDITRAN-TX y Parar EDITRAN-TX.
2.4.1. Arranque y parada EICON X25 en WINDOWS.
Desde símbolo de Sistema, diríjase al directorio c:\WINDOWS\SYSTEM32\EICON para poder
utilizar los siguientes comandos:
 Arrancar tarjeta EICON X25
eccard start
 Detener tarjeta EICON X25
eccard stop
 Comprobar estado tarjeta EICON X25
eccard status
También puede utilizar el Servicio de Windows EiconCards.
2.5.
Arranque y parada UNIX
En los entornos UNIX el script EdiTX es el que se encarga de arrancar y parar EDITRAN/TX.
Se debe definir la variable IP_ROUTE_TX en dicho script, descomentando la línea adecuada
y configurando la IP y el puerto del HOST EDITRAN:
#################
#IP_ROUTE_TX DEFINITION
IP_ROUTE_TX=10.0.0.4:7777
export IP_ROUTE_TX
Para arrancar y parar EDITRAN/TX ejecute EdiTX start y EdiTX stop, y para consultar el
estado de EDITRAN/TX ejecute EdiTX status.
INDRA. Todos los derechos reservados.
EDITRAN/TX
Pág. 2-5
EDITRAN/TX Windows/Unix Manual de Usuario e Instalación
2.6.
2.EDITRAN/TX
Arranque de EDITRAN/TX con traza
Es posible arrancar EDITRAN/TX con traza para depurar errores con mayor detalle.
 En Windows:
 Con el batch Txstart.bat ejecutado de la siguiente forma:
Txstart.bat -t
 Con el comando EdiTx ejecutado de la siguiente forma:
EdiTx start -t –h[IP host]:[Puerto host]
 En el Servicio de Windows EDItranTX, añadiendo –t en el campo Parámetros de inicio y
pulsando en Iniciar (ese parámetro no se queda guardado en el Servicio):
 En tarjeta EICON Windows
Para poder arrancar traza de EICON debe dirigirse desde símbolo de Sistema al directorio
c:\WINDOWS\SYSTEM32\EICON para poder utilizar los siguientes comandos:
 Arrancar traza EICON X25
ECMODULE TRACE X25 /T 128 /S 8000 /port 1
Arranca la traza en el puerto 1 con un buffer de 8000 y se salvaran los primeros 128
bytes de cada paquete. Si estuviera en otro puerto, definir en port el número de
puerto asignado.
 Comprobar traza EICON X25 en pantalla
ECMODULE TRACE X25
 Guardar traza EICON X25 en un fichero
ECMODULE TRACE X25 /O [Ruta y nombre de fichero]
Por ejemplo, el comando ECMODULE TRACE X25 /O c:\trazax25.txt dejará el fichero
de traza en c:\trazax25.txt.
 Detener traza EICON X25
ECMODULE TRACE X25 /S 0
 En Unix:
 Con el script EdiTx ejecutado de la siguiente forma:
EdiTx –t start
La traza de EDITRAN/TX generará los ficheros editrantx.traza, editcp.traza y edix25.traza.
INDRA. Todos los derechos reservados.
EDITRAN/TX
Pág. 2-6
EDITRAN/TX Windows/Unix Manual de Usuario e Instalación
3.
Consultas a la pasarela EDITRAN/TX.
3.1.
Consulta desde EDITRAN
3.Consultas a la pasarela EDITRAN/TX.
Desde el menú de EDITRAN es posible consultar el estado, el log y la configuración de la
pasarela EDITRAN/TX. El proceso servidor encargado de atender estas peticiones es logsrv,
que por defecto escucha en el puerto 8120. Este valor puede modificarse creando o
modificando si existe, el fichero logsrv.cfg; es un fichero de texto en el que deberá contener
una línea con el siguiente formato:
PUERTO=7120
Consulte EDITRAN/P Manual de Usuario para ver los detalles de la información mostrada al
usuario.
3.2.
Consulta Web
EDITRAN/TX permite también consultar su actividad desde cualquier equipo con acceso a la
pasarela mediante un cliente Web. La aplicación está probada y es funcional con Internet
Explorer 8 y Google Chrome.
Para poder realizar consultas mediante un navegador web debemos conectarnos a la
dirección http://IPEDITRANTX:Puerto, siendo el puerto por defecto el 8888. Este dato es
configurable como se explica más adelante.
Al momento de conectarnos en la página web, el servidor web nos pide un usuario y una
contraseña para poder acceder a la aplicación. Hay un usuario creado por defecto que es:
Usuario: editran
Contraseña: editran
3.2.1. edihttplog.cfg
Este archivo por defecto se instala junto a la instalación típica de EDITRANTX, y se
encuentra en la raíz de la instalación. Guarda los parámetros que va a usar el cliente Web.
Estos son:
 PATHHOME: La ruta a partir de donde está la carpeta de la instalación de EDITRANTX
que contiene los recursos del servidor web. Por defecto es weblog.
 IPESCUCHA: IP de escucha del servidor web. Por defecto es 0.0.0.0.
 PUERTO: Puerto de escucha del servidor web. Por defecto es 8888.
 IPDENEGADAS: IPs que no pueden conectarse al servidor web. Por defecto está en
blanco.
 USUARIOS: Usuarios que son capaces de conectarse al servidor para la consulta vía
web.
 IPPERMITIDAS: IPs permitidas para la conexión web. En blanco, permite todas las IPs.
Por defecto está en blanco.
 TIMEOUT: Temporizador de cada petición para la desconexión.
 CABECERA y PIE: Ficheros a incluir, necesarios para el servidor, incluidos en la
instalación.
Estos valores pueden modificarse directamente en este archivo de texto plano (no
recomendable) o mediante el cliente web.
INDRA. Todos los derechos reservados.
EDITRAN/TX
Pág. 3-1
EDITRAN/TX Windows/Unix Manual de Usuario e Instalación
3.Consultas a la pasarela EDITRAN/TX.
3.2.2. Página de inicio
La página principal de la aplicación web podemos verla en la siguiente imagen. Podemos
ver tres apartados distintos:
 Peticiones a la pasarela: Consultas a EDITRAN/TX.
 Peticiones de EDITRAN: Consultas del programa de EDITRAN.
 Peticiones del Servidor Web: Consultas y gestión de la aplicación web.
INDRA. Todos los derechos reservados.
EDITRAN/TX
Pág. 3-2
EDITRAN/TX Windows/Unix Manual de Usuario e Instalación
3.Consultas a la pasarela EDITRAN/TX.
3.2.2.1.Peticiones a la pasarela
Tiene tres apartados:
 Consulta del log: Nos permite ver el log de EDITRAN/TX. Podemos ver una imagen:
 Consultar configuración: Es la configuración de EDITRAN/TX.
 Consulta de Estado: Nos indica si la pasarela de EDITRAN/TX está activa o inactiva.
3.2.2.2.Peticiones de EDITRAN
Dos apartados:
 Consulta de Licencia: Nos permite ver la licencia del producto y su estado.
 Consulta de HostID: Identifica el equipo de la instalación.
INDRA. Todos los derechos reservados.
EDITRAN/TX
Pág. 3-3
EDITRAN/TX Windows/Unix Manual de Usuario e Instalación
3.Consultas a la pasarela EDITRAN/TX.
3.2.2.3.Peticiones del Servidor Web
Dos apartados:
 Servidor Web. Configuración: Nos permite la consulta y administración de usuarios
capaces de acceder al Servidor Web, cambiar la IP y el puerto de escucha, las IPs
denegadas y permitidas y los ficheros cabecera y pie del servidor. Esta aplicación web
es la que modifica edihttplog.cfg. Podemos ver una imagen:
Es aconsejable borrar el usuario por defecto editran y crear uno nuevo con distinta
password para evitar conexiones no deseadas.
 Servidor Web: Reiniciar servidor: Reinicia el servidor web.
INDRA. Todos los derechos reservados.
EDITRAN/TX
Pág. 3-4
EDITRAN/TX Windows/Unix Manual de Usuario e Instalación
4.
4.Anexo: Arranque múltiples EDITRAN/TX
Anexo: Arranque múltiples EDITRAN/TX
Es posible instalar en un mismo equipo varios servicios EDITRAN/TX. En algunos casos puede
ser necesario si por ejemplo, se tiene que atender más de tres NRIs o se quiere balancear la
carga de las transmisiones. Para ello debe realizar el siguiente procedimiento:
1- Instalar EDITRAN/TX de la manera habitual instalando el servicio en la instalación.
2- Una vez instalado, hacer una copia del directorio de EDITRAN/TX instalado con un nombre
distinto de directorio (por ejemplo, EDITRANTX_2)
3- Ahora hay que instalar el servicio del segundo TX. Para ello, debe dirigirse con símbolo de
sistema o modo comando (cmd) al directorio del segundo TX y ejecutar:
serviciotx install 1000
En donde aparece 1000 debe definir un número entre 1000 y 6000.
4- A continuación debe configurar el segundo EDITRAN/TX. Para ello, debe ir con el símbolo
de sistema o modo comando (cmd) al directorio del segundo TX y ejecutar:
txcfg [-ip <ip1> [<ip2> <ip3>]] [-nri <nri1> [<nri2> <nri3>]]
Siendo :
-ip
: Direcciones IP locales donde está instalado EDITRANTX mas el
puerto, separado
por : . Se pueden definir hasta 3 IPs locales
distintas.
IMPORTANTE: Se debe configurar un puerto distinto al configurado en el
primer EDITRAN/TX.
-nri
: NRIs locales conectados al equipo con EDITRAN/TX por los que
se transmitirá la
llamada X25. Se puede definir el puerto al que
está conectado el NRI de la
siguiente forma: 0.314151, 1.315254,
etc.
Nota: Se asume que el primer TX se ha configurado en la instalación; si no, el comando
txcfg serviría para el primer TX por igual.
5- Para finalizar, vaya a la ventana de Servicios de Windows (services.msc) y en el servicio
EDITRANTX configure un usuario distinto de la cuenta de sistema local que se define por
defecto.
Nota: Puede cambiar el usuario del servicio del TX principal o del secundario; el nombre del
servicio EDITRAN/TX secundario dependerá del número que se haya configurado
en
el
comando serviciotx.
INDRA. Todos los derechos reservados.
EDITRAN/TX
Pág. 4-1
Centros de Competencia
eCommerce
Avda. de Bruselas 35
28108 Alcobendas.
Madrid, España
T. +34 91 480 80 80
T. +34 91 480 50 00
www.indracompany.com
INDRA. Todos los derechos reservados.
EDITRAN/TX
Pág. 4-1