> 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/editran-export.md).

# Editran Export

Herramienta de exportación de configuraciones para Editran Classic y Editran Connect

Esta utilidad de línea de comandos permite exportar las configuraciones de los productos **Editran Classic** y **Editran Connect**.

La herramienta puede ejecutarse en los sistemas operativos **Windows** y **RedHat**, utilizando el binario correspondiente en cada caso.

| Nombre del binario   | Plataforma / SO |
| -------------------- | --------------- |
| *editran-export.exe* | Windows         |
| *editran-export*     | Linux           |

El binario **editran-export** es autocontenido y no necesita dependencias externas.

No es necesario que el binario **editran-export** se encuentre en la misma carpeta del producto instalado que se va a exportar, pero si se recomienda situarlo en un lugar conocido del sistema de ficheros del equipo donde se va a ejecutar y en un directorio con permisos de lectura y escritura para el usuario que lo ejecutará.

La herramienta debe ejecutarse siempre desde una terminal con los siguientes requisitos, según el sistema operativo indicado:

* Para Windows, primero inicie sesión con el usuario correspondiente que administre el producto y ejecute la herramienta editran-export desde una **terminal con permisos de administrador**.
* Para RedHat, inicie sesión utilizando el usuario `editran` (o equivalente) que administre el producto a exportar previo a ejecutar la herramienta.

Las diferentes versiones de la herramienta para cada SO están disponibles en la web de descargas del producto Editran.

## Versiones de productos soportadas

La herramienta es compatible con las siguientes versiones de los productos citados anteriormente:

<table><thead><tr><th>Producto</th><th>Versión</th></tr></thead><tbody><tr><td rowspan="5">Editran Classic</td><td>5.0.1 / 5.0.2</td></tr><tr><td>5.1.0</td></tr><tr><td>5.2.0</td></tr><tr><td>5.2.1.y</td></tr><tr><td>5.3.y</td></tr><tr><td rowspan="6">Editran Connect</td><td>1.1.12 / 1.1.16 / 1.1.17</td></tr><tr><td>1.2.20 / 1.2.23</td></tr><tr><td>2.0.6 / 2.0.7 / 2.0.8</td></tr><tr><td>2.1.5 / 2.1.7 / 2.1.9 / 2.1.12 / 2.1.13</td></tr><tr><td>3.0.8</td></tr><tr><td>3.x.y</td></tr></tbody></table>

## Cómo usar la herramienta

A continuación se detallan todos los parámetros disponibles para interactuar con la herramienta de exportación de configuraciones.

| Parámetro                                            | Descripción                                                                                                                                                                                                                                                               | Obligatorio | Ejemplo de uso                                                                                                      |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------- |
| <p><code>-i</code><br><code>--installpath</code></p> | Ruta completa a la carpeta de instalación del producto que queremos exportar su configuración.                                                                                                                                                                            | SI          | <p><code>-i C:\EditranCoreConnect</code><br><code>--installpath C:\EditranConnect</code></p>                        |
| <p><code>-v</code><br><code>--version</code></p>     | Versión y Release de la instalación de Editran de la que queremos exportar los datos.                                                                                                                                                                                     | SI          | <p><code>-v 5.2.0</code><br><code>--version 2.1.12</code></p>                                                       |
| <p><code>-p</code><br><code>--product</code></p>     | <p>Tipo de producto instalado del que exportar la configuración.<br>Valores admitidos: <strong>Connect</strong> para Editran Connect y <strong>Editran</strong> para Editran Classic.</p>                                                                                 | SI          | <p><code>-p Editran</code><br><code>--product Connect</code></p>                                                    |
| <p><code>-fp</code><br><code>--ediperfi</code></p>   | Ruta al fichero de sesiones generado con el comando `ediperfi`.                                                                                                                                                                                                           | NO          | <p><code>-fp C:\Editran\bin\ediperfi.txt</code><br><code>--ediperfi /opt/editran/bin/sesionesP.txt</code></p>       |
| <p><code>-fg</code><br><code>--igaperfi</code></p>   | Ruta al fichero de presentaciones generado con el comando `igaperfi`.                                                                                                                                                                                                     | NO          | <p><code>-fg C:\Editran\bin\igaperfi.txt</code><br><code>--igaperfi /opt/editran/bin/presentacionesG.txt</code></p> |
| <p><code>-o</code><br><code>--output</code></p>      | <p>Ruta completa al directorio de salida donde se creará el fichero comprimido con la configuración exportada.<br>Si no se indica, la salida será la propia carpeta donde se ejecuta el exportador.</p>                                                                   | NO          | <p><code>-o C:\Users\admin\Downloads</code><br><code>--output /opt/migration</code></p>                             |
| <p><code>-h</code><br><code>--help</code></p>        | <p>Comando de ayuda e información de la herramienta.<br>Muestra los argumentos admitidos, si son obligatorios o no, y los valores permitidos.<br>También se mostrará la ayuda si no se indica ningún argumento al invocar el comando o si algún argumento es erróneo.</p> | NO          | <p><code>-h</code><br><code>--help</code></p>                                                                       |
| <p><code>-t</code><br><code>--targz</code></p>       | <p>Empaqueta el fichero de salida <code>data-export</code> en formato <code>.tar.gz</code>, útil para sistemas Linux.<br>Si no se indica este parámetro, el formato por defecto será <code>.zip</code>.</p>                                                               | NO          | `-t`                                                                                                                |

