> 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/connect-3.2/migracion.md).

# Migración

La migración de un Editran Classic a un Editran Connect puede ser realizada entre distintos sistemas operativos y diferentes versiones de Editran (desde la 5.0 en adelante). Este proceso extrae los datos contenidos en los perfiles del Editran de origen y los procesa para adaptarlos al formato de Connect. Este proceso no es reversible, no se puede pasar de un Editran Connect a un Classic.

Es necesario realizar la migración para adaptar los perfiles de Editran al nuevo modelo de datos de Connect 3.0. Entre ellos, podemos destacar cambios de configuraciones de seguridad, pero trataremos los detalles al respecto en el apartado concreto de migración de Editran Classic a Editran Connect.

## Utilidades de migración

En la versión 3.2.7 hemos introducido una nueva herramienta de migración de datos que consta de dos herramientas:

* **Editran Export** - Herramienta que se puede descargar de la web de descargas de Editran y con la que podrá extraer facilmente los datos de su **Editran Clásico** para importarlos en **Editran Connect**
* **Editran import** - Herramienta incluida con **Editran Connect** para importar datos de versiones anteriores de **Editran Clásico** y **Editran Connect**

## Compatibilidad

La migracion a Editran Connect 3.0 es viable desde versiones de Editran 5.0 en adelante.

## Compendio de ficheros de configuración de Editran Classic

A continuación se listan los diferentes ficheros de configuración de Editran Classic así como su localización dentro de la instalación. Es necesario disponer de ellos para abordar los diferentes pasos de migración a Connect 3.0.

### Lista de ficheros de configuración

**Ficheros de configuración de perfiles:**

* **editranp.cfg y editranp.sdx**: ficheros binarios con la configuración del entorno local y las sesiones de Editran/P.
* **editrang.cfg**: fichero binario con la configuración de las presentaciones de Editran/G.

**Fichero de configuración del módulo EditranGT:**

* **editrangt.cfg**: fichero binario con la configuración de las planificaciones del módulo EditranGT (si se adquirió la funcionalidad de editrangt con el producto).

**Ficheros de configuración relativos a la criptografía en Editran:**

* **controlgc.cfg**: fichero binario con la configuración del módulo EditranGC, usado para el intercambio y la gestión de las claves RSA de Editran.
* **ckds.des**: fichero binario que contiene las claves DES usadas para la transmisión segura de ficheros.

> (Sólo para versiones 5.0.x y 5.1.x, anteriores a la 5.2.0)
>
> * **ckds.rsa**: fichero binario con contiene las claves de criptografía RSA de Editran
>
> (Sólo para versiones 5.2.0 y superiores)
>
> * **.rsa**: carpeta que contiene las claves de criptorgafía RSA de Editran.

### Ubicación de los ficheros de configuración en Editran Classic

La localización de los diferentes ficheros de configuración varia según la versión de Editran Classic instalada.

* **Para versiones de Editran Classic inferiores a 5.2.0 (v5.0 y v5.1):**

Los archivos de configuración de perfiles, configuración de EditranGT y configuración de criptografía se encuentran en la raiz de la carpeta de instalación.

```txt
📂 Editran_50
┣ 📄 ckds.des
┣ 📄 ckds.rsa
┣ 📄 editranp.cfg
┣ 📄 editranp.sdx
┣ 📄 editrang.cfg
┣ 📄 controlgc.cfg
┗ 📄 editrangt.cfg
```

**Para versiones de Editran Classic 5.2.0:**

Los archivos de configuración de los perfiles de Editran, la configuración de EditranGT y el fichero `controlgc.cfg` se encuentran en la carpeta `cfg`, y ésta puede estar ubicada en la ruta de instalación del producto, o en la ruta definida en la variable del registro `EDI_DATA` si se especificó una ruta diferente a la de instalación.

El archivo `ckds.des` se encuentra dentro de la carpeta `bin` ubicada en la ruta de instalación del producto.

```txt
📂 Editran_520
┣ 📂 bin
┃ ┗ 📄 ckds.des
┗ 📂 cfg
  ┣ 📂 .rsa
  ┃ ┗ 📄 Ficheros con las claves RSA
  ┣ 📄 editranp.cfg
  ┣ 📄 editranp.sdx
  ┣ 📄 editrang.cfg
  ┣ 📄 controlgc.cfg
  ┗ 📄 editrangt.cfg
```

**Para versiones de Editran Classic 5.2.1 y superiores:**

