> 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-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, desde otros productos Editran configurados anteriormente. 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**. El binario **editran-import** se distribuye junto con el software del producto Editran Connect y se encuentra en la carpeta `/utils/`\* *\* Siendo** **``** **la ruta base de instalación del producto Editran Connect obtenida como variable de entorno en el equipo.* Se definen tres escenarios básicos para operar con la herramienta: 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**. ## Requisitos 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. * Servicios en ejecución: * Licencia (Windows: EditranLicenseService, Linux: editran.license.service) * Data (Windows: EditranDataServer, Linux: editran.data.server.service) * Main (Windows: EditranMainService, Linux: editran.main.service) * Ejecución con permisos elevados de administración de servicios, según corresponda a su sistema operativo. * Para Windows, ejecute la herramienta editran-import desde una **terminal con permisos de administrador**. * Para RedHat, ejecute la herramienta utilizando el usuario `editran` (o equivalente) que administre el producto y sus servicios. ## 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 | Valores admitidos | | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------- | |

-m
--mode

|

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

| TODOS |

connect/restart/reload/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 |

\

| |

-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.
Revisar el apartado sobre la generación de Backups de seguridad

| TODOS |

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

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

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

|

EMPTY
RESTART

|

-a
--admin

| |

-loc
--localcode

| Código local del sistema Connect a configurar en el proceso de onboarding. | 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. |

RELOAD
RESTART
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. |

RELOAD
RESTART
CONNECT

|

-p P\@ssw0rd
--password Editran0!

| |

-h
--help

| Muestra la ayuda del comando. | TODOS |