NOTA: Para indicar una ruta de instalación `-i` que contengan espacios, se debe especificar la ruta completa entre comillas dobles `""` para que la validación se haga correctamente. Por ejemplo: `-i "C:\Editran v5.2.0"`

La herramienta dispone del comando de ayuda `-h`, `--help` que mostrará información similar a la recogida en la tabla anterior de parámetros.

Como ejemplo de uso, el comando `editran-export -h` mostrará la siguiente información:

```shell
***** EDITRAN-EXPORT-TOOL *****
 Version: 1.3.0
 Compilado: 2026-07-08_15:12:27
*******************************

editran-export: Herramienta de exportacion de configuraciones de los productos Editran y Connect.

Uso: editran-export -p <product-type> -i <installation-path> -v <version> [-fp <ediperfi-external-file>] [-fg <igaperfi-external-file>] [-o <output-path>] [-t]
     editran-export -h
  -p, --product <product-type>             Tipo de producto del que exportar la configuracion.
                                           Valores validos: editran o connect.
  -i, --installpath <installation-path>    Ruta completa a la raiz del directorio de instalacion del producto.
  -v, --version <ver.rel.minor>            Version y release del producto instalado. Formato X.X.Y
                                           Versiones validas para producto Editran: 5.0.1, 5.0.2, 5.1.0, 5.2.0, 5.2.1.y, 5.3.y
                                           Versiones validas para producto Connect: 1.1.12, 1.1.16, 1.1.17, 1.2.20, 1.2.23, 2.0.6, 2.0.7, 2.0.8, 2.1.y, 3.0.8, 3.x.y
  -fp, --ediperfi <ediperfi-external-file>   Ruta a ediperfi.txt generado externamente.
  -fg, --igaperfi <igaperfi-external-file>   Ruta a igaperfi.txt generado externamente.
  -o, --output <output-path>               Directorio de salida para el fichero de exportacion.
  -t, --targz                              Empaquetado del fichero de salida en formato .tar.gz. El formato por defecto es .zip.
  -h, --help                               Muestra esta ayuda. Comportamiento por defecto si no se indican flags al comando.

Ejemplos de uso:
   editran-export --product Editran --installpath C:\EditranClassic --version 5.2.1
   editran-export -p Connect -i /opt/EditranConnect -v 2.0.8 -o /home/myuser -t
   editran-export -p editran -i C:\Editran -v 5.2.0 -fp C:\Editran\bin\ediperfi.txt -fg C:\Editran\bin\igaperfi.txt 
```

## Output de la herramienta

La herramienta genera, como resultado de su correcta ejecución, un fichero comprimido con los datos de configuración exportados del producto indicado y con extensión *.zip* o *.tar.gz* según el parámetro de compresión elegido.

