EDITRAN/TX. Windows/Unix. Manual de Usuario e Instalación

EDITRAN/TX Windows/Unix Manual de Usuario e Instalación INDRA 15 de octubre de 2014

Í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.2.1. Guía de instalación en Windows... 2-1 2.3. Configuración de EDITRAN/TX... 2-3 2.4. Arranque y parada Windows... 2-5 2.4.1. Arranque y parada EICON X25 en WINDOWS.... 2-5 2.5. Arranque y parada UNIX... 2-5 2.6. Arranque de EDITRAN/TX con traza... 2-6 3. 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

1.INTRODUCCION Y REQUERIMIENTOS. 1. 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

2.EDITRAN/TX 2. 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

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

2.EDITRAN/TX 2.3. 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: <nri3>]] Siendo : -ip -nri txcfg [-ip <ip1> [<ip2> <ip3>]] [-nri <nri1> [<nri2> : Direcciones IP locales. : NRIs locales. 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

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

2.EDITRAN/TX 2.4. 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

2.EDITRAN/TX 2.6. 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

3.Consultas a la pasarela EDITRAN/TX. 3. Consultas a la pasarela EDITRAN/TX. 3.1. Consulta desde EDITRAN 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

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

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

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

4.Anexo: Arranque múltiples EDITRAN/TX 4. 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