> For the complete documentation index, see [llms.txt](https://docs.editran.onesait.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.editran.onesait.com/documentacion-editran/editran-connect-v3.3/migracion/clasico-a-connect.md).
# Migración a Editran Connect
Este documento detalla paso a paso el proceso de migración de Editran Classic a Editran Connect 3.x
La migración se divide en dos apartados:
1. Migración del módulo Core
2. Migración a Editran Connect 3.x
## Antes de empezar
Antes de poder realizar la migración es necesario cumplir los siguientes requisitos y tener claro en que escenario nos encontramos:
1. Migración en misma plataforma (soportado el cambio de Máquina/PC)
2. Migración con cambio de maquina a diferente plataforma
Entiéndase como plataforma los siguientes conjuntos de Sistemas Operativos:
* Plataforma Windows (p.ej. Windows 11, Windows Server, ...): la configuración de Editran es directamente compatible entre todos ellos.
* Plataforma Unix (Red Hat 9, Ubuntu, ...): la configuración de Editran es directamente compatible entre todos ellos.
### Pasos Previos
* En el caso de utilizar la misma máquina para migrar a la versión actual, es necesario desinstalar la version de Editran Classic previo a instalar el producto Editran Connect. **Se recomienda realizar una copia de seguridad completa de la instalación de Editran Classic previo a la desinstalación.**
* Se debe disponer en la máquina donde se está realizando la migración a la versión actual de los ficheros de configuración de los diferentes ámbitos a migrar:
* Configuración de Editran Classic:
* Si migramos a la misma plataforma: Ficheros editranp.cfg, editranp.sdx y editrang.cfg
* Migración con cambio de plataforma: Ficheros textuales editranp.txt y editrang.txt.
* Configuración de criptografía:
* Fichero de configuración del módulo EditranGC: controlgc.cfg
* Fichero con las claves DES: ckds.des
* Ficheros con las claves RSA: ckds.rsa o carpeta .rsa dependiendo de la version de Editran Classic
* Configuración de EditranGT:
* Fichero editrangt.cfg
* Los ficheros de configuración a migrar se deben organizar con el mismo árbol de directorios que se encontraban en la instalación de origen.\
Para mayor detalle, consultar la sección *Ubicación de los ficheros de configuración en Editran Classic* del documento general de Migración a Connect.
* El producto Connect 3.x debe contener ya la licencia instalada en la carpeta `%EDITRAN_HOME%/bin/SL/licencia.dat` y el servicio `Editran License Service` debe estar en ejecución.
* Se debe haber terminado el *onboarding* de la aplicación Connect, el cual se completa tras crear la IP al iniciar sesión por primera vez.
### Volcado a texto de los perfiles de configuración
Si se optó por un cambio de plataforma al instalar Connect 3.x, tal y como se detalló anteriormente, es necesario convertir la configuración de Editran Classic a formato textual.
Para ello, se deben ejecutar dos comandos incluidos en la carpeta de instalación del producto Editran Classic en la máquina de origen. Por defecto, los comandos crearán los ficheros `.txt` en la carpeta `bin`, a no ser que se indique otro directorio en el parámetro `-o"ruta_completa/otra_ubicacion/nombrefichero.txt"` :
* Ejecutar el comando `ediperfi -r -a -n -oeditranp.txt` para volcar el perfil local y todas las sesiones configuradas que contengan configuración TCP al fichero *editranp.txt*.
* Ejecutar el comando `igaperfi -r -a -oeditrang.txt` para volcar todas las presentaciones configuradas al fichero *editrang.txt*.
Una vez obtenidos los archivos de configuracion textuales, **hay que copiarlos en la carpeta `%EDITRAN_HOME%/cfg` de la nueva instalación de Editran Connect 3.x.**
#### En plataformas Windows
La ruta de instalación de Connect 3.x está indicada por la variable de entorno `%EDITRAN_HOME%`.
#### En plataformas Linux:
La ruta de instalación de Editran Connect 3.x está indicada por la variable `$EDITRAN_HOME`, definida en el fichero `$EDITRAN_CONNECT_HOME/services/Env.conf` de la instalación.
***
## Guía Plataforma Windows
Una vez se hayan cumplido los requisitos previos y se disponga de los ficheros de configuracion `*.cfg` o de la configuración volcada a texto en la maquina de destino. Se debe proceder de la siguiente forma.
### 1. Migración del Core
Este paso de migración de la configuración **sólo se aplica a instalaciones sin cambio de plataforma**.
En este punto, partimos de la configuración original en formato binario y utilizamos las herramientas `Migrar.exe` y `MigrarRSA.exe` incluidas en el módulo Core del producto Editran Connect 3.x (la ruta completa a las herramientas es `%EDITRAN_HOME%/bin`)
#### Migrar.exe: Migrador de configuraciones
Ejecutamos la herramienta `Migrar.exe` para adaptar la configuración de perfiles y de EditranGT (sólo si la licencia contiene la feature `planificador`).
En este dialogo, debemos seleccionar la ruta completa a los perfiles de configuración originales (la ruta a la carpeta con los perfiles copiados si fuera el caso), la version origen de la migración y el checkbox de solo copiar sesiones con datos de red TCP. Por defecto, el directorio de volcado será la carpeta `%EDITRAN_HOME%/cfg`
#### MigrarRSA.exe: Migrador de criptografía RSA
Ejecutamos la herramienta `MigrarRSA.exe` para migrar las claves DEs y RSA utilizadas en las presentaciones de Editran Classic. Este proceso ejecuta automaticamente el comando `checkgc -u` para adaptar las claves DES si fuera necesario.
En este dialogo debemos seleccionar, de igual forma, la ruta completa a los perfiles de configuración originales y la version origen de la migración. Por defecto, el directorio de volcado será la carpeta `%EDITRAN_HOME%/cfg`
#### Ficheros para la migración a Connect 3.x
Finalmente, si todo ha ido correctamente, deberemos encontrar todos los ficheros necesarios para la migración a Connect 3.x en la carpeta de volcado `%EDITRAN_HOME%/cfg`
### 2. Migración a Editran Connect 3.x
En este punto asumimos que ya se disponen de los ficheros para migrar a Editran Connect 3.x, habiendo realizado previamente la migración del Core si fuera necesario.
Todos los scripts necesarios a partir de ahora se encuentran ubicados en la carpeta `%EDITRAN_CONNECT_HOME%/utils`
Previo a ejecutar los scripts, es necesario terminar el *onboarding* de la aplicación Editran Connect, el cual se completa al crear la IP tras iniciar sesión por primera vez.
Para los dos programas de migración de configuración de perfiles, si no se especifica ningún parámetro, automáticamente buscará los ficheros `editranp.txt` y `editrang.txt` en la carpeta `%EDITRAN_HOME%/cfg`, ubicación donde la herramienta `Migrar.exe` deja los perfiles.
#### Ejecutar script migraContactos.bat
Esta herramienta migra a Editran Connect la *configuración local*, es decir, los códigos locales, IPs y las sesiones de Editran/P. Luego, por cada código remoto creará un contacto, los cuales agrupan los canales (antiguas presentaciones)
Este primer migrador está ubicado en `%EDITRAN_CONNECT_HOME%/utils/migraContactos.bat`. Para ser usado requiere que el servicio `Editran Main Service` esté iniciado.
El comando admite varios argumentos, de los cuales destacamos:
* `migraContactos -e`: esta opcion directamente migrará la configuración del fichero `editranp.txt` volcado por la herramienta `Migrar.exe` en la carpeta `%EDITRAN_HOME%/cfg`. Ver proceso [Migración del Core](#windows-migrar-core)
* `migraContactos -f -fp ""`: usar esta opción si se disponen de los perfiles en texto siguiendo el proceso de [cambio de plataforma](#volcado-cambio-plataforma), indicando la ruta completa a la ubicación del fichero editranp.txt.
Tras la ejecución de la herramienta, el propio output del comando nos indicará si existen o no errores. El mensaje de `Ejecución terminada correctamente` significa que no hubo ningún error o warnings en el proceso de migración. En cualquier otro caso, se generará un fichero en la ruta `%EDITRAN_HOME%/log/migrar/conflictosREMOTOS.txt`, el cual contendrá la información de acciones a realizar sobre los perfiles o warnings que hayan sucedido.
**Una vez que este proceso haya terminado sin errores es necesario iniciar el servicio `Editran Protocol Server` para continuar con la herramienta de migración de canales. Es condición obligatoria, sino el siguiente proceso fallará.**
#### Ejecutar script migraCanales.bat
Esta herramienta migra a Editran Connect los canales de transmisión. Para ello, lee las presentaciones de Editran/G (presentes en el fichero editrang.txt) y las sesiones de Editran/P (presentes en el fichero editranp.txt) para crear un canal (sesiones y presentaciones que contienen el mismo código local-remoto-aplicación) en el contacto al que pertenecen (el código remoto).
Este segundo migrador está ubicado en `%EDITRAN_CONNECT_HOME%/utils/migraCanales.bat`. Para ser usado requiere que los servicios `Editran Main Service` y `Editran Protocol Server` estén iniciados. También, es condición indispensable que se haya ejecutado correctamente el script previo `migraContactos.bat` para poder crear los contactos que almacenarán los canales.
El comando admite varios argumentos, de los cuales destacamos:
* `migraCanales -e`: esta opcion directamente migrará la configuración del fichero `editrang.txt` volcado por la herramienta `Migrar.exe` en la carpeta `%EDITRAN_HOME%/cfg`. Ver proceso [Migración del Core](#windows-migrar-core)
* `migraCanales -f -fg "" -fp ""`: usar esta opción si se disponen de los perfiles en texto siguiendo el proceso de [cambio de plataforma](#volcado-cambio-plataforma), indicando la ruta completa a la ubicación de los ficheros editrang.txt y editranp.txt.
Tras la ejecución de la herramienta, saldrá el siguiente mensaje por consola `Ejecucion terminada, para ver el resultado del proceso revise el log de salida`. Este log está ubicado en la siguiente ruta `%EDITRAN_HOME%/log/migrar/logCANALES.txt`, el cual contiene la información de los canales que hayan sido migrados y los que no han podido ser incorporados a Editran Connect.
Una vez finalizado el proceso, los canales estarán dados de alta en Editran/P y en Editran Connect. Se recomienda consultar el panel MenuP para corroborar que todo está correcto.
#### Ejecutar script migraGC.bat
Esta herramienta migra la configuración de las claves criptográficas DES y RSA usadas en Editran Classic a los nuevos canales creados en Editran Connect.
De acuerdo a las [adaptaciones de criptografía introducidas en la versión del producto Connect 3.x y protocolo Editran 5.3](#adaptaciones-criptografia-connect), la configuración original de criptografía puede variar, siendo necesario que el operador de Editran Connect realice adaptaciones manuales sobre cada canal concreto.
Esta herramienta de migración sólo admite un parámetro:
* `migraGC -e`: esta opcion migra a la BBDD de Editran Connect 3.x las claves RSA encontradas en la carpeta `%EDITRAN_HOME%/cfg/.rsa` y aplica, sobre los canales creados, la configuración de criptografía del fichero `controlGC.cfg` (fichero migrado por la herramienta `MigrarRSA.exe` y presente en la carpeta `%EDITRAN_HOME%/cfg`. Ver proceso [Migración del Core](#windows-migrar-core) para mas información).
A mitad de la ejecución de la herramienta, cuando indique el mensaje *Presione una tecla para continuar...* es necesario presionar una tecla para que continue con la vinculación de las claves a los canales previamente creados.
#### Ejecutar script migraGT.bat
Esta herramienta permite migrar las planificaciones a partir de las configuraciones de EditranGT presentes en el fichero `%EDITRAN_HOME%/cfg/editrangt.cfg`.
Esta herramienta de migración necesita recibir dos parámetros en su invocación:
* `migraGT -e -i `: Tras el modificador `-i` deberá indicarse el intervalo de búsqueda de ficheros (en segundos) que se ha configurado en EditranGT. Por defecto, el comando buscará el fichero de configuración `%EDITRAN_HOME%/cfg/editrangt.cfg` para migrar las configuraciones del planificador.
Detalles a tener en cuenta:
* Las configuraciones de EditranGT (líneas del fichero) con algún conflicto o error, y que no se han podido migrar, podrán consultarse en el fichero `migraGT.err` ubicado en la ruta `%EDITRAN_HOME%/log/migrar`.
* El contenido del fichero original `editrangt.cfg`, con las configuraciones de EditranGT, será reemplazado con el contenido del fichero `migraGT.err`. Esto permitirá que las configuraciones que por alguna razón no se han podido migrar, permanezcan en EditranGT.
* Cada vez que se ejecute la herramienta de migración de planificaciones, se creará un backup del fichero `editrangt.cfg`. El fichero de backup se generará en la carpeta `%EDITRAN_HOME%/cfg` y tendrá el siguiente nombre : `editrangt-yyyy-MM-dd-hhmmss.cfg.bak`
***
## Guía Plataforma Linux
Una vez se hayan cumplido los requisitos previos y se disponga de los ficheros de configuracion `*.cfg` o de la configuración volcada a texto en la maquina de destino. Se debe proceder de la siguiente forma.
### 1. Migración del Core
Este paso de migración de la configuración **sólo se aplica a instalaciones sin cambio de plataforma**.
En este punto, partimos de la configuración original en formato binario y utilizamos los scripts `migra-cfg.bash` y `migra-rsa.bash` incluidas en el módulo Core del producto Editran Connect 3.x. La ruta completa a los scripts es `$EDITRAN_HOME/inst`.
#### Script migra-cfg.bash: Migrador de configuraciones
Ejecutamos el script `migra-cfg.bash` para adaptar la configuración de perfiles y de EditranGT (sólo si la licencia contiene la feature `planificador`).
Este script nos va guiando para introducir todos los parámetros necesarios para la migración, como la version y release del Editran Classic origen de la migración y la ruta completa a los perfiles de configuración originales (la ruta a la carpeta con los perfiles copiados si fuera el caso). Por defecto, el directorio de volcado será la carpeta `$EDITRAN_HOME/cfg`
#### Script migra-rsa.bash: Migrador de criptografía RSA
Ejecutamos el script `migra-rsa.bash` para migrar las claves DES y RSA utilizadas en las presentaciones de Editran Classic. Este proceso ejecuta automaticamente el comando `checkgc -u` para adaptar las claves DES si fuera necesario.
En este script debemos introducir, de igual forma, la version de origen de la migración y la ruta completa a los perfiles de configuración originales. Por defecto, el directorio de volcado será la carpeta `$EDITRAN_HOME/cfg`
#### Ficheros para la migración a Editran Connect 3.x
Finalmente, si todo ha ido correctamente, deberemos encontrar todos los ficheros necesarios para la migración a Editran Connect 3.x en la carpeta de volcado `$EDITRAN_HOME/cfg`
A su vez, podemos encontrar todos los ficheros intermedios utilizados para la migración en la carpeta`$EDITRAN_HOME/migration`. Estos ficheros intermedios son:
* ficheros binarios *.cfg* copiados de la instalación original
* ficheros *.err* con posibles errores de salida al ejecutar los comandos ediperfi e igaperfi
* fichero *migra\_cfg.log* con el resultado de la migración
### 2. Migración a Editran Connect 3.x
En este punto asumimos que ya se disponen de los ficheros para migrar a Editran Connect 3.x, habiendo realizado previamente la migración del Core si fuera necesario.
Todos los scripts necesarios a partir de ahora se encuentran ubicados en la carpeta `$EDITRAN_CONNECT_HOME/utils`
Previo a ejecutar los scripts, es necesario terminar el *onboarding* de la aplicación Editran Connect, el cual se completa al crear la IP tras iniciar sesión por primera vez.
Para los dos programas de migración de configuración de perfiles, si no se especifica ningún parámetro, automáticamente buscará los ficheros `editranp.txt` y `editrang.txt` en la carpeta `$EDITRAN_HOME/cfg`, ubicación donde el scripts `migra-cfg.bash` deja los perfiles.
#### Ejecutar script migraContactos.sh
Esta herramienta migra a Editran Connect la *configuración local*, es decir, los códigos locales, IPs y las sesiones de Editran/P. Luego, por cada código remoto creará un contacto, los cuales agrupan los canales (antiguas presentaciones)
Este primer migrador está ubicado en `$EDITRAN_CONNECT_HOME/utils/migraContactos.sh`. Para ser usado requiere que el servicio `Editran Main Service` esté iniciado.
El comando admite varios argumentos, de los cuales destacamos:
* `migraContactos -e`: esta opcion directamente migrará la configuración del fichero `editranp.txt` volcado por el script `migra-cfg.bash` en la carpeta `$EDITRAN_HOME/cfg`. Ver proceso [Migración del Core](#linux-migrar-core)
* `migraContactos -f -fp ""`: usar esta opción si se disponen de los perfiles en texto siguiendo el proceso de [cambio de plataforma](#volcado-cambio-plataforma), indicando la ruta completa a la ubicación del fichero editranp.txt.
Tras la ejecución de la herramienta, el propio output del comando nos indicará si existen o no errores. El mensaje de `Ejecución terminada correctamente` significa que no hubo ningún error o warnings en el proceso de migración. En cualquier otro caso, se generará un fichero en la ruta `$EDITRAN_HOME/log/migrar/conflictosREMOTOS.txt`, el cual contendrá la información de acciones a realizar sobre los perfiles o warnings que hayan sucedido.
**Una vez que este proceso haya terminado sin errores es necesario iniciar el servicio `Editran Protocol Server` para continuar con la herramienta de migración de canales. Es condición obligatoria, sino el siguiente proceso fallará.**
#### Ejecutar script migraCanales.sh
Esta herramienta migra a Editran Connect los canales de transmisión. Para ello, lee las presentaciones de Editran/G (presentes en el fichero editrang.txt) y las sesiones de Editran/P (presentes en el fichero editranp.txt) para crear un canal (sesiones y presentaciones que contienen el mismo código local-remoto-aplicación) en el contacto al que pertenecen (el código remoto).
Este segundo migrador está ubicado en `$EDITRAN_CONNECT_HOME/utils/migraCanales.sh`. Para ser usado requiere que los servicios `Editran Main Service` y `Editran Protocol Server` estén iniciados. También, es condición indispensable que se haya ejecutado correctamente el script previo `migraContactos.sh` para poder crear los contactos que almacenarán los canales.
El comando admite varios argumentos, de los cuales destacamos:
* `migraCanales -e`: esta opcion directamente migrará la configuración del fichero `editrang.txt` volcado por el script `migra-cfg.bash` en la carpeta `$EDITRAN_HOME/cfg`. Ver proceso [Migración del Core](#linux-migrar-core)
* `migraCanales -f -fg "" -fp ""`: usar esta opción si se disponen de los perfiles en texto siguiendo el proceso de [cambio de plataforma](#volcado-cambio-plataforma), indicando la ruta completa a la ubicación de los ficheros editrang.txt y editranp.txt.
Tras la ejecución de la herramienta, saldrá el siguiente mensaje por consola `Ejecucion terminada, para ver el resultado del proceso revise el log de salida`. Este log está ubicado en la siguiente ruta `$EDITRAN_HOME/log/migrar/logCANALES.txt`, el cual contiene la información de los canales que hayan sido migrados y los que no han podido ser incorporados a Connect.
Una vez finalizado el proceso, los canales estarán dados de alta en Editran/P y en Connect. Se recomienda consultar el panel MenuP para corroborar que todo está correcto.
#### Ejecutar script migraGC.sh
Esta herramienta migra la configuración de las claves criptográficas DES y RSA usadas en Editran Classic a los nuevos canales creados en Connect.
De acuerdo a las [adaptaciones de criptografía introducidas en la versión del producto Connect 3.x y protocolo Editran 5.3](#adaptaciones-criptografia-connect), la configuración original de criptografía puede variar, siendo necesario que el operador de Connect realice adaptaciones manuales sobre cada canal concreto.
Esta herramienta de migración sólo admite un parámetro:
* `migraGC -e`: esta opcion migra a la BBDD de Editran Connect 3.x las claves RSA encontradas en la carpeta `$EDITRAN_HOME/cfg/.rsa` y aplica, sobre los canales creados, la configuración de criptografía del fichero `controlGC.cfg` (fichero migrado por el script `migra-rsa.bash` y presente en la carpeta `$EDITRAN_HOME/cfg`. Ver proceso [Migración del Core](#linux-migrar-core) para mas información).
A mitad de la ejecución de la herramienta, cuando indique el mensaje *Presione una tecla para continuar...* es necesario presionar una tecla para que continue con la vinculación de las claves a los canales previamente creados.
***
## Logs de salida con el resultado de la migración
Tras ejecutar los migradores de Connect, estos dejarán una traza del resultado en la carpeta `$EDITRAN_HOME/log/migrar`. Se recomienda consultar estos logs ya que contendrán información necesaria sobre el proceso de migración a Editran Connect 3.x. De igual forma, pueden contener errores o warnings que necesitan atención del operador para adaptar los perfiles de origen previo a realizar la operación de nuevo.
## ANEXO: Adaptaciones en los perfiles de Editran Classic
Compendio resumido de todas las transformaciones y adaptaciones a los perfiles de Editran en el proceso de migración a Editran Connect 3.3.x con el nuevo protocolo Editran 5.3.
### Cambios en las sesiones de Editran P
* Incompatibilidad con remotos en version del protocolo 4.1. Se actualiza el parámetro version remota del canal a version 5.0 automaticamente.
* No se migran sesiones que no tengan una presentación análoga en G (una sesión SOLO configurada en P).
### Cambios en las presentaciones de Editran G
* No se migran presentaciones que no tengan una sesión análoga en P (una presentación SOLO configurada en G).
* Se elimina el parámetro de configuración `Incrementar número de presentación`.
* Se elimina el parámetro `juego de caracteres` con valores ASCII/EBCDIC. Ahora, el alfabeto viaja en el CSB y el sistema Editran remoto se adapta automaticamente.
* El parámetro de `confirmación de descarga` se migra siempre a `NO`. Esta funcionalidad se ha reimplementado en el protocolo 5.3 y sólo es compatible entre extremos con versiones 5.3.
### Cambios en la configuración de criptografía
* **Incompatibilidad de la versión de criptografía DES 2.2:** Ahora, al migrar, dependiendo de las características configuradas en la licencia y de la version del protocolo, la configuración final de criptografía se calcula acorde a los siguientes diagramas. En cualquier caso, *cuando se modifique una configuración de criptografía, el canal puede quedar inutilizable y es necesario realizar un intercambio de claves consensuado con el remoto*:
En EditranP:
En EditranG:
* Incompatibilidad de los algoritmos de cifrado DES y TD2. El algoritmo mínimo de cifrado será TD3, dejando la posibilidad de no cifrar.
* Configurar un algoritmo de confidencialidad en P es una mala práctica, por defecto se deshabilita en la migración de canales. Si es necesario habilitarlo, deberá modificarse manualmente de nuevo.
### Presentaciones con emisión de ficheros de firma
No está soportada la migración de las presentaciones que emiten ficheros de firma clásica.
Durante el proceso de migración, las presentaciones que tengan configuradas el parámetro `COMPROBAR FIRMAS = "S"` se migrarán con dicho parámetro desactivado y se borrarán sus ficheros de emisión configurados.
### Modificación del sentido del trafico de un canal
* Las sesiones configuradas con sentido del trafico bidireccional (X) o emisión (E), que se migren a Connect pero no dispongan de ficheros de emisión, se migrarán como canales de recepción.
* A su vez, las sesiones configuradas con sentido del trafico recepción (R) que se migren a Connect y dispongan de ficheros de emisión, se migrarán como canales bidireccionales.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.editran.onesait.com/documentacion-editran/editran-connect-v3.3/migracion/clasico-a-connect.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.