El fichero comprimido se llamará `data-export_<producto>_<timestamp>.<zip/tar.gz>`.

A modo de ejemplo, la estructura contenida en el fichero comprimido de salida puede ser la siguiente:

| **EDITRAN CLASSIC**                                                                                                                                                                                                                       | **EDITRAN CONNECT**                                                                                                                                                                                            |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>📁 data-export\_editran<br>├── 📁 .rsa<br>├   └── 📄 claves.rsa<br>├── 📄 ckds.des<br>├── 📄 controlgc.cfg<br>├── 📄 editrangt.cfg<br>├── 📄 ediperfi.txt<br>├── 📄 igaperfi.txt<br>├── 📄 editran-export.log<br>└── 📄 index.json</p> | <p>📁 data-export\_connect<br>├── 📁 certs<br>├ └── 📁 SIAVAL<br>├   ├ └── 📄 cert.p12<br>├── 📄 ckds.des<br>├── 📄 editrandb\_dump.sql<br>├── 📄 editran-export.log<br>├── 📄 index.json<br>└── 📄 ks.pfx</p> |

NOTA: Si el producto *Editran* no tiene instalado los módulos *EditranGT* o *EditranGC*, su configuración no se exportará.

NOTA: El nombre final de los ficheros exportados puede variar o pueden aparecer ficheros diferentes no indicados en el ejemplo anterior. Ante cualquier duda o problema, contacte con el equipo de soporte.

El significado de cada archivo exportado es el siguiente, atendiendo a su módulo de configuración respectivo:

* Criptografía RSA:
  * Carpeta `.rsa`: Carpeta que contendrá todas las claves RSA configuradas en la instalación de Editran Classic.
  * Archivos de `claves.rsa`: Archivos individuales con las claves RSA generadas en local o intercambiadas.
  * Fichero de configuración `controlgc.cfg`: Fichero de configuración de la herramienta EditranGC.
* Criptografía DES:
  * Archivo `ckds.des`: Archivo que contendrá las claves DES configuradas en el producto.
* Planificador o Gestor de Transmisiones:
  * Archivo de configuración `editrangt.cfg`: Fichero de configuración de la herramienta EditranGT.
* Configuración de sesiones de Editran/P:
  * Archivo textual `ediperfi.txt`: Archivo textual generado con el comando `ediperfi -r -a -n -oediperfi.txt` a partir de las sesiones configuradas en `editranp.cfg` y `editranp.sdx`.
* Configuración de Presentaciones de Editran/G:
  * Archivo textual `igaperfi.txt`: Archivo textual generado con el comando `igaperfi -r -a -oediperfi.txt` a partir de las sesiones configuradas en `editrang.cfg`.
* Copia de seguridad de la base de datos de Connect:
  * Archivo `editrandb_dump.sql`: Archivo de recuperación de la BBDD de Connect. Este archivo se ha generado con el comando *pg\_dump* de PostgreSQL.
* Reporte del Log de la herramienta de exportación de configuraciones:
  * Archivo `editran-export.log`: Log detallado con el reporte de ejecución de la herramienta.
* Fichero de indices de los archivos exportados:
  * Archivo `index.json`: Archivo textual en formato JSON que contiene los detalles de la exportación: producto, versión y plataforma de exportación, así como un reporte de los módulos y nombre de los ficheros exportados para cada módulo. Este fichero será utilizado por la herramienta de importación de configuraciones incluida en versiones de Connect 3.2 y superiores.
* Configuración de Firma de Connect:
  * Carpeta `certs` con los certificados de autenticación para la comunicación con los proveedores de firma en nube integrados en Connect. Solo disponible a partir de la versión `3.1.0` de Connect.
  * Fichero `ks.pfx`: almacén de los certificados de clave pública de los firmantes. Solo disponible a partir de la versión `2.1.0` de Connect.

## Como exportar la configuración de un producto Editran Classic

### Prerrequisitos

Para extraer la configuración de un producto Editran Classic utilizando la herramienta **editran-export**, primero se debe disponer del ejecutable correspondiente al sistema operativo (Windows o RedHat) donde se encuentra instalado el producto a exportar.

