> 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/open-v5.3/windows/instalacion.md). # Instalación ## Introducción Este documento proporciona el manual de instalación del Sistema Editran en entornos **Microsoft Windows**. Editran es una plataforma de comunicaciones, desarrollada por Indra, sobre redes de datos e Internet que posibilita la comunicación directa entre aplicaciones informáticas residentes en diferentes máquinas y sistemas operativos de diferentes empresas, organismos y entidades públicas o privadas. El documento describe los procesos que es necesario realizar para instalar y configurar el Sistema Editran. También se incluyen los procesos necesarios para actualizar una instalación a su siguiente versión oficial. El manual va dirigido a administradores de sistemas y se asume que el lector posee los conocimientos técnicos necesarios para realizar las tareas que en él se describen. ### Definiciones * **Presentación:** Conjunto de parámetros que en EDITRAN definen cada tipo de transmisión. * **EDITRAN/GC:** Módulo EDITRAN para el intercambio de claves RSA. ## Prerrequisitos ### Requisitos de hardware Las características hardware del equipo dependerán del nivel de carga de trabajo que se espere en cada despliegue del producto. Se da una configuración orientativa por tipos de instalación. #### Procesador Dada la diversidad de arquitecturas diferentes existentes para estos sistemas operativos, deben consultar con el fabricante de los equipos el que se adapte mejor a sus necesidades. En líneas generales el rendimiento del producto mejora con: * Mayor velocidad del procesador. * Mayor número de núcleos/hilos. #### Espacio HDD El disco necesario depende en gran parte del tamaño máximo de los ficheros transmitidos y del tiempo que se mantengan en el equipo. Al no conocerse de antemano, sólo se tienen en cuenta los siguientes factores: * Espacio necesario para el software Editran. Depende del SO, pero no supera los 30 MB. * Espacio necesario para datos de configuración del producto. Cada perfil de transmisión definido ocupa unos 35 KB. El total de transmisiones a configurar dependerá tanto del número de entidades con las que debamos comunicar como de los tipos de información intercambiada. Por tanto, para una instalación media (250 perfiles diferentes) habría que contar con 10 MB aproximadamente. * Espacio para ficheros temporales creados por Editran durante las transmisiones. Por cada transmisión se necesitará tener espacio en disco para el triple del volumen de datos transferidos. En la tabla se da un dimensionamiento recomendado según el uso que se vaya a hacer del producto, basado en el número máximo de transmisiones concurrentes y el volumen de los ficheros intercambiados. #### Dimensionamiento HDD | Carga | Nº Transmisiones | Tamaño Ficheros | Espacio HDD | | -------- | ---------------- | --------------- | ----------- | | Baja | 1 - 25 | 50 MB | 20 GB | | Estándar | 25 - 100 | 250 MB | 140 GB | | Alta | > 100 | 1 GB | > 300 GB | #### Comunicaciones * Tarjeta de red Ethernet para protocolo TCP/IP. #### Soluciones de escalabilidad y alta disponibilidad A nivel de infraestructuras para instalaciones que tengan estas necesidades se recomienda una solución de virtualización. Las implicaciones que tendría en el producto: * Para que esta solución proporcione capacidades de escalabilidad, habría que asociarla a la instalación de múltiples instancias Editran aisladas, cada una gestionando su grupo de transmisiones. * Es necesario instalar el componente Editran/PX que se configura para que enrute el tráfico entrante a la instancia que corresponda. ![diagrama alta disponibilidad](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-5bd33feb4560260eb74f676cf5342e35b8882e91%2Fdiagrama-virtualizacion.png?alt=media) ### Requisitos Software #### Sistemas Operativos soportados El software de Editran se distribuye para Sistemas Operativos de 64 bits y procesador basado en x64. Las versiones soportadas son: | Sistema Operativo | Notas | | ------------------- | -------------------------------------------------------------- | | Windows 10 | El soporte de Microsoft Windows 10 termina en Octubre del 2025 | | Windows 11 | | | Windows Server 2016 | | | Windows Server 2019 | | | Windows Server 2022 | | | Windows Server 2025 | Soportado a partir de la versión 5.2.1.8 | > Microsoft retira el soporte a Windows 10 el 14/10/2025 y dejará de ofrecer parches de seguridad de esta versión del sistema operativo. Tiene más información sobre el fin del soporte de Microsoft [aquí](https://www.microsoft.com/es-es/windows/end-of-support?msockid=1ab3235e9b356f2d2cc736f09a1e6e79\&r=1). A partir de esa fecha, en caso de incidencia con el producto Editran, el equipo le recomendará el upgrade del Sistema Operativo a una versión más moderna. #### Software adicional * Es necesario que esté instalado el paquete ***Microsoft Visual C++ 2015-2022 Redistributable (x86)***, el cual se puede incorporar en el proceso de instalación de Editran. ## Conectividad EDITRAN es un protocolo cliente/servidor. Para habilitar conexiones remotas desde cualquier otra entidad deberá disponer de acceso a Internet con una IP pública fija asignada y un puerto TCP abierto de entrada y/o salida (por defecto EDITRAN utiliza el puerto 7777). > Se recomienda que el equipo donde se instala EDITRAN esté en la red interna con una IP privada y la conexión a Internet se haga a través del módulo EDITRAN/PX, desarrollado como pasarela para añadir más seguridad a las comunicaciones TCP/IP en redes públicas. Para obtener más información de este componente, consulte su Manual de usuario. ## Instalación de Onesait Editran ### Instalación Para llevar a cabo la instalación debe seguir los siguientes pasos. Si lo que quiere realizar es la actualización de versión, diríjase al punto [Actualización de Versión](#actualizacion-de-version) antes de instalar. En todo el proceso de instalación/actualización debe usar un usuario administrador y tener permisos de edición tanto en el registro de Windows como en el programador de tareas. * Ejecutar el paquete de instalación de Editran/Windows. Se mostrará la siguiente pantalla debiendo pulsar el botón Siguiente si desea continuar con la instalación de Editran. ![paso 01 - instalación](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-840051e74b2ee57b05ce236e2970b096dd8aa3be%2Fimage4.png?alt=media) * Aparecerá una pantalla con la carpeta dentro de la cual se creará el directorio de instalación de Editran, pudiendo elegir una carpeta cualquiera o bien la que se propone por defecto; una vez decidido el directorio de instalación, pulse el botón Siguiente: ![paso 02 - instalación](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-72393a6e856417f2990d2fac6681560a6639e60e%2Fimage5.png?alt=media) * En esta pantalla se muestra la ruta completa de instalación de Editran. En esta misma ubicación se almacenarán los ficheros de configuración del producto y los ficheros temporales. Si desea configurar otra ruta para estos ficheros marque el check "Directorio de datos de configuración personalizado" y seleccione la carpeta deseada. Pulse el botón Siguiente: ![paso 03 - instalación](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-42365058cdc500951042e58afcac1cfe97297e7d%2Fimage6.png?alt=media) * Es necesario que esté instalado en el equipo el paquete redistribuible **Microsoft Visual C++**. Si no lo tuviera instalado, se debe marcar la opción ofrecida en la siguiente pantalla: ![paso 04 - instalación](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-aa1a8f3f0b8ad2f0ab5cbc5e3574f5abc9ec56c1%2Fimage7.png?alt=media) > Si desea realizar la instalación posteriormente, debe dejar el check desmarcado y utilizar el ejecutable ubicado en el subdirectorio `Editran\bin\vc160\vcredist_x86.exe`. * En la siguiente pantalla se solicita configurar la periodicidad de la [tarea de verificación de la integridad](#integridad-de-la-instalación) de esta instalación. ![paso 06 - instalacion](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-8a78baec77ef453207a234c643a6c1cb4e478a1b%2Fimage9.png?alt=media) * En la siguiente pantalla se ofrece la instalación del servicio de gestión de transmisiones. Solo se recomienda su instalación si dispone de la licencia específica para este módulo. ![paso 07 - instalacion](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-d5816bdd966d0fea40d4604e1dd5c15f263eda6b%2Fimage10.png?alt=media) * En esta pantalla se muestra un resumen de las carpetas donde se va a instalar Editran con el protocolo TCP/IP, teniendo la posibilidad de volver hacia atrás para modificar lo que se desee. ![paso 08 - instalacion](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-bd3d97dd3e77fa077e907fffabc950bf4ef545e1%2Fimage11.png?alt=media) Pulse Siguiente para comenzar el proceso de instalación. * Aparece la pantalla en la que se muestra el avance durante el proceso de instalación ![avance](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-75f50d06e61b09fc31904cdb4f9c1514d272cc3a%2Fimage12.png?alt=media) * Si se había marcado la opción de instalar el paquete redistribuible **Microsoft Visual C++** en este punto se mostrará la siguiente pantalla y deberá pulsar el botón **Instalar**:\ ![redistributables](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-0d8a622342936b2c6c0dc2d46d543f98f32a7173%2Fimage8.png?alt=media) Si su equipo ya tuviera el paquete instalado, aparecerá la siguiente pantalla y bastará con pulsar el botón **Cerrar** y el botón **Si** en la ventana emergente que se mostrará a continuación.\ ![redistributables](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-5820f4de7d26902f2da02c05defef702f594ec4b%2Fimage41.png?alt=media)\ ![redistributables](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-eda18b2c20177b3a421527694d6be960385ae062%2Fimage42.png?alt=media) * Una vez extraídos todos los componentes del paquete Editran, se notifica que la instalación ha terminado. ![paso 10](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-937b873731522f06db2623cf788c8eb55fe5ea09%2Fimage13.png?alt=media) * Si fuera necesario revisar la información de la instalación, esta queda registrada en un archivo de log en el directorio %Temp%. * Una vez finalizada la instalación de Editran, es posible consultar su versión y otra información de interés desde el Panel de control de Windows. ![paso 11 - instalacion](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-66b03e52c55019871f18b23b3156767ccdc1cdb6%2Fimage14.png?alt=media) * El proceso de instalación crea los ficheros de log que registran la actividad del sistema. Estos ficheros son cíclicos, y se dimensionan para 20.000 mensajes. Si el cliente necesitase un histórico mayor puede redimensionarlos ejecutando el comando **makelog** como se muestra en la imagen. Solo debe tener en cuenta que es necesario hacerlo con el servicio de Editran detenido. ![makelog](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-bd2aa92036649a83357cb12f1a0eb214723dc404%2Fimage15.png?alt=media) Desde el directorio de instalación de Editran también se puede obtener la versión completa del producto a través del comando **ediver**: ![ediver](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-717ee64fd272e04b2bd07126353a8ab5b7586e7a%2Fimage16.png?alt=media) ## Seguridad ### Bastionado del sistema operativo El bastionado es un proceso mediante el cual se implementan las medidas técnicas y organizativas necesarias para reducir las vulnerabilidades de un sistema. Desde Editran se recomienda lo siguiente: * Instalación de "**Security Compliance Toolkit and Baselines**" y configuración de las directivas de acuerdo con las especificaciones para el tipo de versión que provee Microsoft. * Uso de las **guías de bastionado de CCN sobre entornos Windows** (Serie 500). * Filtrado de servicios en el **firewall** de Windows. * Desactivación de servicios innecesarios, características de Windows, powershell, etc. * Se recomienda tener una partición para el uso temporal aparte del sistema. * Se deben configurar las actualizaciones para que, al menos las de seguridad, se instalen por defecto. * Se recomienda probar y evaluar en una VM (de preproducción, nunca de producción) el despliegue. Se pueden utilizar herramientas como [HardeningKitty](https://github.com/scipag/HardeningKitty) para revisar parte del bastionado. * Se recomienda la creación de un usuario no administrador para la gestión y ejecución del producto Editran. Este punto se describe con más detalle en el apartado [Ejecución en entorno seguro](#ejecución-en-entorno-seguro) ### Ejecución en entorno seguro Editran es una aplicación que solo transfiere la información, ni procesa ni recopila el contenido de los ficheros que transmite. Desde este punto de vista no existe el riesgo de exponer información sensible. No obstante, es recomendable que recursos como ficheros de configuración y logs, creados durante la actividad de la aplicación, no sean accesibles por cualquier usuario del equipo. Con este objetivo se dan recomendaciones para ejecutar el producto en un entorno seguro. El control de acceso que se propone para la carpeta de instalación del producto está basado en permisos de usuario y se explica en los siguientes pasos: 1. Crear una nueva cuenta como usuario con rol de administrador de Editran. En nuestro caso creamos uno genérico con el nombre del producto en el dominio del equipo. Si no fuera posible en la infraestructura del cliente, se debería asignar ese rol a un usuario determinado de la organización. 2. Se recomienda que dicho usuario tenga solo permisos de escritura en los ficheros y carpetas indispensables. 3. Una vez instalado el producto Editran, se modificarán los permisos de la carpeta Editran para restringir el acceso. Situado sobre la carpeta elegir la opción **Propiedades** y seleccionar la pestaña **Seguridad** en la ventana desplegada. En esta pestaña puede verse los permisos actuales de la carpeta, y pinchando en el botón Editar se abrirá una nueva ventana similar a la anterior que permite agregar y quitar usuarios, además de configurar permisos concretos para cada usuario. > Una configuración adecuada sería la propuesta en la imagen: solo autorizar con control total al usuario administrador de Editran, y opcionalmente al Administrador o grupo de Administradores del equipo.\* ![configuracion adecuada usuario](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-abe79790a69c6daffa45fb67b866bf792b2f0739%2Fimage17.png?alt=media) 4. Los binarios de Editran se instalan por defecto con la propiedad "solo lectura", no debe modificarse dicha propiedad.\* 5. El producto instala dos servicios que por defecto se configuran para que inicien sesión como Sistema local. Una vez cambiados los permisos habrá que modificar en **Propiedades** para que se inicien con la cuenta del usuario con permisos sobre la carpeta.\* ![servicios usuario](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-e21c9d33728f16cac0b8dbf757120524179513fc%2Fimage18.png?alt=media) 6. Por último, se recomienda que el usuario que inicia el servicio Editran no tenga permisos de Administrador. El no cumplir con esta recomendación puede significar una brecha de seguridad, y será responsabilidad del cliente controlar la integridad de los scripts que pueden configurarse en Editran como Programas de Usuario.\* ### Integridad de la instalación Tras la instalación de Editran, en el programador de tareas Windows queda configurada la **Tarea Integridad Editran** cuya misión es garantizar que los binarios de Editran no hayan cambiado desde su instalación, y, por tanto, que su ejecución es segura. ![programador de tareas](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-59aca80f709dd2bd30efd8b5be18e66c7d7b9260%2Fimage19.png?alt=media) Si la tarea de verificación detecta alguna inconsistencia, se generará un evento que se podrá consultar en el visor de eventos de Windows. De esta manera se pueden explotar estos registros y tomar las medidas oportunas si se detectan errores. ![visor de sucesos](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-17def742abbe26e7d0efa9ce5c66d3d90f158103%2Fimage20.png?alt=media) ### Firma de código Todo el código binario (ejecutables y DLLs) que la aplicación Editran distribuye se entrega firmado. El propósito es permitir a los usuarios finales y al sistema operativo comprobar que el código de programa procede del propietario correcto y que no se ha dañado accidentalmente o alterado de forma malintencionada. La firma Authenticode adjunta al código entregado un certificado digital que identifica a Editran como proveedor. Estos certificados son emitidos por entidades de certificación o CAs. En nuestro caso la entidad emisora raíz también es de producto, esto implica que en la verificación de la firma el usuario tiene que incluirla como CA de confianza ya que no está publicada en las listas que Windows proporciona. Formas de verificar la firma una vez instalado el software: Comprobando la firma de los programas desde el ***explorador de Windows***. Para ello, localizar cualquier archivo de la subcarpeta *«bin»* de Editran, y pulsar sobre él con el botón derecho para abrir la ventana ***Propiedades***. En la parte superior aparece una pestaña llamada ***Firmas digitales.*** Pulsamos sobre ella para ver la firma incluida: ![Propiedades Firma](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-5db9f4abe4b2808177c5ecd2102cc44a8d363ac2%2Fimage21.png?alt=media) Para ver en detalle una firma y poder verificar si ésta es realmente válida y no ha sido suplantada, lo que debemos hacer es seleccionarla y pulsar sobre el botón «Detalles». Así vamos a poder ver toda la información relacionada con esta firma digital y el certificado que identifica al firmante. ![Información Firma](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-34713badefc736444ff10dba54d67461db0e2aa4%2Fimage22.png?alt=media) El explorador permite la comprobación manual, pero hay herramientas que permitirían al usuario final automatizar un mecanismo de validación. Si está instalado el SDK de Windows se puede recurrir a una herramienta llamada SignTool que, desde CMD, nos permite comprobar la firma. ![verify editran](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-b51ae229de6f71b2aa0083e033e013d7eeab508f%2Fimage23.png?alt=media) En nuestro caso la verificación se realiza con la opción /pa para indicar que debe emplearse la Política de Verificación de Autenticación por Defecto. Si no se especifica, SignTool usa la Política de Verificación de los Drivers de Windows, y fallaría al exigir que la CA sea una entidad emisora reconocida. Si no tenemos el SDK instalado y no queremos instalarlo en el equipo, hay otras herramientas gratuitas disponibles. Por ejemplo, [Digicert Certificate Utility](https://www.digicert.com/es/support/tools/certificate-utility-for-windows). ### Licencia Una vez instalado adecuadamente, Editran requiere para su funcionamiento una licencia específica para cada ordenador dependiendo de un Hostid (código único de cada máquina donde esté instalado Editran). Para generar dicho Hostid puede: 1. Abrir la carpeta de accesos directos en el apartado de Programas del menú Inicio de Windows y ejecute **Licencia**. El programa mostrará en un Bloc de Notas el nuevo Hostid. Además, generará un fichero con fecha, con formato **hostid\_DD-MM-YY.txt**, en el directorio **bin** de la instalación de Editran. 2. Abrir el menú Editran/P, abrir la pestaña Archivo y pulsar en **Generar HostID**. Aceptar la pregunta que realiza y decidir un directorio para copiar el fichero **hostid.txt** resultante. 3. Si no pudiera abrir el menú Editran/P porque accede desde un equipo remoto o una máquina virtual, debe ir en modo comando a la carpeta **bin** de Editran y ejecutar el siguiente comando: > hostid -a > hostid.txt En cualquier caso, el fichero resultante con el **HostID** hay que enviarlo a la email de para que generemos la licencia correspondiente. También tiene que enviar el fichero **licencia.dat** de la versión anterior de Editran, si lo tuviera. Recibirá un correo electrónico con 1 archivo adjunto que debe descargar en el directorio **bin/SL**. Es responsabilidad del administrador de Editran proteger este fichero para que no se pueda modificar, ya que eso ocasionaría que el sistema dejase de funcionar. > *\*: Fichero de licencia con nombre extendido. Debe renombrarse como **licencia.dat** ## Instalación Editran/GT Para utilizar el servicio de Editran/GT, debe disponer previamente de una licencia válida con el módulo editrangt. Durante la instalación de Editran/Windows, el asistente ya ofrece la opción de instalar el servicio de Editran/GT. Si no se seleccionó en ese momento y desea instalarlo posteriormente, puede hacerlo siguiendo estas instrucciones. Para poder instalarlo como servicio debe ejecutar los siguientes comandos, ubicado en el directorio `bin/` de Editran con un Símbolo de Sistema (cmd.exe) ejecutado como Administrador: ```powershell EDItranGTServ.exe -install reg.exe FLAGS HKLM\SOFTWARE\EDITRAN\EditranGT SET DONT\_VIRTUALIZE /reg:32 ``` Se instalará un servicio llamado **EDItranGTServ**. En el apartado del Usuario, puede elegir que arranque con la cuenta de sistema local de Windows (local system) o definir un usuario específico; esta última opción sirve para cuando se necesiten permisos especiales en el tratamiento de los ficheros de las transmisiones de Editran (recursos de red con permisos limitados a ciertos usuarios, etc.). ## Sistema Editran ### Arranque y parada En los entornos Editran Windows se puede arrancar y parar el sistema de 3 maneras: #### Como Servicio Windows De esta forma Editran arranca como servicio de Windows, pudiendo arrancar a nombre de un usuario específico y no tener que estar en sesión. El nombre del servicio es: **Editran Servicio Base** Editran realmente consta de dos servicios: * **Editran Servicio Base** * **Editran Servicio Licencia** No obstante, dado que se instalan con una dependencia pre-configurada del Base respecto al de Licencia, bastará con arrancar el Base para que se desencadene el arranque de los dos servicios. Si lo arranca de esta manera, no se podrá usar el semáforo o el comando Editran; deberá usar las opciones correspondientes desde la ventana de Servicios de Windows (*services.msc*). En el apartado del Usuario, puede elegir que arranque con la cuenta de sistema local de Windows (Local System) o definir un usuario específico; esta última opción sirve para cuando se necesiten permisos especiales en el tratamiento de los ficheros de las transmisiones (recursos de red con permisos limitados a ciertos usuarios, etc.). **Parada** Si se quieren parar los dos servicios, se detendrá primero el servicio de Licencia, eligiendo si se para o no el Base cuando se haga la pregunta obligada por las dependencias. **Instalación/Desinstalación** En la instalación del producto los servicios se instalarán automáticamente. Para poder instalarlos o desinstalarlos posteriormente: * Ejecutar el comando correspondiente desde el directorio **bin** de Editran, con un *Símbolo del Sistema* (cmd.exe) ejecutado como Administrador * **SvcInstall** o **SvcUninstall**, según sea el caso > ***Nota**: Para eliminar el servicio, tendrá que cerrar la ventana de Servicios de Windows, si no, dependiendo de la versión de Windows, no se eliminará hasta que reinicie el equipo.* Si quiere que Editran se recupere de alguna caída anómala del servicio, deberá configurar de la siguiente manera el servicio de Editran en el apartado de Recuperación: ![Propiedades Servicio Editran](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-9df12d7f8a1b40a8e34d0230acde3d952c55684b%2Fimage24.png?alt=media) #### Desde el semáforo de los menús P y G (o las opciones Arrancar y Parar Editran de la pestaña Archivo) De esta forma Editran arranca los procesos necesarios para su funcionamiento a nombre del usuario que lo haya ejecutado. Por lo tanto, Editran usará los permisos de dicho usuario y, además, si se cierra sesión, Editran se detendrá. El semáforo en rojo significa que Editran está detenido; si está en verde, estará arrancado. Si Editran está arrancado como Servicio no se podrá utilizar el semáforo, apareciendo el siguiente mensaje: ![Error arranque semaforo](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-2b07a6259f02a13790f4f5651ebb079c53f0d229%2Fimage25.png?alt=media) #### Desde el comando Editran De esta forma Editran arranca desde comando los procesos necesarios para su funcionamiento. La sintaxis del comando es: ![comando arranque](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-e13c7a0bfdbdd89a64701c274856760194a9b21a%2Fimage26.png?alt=media) Tal como ocurre en la opción anterior, no se puede utilizar este método de arranque si se está usando el Servicio. ## Ajustes de configuración en registro de Windows En el proceso de instalación de Editran se crea una nueva clave en el registro de Windows cuyo path es *HKLM\SOFTWARE\ WOW6432Node\EDITRAN*. El único valor que se crea siempre es ***InstallPath*** con el directorio raíz de Editran. Sin embargo, hay otros valores que un usuario con permisos puede crear para establecer algunos ajustes de configuración que permiten parametrizar el comportamiento del sistema. Estos valores son: | Variable | Descripción | Tipo | Valores Admitidos | Valor por defecto | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ----------------------------------------------------------------- | ----------------------- | | **DataPath** | Directorio para los ficheros de datos de EDITRAN: configuración y ficheros temporales (tampones, estado, etc.). En esta versión existe la posibilidad de desligarlos del path de instalación del producto definiendo la ruta en la que los procesos buscan y guardan dichos ficheros. | REG\_SZ | Path existente y con permisos | el valor de InstallPath | | **LogLevel** | Determina el nivel de información de log que se registra durante las transmisiones. | REG\_DWORD |

