EDItran TX 5.0

EDItran TX 5.0
IMS (Windows-UNIX)
Manual de instalación y usuario
Indra.
Junio de 2009.
ETX50USII.doc.
Indra.
La información aquí contenida puede ser objeto de cambios sin previo aviso. Las distintas versiones del producto
pueden dar lugar a cambios, adiciones o supresiones de información en este manual.
La correspondencia acerca de este manual debe realizarse en la hoja de comentarios aquí incluida y debe ser dirigida a Indra,
Producto EDItran, Avda. de Bruselas 35 (Edificio VIO-1), 28108 - Arroyo de la Vega - Alcobendas, Madrid.
Comentarios de usuario sobre esta documentación.
Exprese, y háganos llegar, su opinión y comentarios acerca de la documentación entregada y así podremos
corregirla en las posteriores versiones de este documento.
Indra.
Producto: EDItran TX 5.0 IMS
Manual de instalación y usuario
Referencia: ETX50USII.doc
Avda. de Bruselas 35 - Arroyo de la Vega - Alcobendas.
28108 MADRID.
_______________________________________________________________________________________________________
_______________________________________________________________________________________________________
_______________________________________________________________________________________________________
_______________________________________________________________________________________________________
_______________________________________________________________________________________________________
_______________________________________________________________________________________________________
_______________________________________________________________________________________________________
_______________________________________________________________________________________________________
_______________________________________________________________________________________________________
_______________________________________________________________________________________________________
_______________________________________________________________________________________________________
_______________________________________________________________________________________________________
_______________________________________________________________________________________________________
Empresa :
____________________________________________________________________________________
Departamento:
____________________________________________________________________________________
Contacto:
____________________________________________________________________________________
Dirección:
____________________________________________________________________________________
Manual de Instalación y usuario
Índice
1.
INTRODUCCION Y REQUERIMIENTOS. ....................................................................................................1-1
2.
DEFINICIONES Y CAMBIOS (OS/390 – Z/OS). ............................................................................................2-1
3.
EDITRAN/TX EN UNIX Y WINDOWS............................................................................................................3-1
3.1.
3.2.
3.3.
3.4.
3.5.
3.6.
3.7.
3.8.
INSTALACIÓN DE EDITRAN/TX EN UNIX ...........................................................................................................3-1
INSTALACIÓN DE EDITRAN/TX EN WINDOWS .................................................................................................3-1
CONFIGURACIÓN DE EDITRAN/TX WINDOWS .................................................................................................3-1
ARRANQUE Y PARADA WINDOWS ....................................................................................................................3-1
CONSULTAS A LA PASARELA WINDOWS. .............................................................................................................3-1
CONFIGURACIÓN DE EDITRAN/TX UNIX...........................................................................................................3-2
ARRANQUE Y PARADA UNIX..............................................................................................................................3-2
CONSULTAS A LA PASARELA UNIX ......................................................................................................................3-5
Indra. Todos los derechos reservados
ETX50USII.doc
18/10/2011
Pag.
1-1
EDItran TX 5.0 IMS.
1.
INTRODUCCION Y REQUERIMIENTOS.
Se ha desarrollado una nueva utilidad que consiste en evitar la 3745 para poder establecer
conexiones con remotos x25. Esta utilidad, se contrata de forma independiente al propio EDItran, y
requiere: EDItran/TX y software pasarela de datos para entorno UNIX-WINDOWS. El sistema se
basa en los siguientes elementos:
•
El host (CICS), dialoga a través de TCP/IP con PASARELA EDItran que corren en el entorno
WINDOWS-UNIX, encapsulando y desencapsulando datos.
•
PASARELA que corre en la plataforma UNIX-WINDOWS, dialoga a través de x25 con los
extremos remotos.
•
En llamadas salientes desde IMS, éste, proporciona a PASARELA UNIX-WINDOWS información
x25 necesaria para esa conexión.
•
En llamadas entrantes al IMS, PASARELA UNIX-WINDOWS proporciona al anterior la
información x25 disponible.
•
Una vez que hay conectividad entre ambos extremos, PASARELA UNIX-WINDOWS es un mero
transmisor de datos:
•
Cuando EDItran IMS quiere enviar un dato al extremo remoto, se lo envía a PASARELA unixwindows a través del socket establecido. PASARELA, recibe ese dato y lo envía al extremo
remoto a través del cvc x25.
•
Cuando el remoto envía un dato, le llega a PASARELA UNIX-WINDOWS a través del circuito
x25 conectado entre ambos. Pasarela, envía ese dato al IMS a través del socket ip que
ambos tienen conectados.
Esta utilidad tiene las siguientes características:
•
Se requiere una plataforma UNIX-WINDOWS
•
Se contrata de forma independiente al propio EDItran, y requiere: EDItran/TX y pasarela de
datos (software para entorno UNIX-WINDOWS).
•
No sirve para otro producto que no sea EDItran.
•
No requiere que el extremo remoto cambie nada (a no ser que se cambie el nri local x25 de host,
el cual estará enganchado en la plataforma unix-windows).
•
No requiere que el remoto tenga instalada esta utilidad, puesto que para ese remoto se continúa
siendo x25.
•
Se tratan y se generan las liberaciones como en el mundo x25, a diferencia del mundo tcp/ip
nativo, en donde para liberar se cierra el socket.
•
EDItran puede funcionar simultáneamente con varios tipos de conexión (x25, TCP/IP y TX), es
decir puede tener simultáneamente una sesiones conectadas por x25, otras por lu6.2, otras
contra PAD privados, otras contra PAD públicos, otras contra tcp/ip y otras por tcp contra remotos
x25.
En resumen, EDItran TX permite:
1. Conexiones EDItran desde un host (IMS) hacia remotos x25, sin necesidad de disponer de
una 3745, de forma que sea para esos remotos un proceso transparente. Para ello, desde
el host se realizan conexiones ip contra un unix-windows, el cual dispone de una tarjeta de
red x25, que es la que se comunica con los extremos remotos.
Indra. Todos los derechos reservados
ETX50USII.doc
18/10/2011
Pag.
1-1
EDItran TX 5.0 IMS.
2. Conexiones EDItran x25 y x28 desde centros remotos a un host (IMS). Para ello, dichos
remotos se conectan vía x25 a un windows-unix, y éste se engancha vía ip al host (IMS),
que en definitiva es el destino final de la conexión remota. De esta manera, se evita
también la 3745 y el proceso es transparente para las entidades remotas.
EDItran/TX requiere por tanto de los siguientes elementos:
1.- Una ó más máquinas UNIX (SOLARIS, AIX, HP) ó WINDOWS (NT ó 2000) con n tarjetas
de red x25 (en un UNIX pueden ir varias tarjetas mientras que en un windows sólo puede ir una
tarjeta, que además debe ser dedicada a EDItran/TX). Las placas x25 no requieren modem y deben
ser SAGEM (modelo PRIMA ó XMEM) ó EICON (múltiples modelos).
2.- Software EDItran/TX para UNIX-WINDOWS.
3.- TCP/IP desde host (IMS) a las máquinas unix-windows.
4.- Software EDItran/TX para IMS.
Pasarela remota
EDItran
TCP/IP
WAN
EDItran
EDItran
Pasarela 1-n
X25
TCP/IP
LAN
PAD
Indra. Todos los derechos reservados
ETX50USII.doc
18/10/2011
EDItran
Pag.
1-2
Manual de Instalación y usuario
2.
DEFINICIONES Y CAMBIOS (OS/390 – Z/OS).
Se requiere la misma instalación que para EDItran/TCP. Las definiciones están
descritas en el manual Interfaz TCP/IP 5.0. Manual de instalación y usuario (IP50USII)
Los parámetros afectados de los perfiles de EDItran/P se enumeran en el citado
manual y están descritos en el manual de usuario de EDItran/P (EP50USUI).
En la consulta de la traza se han introducido nuevos mensajes para las sesiones que
utilizan la pasarela, que incluyen mensajes de TCP/IP y mensajes de X25. (Ejemplo en
versión 4.1 pues no ha variado)
31/03/05
15:34:17
SESION
-----------------------000000000000000000000000
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
31/03/05
15:35:32
SESION
-----------------------000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
000099930000099980TELEGC
CONSULTA DE LA TRAZA
FECHA
----30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
HORA
-------15:23:41
15:23:41
15:23:41
15:23:41
15:23:41
15:23:42
15:24:09
15:24:09
15:24:13
15:24:13
15:24:13
15:24:13
15:24:13
15:24:13
15:24:13
15:24:15
S
E
E
E
S
S
E
E
S
E
S
S
S
E
S
S
E
CLA
--CON
TAK
X25
X25
X00
X00
SAP
SAR
SCP
A2P
SDR
EAB
EAB
SAB
E11
E11
C NSM
COMENTARIO
- ------ -----------------------1 INDICACION CONEXION TCP
1 ACEPTA CONEX. TCP-X25
0B
0F
INDICACION CONEXION
INDICACION CONEXION
PETICION SESION REMOTA
ACEPTACION PET. SESION
0
0 PETICION DE RECEPCION
SOLICITA PREVIO RECEPC.
3
0 FICH.INCORRECTO EN RECEP
PETICION FIN DE SESION
PETICION FIN DE SESION
LIBERACION DE APLICACION
PETICION LIBERACION
PETICION LIBERACION
CONSULTA DE LA TRAZA
FECHA
----30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
30-03
HORA
-------15:21:21
15:21:21
15:21:21
15:21:21
15:21:21
15:21:23
15:21:24
15:21:41
15:21:41
15:21:41
15:21:42
15:21:45
15:21:45
15:21:49
15:21:49
15:21:49
S
S
E
S
S
S
S
E
E
S
E
S
E
S
E
S
S
CLA
--E00
E00
SOC
CON
X25
X11
X11
X25
X00
X00
SAP
SAR
SCP
SDR
A7I
EAB
EDITRAN
4.1
EDITRAN
4.1
C NSM
COMENTARIO
- ------ -----------------------PETICION DE CONEXION
PETICION DE CONEXION
1 PETICION CONEXION TCP
1 PETICION CONEXION TCP
0B
INDICACION LIBERACION
INDICACION LIBERACION
0F
INDICACION CONEXION
INDICACION CONEXION
PETICION SESION
ACEPTACION PET. SESION
0
0 PET. INICIO DE EMISION
3
0 FICH.INCORRECTO EN EMIS.
INFORMATIVO A LA APLICA.
PETICION FIN DE SESION
Los mensajes de la red X25 se incluyen con la clave ‘X25’ y son similares a los
mensajes XAI y GAT de las interfaces de conexión ISAR o NPSI/GATE para X25.
Indra. Todos los derechos reservados
ETX50USII.doc
18/10/2011
Pag.
2-1
Manual de Instalación y usuario
En la consulta expandida puede verse el contenido completo de los mensajes X25 que
se intercambian entre EDItran IMS y la Pasarela UNIX-Windows.
-----------------------------------------------------------------------------|
31/03/05
GESTOR DEL EDITRAN
EDITRAN
|
|
15:48:02
CONSULTA DE LA TRAZA
4.1
|
-----------------------------------------------------------------------------|
|
|
CODIGO LOCAL:
CODIGO REMOTO:
APLICACION:
|
|
|
|
30/03/2005 15:23:41.24 000099930000099980TELEGC E X25
|
|
430B000FB0A330000099983054454C4547430A0000000000000000000000
|
0000000000000000000A00000031713283030A0000003151362514000000
|
|
|
|
|
|
|
|
|
30/03/2005 15:23:41.25 000099930000099980TELEGC S X25
|
|
130F00000000000000000000000000000000000000000000000000000000
|
|
000000000000000000000000000000000000000000000000000000000000
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
------------------------------------------------------------------------------
En el mensaje de solicitud de llamada ‘0B’ tenemos
43· que es la longitud del mensaje en hexadecimal
0B es el tipo de mensaje X25 (solicitud de llamada)
000F indica la longitud de datos de usuario
B0A330000099983054454C4547430A son los datos de usuario
0A0000003171328303 es la longitud, en hexadecimal, y el nri llamante
0A0000003151362514 es el nri llamado.
.
La indicación de llamada entrante (0B) es idéntica a la solicitud de llamada
El mensaje de aceptación de llamada, o de llamada aceptada (0F) sólo incluye,
generalmente, la longitud y el código de mensaje. En ocasiones pueden aparecer datos de
parámetros negociados
130F00000000000000000000000000000000000000
Las indicaciones de liberación o las peticiones de liberación (13) están compuestas de
longitud, tipo de mensaje y causa y diagnóstico de liberación. La causa y diagnóstico se
corresponde con los códigos estándar de X25.
0313497F
Indra. Todos los derechos reservados
ETX50USII.doc
18/10/2011
Pag.
2-2
Manual de Instalación y usuario
3.
EDItran/TX EN UNIX Y WINDOWS
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 EDItran 4.1 Manual de
Instalación 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.
3.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. Por ejemplo, si se ha recibido el fichero editx.sparc-sunsolaris2.6.V413-2003-06-24.tar.gz deberá ejecutar lo siguiente:
gunzip editx.sparc-sun-solaris2.6.V413-2003-06-24.tar.gz
tar –xf editx.sparc-sun-solaris2.6.V413-2003-06-24.tar
3.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 debe seleccionar el botón de INICIO y al desplegarse el menú elegir la opción
Ejecutar.
Si la unidad donde se encuentra el producto para instalar fuera “E:”, teclee lo siguiente:
E:\EDItranTX413.exe
Siga las instrucciones que vayan apareciendo por la pantalla.
3.3.
Configuración de EDItran/TX WINDOWS
En el mismo proceso de instalación se deben indicar las direcciones IP locales y
puertos de escucha, las direcciones de X.25 y la dirección IP del CICS y puerto de escucha,
también se indica el modelo de tarjeta X.25, SAGEM o EICON.
3.4.
Arranque y parada WINDOWS
En el menú de inicio elegir programas y aparece la opción EDItranTX Windows 413,
ejecutando dicha opción da la posibilidad de Arrancar EDItranTX, Parar EDItranTX y
documentación de EDItranTX.
3.5.
Consultas a la pasarela Windows.
Desde IMS, se puede consultar el estado, el log ó la configuración de la pasarela
Windows (consulte el manual EP50USUI, capítulo 4.2.4), siempre y cuando haya sido
configurada la misma, para ello es necesario que en la máquina Windows se esté ejecutando
el proceso logsrv que por defecto escucha en el puerto 8120. Este valor puede modificarse
Indra. Todos los derechos reservados
ETX50USII.doc
18/10/2011
Pag.
3-1
Manual de Instalación y usuario
mediante la variable de entorno EDI_IPC_KEY_BASE. El puerto por el que escuchará es el
valor que tenga la variable de entorno EDI_IPC_KEY_BASE sumándole el valor 120 (para
escuchar sobre el puerto 6120 habría que poner la variable de entorno EDI_IPC_KEY_BASE
a 6000).
3.6.
Configuración de EDItran/TX UNIX
Una vez instalado es necesario establecer algunos parámetros necesarios para el
funcionamiento de la pasarela. Para ello se proporciona el siguiente comando que hay que
ejecutar antes de arrancar el sistema por primera vez.
Uso:
TxCfg –ip <ip1> [<ip2> <ip3>] –nri <nri1> [<nri2> <nri3>]
Siendo:
-ip: Direcciones IP locales.
-nri: 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, TxCfg –ip 172.25.145.80:7888 172.25.145.80:7889 –nri 312456789
configura la pasarela para escuchar en TCP por la dirección 172.25.145.80 y dos puertos
distintos 7888 y 7889 y por X25 aceptará las llamadas que lleguen al NRI 312456789.
Además, es necesario tener definida como variable de entorno IP_ROUTE_TX que
establece la dirección y puerto IP del HOST.
3.7.
Arranque y parada UNIX
Para arrancar y parar EDItran/TX ejecute EdiTX start y EdiTX stop.
En los entornos Windows también se puede establecer el valor de la variable
IP_ROUTE_TX al arrancar mediante la opción –h del comando EdiTX. Si por ejemplo el
EDItran/TX del Host tiene como IP de escucha 156.122.34.12 y puerto 8888 debería ejecutar
EdiTx start –h156.122.34.12:8888
En los entornos UNIX EdiTX es el script que se lista a continuación. Se recomienda
definir la variable IP_ROUTE_TX en este script descomentando la línea adecuada y
asignandola el valor que proceda.
#!/bin/sh
#################
#SUN, DEC y LINUX
LD_LIBRARY_PATH=`pwd`:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH
#################
#AIX
Indra. Todos los derechos reservados
ETX50USII.doc
18/10/2011
Pag.
3-2
Manual de Instalación y usuario
LIBPATH=`pwd`
export LIBPATH
#################
#HP
SHLIB_PATH=`pwd`
export SHLIB_PATH
#export X25_IFNAME_A=NXL0
#export X25_IFNAME_B=NXL1
#################
#DEC DTE CLASS DEFINITION
#X25_DTE_CLASS_A=llc2-class-a
#export X25_DTE_CLASS_A
#X25_DTE_CLASS_B=llc2-class-b
#export X25_DTE_CLASS_B
#################
#IP_ROUTE_TX DEFINITION
#IP_ROUTE_TX=IP:PUERTO HOST
#export IP_ROUTE_TX
PROC_STAR="editrantx editcp edix25"
PROC_STOP="editrantx editcp edix25"
N=`tput rmso`
B=`tput smso`
if ps -ef > /dev/null 2>&1; then
PS="ps -ef"
else
PS="ps -x"
fi
# arranque del proceso dado
startproc() {
if [ -f $1 ]; then
echo '*** Arranque ***' - $USER - `date` >>$1.out
if [ ! -z "$traza" ] ; then
EDI_DEBUG=$1.traza
else
EDI_DEBUG=
fi
$1 >> $1.out 2>&1 &
sleep 8
pid=`$PS |
grep $! | grep $1 | grep -v grep |
awk '{print $2}'`
if [ "$pid" != "" ] ; then
echo "\tProceso $1 arrancado."
return 0
else
echo "\tProceso $1 NO ARRANCADO."
return 1
fi
fi
}
# parada del proceso dado
Indra. Todos los derechos reservados
ETX50USII.doc
18/10/2011
Pag.
3-3
Manual de Instalación y usuario
stopproc() {
pid=`$PS |
grep $1 | grep -v grep |
awk '{print $2}'`
if [ "$pid" != "" ] ; then
kill -2 $pid > /dev/null 2>&1
if [ $? = 0 ] ; then
echo "\tProceso $1 detenido."
return 0
else
echo "\tProceso $1 NO DETENIDO."
return 1
fi
else
echo "\tProceso $1 no encontrado."
fi
sleep 4
}
# estado del proceso dado
statusproc() {
pid=`$PS |
grep $1 | grep -v grep |
awk '{print $2}'`
if [ "$pid" != "" ] ; then
return 0
else
return 1
fi
}
##################################
traza=
force=
while getopts tf opcion
do
case $opcion in
t) traza=1 ;;
f) force=1 ;;
\?) printf "Opcion invalida\n" ;;
esac
done
shift `expr $OPTIND - 1`
case $1 in
'start')
echo "Arrancando sistema EDItran/TX..."
if [ -z "$force" ] ; then
statusproc editrantx
if [ $? = 0 ]; then
echo "${B}Hay otro sistema EDItran/TX arrancado${N}."
exit 1
fi
fi
for PROCESO in $PROC_STAR;
do
Indra. Todos los derechos reservados
ETX50USII.doc
18/10/2011
Pag.
3-4
Manual de Instalación y usuario
startproc $PROCESO
done;
statusproc editrantx
if [ $? = 0 ]; then
echo "Sistema EDItran/TX arrancado."
exit 0
else
echo "${B}Sistema EDItran/TX NO ARRANCADO${N}."
exit 1
fi
;;
'stop')
echo "Deteniendo sistema EDItran/TX..."
for PROCESO in $PROC_STOP;
do
stopproc $PROCESO
done;
statusproc editrantx
if [ $? = 0 ]; then
echo "${B}Sistema EDItran/TX NO DETENIDO${N}."
exit 0
else
echo "Sistema EDItran/TX detenido."
exit 1
fi
;;
'status')
echo "Estado sistema EDItran/TX..."
statusproc editrantx
if [ $? = 0 ]; then
echo "${B}Sistema EDItran/TX arrancado${N}."
exit 0
else
echo "Sistema EDItran/TX detenido."
exit 1
fi
exit 0
;;
*)
printf "Usage: %s [-t] [-f] start|stop|status\n" $0
printf "\t-t\t Traza\n"
printf "\t-f\t Ignora otro EDItran/TX arrancado\n"
printf "\tstart\t Arranca el sistema EDItran/TX\n"
printf "\tstop\t Detiene el sistema EDItran/TX\n"
printf "\tstatus\t Obtiene el estado del sistema EDItran/TX\n"
exit 1
;;
esac
3.8.
Consultas a la pasarela Unix
Desde IMS, se puede consultar el estado, el log ó la configuración de la pasarela
Windows (consulte el manual EP50USUI, capítulo 4.2.4) , siempre y cuando haya sido
configurada la misma, para ello es necesario que en la máquina Unix se esté ejecutando el
proceso logsrv que por defecto escucha en el puerto 8120. Este valor puede modificarse
mediante la variable de entorno EDI_IPC_KEY_BASE. Por ejemplo, si se modificaran las
siguientes líneas del script de arranque, el puerto sería el 6120 (KEY_BASE + 120).
Indra. Todos los derechos reservados
ETX50USII.doc
18/10/2011
Pag.
3-5
Manual de Instalación y usuario
#################
#EDI_IPC_KEY_BASE DEFINITION
EDI_IPC_KEY_BASE=6000
export EDI_IPC_KEY_BASE
Indra. Todos los derechos reservados
ETX50USII.doc
18/10/2011
Pag.
3-6
BARCELONA
Avda. Diagonal, 218, 3º
08018 BARCELONA
BILBAO
Henao, 4, 4ºA
48001 BILBAO
MADRID
Avda. de Bruselas 35 - Arroyo de la Vega - Alcobendas
28108 MADRID
SEVILLA
Avda. San Francisco Javier, 22, 6º
41018 SEVILLA
VALENCIA
Colón, 60
46004 VALENCIA