> 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/editran-import.md). # Editran Import Herramienta de importación de configuraciones para Editran Connect con versiones 3.2 y superiores. ## Overview Esta utilidad de línea de comandos permite importar configuración de forma fácil y rápida al producto Editran Connect. Es compatible con los ficheros comprimidos de configuración que genera la utilidad editran-export. La herramienta puede ejecutarse en los sistemas operativos **Windows** y **RedHat**, utilizando el binario correspondiente en cada caso. | Nombre del binario | Plataforma / SO | | -------------------- | --------------- | | *editran-import.exe* | Windows | | *editran-import* | Linux | El binario **editran-import** se distribuye junto con el software del producto Editran Connect y sólo es compatible con versiones 3.2 y superiores. Podrá encontrar el binario de la herramienta **editran-import** correspondiente a su sistema operativo en la carpeta `/utils/`, siendo `` la ruta base de instalación del producto Editran Connect obtenida como variable de entorno en el equipo. ### Requisitos 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-import desde una **terminal con permisos de administrador**. * Para RedHat, inicie sesión utilizando el usuario `editran` (o equivalente) que administre el producto Connect antes de ejecutar la herramienta de importación. Dicho usuario debe tener permisos `sudo` para administrar los servicios del producto Connect. Para mas información, consulte el apartado [dar permisos de sudo al usuario editran](#dar-permisos-de-sudo-al-usuario-editran) Para que la herramienta de importación de configuración funcione correctamente, es necesario asegurar los siguientes puntos: * Disponer de una licencia del producto Editran Connect correspondiente a la versión instalada y conocer su PIN de verificación. El fichero de licencia `licencia.dat` debe estar copiado en la carpeta `/core/bin/SL/`. * El servicio de licencia debe estar en ejecución con la licencia cargada. Si no está seguro de que el servicio de licencia haya cargado el fichero de licencia, reinicie el servicio tras copiar el fichero de licencia en la carpeta correspondiente citada anteriormente. * En Windows, el servicio de licencia se llama `EditranLicenseService`. * En RedHat, el servicio de licencia se llama `editran.license.service`. * El servicio de Base de Datos de Editran Connect debe estar en ejecución. * En Windows, el servicio de base de datos se llama `EditranDataServer`. * En RedHat, el servicio de base de datos se llama `editran.data.server.service`. * El servicio principal de Editran Connect debe estar en ejecución. * En Windows, el servicio principal de Connect se llama `EditranMainService`. * En RedHat, el servicio de licencia se llama `editran.main.service`. #### Dar permisos de sudo al usuario editran Para el correcto funcionamiento de la herramienta en entornos RedHat, es necesario que el usuario con el que se ejecute la herramienta, por defecto `editran`, tenga permisos para administrar los servicios del producto Editran Connect mediante `sudo` sin necesidad de introducir contraseña. **NOTA: Esta configuración puede ser eliminada del sistema tras la importación de datos.** Existen diferentes opciones de configuración: * OPCION 1: añadir el usuario `editran` al grupo wheel (o equivalente). * OPCION 2: añadir el usuario `editran` al grupo sudo con administración exclusiva de sus servicios. **OPCION 1:** Añadir el usuario `editran` al grupo `wheel`. ```bash sudo usermod -aG wheel editran ``` Dependiendo de tu versión de RELH, el grupo `wheel` puede no existir. Puedes consultar los grupos de usuarios disponibles en `/etc/sudoers`. **OPCION 2:** Para configurar estos permisos, un administrador del sistema operativo debe crear el fichero `/etc/sudoers.d/editran` y añadir los permisos para operar con los servicios de Connect, ejecutando los siguientes comandos: 1. Crear el fichero que contendrá las reglas de autorización sobre los servicios de Connect ```bash sudo touch /etc/sudoers.d/editran sudo visudo /etc/sudoers.d/editran ``` 2. Añadir al fichero las siguientes reglas y guardarlo con el nombre `editran`: ```bash Cmnd_Alias EDITRAN_SERVICES = /usr/bin/systemctl start editran.*.service, \ /usr/bin/systemctl stop editran.*.service, \ /usr/bin/systemctl restart editran.*.service editran ALL=(ALL) NOPASSWD: EDITRAN_SERVICES ``` 3. Dar al nuevo fichero los permisos de ejecución `0440` y propietario `root`. ```bash sudo chmod 0440 /etc/sudoers.d/editran sudo chown root:root /etc/sudoers.d/editran ``` 4. Validar que la sintaxis del fichero es correcta: ```bash sudo visudo -c -f /etc/sudoers.d/editran ``` Si la sintaxis es correcta, el comando devolverá: ``` /etc/sudoers.d/editran: parsed OK. ``` NOTA: La ruta de systemctl puede variar según la distribución. Verifique la ruta correcta con `which systemctl` antes de crear el fichero. En la mayoría de sistemas RedHat modernos la ruta es `/usr/bin/systemctl`. ### Modos de operación básicos con la herramienta editran-import A modo introductorio, la herramienta **editran-import** dispone de varios modos de operación sobre una instalación de Editran Connect. El escenario de aplicación de cada modo dependerá del estado de la instalación en el momento de usar la herramienta. Se definen tres escenarios básicos: 1. Nueva instalación o instalación vacía. Se permite la importación de configuración de un Editran Classic previamente exportado con **editran-export**. 2. Modificación de una instalación con datos previamente configurados. Se permite la importación de configuración de un Editran Classic previamente exportado con **editran-export**. 3. Recuperación completa de la configuración de un Editran Connect previamente exportado con **editran-export**. Atendiendo a los tres escenarios principales, la herramienta dispone de los siguientes modos de operación e importación de datos: | Escenario | Modo de operación | Descripción del modo | | ------------------------------------------------------------------------------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