1(info)
2(traza)
3(debug)

| info | | **GLogPresentacion** | Se creará este valor si se quiere que Editran registre la información en ficheros de log diferentes para cada *Presentación*. Dichos ficheros se guardan en la subcarpeta log, nombrada como \.log. | REG\_DWORD | Si no se define el valor, el fichero de log es único. | | | **GUpgrade** | Determina los parámetros que Editran pasa a los programas de usuario previos. Si se desarrollaron para versiones inferiores a 5.2.0, y no es posible su adaptación, se creará este valor para seguir trabajando en modo compatible. | REG\_DWORD |

0(parámetros estándar)
1(parámetros en modo compatible)

| modo estándar | | **Sleep** | En caso de ser necesario, permite ajustar el tiempo de demora al arrancar el servicio Base ya que para iniciarse correctamente es necesario que el servicio de Licencia esté activo. | REG\_DWORD | Número de segundos de demora | 3 (segundos) | | **ReportPath** | Este valor activa la funcionalidad opcional de creación de informes de ficheros transmitidos. | REG\_SZ | Path existente y con permisos | | | **ReportLevel** | Nivel de detalle en la generación de informes de ficheros. | REG\_DWORD |

0(básico)
1(extendido)

| básico | | **disableLogBackup** | Al arrancar Editran se realiza un backup de determinados ficheros de log. Esta variable del registro se encarga de deshabilitar esta funcionalidad. | REG\_DWORD | 0(backup de log activo), 1(backup de log inactivo) | backup de log activo | Es importante tener en cuenta lo siguiente: * Todos los valores de tipo REG\_DWORD indicados en esta tabla deben introducirse en base **decimal**.\ ![decimal](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-af239b0004a8a0eafc3a7079c45cc8b561baa2e6%2Fimage43.png?alt=media) * Si alguna clave no se crea en el Registro, **Editran** usará su valor por defecto. * El valor de las claves se aplica durante el arranque del servicio de Windows **Editran Servicio Base**. Por tanto, cualquier modificación realizada sobre ellas requiere reiniciar el servicio para que los cambios sean efectivos. ## Ajustes de configuración del Servidor de Licencia No es necesario hacer ningún ajuste en la configuración del servidor de licencia, salvo que se deseen establecer puertos de escucha diferentes a los que el servidor usa por defecto. Los parámetros configurables se encuentran en `bin\SL\App.conf` y son los siguientes: * **BASE** El instalador ya deja configurado este parámetro con la ruta `\bin\SL`. Es el directorio raíz del servicio de licencia y en él se generarán sus logs, informes, temporales, etc. ```txt # Dir BASE de la Aplicación BASE: /opt/editran/bin/SL ``` * **SL.PORTSRV** (opcional) Inclúyalo si desea usar un puerto de licencia distinto del predeterminado (**50777**). ```txt # SL (Servidor Licencia) #------------------------- SL.PORTSRV: 50777 ``` Si se personaliza, también se debe incluir en las variables de entorno la variable **LICSRV** en las variables de usuario del usuario que administra Editran, con el mismo puerto del punto anterior. ![variable de entorno LICSRV](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-e34c6f93bd878413fa8ef22123b2cad262de2bf5%2Fimage28.png?alt=media) * **FC.PORTSRV** (opcional) Inclúyalo si desea usar un puerto de facturación distinto del predeterminado (**50778**). ```txt # FC (Servidor Facturación) #--------------------------- # Día del mes que se genera el informe #DIAINF: 1 FC.PORTSRV: 50788 ``` Si se personaliza, también se debe incluir en las variables de entorno la variable **FACTSRV** en las variables de usuario del usuario que administra Editran, con el mismo puerto del punto anterior. ![variable de entorno FACTSRV](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-37f30bb6639c3199a5632df0a2c81bdcc4b4a4b7%2Fimage44.png?alt=media) * **DIAINF** (opcional, solo si la licencia tiene facturación) Sirve para elegir el día de generación del informe de resultados de facturación. Por defecto es el primer día de mes; solo hay que descomentarlo si desea otro día. ```txt # FC (Servidor Facturación) #--------------------------- # Día del mes que se genera el informe DIAINF: 2 ``` > Nota: No se deben utilizar los puertos reservados para Editran como puertos candidatos para el servidor de licencia. ## Actualización de versión ### Pasos previos Para la descarga de software y manuales de **Editran 5.3.x** acceda al [portal para clientes](https://www.onesait.com/editran/resources). En la pestaña **Recursos** se encuentra la última versión disponible y sus manuales. En todo el proceso de instalación/actualización debe usar un usuario administrador y tener permisos de edición tanto en el registro de Windows como en el programador de tareas. Si necesita ayuda puede ponerse en contacto con el grupo de soporte en: * Teléfono de soporte. - 91.480.80.80 * Dirección e-mail.- ### Versión origen 5.2.1.3 o superior Si la versión anterior es 5.2.1.3 o superior ya no es necesario desinstalar previamente. Al ejecutar el programa de instalación detectará que hay una versión previa instalada, y le guiará en la actualización. Para llevar a cabo la actualización en estos casos debe seguir los siguientes pasos. * Cerrar cualquier software de Editran (menup.exe, menug.exe, menugt.exe, editrangc.exe...). * Realizar una copia de seguridad del directorio de Editran de la versión anterior (sin borrar ni mover la carpeta original) * Ejecutar el paquete de instalación de Editran/Windows. Se mostrará la siguiente pantalla, debiendo pulsar el botón Siguiente si desea continuar con la actualización de Editran. ![actualización - paso 01](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-6889f03f661961a37b132b057143050993494ea4%2Fimage29.png?alt=media) * La siguiente pantalla muestra los datos de la instalación previa de Editran.\ Si la actualización requiere una migración de perfiles, se creará una carpeta de backup con los elementos necesarios para realizar este proceso posteriormente.\ Debe pulsar el botón Siguiente para poder continuar con la actualización de versión. ![actualización - paso 02](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-1345bbc7ef858a18e79ced0d1d2a74e696c94183%2Fimage30.png?alt=media) * Es necesario que esté instalado en el equipo el paquete redistribuible **Microsoft Visual C++**. Si no lo tuviera instalado, se debe marcar la opción ofrecida en la siguiente pantalla: ![redistributable](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-aa1a8f3f0b8ad2f0ab5cbc5e3574f5abc9ec56c1%2Fimage7.png?alt=media) > Se recomienda desinstalar los redistribuibles instalados en versiones anteriores a Editran 5.2.1.4 (Microsoft Visual C++ 2008 Redistributable). * En la siguiente pantalla se solicita configurar la periodicidad de la tarea de verificación de la integridad de esta instalación: ![actualización - paso 05](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-5d2e4bc3d676dcb5dd76dae04623b83bf6fd050e%2Fimage32.png?alt=media) * A continuación, se indica que el software está listo para su instalación, teniendo la posibilidad de volver hacia atrás para modificar lo que se desee: ![actualización - paso 06](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-9787423a5ab4b0ba6ce5bd398dce529a84a0eae2%2Fimage33.png?alt=media) * Al continuar con la actualización, se mostrará la pantalla con el avance del proceso: ![actualización - paso 07](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-4bc671f4034b8f94d703a6eaea1cdeb53961db81%2Fimage34.png?alt=media) * Si se había marcado la opción de instalar el paquete redistribuible **Microsoft Visual C++** en este punto se mostrará la siguiente pantalla y deberá pulsar el botón **Instalar**:\ ![redistributables](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-0d8a622342936b2c6c0dc2d46d543f98f32a7173%2Fimage8.png?alt=media) Si su equipo ya tuviera el paquete instalado, aparecerá la siguiente pantalla y bastará con pulsar el botón **Cerrar** y el botón **Si** en la ventana emergente que se mostrará a continuación.\ ![redistributables](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-5820f4de7d26902f2da02c05defef702f594ec4b%2Fimage41.png?alt=media)\ ![redistributables](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-eda18b2c20177b3a421527694d6be960385ae062%2Fimage42.png?alt=media) * Una vez extraídos todos los componentes del paquete Editran, se notificará su finalización. ![actualización - paso 08](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-4aeba31224fb99ab8448217e74943f2e6563494c%2Fimage35.png?alt=media) * Si fuera necesario revisar la información de la actualización, esta queda registrada en un archivo de log en el directorio %Temp%. > **Nota**: Si, tras una actualización a la versión 5.2.1.4 o superior, fuera preciso restaurar la versión anterior de Editran, el ejecutable **restore.exe** situado en el directorio de instalación del producto le permitirá hacerlo.\*\*Antes de ejecutarlo, debe cerrar cualquier software de Editran (menup.exe, menug.exe, menugt.exe, editrangc.exe...) y salir de cualquier programa que esté accediendo al directorio de instalación del producto. > > *No se recomienda realizar esta operativa salvo en situaciones muy puntuales y críticas.* ### Versión origen 5.2.0 o inferior Si se va a realizar la actualización en el mismo servidor en el que estaba instalada la versión anterior, deberá realizar previamente los siguientes pasos: * Detener los servicios de **Editran.** * Si tiene contratado el módulo Editran/GT, detener el servicio **EditranGTServ**. * Cerrar cualquier software de Editran (menup.exe, menug.exe, menugt.exe, editrangc.exe...). * Realizar una copia de seguridad del directorio de Editran de la versión anterior (sin borrar ni mover la carpeta original) * Desinstalar Editran: La desinstalación se debe realizar desde Agregar o Quitar Programas en el Panel de Control. Verificar que se han eliminado los servicios de la versión anterior. Si siguen apareciendo, desde el Símbolo del sistema de Windows (cmd.exe) ejecutado como administrador, debe utilizar los siguientes comandos: ```bash sc delete ediserv # Si tiene el módulo Editran/GT: sc delete editrangtserv ``` * Eliminar la carpeta original de Editran. * Comenzar la **instalación** del producto siguiendo el [apartado instalación](#instalación) de este manual. * Como punto importante de dicho apartado, colocar la licencia del producto (**licencia.dat**) en el subdirectorio **bin/SL** antes de continuar con la migración de la configuración. Si la nueva versión se va a instalar en un servidor diferente, el proceso de instalación es el mismo que se explica en el [apartado instalación](#instalación). Dado que es una actualización será necesario copiar al nuevo servidor los ficheros de configuración a migrar tal y como se explica en el siguiente apartado. #### Migrar configuración > Cuando tenga el producto licenciado, ejecute **bin/Migrar.exe** como Administrador para migrar toda la configuración de la versión anterior de Editran a la nueva. Primero debe elegir: * El ***directorio*** donde están los perfiles de la versión anterior de Editran. Si la actualización se realiza en el mismo servidor bastará con seleccionar la carpeta de backup de la versión anterior. Si se actualiza en un servidor diferente habrá que crear una carpeta y copiar allí los siguientes ficheros: | Versión origen | Carpeta origen datos | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Anterior a 520** |