Se puede descargar el binario correspondiente de la herramienta desde la web de descargas del producto Editran.

Se recomienda copiar el binario a una carpeta conocida, o en su defecto, en la raíz del producto instalado que vamos a exportar (p.ej: C:\Editran u /opt/editran).

Para conocer la version del producto editran instalado en el equipo, se puede ejecutar el comando `ediver` desde una terminal, incluido en el producto dentro de la carpeta `bin` de la ruta de instalación, el cual mostrará la información de la versión del producto.

```shell
C:\Editran\bin>ediver.exe
Editran v5.3.1
ProductId: 53 1 Jul  8 2025 22388
```

Para que la herramienta de exportación funcione correctamente, es necesario que la licencia del producto esté en ejecución. Para versiones superiores a Editran Classic 5.2.0, el servicio de licencia debe estar en ejecución con una licencia válida.

### Exportación en Windows

Con una terminal con permisos de administrador, ejecutamos el comando de invocación de la herramienta siguiendo las reglas definidas en la ayuda del comando.

Especificamos `editran` como tipo de producto a exportar con el parámetro `-p editran`, indicamos la ruta de instalación completa en el sistema de ficheros del equipo con `-i <installation-path>` y la version del producto a exportar con el parámetro `-v <version>`. Opcionalmente, se puede indicar una ruta alternativa donde se generará el archivo comprimido de exportación con el parámetro `-o <output-path>`, indicado la ruta completa a la carpeta de output. Para utilizar el formato de compresión `tar.gz`, indique el parámetro `-t` al ejecutar la herramienta.

A modo de ejemplo, el siguiente comando exportará la configuración de un producto Editran Classic con versión 5.3.1 en SO Windows, instalado en la ruta `C:\Editran`, utilizando el binario *editran-export.exe*:

`editran-export.exe -p editran -i C:\Editran -v 5.3.1`

```shell
C:\Editran>editran-export.exe -p editran -i C:\Editran -v 5.3.1
***** EDITRAN-EXPORT-TOOL *****
 Version: 1.1.0
 Compilado: 2026-01-12_10:13:16
*******************************
LOGGER Creado fichero de log en C:\Editran\data-export_editran_20260114_121136\editran-export.log
Exportando configuracion de Editran...
Ruta de instalacion: C:\Editran
Version: 5.3.1
Directorio de salida: C:\Editran\data-export_editran_20260114_121136
Formato: zip
[Editran/P] Exportada configuracion de EditranP en C:\Editran\data-export_editran_20260114_121136\ediperfi.txt.
[Editran/G] Exportada configuracion de EditranG en C:\Editran\data-export_editran_20260114_121136\igaperfi.txt.
[Planificador] Copiado fichero C:\Editran\data-export_editran_20260114_121136\editrangt.cfg
[Claves RSA] Copiado fichero C:\Editran\data-export_editran_20260114_121136\controlGC.cfg
[Claves RSA] Copiado directorio C:\Editran\data-export_editran_20260114_121136\.rsa
[Claves DES] Copiado fichero C:\Editran\data-export_editran_20260114_121136\ckds.des
Fichero comprimido en formato ZIP generado correctamente: C:\Editran\data-export_editran_20260114_121136.zip
Exportacion completada con exito.
```

El log de la herramienta indica la ubicación del fichero comprimido generado. En el ejemplo:

`Fichero comprimido en formato ZIP generado correctamente: C:\Editran\data-export_editran_20260114_121136.zip`

Dentro de este fichero podremos encontrar el log detallado de la herramienta llamado `editran-export.log`, que indicará todos los pasos y acciones realizadas para exportar la configuración, así como posibles errores que hayan surgido.

Se recomienda consultar dicho log para comprobar que todo ha terminado correctamente.

### Exportación en RedHat Enterprise Linux

Con una terminal en RedHat y habiendo iniciado sesión con el usuario administrador de la instalación del producto Editran Classic, ejecutamos el comando de invocación de la herramienta siguiendo las reglas definidas en la ayuda del comando.