Escenario 1.
Nueva instalación o instalación vacía

| [Modo `EMPTY`](#modo-empty) |

Configuración rápida del producto sobre una nueva instalación.
El resultado final será un Editran Connect con configuración básica importada.
Permite la importación de configuración de un Editran Classic previamente exportado, indicándolo en la invocación de la herramienta.

| |

Escenario 2.
Modificación de una instalación con datos previos configurados

| [Modo `RELOAD`](#modo-reload) |

Recarga de la configuración mínima de una instalación.
El resultado final será un Editran Connect con la configuración mínima recargada.
Permite la importación de configuración de un Editran Classic previamente exportado, indicándolo en la invocación de la herramienta.

| |

Escenario 2.
Modificación de una instalación con datos previos configurados

| [Modo `RESTART`](#modo-restart) |

Borrado completo de la configuración de una instalación. El resultado final será un Editran Connect con la configuración restaurada a los valores de la instalación.
Permite la importación de configuración de un Editran Classic previamente exportado, indicándolo en la invocación de la herramienta.

| |

Escenario 3.
Recuperación completa de un Editran Connect

| [Modo `CONNECT`](#modo-connect) | Recuperación de una instalación completa de un Editran Connect previamente exportado. Borra toda la configuración de la instalación actual. | De forma resumida: * Si desea importar configuración de otra instalación previa de Editran Classic, utilice los modos `empty`, `reload` o `restart`, dependiendo del estado de su instalación de Editran Connect y de si desea mantener la configuración de la instalación actual. * Si desea importar configuración de otra instalación previa de Editran Connect, utilice el modo `connect`, asumiendo que se borrará por completo toda la configuración realizada hasta el momento en la instalación actual. ## Cómo usar la herramienta En esta sección se van a detallar todos los modos de operación soportados en la herramienta de importación de datos, así como los parámetros permitidos desde la línea de comandos. ### Parámetros del comando Los parámetros disponibles para interactuar con la herramienta de importación de configuraciones son: ```bash editran-import -m -lic [flags...] [-nbk] editran-import -h ``` | Parámetro | Descripción | Modo de operación admitido | Ejemplo de uso | | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | |

-m
--mode

|

Modo de operación a realizar sobre la instalación de Connect.
Valores admitidos: empty, reload, restart, connect

| TODOS LOS MODOS |

-m connect
--mode empty

| |

-lic
--license

| Código pin para validar la licencia de Connect. Si la licencia no se verifica o el código es incorrecto, no se podrá ejecutar el modo indicado. | TODOS LOS MODOS |

-lic 9D9B7FE0
--license ABCD1234

| |

-nbk
--no-backup

|

Omite la creación de un backup de seguridad de la Base de Datos de Connect con la configuración previa.
La creación del backup puede tardar varios minutos, dependiendo de la cantidad de datos a preservar, y ocupará espacio en disco.

| TODOS LOS MODOS |

-nbk
--no-backup

| |

-f
--file

| Ruta al fichero comprimido .zip/.tar.gz exportado con *editran-export*. Si se provee este parámetro, se realizará una importación de datos con la configuración contenida en el fichero indicado. | TODOS LOS MODOS |

-f C:\backup\data-export-connect.zip
--file opt/backup/data-export-editran.tar.gz

| |

-c
--company

| Nombre de la empresa a crear en el proceso de onboarding de Connect. |

MODO EMPTY
MODO RESTART

|

-c "Mi Empresa S.L."
--company INDRA

| |

-a
--admin

|

Email del usuario administrador global del sistema Connect que se va a crear en el proceso de onboarding.
El usuario se creará con la contraseña por defecto Editran0! y se recomienda cambiarla en el primer login del usuario.

|

MODO EMPTY
MODO RESTART

|

-a
--admin

| |

-loc
--localcode

| Código local del sistema Connect a configurar en el proceso de onboarding. | MODO EMPTY | `-loc 02345678L` | |

-u
--user

| Email de un usuario administrador global creado en el sistema Connect para autenticarse en los modos reload, restart y connect. |

MODO RELOAD
MODO RESTART
MODO CONNECT

|

-u
--user

| |

-p
--password

| Contraseña del usuario administrador global indicado en el parámetro `--user` para autenticarse en los modos reload, restart y connect. |

MODO RELOAD
MODO RESTART
MODO CONNECT

|

-p P\@ssw0rd
--password Editran0!

| |

-h
--help

| Muestra la ayuda el comando. | TODOS LOS MODOS |

-h
--help

|
La herramienta dispone del comando de ayuda `-h`, `--help` que mostrará información similar a la recogida en la tabla anterior de parámetros. En esta ayuda se indicarán los parámetros obligatorios y opcionales para cada modo de operación indicado. Como ejemplo de uso, el comando `editran-export -h` mostrará la siguiente información: ```shell ***** EDITRAN-IMPORT-TOOL ***** Version : 1.0.0 Compilado: 2026-01-12_10:15:20 ******************************* editran-import: Herramienta de configuracion rapida para Editran Connect. Uso: editran-import -m -lic [flags...] [-nbk] editran-import -h -h, --help Muestra esta ayuda. -m, --mode Modo de importacion de datos. Valores validos: empty, reload, restart, connect. Flags comunes a todos los modos: -lic, --license Codigo de validacion de la licencia instalada. -nbk, --no-backup Omite la generacion de un backup con la configuracion actual de la BBDD de Connect. AVISO: Si el proceso de importacion falla y no se genero un backup, puede no ser posible recuperar un estado funcional de la instalacion. Flags admitidos por modo: Modo empty: Si se indica --file: --license --company --admin --file Si NO se indica --file: --license --company --admin --loc -c, --company Nombre de la compañia. -a, --admin Email del usuario administrador. -loc, --localcode Codigo local. -f, --file Ruta completa al fichero de importacion. Modo connect: -f, --file Ruta completa al fichero de importacion. Modo reload: -u, --user Usuario administrador para login. -p, --password Contraseña del usuario administrador. -f, --file (Opcional) Ruta completa al fichero de importacion. Modo restart: Si se indica --file: --license --user --password --company --admin --file Si NO se indica --file: --license --user --password -c, --company Nombre de la compañia. -a, --admin Email del usuario administrador. -u, --user Usuario administrador para login. -p, --password Contraseña del usuario administrador. -f, --file Ruta completa al fichero de importacion. Ejemplos de uso: editran-import -m empty -lic 1A2B3C4D -c "MI EMPRESA SA" -a admin@miempresa.com -loc 02345678L editran-import -m restart -lic 1A2B3C4D -u user@company.com -p password -c "ACME INC" -a admin@admin.com -f C:\backup\data-export_editran.zip --no-backup editran-import -m connect -lic 1A2B3C4D -f /home/root/data-export_connect.tar.gz --no-backup ``` ### Fichero de Log de editran-import La herramienta, además de la información que muestra en la terminal de ejecución, generará un fichero de log detallado con todos las acciones realizadas y posibles errores ocurridos en el proceso de importación. Dicho log se creará en la ruta `\logs\editran-import.log`, siendo `` la ruta base de instalación del producto Editran Connect obtenida como variable de entorno en el equipo. Este fichero de log contendrá el detalle de los procesos y acciones que realiza el modo de importación indicado, por ejemplo: * Información sobre las acciones realizadas sobre la Base de Datos de Connect para los diferentes modos de operación soportados. * Detalle de la configuración a importar * Información sobre la importación de datos en el sistema, así como posibles errores ocurridos en el proceso. * Logs concatenados de otros ficheros de log relevantes para el proceso de importación. ### Creación de un backup de seguridad de la base de datos La herramienta **editran-import**, por defecto, genera un backup de seguridad completo de la Base de Datos del producto Editran Connect, previo a realizar el modo de operación indicado. Este backup puede ser omitido para ahorrar tiempo de procesamiento y espacio en el disco duro del equipo, indicando el parámetro `--no-backup` en la invocación del comando. El backup se generará en la ruta `\tmp\data-import_\backup\` y contendrá los siguientes datos: * Archivo de backup de la base de datos, llamado `editrandb_dump.sql` y generado con el comando *pg\_dump* de PostgreSQL. * Carpeta `cfg` con los ficheros de backup del componente `Core`. Podrá contener los siguientes archivos de recuperación, aunque ésto varia dependiendo de la configuración disponible en el momento de realizar el backup: * Carpeta `.rsa` con las claves RSA de las transmisiones en activo. * Archivo `ckds.des` con las claves DES configuradas en Connect. * Archivos `editranp.cfg` y `editranp.sdx` con la configuración del módulo `Menu/P` del componente `Core`. Para ahorrar espacio de almacenamiento, tras finalizar el modo de operación exitosamente y sin errores, la carpeta de backup se borrará automáticamente. Si se realizó el backup automático de seguridad de la base de datos y la ejecución del modo de importación de datos finalizó con errores que no hacen posible el funcionamiento correcto del producto, la herramienta NO recuperará automáticamente la instalación previa. En este caso, se indicará la ruta de creación de dicho backup y será necesario una recuperación manual del estado previo. Para mayor información, consulte el epígrafe sobre [restauración manual de un backup de seguridad](#restauración-manual-de-un-backup-de-seguridad) **NOTA: Tenga en cuenta que si se omite la generación del backup automático y la herramienta da error, la instalación puede quedar en un estado inconsistente y no será posible recuperar un estado funcional de la instalación.** ### Modos de importación de datos La utilidad de importación admite varios modos de carga de datos, indicado por el argumento `--mode`. Cada modo de operación puede requerir de diversos parámetros introducidos en la invocación al comando. #### MODO EMPTY: Configuración rápida de Editran Connect Este modo de operación permite realizar el onboarding o puesta en marcha rápida para una nueva instalación de Editran Connect y la configuración básica de todos los componentes del sistema. Este modo sólo está permitido en nuevas instalaciones del producto o instalaciones donde se haya reiniciado el producto con el modo restart, donde no exista ningún tipo de configuración hasta el momento. El modo empty realizará las siguientes acciones sobre una instalación vacía de Editran Connect: * Validación de la licencia del producto con el PIN indicado en el argumento `--license`. * Creación de una nueva instancia de empresa, con el alias indicado en el argumento `--company`. * Creación de un nuevo usuario administrador global del sistema connect, con el email indicado en el argumento `--admin` y con contraseña por defecto `Editran0!`. * Configuración del entorno local de la instalación, incluyendo el código local, la IP y el puerto de conexión para conexiones entrantes. Adicional al proceso de configuración básico, el modo empty permite importar toda la configuración de una instalación previa de Editran Classic, utilizando el fichero comprimido de configuración obtenido con la herramienta **editran-export**. Para indicar la configuración exportada de otra instalación, indique la ruta absoluta al fichero con el argumento `--file `. 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. Si se indica un fichero de importación con el parámetro `--file`, no será necesario indicar el argumento `--localcode` ya que la herramienta configurará el entorno local del producto (código local, IP y Puerto de conexión) con los mismo valores exportados de la instalación previa de Editran Classic: * El/Los código/s local/es presentes en la configuración a importar. * IP/s de conexión presentes en la configuración a importar. * Puerto/s de conexión presentes en la configuración a importar. En caso contrario, si no se indica ningún fichero de importación, se deberá indicar el código local a configurar con el parámetro `--localcode` y se asumirán los siguientes valores por defecto: * El código local indicado en el argumento `--localcode`. * IP de conexión por defecto `0.0.0.0`. * Puerto de conexión por defecto `7777` **Ejemplos de uso MODO EMPTY** En este ejemplo, en una nueva instalación de Connect, con el modo empty crearemos la empresa `"INDRA S.L."`, configuramos el usuario global administrador con el email `admin@admin.es` y contraseña por defecto `Editran0!`, entorno local de la instalación con código local `012345678`, IP y Puerto por defecto `0.0.0.0:7777` y licencia con PIN `CB4A1169`. ```bash C:\EditranConnect\utils>editran-import.exe -m empty -lic CB4A1169 -c "INDRA S.L." -a admin@admin.es -loc 012345678 ***** EDITRAN-IMPORT-TOOL ***** Version : 1.0.0 Compilado: 2026-01-19_16:57:09 ******************************* - Parametros de entrada - mode : empty license : CB4A1169 company : INDRA S.L. admin : admin@admin.es localcode: 012345678 no-backup: falso Creando backup de la base de datos de Connect. Puede tardar unos minutos ... ---- Iniciando modo empty ---- Gestionando los servicios de Connect ... Invocando onboarding en Connect Onboarding Correcto ---- Finalizado modo empty ---- EDITRAN-IMPORT-TOOL finalizado correctamente ``` En este otro ejemplo, en una nueva instalación de Connect, con el modo empty crearemos la empresa `"INDRA S.L."`, configuramos el usuario global administrador con el email `admin@admin.es` y contraseña por defecto `Editran0!`, licencia con PIN `CB4A1169` y realizaremos una importación de datos y canales de una instalación previa de Editran Classic indicando la ruta al fichero de configuración exportado con el parámetro `--f` . El parámetro `--no-backup` evita crear un backup de la Base de Datos previo a configurar Connect. ```bash C:\EditranConnect\utils>editran-import.exe -m empty -lic CB4A1169 -c "INDRA S.L." -a admin@admin.es -f C:\Users\admin\Downloads\data-export_editran_20260120_165012.zip -nbk ***** EDITRAN-IMPORT-TOOL ***** Version : 1.0.0 Compilado: 2026-01-19_16:57:09 ******************************* - Parametros de entrada - mode : empty license : CB4A1169 company : INDRA S.L. admin : admin@admin.es file : C:\Users\admin\Downloads\data-export_editran_20260120_165012.zip no-backup: verdadero ---- Iniciando modo empty ---- Gestionando los servicios de Connect ... [Editran/P] preparado para migrar [Editran/G] preparado para migrar [Planificador] [AVISO] no existe configuracion de Planificador para migrar [Claves DES] preparado para migrar [Claves RSA] preparado para migrar Invocando onboarding en Connect Onboarding Correcto Migrando perfiles ... [migraContactos] Migrando configuracion local y contactos ... [migraContactos] Ejecución terminada correctamente [migraCanales] Migrando canales ... [migraCanales] Ejecucion terminada, para ver el resultado del proceso revise el log de salida [migraGC] Migrando criptografia ... [migraGC] Proceso finalizado. 2 registros procesados, 0 registros erróneos o no procesados. Para ver el resultado revise el log. [migraGC] Actualizando criptografia en canales ... [migraGC] Canales de transmision vinculados a los de GC Migracion de perfiles completada ---- Finalizado modo empty ---- EDITRAN-IMPORT-TOOL finalizado correctamente ``` Tal y como indica el reporte final, para comprobar los posibles errores ocurridos en el proceso de importación, se recomienda consultar detalladamente el log creado en la ruta `EDITRAN_CONNECT_HOME\logs\editran-import.log` para comprender y subsanar los problemas ocurridos en la importación de datos. Ante cualquier duda o problema con la herramienta, consulte con el equipo de soporte enviando dicho fichero de log. #### MODO RELOAD: Recarga de la configuración mínima de Editran Connect Este modo de operación permite recargar la configuración minima de una instalación de Connect previamente configurada. Se entiende por configuración mínima los siguientes conjuntos de datos: * Configuración básica de la instalación: idioma y diccionarios de traducción, categorías de aplicaciones, codificación del sistema, ... * Licencias instaladas. * Compañía configurada. * Códigos locales y direcciones IP configurados hasta el momento. * Usuarios de login existentes con sus roles y permisos en el sistema Editran Connect. * Servidores de email configurados. Este modo eliminará por completo los siguientes datos de configuración y de uso del producto: * Contactos remotos configurados. * Canales de transmisión configurados. * Claves criptográficas RSA configuradas e intercambiadas con otros remotos. * Planificaciones. * Histórico de transmisiones y alertas. Al ser un modo de operación que borrará datos de la instalación, se necesita una aceptación explicita del usuario indicando que acepta modificar la instalación: ```txt WARNING: se van a eliminar todas las configuraciones de contactos remotos y canales. Solo se conservara la configuracion minima. ¿Estas seguro? (s/n): ``` También, será necesario autenticarse en Connect indicando el email de un usuario con rol de `administrador global`, con el parámetro `--user `, y su contraseña de acceso, con el parámetro `--password `. Si el usuario indicado no tiene rol de `administrador global`, el modo de operación será rechazado. Adicional al proceso de recarga de la configuración mínima, el modo reload permite importar la configuración de una instalación previa de Editran Classic, utilizando el fichero comprimido de configuración obtenido con la herramienta **editran-export**. En este caso, debido al proceso de recarga más importación de datos, la instalación resultante contendrá la configuración minima recargada y se le añadirá la configuración adicional contenida en el fichero importado. Para indicar la configuración exportada de otra instalación, indique la ruta absoluta al fichero con el argumento `--file `. 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. **Ejemplos de uso MODO RELOAD** En este ejemplo, sobre una instalación de Connect previamente configurada, con el modo reload se borrará toda la configuración que no se considere mínima para la instalación, manteniendo todos los usuarios de login, licencia, códigos locales y datos de la compañía. Para autenticarse en este modo de operación será necesario indicar el email y contraseña de un usuario con permisos de `administrador global` en el sistema Connect y aceptar o rechazar conscientemente que se va a modificar la instalación. ```txt C:\EditranConnect\utils>editran-import.exe -m reload -lic CB4A1169 -u admin@admin.es -p Editran0! ***** EDITRAN-IMPORT-TOOL ***** Version : 1.0.0 Compilado: 2026-01-20_16:59:37 ******************************* WARNING: se van a eliminar todas las configuraciones de contactos remotos y canales. Solo se conservara la configuracion minima. ¿Estas seguro? (s/n): s Confirmado. Continuando... - Parametros de entrada - mode : reload license : CB4A1169 user : admin@admin.es password : ******** no-backup: falso Invocando validacion de la licencia en Connect Validacion de la licencia correcta Invocando login en Connect Login Correcto: admin@admin.es Creando backup de la base de datos de Connect. Puede tardar unos minutos ... ---- Iniciando modo reload ---- Gestionando los servicios de Connect ... Obteniendo la configuracion minima de Connect. Puede tardar unos minutos ... Regenerando la base de datos de Connect. Puede tardar unos minutos ... Base de datos regenerada correctamente Arrancando servicio EditranMainService ... Regenerando la configuracion del Core ... [migraContactos] Configurando entorno local en el Core ... [migraContactos] Configuración local actualizada ---- Finalizado modo reload ---- EDITRAN-IMPORT-TOOL finalizado correctamente ``` En este otro ejemplo, sobre una instalación de Connect previamente configurada, el modo reload borrará toda la configuración que no se considere mínima para la instalación, manteniendo todos los usuarios de login, licencia, códigos locales y datos de la compañía. Adicionalmente, se va a importar configuración de datos y canales de una instalación previa de Editran Classic, indicando la ruta al fichero de configuración exportado con el parámetro `--f` . ```txt C:\EditranConnect\utils>editran-import.exe -m reload -lic CB4A1169 -u admin@admin.es -p Editran0! -f C:\Users\admin\Downloads\EXPORTS\data-export_editran_20260114_121434.zip ***** EDITRAN-IMPORT-TOOL ***** Version : 1.0.0 Compilado: 2026-01-20_16:59:37 ******************************* WARNING: se van a eliminar todas las configuraciones de contactos remotos y canales. Solo se conservara la configuracion minima. ¿Estas seguro? (s/n): s Confirmado. Continuando... - Parametros de entrada - mode : reload license : CB4A1169 file : C:\Users\admin\Downloads\EXPORTS\data-export_editran_20260114_121434.zip user : admin@admin.es password : ******** no-backup: falso Invocando validacion de la licencia en Connect Validacion de la licencia correcta Invocando login en Connect Login Correcto: admin@admin.es Creando backup de la base de datos de Connect. Puede tardar unos minutos ... ---- Iniciando modo reload ---- Gestionando los servicios de Connect ... [Editran/P] preparado para migrar [Editran/G] preparado para migrar [Planificador] preparado para migrar [Claves DES] preparado para migrar [Claves RSA] preparado para migrar Obteniendo la configuracion minima de Connect. Puede tardar unos minutos ... Regenerando la base de datos de Connect. Puede tardar unos minutos ... Base de datos regenerada correctamente Arrancando servicio EditranMainService ... Regenerando la configuracion del Core ... [migraContactos] Configurando entorno local en el Core ... [migraContactos] Configuración local actualizada Migrando perfiles ... [migraContactos] Migrando configuracion local y contactos ... [migraContactos] Ejecución terminada correctamente [migraCanales] Migrando canales ... [migraCanales] Ejecucion terminada, para ver el resultado del proceso revise el log de salida [migraGC] Migrando criptografia ... [migraGC] Proceso finalizado. 137 registros procesados, 0 registros erróneos o no procesados. Para ver el resultado revise el log. [migraGC] Actualizando criptografia en canales ... [migraGC] Canales de transmision vinculados a los de GC [migraGT] Migrando planificaciones ... [migraGT] Proceso finalizado. 4 líneas procesadas, 0 líneas/configuraciones erróneas y 4 canales planificados. Para ver el resultado revise el log. Migracion de perfiles completada ---- Finalizado modo reload ---- EDITRAN-IMPORT-TOOL finalizado correctamente ``` #### MODO RESTART: Restablecimiento o borrado completo de la configuración de Editran Connect Este modo de operación permite restablecer una instalación de Connect previamente configurada. El restablecimiento implica que toda la configuración de usuario será eliminada, resultando en una instalación vacía del producto Editran Connect, tal y como si fuese recién instalado. Al ser un modo de operación que borrará todos los datos de la instalación, se necesita una aceptación explicita del usuario indicando que acepta modificar la instalación: ```txt WARNING: se va a eliminar toda la configuracion de Connect hasta el momento. Connect va a ser reseteado. ¿Estas seguro? (s/n)?: ``` También, será necesario autenticarse en Connect indicando el email de un usuario con rol de `administrador global`, con el parámetro `--user `, y su contraseña de acceso, con el parámetro `--password `. Si el usuario indicado no tiene rol de `administrador global`, el modo de operación será rechazado. Adicional al proceso de restablecimiento completo de la configuración, el modo restart permite importar la configuración de una instalación previa de Editran Classic, utilizando el fichero comprimido de configuración obtenido con la herramienta **editran-export**. En este caso, debido al proceso de restablecimiento completo, es necesario realizar el proceso de onboarding previo a la importación de datos, indicando los parámetros `--company ` y `--admin `. La instalación resultante será similar al proceso realizado en el modo `empty` con importación de configuración, un sistema Editran Connect recién instalado con la configuración importada desde un fichero previamente exportado. Para indicar la configuración exportada de otra instalación, indique la ruta absoluta al fichero con el argumento `--file `. 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. **Ejemplos de uso MODO RESTART** En este ejemplo, sobre una instalación de Connect previamente configurada, con el modo restart se borrará completamente toda la configuración realizada hasta el momento. Para autenticarse en este modo de operación será necesario indicar el email y contraseña de un usuario con permisos de `administrador global` en el sistema Connect y aceptar o rechazar conscientemente que se va a modificar la instalación. ```txt C:\EditranConnect\utils>editran-import.exe -m restart -lic CB4A1169 -u admin@admin.es -p Editran0! ***** EDITRAN-IMPORT-TOOL ***** Version : 1.0.0 Compilado: 2026-01-19_16:57:09 ******************************* WARNING: se va a eliminar toda la configuracion de Connect hasta el momento. Connect va a ser reseteado. ¿Estas seguro? (s/n)?: s Confirmado. Continuando... - Parametros de entrada - mode : restart license : CB4A1169 user : admin@admin.es password : ******** no-backup: falso Invocando validacion de la licencia en Connect Validacion de la licencia correcta Invocando login en Connect Login Correcto: admin@admin.es Creando backup de la base de datos de Connect. Puede tardar unos minutos ... ---- Iniciando modo restart ---- Gestionando los servicios de Connect ... Regenerando la base de datos de Connect. Puede tardar unos minutos ... Base de datos regenerada correctamente Arrancando servicio EditranMainService ... ---- Finalizado modo restart ---- EDITRAN-IMPORT-TOOL finalizado correctamente ``` En este otro ejemplo, sobre una instalación de Connect previamente configurada, con el modo restart se borrará completamente toda la configuración realizada hasta el momento. Para autenticarse en este modo de operación será necesario indicar el email y contraseña de un usuario con permisos de `administrador global` en el sistema Connect y aceptar o rechazar conscientemente que se va a modificar la instalación. Adicionalmente, se va a importar configuración de datos y canales de una instalación previa de Editran Classic, indicando la ruta al fichero de configuración exportado con el parámetro `--f` . En este caso, dado que la instalación va a quedar vacía tras el restart, antes de importar datos de canales y contactos, es necesario indicar los parámetros de onboarding para crear la compañía `--company "INDRA S.L."` y un nuevo usuario administrador global del sistema connect `--admin ` con contraseña por defecto `Editran0!`. ```txt C:\EditranConnect\utils>editran-import.exe -m restart -lic CB4A1169 -u admin@admin.es -p Editran0! -f C:\Users\admin\Downloads\data-export_editran_20260120_165012.zip -c "INDRA S.L." -a newadmin@newadmin.es --no-backup ***** EDITRAN-IMPORT-TOOL ***** Version : 1.0.0 Compilado: 2026-01-20_16:59:37 ******************************* WARNING: se va a eliminar toda la configuracion de Connect hasta el momento. Connect va a ser reseteado. ¿Estas seguro? (s/n)?: s Confirmado. Continuando... - Parametros de entrada - mode : restart license : CB4A1169 company : INDRA S.L. admin : newadmin@newadmin.es file : C:\Users\admin\Downloads\data-export_editran_20260120_165012.zip user : admin@admin.es password : ******** no-backup: verdadero Invocando validacion de la licencia en Connect Validacion de la licencia correcta Invocando login en Connect Login Correcto: admin@admin.es ---- Iniciando modo restart ---- Gestionando los servicios de Connect ... [Editran/P] preparado para migrar [Editran/G] preparado para migrar [Planificador] [AVISO] no existe configuracion de Planificador para migrar [Claves DES] preparado para migrar [Claves RSA] preparado para migrar Regenerando la base de datos de Connect. Puede tardar unos minutos ... Base de datos regenerada correctamente Arrancando servicio EditranMainService ... Invocando onboarding en Connect Onboarding Correcto Migrando perfiles ... [migraContactos] Migrando configuracion local y contactos ... [migraContactos] Ejecución terminada correctamente [migraCanales] Migrando canales ... [migraCanales] Ejecucion terminada, para ver el resultado del proceso revise el log de salida [migraGC] Migrando criptografia ... [migraGC] Proceso finalizado. 2 registros procesados, 0 registros erróneos o no procesados. Para ver el resultado revise el log. [migraGC] Actualizando criptografia en canales ... [migraGC] Canales de transmision vinculados a los de GC Migracion de perfiles completada ---- Finalizado modo restart ---- EDITRAN-IMPORT-TOOL finalizado correctamente ``` #### MODO CONNECT: Importación de configuración de un Editran Connect previo Este modo de operación permite la recuperación completa de la configuración de un Editran Connect previamente exportado con **editran-export**. Tenga en cuenta que este modo borra toda la configuración de la instalación actual. Para ejecutar este modo, debe indicar el pin para validar la licencia con el parámetro `--license ` e indicar la ruta absoluta al fichero de configuración de otra instalación de Editran Connect con el parámetro `--file `. 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. **Ejemplos de uso MODO CONNECT** Este ejemplo indica como invocar a la herramienta utilizando el modo connect para importar la configuración de un Editran Connect previamente exportado. Es necesario indicar en la llamada del comando el pin para verificar la licencia con `-lic CB4A1169` y la ruta absoluta al fichero que vamos a importar con `-f C:\Users\admin\Downloads\data-export_connect_20251217_170905.zip`. Tras finalizar el modo de importación correctamente, tendremos una imagen recuperada de la instalación previa, con todos los canales, contactos, usuarios de login y configuración adicional que hubiese en la instalación previa. ```txt C:\EditranConnect\utils>editran-import.exe -m connect -lic CB4A1169 -f C:\Users\admin\Downloads\data-export_connect_20251217_170905.zip -nbk ***** EDITRAN-IMPORT-TOOL ***** Version : 1.0.0 Compilado: 2026-01-20_16:59:37 ******************************* - Parametros de entrada - mode : connect license : CB4A1169 file : C:\Users\admin\Downloads\data-export_connect_20251217_170905.zip no-backup: verdadero Invocando validacion de la licencia en Connect Validacion de la licencia correcta ---- Iniciando modo connect ---- Gestionando los servicios de Connect ... [Claves DES] preparado para migrar [Base de Datos] preparado para migrar Regenerando la base de datos de Connect. Puede tardar unos minutos ... Base de datos regenerada correctamente Arrancando servicio EditranMainService ... [migraContactos] El fichero SalidaP no existe Actualizando licencia en Connect Actualizacion de la licencia correcta Regenerando la configuracion del Core ... [migraContactos] Configurando entorno local en el Core ... [migraContactos] Configuración local actualizada [migraCanales] Configurando perfiles en el Core ... [migraCanales] Canales registrados en editranP ---- Finalizado modo connect ---- EDITRAN-IMPORT-TOOL finalizado correctamente ``` ### Restauración manual de un backup de seguridad Si se realizó el backup automático de seguridad de la base de datos y la ejecución del modo de importación seleccionado finalizó con errores que no hacen posible el funcionamiento correcto del producto, la herramienta NO recuperará automáticamente la instalación previa. En este caso, se indicará la ruta de creación de dicho backup y será necesario una recuperación manual del estado previo. ```txt Se ha creado el archivo de backup C:\EditranConnect\tmp\data-import_20260122_172800\backup\editrandb_dump.sql con la configuracion original de la BBDD. Use este archivo para recuperar la configuracion manualmente. Consulte el manual para mas informacion. ``` En la carpeta indicada se encontrarán todos los archivos necesarios para la recuperación de la instalación. Para recuperar la base de datos a un estado funcional, deberá utilizarse el script `regenerate.[bat|sh]`, presente en la carpeta `/bin/pgsql` de instalación del producto Connect, indicando la ruta al fichero de backup generado. La forma correcta de invocar al script de recuperación del backup es: `regenerate "/path/to/backup/editrandb_dump.sql"` El proceso de restauración puede tardar varios minutos dependiendo del tamaño del backup de seguridad. No cierre la terminal de ejecución hasta que termine todo el proceso. ```txt C:\EditranConnect>cd bin/pgsql C:\EditranConnect\bin\pgsql>regenerate.bat "C:\EditranConnect\tmp\data-import_20260122_172800\backup\editrandb_dump.sql" ========================================== Fichero: "C:\EditranConnect\tmp\data-import_20260122_172800\backup\editrandb_dump.sql" Carga inicial: false ========================================== Borrando esquemas ... Cargando fichero "C:\EditranConnect\tmp\data-import_20260122_172800\backup\editrandb_dump.sql" Actualizando estructura y datos de la base de datos ... Actualizando ROLE editran ... Base de datos regenerada correctamente Consulte el archivo C:\EditranConnect\logs\regenerate.log para obtener informacion detallada sobre el proceso. ``` Tras la finalización de la recuperación del backup, también es necesario copiar todo el contenido de la carpeta `path/to/backup/cfg` de nuevo en la carpeta de configuración del módulo Core `/cfg` ## Compendio de errores de ejecución ### Ejecución de editran-export sin privilegios de administrador Este error indica que **editran-import** no se ha ejecutado desde una terminal con privilegios de administrador. Es necesario ejecutarlo con dichos privilegios para arrancar y detener los servicios necesarios involucrados en el proceso de importación. ```txt Gestionando los servicios de Connect ... Error: IMPORT_MANAGER:35: EMPTY_MODE:25: EMPTY_MODE:18: WINDOWS_SERVICES:242: WINDOWS_SERVICES:213: WINDOWS_SERVICES:184: error al conectar con el SCM. Ejecute la herramienta con privilegios de administrador.: Access is denied. EDITRAN-IMPORT-TOOL finalizado con errores ``` ### Base de datos no disponible Este error indica que el servicio de datos de Editran Connect no está en ejecución y no es posible verificar la licencia o realizar otras acciones con la herramienta de importación. ```txt Invocando validacion de la licencia en Connect Error: No se puede validar la licencia. | DATABASE_TASK:19: SQL_EXECUTOR:34: BBDD no disponible.: dial tcp 127.0.0.1:5432: connectex: No connection could be made because the target machine actively refused it. ``` Para solventar el problema, asegúrese de que el servicio de datos `EditranDataServer` del producto Connect esté iniciado y funcionando correctamente antes de ejecutar la herramienta de importación de configuración. ### Backend no disponible Este error indica que el servicio backend o servicio principal de Editran Connect no está en ejecución y no es posible realizar acciones con la herramienta de importación, como la verificación del usuario o invocación de los procesos de migración de datos. ```txt Invocando login en Connect Error: IMPORT_MANAGER:18: SETUP:146: SETUP:112: LOGIN_TASK:112: WEBSERVICES:204: WEBSERVICES:360: [StatusCode: -1] Conexión rechazada: el backend no está disponible: Post "http://localhost:8081/connect-back/login": dial tcp 127.0.0.1:8081: connectex: No connection could be made because the target machine actively refused it. ``` Para solventar el problema, asegúrese de que el servicio principal `EditranMainService` del producto Connect esté iniciado y funcionando correctamente antes de ejecutar la herramienta de importación de configuración. ### Error en la elección del modo empty. Onboarding ya invocado Este error indica que el modo de operación `EMPTY` elegido no es correcto. La instalación ya realizó el onboarding del producto anteriormente y no puede volver a ser ejecutado. Compruebe el estado de su instalación previo a ejecutar uno de los modos de operación. ```txt Invocando onboarding en Connect Error: IMPORT_MANAGER:35: EMPTY_MODE:36: ONBOARDING_TASK:99: WEBSERVICES:177: Este método ya no puede ser invocado de nuevo EDITRAN-IMPORT-TOOL finalizado con errores ``` ### El modo seleccionado no permite importar el fichero de configuracion indicado Los siguientes errores indican que el modo de operación seleccionado no es compatible con el tipo de fichero de configuración a importar indicado al invocar el comando. ```txt Error: IMPORT_MANAGER:18: SETUP:163: IMPORT_FILE:61: IMPORT_FILE:29: el modo reload seleccionado no permite importar el fichero de configuracion de connect indicado. Utilice otro modo de operacion o indique un fichero con configuracion de editran compatible. EDITRAN-IMPORT-TOOL finalizado con errores ``` ```txt Error: IMPORT_MANAGER:18: SETUP:163: IMPORT_FILE:61: IMPORT_FILE:25: el modo connect seleccionado no permite importar el fichero de configuracion de editran indicado. Utilice otro modo de operacion o indique un fichero con configuracion de connect compatible. EDITRAN-IMPORT-TOOL finalizado con errores ``` Para importar configuración de un producto `Editran Classic` previamente exportado, sólo se podrán utilizar los modos `empty`, `reload` y `restart`. La elección concreta del modo dependerá del estado de la instalación de `Editran Connect`. Para importar configuración de otra instalación previa de `Editran Connect`, sólo se podrá utilizar el modo `connect`, asumiendo que se borrará por completo toda la configuración realizada hasta el momento en la instalación actual. ### El usuario indicado no está dado de alta en Editran Connect Este error indica que los datos de login suministrados al comando no son correctos. Puede ser que el usuario indicado en el parámetro `--user ` no esté dado de alta en el sistema Connect, o que su contraseña indicada en el parámetro `--password ` no sea la correcta. ```txt Invocando login en Connect Error: IMPORT_MANAGER:18: SETUP:146: SETUP:112: LOGIN_TASK:112: WEBSERVICES:224: Usuario (admin@admin.es) o contraseña incorrecta: Unauthorized EDITRAN-IMPORT-TOOL finalizado con errores ``` Revise correctamente las credenciales de acceso al sistema para subsanar el error. Si el error persiste, intente resetear la contraseña de acceso para el usuario indicado siguiendo el procedimiento `¿No recuerdas la contraseña?` disponible desde la vista de login de Connect. ### El usuario indicado no tiene permisos de Administrador Global Este error indica que el usuario suministrado para validar el modo de operación no dispone de privilegios de `Administrador Global` sobre el sistema Connect. ```txt Invocando login en Connect Error: IMPORT_MANAGER:18: SETUP:146: SETUP:112: LOGIN_TASK:112: WEBSERVICES:217: El usuario indicado no tiene permisos de Administrador Global. ROL Operador Avanzado EDITRAN-IMPORT-TOOL finalizado con errores ``` Debe indicar un usuario con los privilegios necesarios para operar con la herramienta **editran-import**. Si tiene dudas de su rol en el sistema Connect, contacte con su administrador del sistema. ### La ruta indicada al fichero de importación es errónea Este error indica que la ruta al fichero de importación indicado en el parámetro `--file ` no es correcta. ```txt Error: [Validacion] valor de parametro invalido --file: C:\Users\admin\Downloads\data-export_connect_20251217_170905. Valores validos El fichero comprimido de configuracion no existe o no es accesible. ``` Revise detalladamente que el nombre del fichero de importación es el correcto, que la ruta completa al fichero es correcta y que la ruta no contenga espacios en blanco. Para introducir rutas de carpetas que contengan espacios en blanco, es necesario usar comillas dobles `""` para que la herramienta lo valide correctamente. --- # 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/editran-import.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.