Todos los archivos de configuración de perfiles, EditranGT y configuración de criptografía se encuentran en la carpeta `cfg`, y ésta puede estar ubicada en la ruta de instalación del producto, o en la ruta definida en la variable del registro `EDI_DATA` si se especificó una ruta diferente a la de instalación.

```txt
📂 Editran_521
┗ 📂 cfg
  ┣ 📂 .rsa
  ┃ ┗ 📄 Ficheros con las claves RSA
  ┣ 📄 ckds.des
  ┣ 📄 editranp.cfg
  ┣ 📄 editranp.sdx
  ┣ 📄 editrang.cfg
  ┣ 📄 controlgc.cfg
  ┗ 📄 editrangt.cfg
```

Como podemos ver, los archivos de configuración de Editran Classic y su localización varian según la versión instalada. Para conseguir una migración correcta de los perfiles, es necesario indicar en el proceso cual es la versión origen a migrar a Editran Connect 3.0 y disponer de los ficheros necesarios para cada versión.

## Proceso de migración

Los perfiles de las diferentes versiones de Editran Classic no son directamente compatibles con el nuevo producto Editran Connect 3.0, ni tampoco con el software Editran Core 5.3 integrado. Por ello, la migración a Editran Connect 3.0 se realiza partiendo de los perfiles de configuración de Editran Classic en modo textual, es decir, volcando el entorno local, las sesiones y las presentaciones configuradas en Classic a un fichero.

Destacamos tres escenarios principales, con diferente operativa cada uno, para abordar la migración. La operativa detallada de como realizar la migración en cada escenario se explicará más adelante en la guia paso a paso.

Dependiendo de cada escenario, el volcado de los perfiles a texto (punto de partida de la migración a Editran Connect 3.0 como mencionamos anteriormente) se podrá realizar de forma automática (lo realiza el migrador de perfiles incluido en el módulo Core) o manualmente por el operador que llevará a cabo la migración (se detalla como hacerlo en la guia paso a paso).

Importante mencionar que las sesiones/presentaciones pueden sufrir una adaptación automática en el volcado a texto, necesario para la adaptación a Editran Connect 3.0, pero en cualquier caso, sin modificar la configuración original de la instalación de Editran Classic (los perfiles de configuración en formato binario no cambiarán en la instalación origen). Puede consultar el resumen de todas las modificaciones realizadas para la adaptación de los perfiles a Editran Connect 3.0 en esta misma página.

### Entre máquinas distintas con mismo sistema operativo

Si el nuevo sistema Editran Connect 3.0 se encuentra en una máquina diferente a la de origen (donde se encuentra instalado Editran Classic), asegurando que el sistema operativo es el mismo, es necesario copiar toda configuración de Editran en su formato binario *(dependiendo de la version de origen, la localización de los diferentes ficheros de configuración varía acorde a lo tratado anteriormente)* a la máquina destino, previo a comenzar el proceso de migración.

### En la misma máquina

En este caso, ya existe la configuración de Editran Classic en la misma máquina y solo es necesario asegurar que es accesible desde el nuevo sistema Editran Connect 3.0.

Se recomienda realizar una copia de seguridad completa de la instalación de Editran Classic previo a migrar a Connect.

### Migración entre distintos sistemas operativos

En entornos donde el SO origen es diferente al SO destino, el proceso de migracion difiere brevemente.

Se deben volcar a formato textual los perfiles de configuración, previo a copiarlos a la maquina destino, usando los comandos `ediperfi` e `igaperfi` de la version de Editran Classic en la maquina de origen.

Se deben copiar tambien, junto a los ficheros de configuración de perfiles textuales, los ficheros de configuración de criptografía *tal cual* (en formato binario, sin volcarlos a texto ni realizar ninguna transformación con ellos) y la configuracion de EditranGT si estuviera disponible (también en formato binario).

## Resumen de modificaciones realizadas en la migración sobre los perfiles de Editran

Los cambios implementados en la nueva version de Connect 3.0 incluyen:

* Incompatibilidad del protocolo Editran 4.1
* Incompatibilidad de la versión de criptografía DES 2.2
* Se ha eliminado el parámetro *incrementar número de presentación*.
* Reimplementación de la funcionalidad Acuse de descarga (sólo valido entre sistemas Connect 3.0 y Editran Classic 5.3).
* Incompatibilidad de los algoritmos de cifrado DES y TD2.
* *Incompatibilidad de confidencialidad en P*


---

# 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/connect-3.2/migracion.md?ask=<question>&goal=<endgoal>
```

`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.