Especificamos `editran` como tipo de producto a exportar con el parámetro `-p editran`, indicamos la ruta de instalación completa en el sistema de ficheros del equipo con `-i <installation-path>` y la version del producto a exportar con el parámetro `-v <version>`. Opcionalmente, se puede indicar una ruta alternativa donde se generará el archivo comprimido de exportación con el parámetro `-o <output-path>`, indicado la ruta completa a la carpeta de output. Para utilizar el formato de compresión `tar.gz`, indique el parámetro `-t` al ejecutar la herramienta.

A modo de ejemplo, el siguiente comando exportará la configuración de un producto Editran Classic con versión 5.2.1.9 en SO RedHat, instalado en la ruta `/opt/classic/editran` comprimiendo la configuración en formato `.tar.gz`, y utilizando para ello el binario *editran-export*:

```shell
[classic@EDILDA01 editran]$ editran-export -p editran -v 5.2.1.9 -i /home/classic/editran -t
***** EDITRAN-EXPORT-TOOL *****
 Version: 1.1.0
 Compilado: 2026-01-12_10:02:18
*******************************
LOGGER Creado fichero de log en /home/classic/editran/data-export_editran_20260114_131303/editran-export.log
Exportando configuracion de Editran...
Ruta de instalacion: /home/classic/editran
Version: 5.2.1.9
Directorio de salida: /home/classic/editran/data-export_editran_20260114_131303
Formato: tar.gz
[Editran/P] Exportada configuracion de EditranP en /home/classic/editran/data-export_editran_20260114_131303/ediperfi.txt.
[Editran/G] Exportada configuracion de EditranG en /home/classic/editran/data-export_editran_20260114_131303/igaperfi.txt.
[Planificador] AVISO: editrangt.cfg no esta configurado en esta instalacion. Se continuara con la exportacion.
[Claves RSA] Copiado fichero /home/classic/editran/data-export_editran_20260114_131303/controlGC.cfg
[Claves RSA] Copiado directorio /home/classic/editran/data-export_editran_20260114_131303/.rsa
[Claves DES] Copiado fichero /home/classic/editran/data-export_editran_20260114_131303/ckds.des
Fichero comprimido en formato TarGz generado correctamente: /home/classic/editran/data-export_editran_20260114_131303.tar.gz
Exportacion completada con exito.
```

El log de la herramienta indica la ubicación del fichero comprimido generado. En el ejemplo:

`Fichero comprimido en formato TarGz generado correctamente: /home/classic/editran/data-export_editran_20260114_131303.tar.gz`

Dentro de este fichero podremos encontrar el log detallado de la herramienta llamado `editran-export.log`, que indicará todos los pasos y acciones realizadas para exportar la configuración, así como posibles errores que hayan surgido.

Se recomienda consultar dicho log para comprobar que todo ha terminado correctamente.

### Generación manual de los ficheros de sesiones y presentaciones

La herramienta de exportación de datos permite añadir ficheros externos ya generados que contengan el volcado a texto de las sesiones y presentaciones de la instalación de Editran, mediante los parámetros `-fp <path-to-ediperfi-output>` y `-fg <path-to-igaperfi-output>`.

Si se indica el argumento `-fp` con un fichero externo que contiene las sesiones, la herramienta de export no ejecutará internamente el comando `ediperfi`, evitando posibles errores de compatibilidad con Sistemas Operativos antiguos. De igual forma sucede con el argumento `-fg` y un fichero externo que contenga las presentaciones.

Para generar el fichero `ediperfi.txt` con las sesiones de la instalación de editran, el comando a utilizar es: `ediperfi -r -a -n -oediperfi.txt`

Para generar el fichero `igaperfi.txt` con las presentaciones de la instalación de editran, el comando a utilizar es: `igaperfi -r -a -oigaperfi.txt`

Antes de volcar las sesiones y presentaciones a un fichero textual, asegúrese de que no existe ya un fichero previo con el mismo nombre, en cuyo caso se añadirá la información al fichero existente, pudiendo provocar errores en la migración de datos.

Si se prefiere cambiar el nombre del fichero de texto a generar, indíquelo en el último argumento `-o<filename.txt>` del comando correspondiente de volcado.

## Como exportar la configuración de un producto Editran Connect