-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-import -h` mostrará la siguiente información: ```shell ***** EDITRAN-IMPORT-TOOL ***** Version : 2.0.0 Compilado: 2026-05-06_13:02:51 ******************************* 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 del backup de la configuracion actual 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 -c "ACME INC" -a admin@admin.com -u user@company.com -p password -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 ``` ## Casos de uso 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 | | ------------------------------------------------------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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.

| | Recarga de la configuración mínima sobre una instalación existente. | [Modo `RELOAD`](#modo-reload) |

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.

| | Borrado completo de la configuración de una instalación existente. | [Modo `RESTART`](#modo-restart) |

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.

| | 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. | ## Modos de ejecución de la herramienta 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 permite realizar la puesta en marcha rápida de Editran Connect, configurando los componentes básicos del sistema. Este modo solo puede ejecutarse sobre nuevas instalaciones o sobre instalaciones que hayan sido reiniciadas previamente con el modo `restart`. ```bash editran-import -m empty -lic XXXXXX -c "COMPANY" -a "user@company.com" {-loc XXXXXX | -f } ``` El modo realizará las siguientes acciones: * **Validación de la licencia** del producto con el PIN indicado en el argumento `--license`/`-lic`. * **Creación de la entidad empresa**, con el alias indicado en el argumento `--company`/`-c`. * **Creación del usuario administrador global** del sistema connect, con el email indicado en el argumento `--admin`/`-a` 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. \* * **Importación del fichero de configuración de Editran Classic**, si se indica el argumento `--file`/`-f` con un fichero válido \*\* *\* Ver* [*Configuración del entorno local*](#configuración-del-entorno-local-de-la-instalación)\ *\*\* Es necesario usar comillas dobles** **`""`** **para introducir rutas de carpetas que contengan espacios en blanco y que la herramienta lo valide correctamente.* #### Configuración del entorno local de la instalación La configuración que aplica al entorno local del producto depende de los parámetros `--file`/`-f` y `--localcode`/`-loc`. **El uso de uno de estos parámetros es excluyente, solo se podrá indicar uno de los dos en el modo `empty`.** Si se indica un fichero de importación de un producto Editran Classic, con el parámetro `--file`/`-f`, la herramienta configura el entorno local del producto con los valores de dicho fichero de carga de datos: * Los códigos locales presentes en la configuración a importar. * Las IPs y puertos de conexión presentes en la configuración a importar. Si, en cambio, se indica un código local válido con el argumento `--localcode`/`-loc`, se aplican los siguientes valores: * 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`. #### Importación del fichero de configuración Adicionalmente a la configuración básica del producto, al indicar un fichero de configuración, con el parámetro `--file`/`-f`, se migrarán a Connect las siguientes entidades: * Direcciones IP de Proxy locales. * Canales y Contactos Remotos. * Claves RSA locales y remotas. * Planificaciones sobre los canales. #### Ejemplos de uso MODO EMPTY En este ejemplo, en una nueva instalación de Connect, el modo empty crea la empresa `"INDRA S.L."`, configura un usuario global administrador con el email `admin@indra.es` y contraseña por defecto `Editran0!`, crea el entorno local de la instalación con el código local `012345678`, la IP y el puerto por defecto `0.0.0.0:7777` y la licencia con PIN `CB4A1169`. ```bash C:\EditranConnect\utils>editran-import.exe -m empty -lic CB4A1169 -c "INDRA S.L." -a admin@indra.es -loc 012345678 ***** EDITRAN-IMPORT-TOOL ***** Version : 2.0.0 Compilado: 2026-05-06_13:02:51 ******************************* - Parametros de entrada - mode : empty license : CB4A1169 company : INDRA S.L. admin : admin@indra.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 Invocando login en Connect Login Correcto: admin@indra.es ---- Finalizado modo empty ---- EDITRAN-IMPORT-TOOL finalizado correctamente ``` En este otro ejemplo, en una nueva instalación de Connect, el modo empty crea la empresa `"INDRA S.L."`, configura un usuario global administrador con el email `admin@indra.es` y contraseña por defecto `Editran0!`, configura una licencia con PIN `CB4A1169` y realiza una importación de datos y canales de una instalación previa de Editran Classic desde el fichero de configuración indicado 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@indra.es -f C:\Users\admin\Downloads\data-export_editran_20260120_165012.zip -nbk ***** EDITRAN-IMPORT-TOOL ***** Version : 2.0.0 Compilado: 2026-05-06_13:02:51 ******************************* - Parametros de entrada - mode : empty license : CB4A1169 company : INDRA S.L. admin : admin@indra.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] Entorno local encontrado en el fichero de importacion: CODIGO LOCAL = [W00000010] DIRECCION/ES IP LOCAL = 0.0.0.0:7777 [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 Invocando login en Connect Login Correcto: admin@indra.es Migrando perfiles ... Canales procesados: 2. Canales correctamente dados de alta: 2. Canales con error al dar de alta: 0. Claves RSA procesadas: 2. Claves dadas de alta: 2. Claves con error al dar de alta: 0. Claves no migradas: 0 Migracion de perfiles completada ---- Finalizado modo empty ---- EDITRAN-IMPORT-TOOL finalizado correctamente ``` Si la herramienta finaliza indicando algún error, se recomienda consultar el log detallado creado en la ruta `EDITRAN_CONNECT_HOME\logs\editran-import.log`, para comprender y subsanar los posibles 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 permite recargar la configuración mínima de una instalación de Connect previamente configurada. ```bash editran-import -m reload -lic XXXXXX -u "user@company.com" -p USR_PASSWD [-f ] [-nbk] [-y] ``` 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. #### Autenticación y confirmación del usuario Al ser un modo que borra datos de la instalación, se necesitan cumplir una serie de requisitos para validar la operación: * Confirmación explícita 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): ``` * Autenticación de un usuario con rol de `administrador global` en Connect, indicando el email, con el parámetro `--user `, y su contraseña de acceso, con el parámetro `--password `. #### Importación de un fichero de configuración Adicionalmente, tras la recarga de la configuración mínima, el modo reload permite importar la configuración de una instalación previa de Editran Classic, indicando un fichero comprimido de configuración válido con el parámetro `--file`/`-f`. \* *\* Es necesario usar comillas dobles** **`""`** **para introducir rutas de carpetas que contengan espacios en blanco y que la herramienta lo valide correctamente.* La instalación resultante contendrá la configuración mínima recargada más la siguiente configuración adicional importada del fichero: * Configuración mínima de la instalación original (ver [definición](#entidad-config-minima)). * Canales y contactos remotos configurados en el fichero a importar. * Claves RSA locales y remotas configuradas en el fichero a importar. * Planificaciones sobre los canales configuradas en el fichero a importar. #### Ejemplos de uso MODO RELOAD En este ejemplo de uso básico, el modo reload borra toda la configuración no considerada mínima para la instalación. El modo exige autenticación como `administrador global` y confirmación explícita antes de proceder. ```txt C:\EditranConnect\utils>editran-import.exe -m reload -lic CB4A1169 -u admin@indra.es -p Editran0! ***** EDITRAN-IMPORT-TOOL ***** Version : 2.0.0 Compilado: 2026-05-13_17:04:43 ******************************* 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@indra.es password : ******** no-backup: falso Invocando validacion de la licencia en Connect Validacion de la licencia correcta Invocando login en Connect Login Correcto: admin@indra.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, además del reload, se indica con el parámetro `-f` la ruta a un fichero de configuración exportado de Editran Classic para importar canales, contactos, claves RSA y planificaciones adicionales. ```txt C:\EditranConnect\utils>editran-import.exe -m reload -lic CB4A1169 -u admin@indra.es -p Editran0! -f C:\Users\admin\Downloads\EXPORTS\data-export_editran_20260114_121434.zip ***** EDITRAN-IMPORT-TOOL ***** Version : 2.0.0 Compilado: 2026-05-13_17:04:43 ******************************* 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\data-export_editran_20260120_165012.zip user : admin@indra.es password : ******** no-backup: falso Invocando validacion de la licencia en Connect Validacion de la licencia correcta Invocando login en Connect Login Correcto: admin@indra.es Creando backup de la base de datos de Connect. Puede tardar unos minutos ... ---- Iniciando modo reload ---- Gestionando los servicios de Connect ... [Editran/P] Entorno local encontrado en el fichero de importacion: CODIGO LOCAL = [W00000010] DIRECCION/ES IP LOCAL = 0.0.0.0:7777 [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 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 ... Canales procesados: 2. Canales correctamente dados de alta: 2. Canales con error al dar de alta: 0. Claves RSA procesadas: 2. Claves dadas de alta: 2. Claves con error al dar de alta: 0. Claves no migradas: 0 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 permite restablecer una instalación de Editran Connect previamente configurada. El restablecimiento implica que toda la configuración de usuario será eliminada, resultando en una instalación vacía del producto. ```bash editran-import -m restart -lic XXXXXX -u "user@company.com" -p USR_PASSWD [-f -c "COMPANY" -a "newuser@company.com"] [-nbk] [-y] ``` #### Autenticación y confirmación del usuario Al ser un modo que borra datos de la instalación, se necesitan cumplir una serie de requisitos para validar la operación: * Confirmación explícita del usuario indicando que acepta eliminar la configuración de 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)?: ``` * Autenticación de un usuario con rol de `administrador global` en Connect, indicando el email, con el parámetro `--user `, y su contraseña de acceso, con el parámetro `--password `. #### Importación de un fichero de configuración Adicionalmente, tras el restablecimiento completo de la configuración, el modo restart permite importar la configuración de una instalación previa de Editran Classic, indicando un fichero comprimido de configuración válido con el parámetro `--file`/`-f`. \* *\* Es necesario usar comillas dobles** **`""`** **para introducir rutas de carpetas que contengan espacios en blanco y que la herramienta lo valide correctamente.* En este caso, tras el restablecimiento completo, la herramienta debe realizar el proceso de onboarding antes de comenzar la importación de datos, siendo necesario para ello indicar los parámetros `--company/-c ` y `--admin/-a `. 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 el fichero indicado. #### Ejemplos de uso MODO RESTART En este ejemplo de uso básico, el modo restart borra toda la configuración realizada hasta el momento en la instalación. El modo exige autenticación como `administrador global` y confirmación explícita antes de proceder. ```txt C:\EditranConnect\utils>editran-import.exe -m restart -lic CB4A1169 -u admin@admin.es -p Editran0! ***** EDITRAN-IMPORT-TOOL ***** Version : 2.0.0 Compilado: 2026-05-06_13:02:51 ******************************* 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, además de la operación de restablecimiento, se indica con el parámetro `-f` la ruta a un fichero de configuración exportado de Editran Classic. Dado que la instalación va a quedar vacía tras el restart, y antes de importar datos de canales y contactos, la herramienta realiza el onboarding, creando la compañía `--company "INDRA S.L."` y el nuevo usuario administrador global del sistema Connect `--admin newadmin@newadmin.es` con contraseña por defecto `Editran0!`. ```txt C:\EditranConnect\utils>editran-import.exe -m restart -lic CB4A1169 -u admin@indra.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 : 2.0.0 Compilado: 2026-05-13_17:04:43 ******************************* 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@indra.es password : ******** no-backup: verdadero Invocando validacion de la licencia en Connect Validacion de la licencia correcta Invocando login en Connect Login Correcto: admin@indra.es ---- Iniciando modo restart ---- Gestionando los servicios de Connect ... [Editran/P] Entorno local encontrado en el fichero de importacion: CODIGO LOCAL = [W00000010] DIRECCION/ES IP LOCAL = 0.0.0.0:7777 [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 Invocando login en Connect Login Correcto: newadmin@newadmin.es Migrando perfiles ... Canales procesados: 2. Canales correctamente dados de alta: 2. Canales con error al dar de alta: 0. Claves RSA procesadas: 2. Claves dadas de alta: 2. Claves con error al dar de alta: 0. Claves no migradas: 0 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 permite la recuperación completa de la configuración de un Editran Connect previamente exportado con **editran-export**. Recuperar una imagen de una instalación previa de Connect implica borrar toda la configuración de la instalación actual. ```bash editran-import -m connect -lic XXXXXX -f [-nbk] ``` Para ejecutar este modo es necesario indicar el PIN de la licencia con el parámetro `--license`/`-lic` y la ruta absoluta al fichero de configuración exportado con el parámetro `--file`/`-f`. \* *\* Es necesario usar comillas dobles** **`""`** **para introducir rutas de carpetas que contengan espacios en blanco y que la herramienta lo valide correctamente.* #### Ejemplos de uso MODO CONNECT En este ejemplo, el modo `connect` importa la configuración completa de un Editran Connect previamente exportado, indicando el PIN de la licencia con `-lic` y la ruta al fichero exportado con `-f`. Al finalizar correctamente, la instalación quedará con todos los canales, contactos, usuarios de login y configuración adicional presentes en el fichero importado. ```txt C:\EditranConnect\utils>editran-import.exe -m connect -lic CB4A1169 -f C:\Users\admin\Downloads\data-export_connect_20251217_170905.zip ***** EDITRAN-IMPORT-TOOL ***** Version : 2.0.0 Compilado: 2026-05-13_17:04:43 ******************************* - Parametros de entrada - mode : connect license : CB4A1169 file : C:\Users\admin\Downloads\data-export_connect_20251217_170905.zip no-backup: falso 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] Connect preparado para actualizar los perfiles del Core 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 ``` ## Backups de seguridad ### 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. **\* 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.** El backup se generará en la ruta `/tmp/data-import_/backup/` y contendrá los siguientes datos: * 📄 Fichero `editrandb_dump.sql`: archivo de backup de la base de datos generado con el comando *pg\_dump* de PostgreSQL. * 📄 Fichero `ks.pfx`: almacén de los certificados de clave pública de los firmantes. * 📁 Carpeta `certs` con los certificados de autenticación para la comunicación con los proveedores de firma en nube integrados en Connect. * 📁 Carpeta `cfg` con los ficheros de backup del componente `Core`. Podrá contener los siguientes archivos de recuperación, aunque esto varía 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 correctamente y sin errores, la carpeta de backup se borrará automáticamente. Considere realizar un backup manual completo de la carpeta `/signs`. Por restricciones de tamaño, se omite el guardado automático de dicho contenido. Para más información acerca de la restauración del backup, consulte el siguiente epígrafe sobre [restauración manual de un backup de seguridad](#restauración-manual-de-un-backup-de-seguridad) ### 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á necesaria 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 "/tmp/data-import_/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 finalizar la recuperación del backup, también será necesario: * Copiar todo el contenido de la carpeta `/tmp/data-import_/backup/cfg` de nuevo en la carpeta de configuración del módulo Core `/core/cfg` * Copiar el fichero `/tmp/data-import_/backup/ks.pfx` en la carpeta `/sign/documents/` * Copiar todo el contenido de la carpeta `/tmp/data-import_/backup/certs` de nuevo en la carpeta de configuración de Connect `/server/certs` ## 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 todas 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: * Detalle de la configuración a importar * Información sobre las acciones realizadas sobre la Base de Datos de Connect para los diferentes modos de operación soportados. * Procesos análogos realizados para llevar a cabo el modo de operación, como la copia de los ficheros necesarios, el arranque de los servicios involucrados o la creación de un backup de seguridad * Información sobre la adaptación de la criptografía en los canales migrados * Información sobre la importación de datos en el sistema, así como posibles errores ocurridos en el proceso. * Información sobre otros ficheros de log relevantes para el proceso de importación. ### Información sobre la adaptación de la criptografía en los canales a migrar El log de la herramienta muestra la configuración final de criptografía aplicada para cada canal individual que se migra a Connect. Si un canal no tiene criptografía, se mostrará lo siguiente en el log: ``` [INFO] Canal 012345670-076543210-APLIC1 [ACTIVO]: Criptografia false ``` Si un canal tiene criptografía y todos los parámetros son adecuados para Connect, se mostrarán trazas similares a la siguiente: ``` [INFO] Canal 012345670-076543210-APLIC1 [ACTIVO]: Criptografia true; Version de criptografia 30; Cifrado FILE; Confidencialidad TD3; Autenticacion RSA; Claves de autenticacion: Local E, Remota E ``` Si alguno de los parámetros de criptografía es inválido para Connect, el log indicará algo similar al siguiente mensaje: ``` [INFO] Canal 012345670-076543210-APLIC1 [DESACTIVADO]: Criptografia true; Version de criptografia 30; Cifrado FILE; Confidencialidad TD3; Confidencialidad eliminada en transmision; Autenticacion DES; Claves de autenticacion: Local DES_LOCAL, Remota REMOTA_DES; Motivo desactivacion: Confidencialidad eliminada en transmision ``` Cabe mencionar que la criptografía versión 2.2 está descontinuada y los canales que contengan dicha configuración se deben migrar desactivados. Teniendo en cuenta esta regla, podrían aparecer trazas similares a las siguientes, donde se indica el motivo de la desactivación y las transformaciones aplicadas al canal: ``` [INFO] Canal 012345670-076543210-APLIC1 [DESACTIVADO]: Criptografia true; Version de criptografia 22; Cifrado FILE; Confidencialidad TD3; Autenticacion DES; Claves de autenticacion: Local ??????????????, Remota ??????????????; Claves inconsistentes o incompletas, se asignan claves ficticias; Motivo desactivacion: Version de criptografia 22 descontinuada. ``` ### Información sobre la creación de los canales en Connect El log de la herramienta también informa del estado general de la migración de los canales en Connect. Esta información indica si un canal individual pudo ser migrado correctamente al nuevo sistema o si surgió algún error derivado de la migración. Como ejemplo, las trazas de un canal creado correctamente serán similares a las siguientes: ``` [INFO] Migrando Canal: CANAL-EJEMPLO (012345670-076543210-APLIC1) [INFO] Canal creado correctamente [200] ``` Si la creación de un canal falló, las trazas indicarán el motivo concreto y el código de error correspondiente: ``` [INFO] Migrando Canal: CANAL-EJEMPLO (012345670-076543210-APLIC1) [INFO] Conflicto creando el canal [409]: Ya existe un canal con esa combinación Local/Remoto/Aplicación ``` Al finalizar el proceso de migración de canales, el log mostrará las estadísticas del proceso completo: ``` [INFO] Canales procesados: 532. Canales correctamente dados de alta: 520. Canales con error al dar de alta: 12. ``` ### Información sobre la migración de las claves RSA en Connect Del mismo modo que sucede con los canales, el log de la herramienta indica el estado de la migración de las claves RSA encontradas en el fichero de configuración `controlGC.cfg`. Si una clave se migró correctamente a Connect, se podrán ver trazas similares a la siguiente: ``` [INFO] Migrando clave RSA: 012345670-000000000-K [INFO] Clave RSA creada correctamente [200] ``` En cambio, si una clave falló en la migración, el log indicará el motivo y el código de error en una traza similar a la siguiente. En este caso concreto, el mensaje indica que no existe una clave privada para el código local indicado con subsistema H migrada previamente y no se puede asignar al canal de intercambio TELEGC: ``` [INFO] Migrando clave RSA: 012345670-076543210-H [INFO] Conflicto creando clave RSA [404]: RSA local key not found for localCode=000030010, subsystem=H ``` Al finalizar el proceso de migración de claves RSA, el log mostrará las estadísticas del proceso completo: ``` [INFO] Claves RSA procesadas: 31. Claves dadas de alta: 25. Claves con error al dar de alta: 6. Claves no migradas: 0 ``` ## Compendio de errores de ejecución Esta sección recoge los errores más comunes que pueden darse al ejecutar la herramienta de importación de datos. ### Ejecución de editran-import en Windows sin privilegios de administrador Este error indica que **editran-import** no se ha ejecutado desde una consola de comandos 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 ``` ### Ejecución de editran-import en RedHat sin autorización del usuario para administrar los servicios Este error indica que **editran-import** se ha ejecutado con un usuario que no tiene autorización 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:56: LINUX_SERVICES:182: LINUX_EXEC:106: error ejecutando systemctl start editran.protocol.server.service: exit status 1 EDITRAN-IMPORT-TOOL finalizado con errores ``` En el log de la herramienta se puede ver el detalle del comando y servicio que dio error: ```txt [INFO] 2026/05/13 11:09:33 iniciando servicio editran.protocol.server.service ... [INFO] 2026/05/13 11:09:33 [systemctl.log] Ejecucion de systemctl start editran.protocol.server.service [INFO] 2026/05/13 11:09:33 [systemctl.log] Failed to start editran.protocol.server.service: Interactive authentication required. [INFO] 2026/05/13 11:09:33 [systemctl.log] See system logs and 'systemctl status editran.protocol.server.service' for details. [INFO] 2026/05/13 11:09:33 Resultado [1] Comando [systemctl start editran.protocol.server.service] [ERROR] 2026/05/13 11:09:33 IMPORT_MANAGER:35: EMPTY_MODE:56: LINUX_SERVICES:182: LINUX_EXEC:106: error ejecutando systemctl start editran.protocol.server.service: exit status 1 ``` Para solventar este error, revise el anexo [Autorización del usuario editran](#autorización-del-usuario-editran-para-la-administración-de-los-servicios-en-redhat) ### 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 configuración 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. ### Servicio Editran Protocol no disponible Este error se puede encontrar al migrar un canal a Connect e indica que el servicio Editran Protocol Server no está en ejecución o está tardando demasiado en arrancar. ```txt [INFO] Migrando Canal: CANAL-EJEMPLO (012345670-076543210-APLIC1) [INFO] Conflicto creando el canal [409]: Los servicios de Editran no están en ejecución ``` Revise que el servicio Editran Protocol Server está arrancado o si existe algún problema, contacte con el equipo de soporte. ## Anexo ### Autorización del usuario editran para la administración de los servicios en RedHat 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 permiso de administración sobre los servicios del producto Editran Connect. La autorización de los privilegios se basa en Reglas de Polkit, donde Polkit es el mecanismo de autorización de sistemas operativos Linux que permite delegar permisos administrativos a usuarios sin otorgarles acceso root completo. El instalador del producto creará automáticamente un fichero de reglas llamado `50-editran-systemd.rules`, en la ruta del sistema `/etc/polkit-1/rules.d/`, con el administrador del sistema como propietario y con permiso exclusivo de lectura para el resto de usuarios del sistema operativo. En condiciones normales, el instalador del producto realiza esta configuración de forma automática. Si detecta errores de autenticación al usar la herramienta, compruebe que el fichero existe siguiendo los pasos de este apartado. La siguiente definición del fichero de reglas **permite autorizar al usuario `editran` a operar exclusivamente con los servicios de Connect definidos en la regla**. Su contenido es el siguiente: ```javascript polkit.addRule(function(action, subject) { // Solo permitir gestión de unidades systemd if (action.id !== "org.freedesktop.systemd1.manage-units") { return polkit.Result.NOT_HANDLED; } // Usuario autorizado if (subject.user !== "editran") { return polkit.Result.NOT_HANDLED; } // Lista blanca de servicios permitidos var allowedUnits = [ "editran.license.service", "editran.protocol.server.service", "editran.data.server.service", "editran.main.service", "editran.web.server.service", "editran.sign.service" ]; var unit = action.lookup("unit"); if (allowedUnits.indexOf(unit) !== -1) { return polkit.Result.YES; } return polkit.Result.NOT_HANDLED; }); ``` Es necesario que la instalación contenga este fichero de autorización previo a ejecutar la herramienta de importación. Si detecta algún error de autenticación del usuario al operar con la herramienta, compruebe que este fichero exista. Si no existe, será necesario crearlo manualmente. Para ello, siguiendo la definición citada anteriormente, se deberán ejecutar los siguientes comandos con un usuario administrador del sistema operativo: ```bash # Crear el fichero de reglas en la ruta indicada con un editor de texto sudo nano /etc/polkit-1/rules.d/50-editran-systemd.rules # pegar el contenido de la regla anterior y guardar el fichero con el editor seleccionado # Modificar los atributos del fichero de reglas indicando los permisos y el propietario específicos sudo chmod 0644 /etc/polkit-1/rules.d/50-editran-systemd.rules sudo chown root:root /etc/polkit-1/rules.d/50-editran-systemd.rules ``` --- # 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-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.