- editranp.cfg
- editrang.cfg
- ckds.des
- √ con licencia editrangt
- editrangt.cfg
- √ con licencia rsa
- controlGC.cfg
- ckds.rsa

| | **520** |

- Carpeta cfg al completo
- bin/ckds.des

| | **Superior a 520** | - Carpeta **cfg** al completo | > ℹ️ *Nota:* En el caso de que la instalación origen sea 5.2.0, y se estuviese trabajando con un directorio de datos de configuración distinto al de la instalación, el directorio origen que debe introducir es en realidad el definido en la variable DataPath. Con una salvedad, antes de migrar deberá copiar en la carpeta DataPath el archivo bin/ckds.des de la instalación original.\_ * La ***versión*** de Editran origen de la migración (versión a la que corresponden los perfiles) * En versiones más antiguas podían existir perfiles para red X25 y X28; si marca la casilla de ***Sólo sesiones TCP*** sólo se migrarán las configuradas para TCP (es lo adecuado). > ℹ️ *Nota:* Si se marca, en el archivo migrar.out existirán mensajes de AVISO de las presentaciones de EDITRAN/G que no se habrán migrado al carecer de las sesiones de EDITRAN/P que usaban X25 o X28).\_ Pulse en el botón **Migrar** para comenzar la migración: Si el proceso termina correctamente aparecerán unos mensajes similares a los siguientes: ![Migración de perfiles editran](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-2770f173402f12e88ea854c3af8676ea4c8a3f8c%2Fimage36.png?alt=media) Pulse **Salir** para terminar la migración. Si aparecen errores, debe consultar los archivos de log **migrar.out** y **Migrar.log** (ubicados en el subdirectorio **log)**, y contactar con el Soporte Técnico de Editran solicitando un técnico de Windows para que se valoren dichos mensajes, ya que en la mayoría de los casos son mensajes de *aviso* debidos a validaciones entre versiones y que no afectan a la consistencia de los datos en la migración (son los registrados como "AVISO"). **Nota**: Si la instalación previa tenía perfiles con datos descatalogados en esta nueva versión, se mostrará un mensaje informativo. Una vez finalizada la migración debe adaptar los perfiles mencionados. ![Migración de perfiles editran](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-e52450a4deb6304948bd5bc84f1517199fb6bf9a%2Fimage40.png?alt=media) ### Adaptación de Programas de Usuario de versiones anteriores Si existen Programas de Usuario específicos que se ejecutan como procedimientos previos y posteriores a las transmisiones, deberá adaptarlos teniendo en cuenta los siguientes cambios. * En los programas previos a la transmisión la lista de parámetros es: Presentación, sentido, código local, código remoto y aplicación. * En los programas posteriores a la transmisión la lista de parámetros es: Presentación, sentido, código local, código remoto, aplicación y el path absoluto del fichero con la lista de los ficheros emitidos o recibidos. * Los programas posteriores sólo se ejecutan cuando la transmisión **finaliza con éxito**. En cualquier otro caso, incluidos los errores en el proceso de carga y descarga, se ejecutará el programa de **excepción**. * Se recomienda que estos scripts se dejen en **bin/utils**, para diferenciarlos del software del producto. * En la migración de la configuración se eliminan los Programas de Usuario por defecto de Editran en los previos (U\_PRVEMI y U\_PRVREC) y en los posteriores (U\_PSTEMI y U\_PSTREC) de cada presentación, a no ser que tuviera definidos unos propios. Si había modificado esos Programas de Usuario por defecto, recomendamos que les defina un nombre distinto, los deposite en el subdirectorio **bin/utils** y los configure en las presentaciones que le interese. En la siguiente tabla se indican los argumentos de cada tipo de Programa de Usuario: | Variable | Excepción | Previo | Posterior | | -------- | --------------------------------- | ----------------------- | ------------------------------------------------------ | | 0 | Nombre del programa | Nombre del programa | Nombre del programa | | 1 | Presentación | Presentación | Presentación | | 2 | Emisión (E) o Recepción | Emisión (E) o Recepción | Emisión (E) o Recepción | | 3 | Resultado transmisión (4 dígitos) | Código Local | Código Local | | 4 | Código Local | Código Remoto | Código Remoto | | 5 | Código Remoto | Aplicación | Aplicación | | 6 | Aplicación | | Ruta del fichero con la lista de ficheros transmitidos | En la actualización de versión, se deja preparado el entorno de producción para trabajar con los Programas de Usuario de versiones anteriores, aunque se recomienda su adaptación al nuevo formato. En líneas generales los cambios a realizar en este proceso son: * Si en sus scripts se están utilizando los argumentos con que los invoca Editran, adaptar los valores necesarios a los de la versión actual (Por ejemplo, si utilizaba el valor 4 para recoger el Código local en un programa de usuario Posterior a recepción, deberá cambiarlo por el 3.). * Eliminar el valor de Registro de Windows con nombre **GUpgrade** en la clave `HKEY_LOCAL_MACHINE\\SOFTWARE\\WOW6432Node\\EDITRAN` * Si tuviera arrancado el servicio de Editran, reiniciarlo para que se apliquen los cambios. #### Scripts de usuario en modo compatible con versiones anteriores No recomendamos usar esta opción, pero existe la posibilidad de indicar que se van a usar scripts que esperan los parámetros de entrada de versiones anteriores. Para hacerlo hay que crear el valor DWORD en el Registro de Windows con nombre **GUpgrade** y valor 1 en la clave `HKEY_LOCAL_MACHINE\\SOFTWARE\\WOW6432Node\\EDITRAN` La siguiente tabla muestra los argumentos de cada tipo de programa de usuario en función de la presencia o ausencia de GUpgrade: | Variable | Excepción |