### Prerrequisitos

Para extraer la configuración de un producto Editran Connect utilizando la herramienta **editran-export**, primero se debe disponer del ejecutable correspondiente al sistema operativo (Windows o RedHat) donde se encuentra instalado el producto a exportar.\
Se puede descargar el binario correspondiente de la herramienta desde la web de descargas del producto Editran.

Se recomienda copiar el binario a una carpeta conocida, o en su defecto, en la raíz del producto instalado que vamos a exportar (p.ej: C:\EditranConnect u /opt/editranconnect).

Puede verificar la versión del producto connect instalado en el panel de `Configuración Local > Licencia > Datos de licencia` de la aplicación de Connect o desde su WebView.

![Obtener versión del producto Connect](https://3558922613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQXv5BLHrdIc5WgYzixC%2Fuploads%2Fgit-blob-7e2c036af5b6adee76835e09d9d30e40bb3063d3%2Fver_version_connect.png?alt=media)

Para que la herramienta de exportación funcione correctamente, es necesario que el `servicio de licencia` y el `servicio de datos` del producto estén en ejecución.

### Exportación en Windows

Con una terminal con permisos de administrador, ejecutamos el comando de invocación de la herramienta siguiendo las reglas definidas en la ayuda del comando.<br>

Especificamos `connect` como tipo de producto a exportar con el parámetro `-p connect`, indicamos la ruta de instalación completa en el sistema de ficheros del equipo con `-i <installation-path>` y la version del producto a exportar con el parámetro `-v <version>`. Opcionalmente, se puede indicar una ruta alternativa donde se generará el archivo comprimido de exportación con el parámetro `-o <output-path>`, indicado la ruta completa a la carpeta de output. Para utilizar el formato de compresión `tar.gz`, indique el parámetro `-t` al ejecutar la herramienta.

A modo de ejemplo, el siguiente comando exportará la configuración de un producto Editran Connect con versión 3.2.0 en SO Windows, instalado en la ruta `C:\EditranConnect`, creando el fichero comprimido con la configuración exportada en la carpeta de usuario situada en `C:\Users\admin\Documentos\fichero exportacion` y utilizando el binario *editran-export.exe*:

NOTA: Tenga en cuenta que para introducir rutas de carpetas que contengan espacios en blanco es necesario usar comillas dobles `""` para que la herramienta lo valide correctamente.

`editran-export.exe -p connect -v 3.2.1 -i C:\EditranConnect -o "C:\Users\admin\Documentos\fichero exportacion"`

```shell
C:\Users\admin\Downloads\editran-tools-win\utils>editran-export.exe -p connect -v 3.3.2 -i C:\EditranConnect -o "C:\Users\admin\Documentos\fichero exportacion"
***** EDITRAN-EXPORT-TOOL *****
 Version: 1.3.1
 Compilado: 2026-08-19_14:09:22
*******************************
LOGGER Creado fichero de log en C:\Users\admin\Documentos\fichero exportacion\data-export_connect_20260115_105424\editran-export.log
Exportando configuracion de Connect...
Ruta de instalacion: C:\EditranConnect
Version: 3.3.2
Directorio de salida: C:\Users\admin\Documentos\fichero exportacion\data-export_connect_20260115_105424
Formato: zip
[Claves DES] Copiado fichero C:\Users\admin\Documentos\fichero exportacion\data-export_connect_20260115_105424\ckds.des
[Firma] Copiado fichero C:\Users\admin\Documentos\fichero exportacion\data-export_connect_20260115_105424\ks.pfx
[Firma] Copiado directorio C:\Users\admin\Documentos\fichero exportacion\data-export_connect_20260115_105424\certs
[Firma] AVISO: Considere copiar manualmente todos los ficheros que sean necesarios de la carpeta origen C:\EditranConnect/signs/documents en la instalacion de destino.
[Base de Datos] Realizando exportacion de la base de datos.
[Base de Datos] Exportacion de la base de datos completada correctamente.
Fichero comprimido en formato ZIP generado correctamente: C:\Users\admin\Documentos\fichero exportacion\data-export_connect_20260115_105424.zip
Exportacion completada con exito.
```

El log de la herramienta indica la ubicación del fichero comprimido generado. En el ejemplo:

`Fichero comprimido en formato ZIP generado correctamente: C:\Users\admin\Documentos\fichero exportacion\data-export_connect_20260115_105424.zip`

Dentro de este fichero podremos encontrar el log detallado de la herramienta llamado `editran-export.log`, que indicará todos los pasos y acciones realizadas para exportar la configuración, así como posibles errores que hayan surgido.

Se recomienda consultar dicho log para comprobar que todo ha terminado correctamente.

### Exportación en RedHat Enterprise Linux

Con una terminal en RedHat y logueado con el usuario administrador de la instalación del producto Editran Connect, ejecutamos el comando de invocación de la herramienta siguiendo las reglas definidas en la ayuda del comando.

Especificamos `connect` como tipo de producto a exportar con el parámetro `-p connect`, indicamos la ruta de instalación completa en el sistema de ficheros del equipo con `-i <installation-path>` y la version del producto a exportar con el parámetro `-v <version>`. Opcionalmente, se puede indicar una ruta alternativa donde se generará el archivo comprimido de exportación con el parámetro `-o <output-path>`, indicado la ruta completa a la carpeta de output. Para utilizar el formato de compresión `tar.gz`, indique el parámetro `-t` al ejecutar la herramienta.

NOTA: El proceso de exportación de Connect puede tardar varios minutos dependiendo del tamaño de la Base de Datos. A mayor cantidad de datos configurados en el producto, mayor será el tamaño de la BD y puede tardar. Espere pacientemente hasta que aparezca el mensaje `[Base de Datos] Exportacion de la base de datos completada correctamente`. Ante cualquier duda o problema al respecto contacte con el equipo de soporte.

A modo de ejemplo, el siguiente comando exportará la configuración de un producto Editran Connect con versión 2.1.17 en SO RedHat, instalado en la ruta `/opt/EditranConnect` comprimiendo la configuración en formato `.tar.gz`, y utilizando para ello el binario *editran-export*:

```shell
[editran@EDILDA01 EditranConnect]$ editran-export -p connect -v 2.1.17 -i /opt/EditranConnect -t
***** EDITRAN-EXPORT-TOOL *****
 Version: 1.1.0
 Compilado: 2026-01-12_10:02:18
*******************************
LOGGER Creado fichero de log en /opt/EditranConnect/data-export_connect_20260114_170426/editran-export.log
Exportando configuracion de Connect...
Ruta de instalacion: /opt/EditranConnect
Version: 2.1.17
Directorio de salida: /opt/EditranConnect/data-export_connect_20260114_170426
Formato: tar.gz
[Claves DES] Copiado fichero /opt/EditranConnect/data-export_connect_20260114_170426/ckds.des
[Base de Datos] Realizando exportacion de la base de datos.
[Base de Datos] Exportacion de la base de datos completada correctamente.
Fichero comprimido en formato TarGz generado correctamente: /opt/EditranConnect/data-export_connect_20260114_170426.tar.gz
Exportacion completada con exito.
```

El log de la herramienta indica la ubicación del fichero comprimido generado. En el ejemplo:

`Fichero comprimido en formato TarGz generado correctamente: /opt/EditranConnect/data-export_connect_20260114_170426.tar.gz`

Dentro de este fichero podremos encontrar el log detallado de la herramienta llamado `editran-export.log`, que indicará todos los pasos y acciones realizadas para exportar la configuración, así como posibles errores que hayan surgido.

Se recomienda consultar dicho log para comprobar que todo ha terminado correctamente.

## Compendio de errores de ejecución

### Ejecución de editran-export sin privilegios de administrador

Este error indica que **editran-export** no se ha ejecutado desde una terminal con privilegios de administrador. Es necesario ejecutarlo con dichos privilegios para comprobar el estado de los servicios necesarios y asegurar el correcto funcionamiento de la exportación.

```shell
Error: EDITRAN_EXPORT:42: WINDOWS_SERVICES:73: error al conectar con el SCM. Ejecute la herramienta con privilegios de administrador.: Access is denied.
```

### El servicio de licencia no está en ejecución

Este error indica que el servicio de licencia del producto instalado no está en ejecución.

```shell
Error: EDITRAN_EXPORT:46: el servicio de licencia no esta en ejecucion
```

Para solventar el problema asegúrese de que el servicio de licencia esté en ejecución. Además, compruebe que la licencia sea válida para la versión instalada y/o no esté caducada. El archivo `licencia.dat` debe existir en la carpeta `<installation_path>\bin\SL\`.

### Licencia de producto incorrecta o caducada

Estos errores indican que la licencia del producto no es correcta. El log del comando indicará concretamente cual es el error de la licencia, si está caducada o si la versión de la licencia no es la apropiada para la versión del software instalado.

```shell
Error: LINUX_EXEC:66: error ejecutando /home/classic/editran/bin/ediperfi -r -a -n -o/home/classic/editran/data-export_editran_20260114_133129/ediperfi.txt:
/home/classic/editran/bin/ediperfi: Licencia:  [LicAPI]-Licencia CADUCADA
: exit status 4
Error: EDITRAN_EXPORT:89: no se pueden volcar las sesiones de EditranP
```

```shell
Error: LINUX_EXEC:66: error ejecutando /home/classic/editran/bin/ediperfi -r -a -n -o/home/classic/editran/data-export_editran_20260114_133702/ediperfi.txt:
/home/classic/editran/bin/ediperfi: Licencia:  [LicAPI]-Version NO licenciada
: exit status 4
Error: EDITRAN_EXPORT:89: no se pueden volcar las sesiones de EditranP
```

Para conocer la versión del producto instalado:

* En el producto Editran Classic ejecute el comando `ediver` incluido en la carpeta `<installation-path>\bin` del producto.
* En el producto Editran Connect, puede verificar la versión instalada en el panel de `Configuración Local > Licencia > Datos de licencia` de la aplicación de Connect o desde su WebView.

Para obtener una nueva licencia para el producto instalado, contacte con el equipo de soporte.

### El servicio de Base de Datos de Editran Connect no está en ejecución

Este error indica que el servicio de datos de Editran Connect no está en ejecución.

```shell
Error: CONNECT_EXPORT:181: CONNECT_EXPORT:120: WINDOWS_SERVICES:107: el servicio EditranDataServer no está en ejecución
```

El nombre del servicio de datos puede variar entre las diferentes versiones y/o sistemas operativos soportados de acuerdo a la siguiente tabla:

| Plataforma | Versión inferior a 3.2       | Versión 3.2 y superior      |
| ---------- | ---------------------------- | --------------------------- |
| Windows    | EditranConnectData           | EditranDataServer           |
| Linux      | editran.connect.data.service | editran.data.server.service |

Para solventar el problema asegúrese de que el servicio de datos del producto Connect esté iniciado y funcionando correctamente antes de ejecutar la herramienta de exportación de configuración.

### Ruta de instalación del producto incorrecta

Este error indica que la ruta de instalación indicada en el parámetro `-i, --installpath` del comando **editran-export** no es correcta y la herramienta no puede encontrar el producto instalado.

En RedHat, el error mostrado será el siguiente:

```shell
Error: EDITRAN_EXPORT:42: LINUX_SERVICES:100: no se pudo consultar el estado del servicio: exec: "/home/classic/bin/EDItran": stat /home/classic/bin/EDItran: no such file or directory
Error: EDITRAN_EXPORT:89: no se pueden volcar las sesiones de EditranP
```

En Windows, el error mostrado será el siguiente:

```shell
Error: exec: "C:\EditranClassic\bin\ediperfi.exe": file does not exist
Error: EDITRAN_EXPORT:89: no se pueden volcar las sesiones de EditranP
```

Para solventarlo, asegúrese de que la ruta de instalación indicada en el parámetro `-i, --installpath` es correcta. Si la ruta contiene espacios, se debe especificar la ruta completa entre comillas dobles `""` para que la validación se haga correctamente. Por ejemplo: `-i "C:\Editran v5.2.0"`


---

# 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/editran-export.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.