Previo
SIN GUpgrade

|

Previo
CON GUpgrade

|

Posterior
SIN GUpgrade

|

Posterior
CON GUpgrade

| | -------- | --------------------------------- | ----------------------------- | ----------------------------- | ------------------------------------------------------ | ------------------------------------------------------ | | 0 | Nombre del programa | Nombre del programa | Nombre del programa | Nombre del programa | Nombre del programa | | 1 | Presentación | Presentación | Presentación | Presentación | Presentación | | 2 | Emisión (E) o Recepción (R) | Emisión (E) o Recepción (R) | Emisión (E) o Recepción (R) | Emisión (E) o Recepción (R) | Emisión (E) o Recepción (R) | | 3 | Resultado transmisión (4 dígitos) | Código Local | RESULTADO | Código Local | RESULTADO | | 4 | Código Local | Código Remoto | Código Local | Código Remoto | Código Local | | 5 | Código Remoto | Aplicación | Código Remoto | Aplicación | Código Remoto | | 6 | Aplicación | | Aplicación | Ruta del fichero con la lista de ficheros transmitidos | Aplicación | | 7 | | | | | Ruta del fichero con la lista de ficheros transmitidos | ## Errores frecuentes ### Durante la Instalación #### No ha sido posible crear el servicio Editran Servicio Licencia Este error se produce cuando el usuario que realiza la instalación no tiene los permisos necesarios para crear la configuración de Editran en el registro de Windows. ### En la Migración #### No se ha registrado la versión migrada Si aparece este mensaje de error, el problema se debe a que el proceso de migración no tenía permisos para escribir una configuración necesaria en el registro de Windows. ![variables erroneas](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-70636696bc945a41b0fa636e8f982b3ee8f0342b%2Fimage37.png?alt=media) Podría ejecutar de nuevo la migración ejecutando el proceso con la opción de Ejecutar como Administrador, aunque basta con crear en el registro de Windows la entrada **GUpgrade** con el valor de la versión migrada. ![error en registro](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-442abe3fe7405f478f0cf8c318a5e2f9b41aeeeb%2Fimage38.png?alt=media) #### No existe **controlgc.cfg** Aunque aparece siempre como ERROR, debe ignorarse si no tenía licencia **rsa** en la versión migrada. ![variables erroneas](https://3256837847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiQfLim2uDaLOZRkgWkOk%2Fuploads%2Fgit-blob-dd710de5a3c8c45ebe3b69eb2ac0eefed11f486b%2Fimage39.png?alt=media) --- # 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/open-v5.3/windows/instalacion.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.