> For the complete documentation index, see [llms.txt](https://docs.editran.onesait.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.editran.onesait.com/documentacion-editran/connect-v3.1/instalacion/windows_instalacion.md).

# Instalación Windows

Esta guía te ayudará a instalar **Editran Connect** en tu sistema operativo Windows, paso a paso.

***

## Requisitos previos

* **Sistema operativo**: Windows 10, Windows 11, Windows Server 2019 o superior.
* **Procesador**: x64 (64 bits)
* **Espacio en disco**: El espacio requerido por el software es de 1Gb, pero para su explotación y dependiendo del volumen de datos gestionado por la instalación, se recomienda un mínimo de 10Gb.
* **Memoria**: Para la ejecución será necesario un mínimo de 4GB de memoria RAM.
* **Servidor de correo electrónio**: Compatible con el protocolo simple de transferencia de correo (SMTP).
* **Certificado**: Certificado propio autofirmado en servidor para conexión web https (443 por defecto)
* **Permisos**: Usuario con permisos de administrador e iniciar servicios.

Si tienes instalada la aplicación **Editran Core Connect**, deberás desinstalarla antes de proceder con la instalación de **Editran Connect**. Esto evitará conflictos entre ambas aplicaciones. Se recomienda realizar una copia de seguridad completa de los datos, carpetas y archivos de **Editran Core Connect** antes de desinstalarlo.

***

## Instalación

A continuación, se describen los pasos de la instalación. El proceso es bastante sencillo y rápido de realizar.

## Paso 1: Inicio

Ejecuta el paquete de instalación que nos mostrará la siguiente pantalla de bienvenida:

![Inicio de la instalación](https://gitlab.devops.onesait.com/onesait/disruptors/ecosystems-editran/editran-documentation/-/blob/public/connect/3.1/instalacion/broken-reference)

Haz clic en **Siguiente** para comenzar con el proceso

***

## Paso 2: Directorio de instalación

El instalador te pedirá que selecciones el directorio donde deseas instalar la aplicación.

![Directorio de instalación](https://3624397791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-7900a7015c7e00cfab627e8e0ae6dfef454776c7%2Fdirectorio_instalacion.png?alt=media)

1. **Ruta predeterminada**: `C:\EditranConnect`.
2. Si prefieres un directorio diferente, haz clic en el icono y selecciona la nueva ubicación, o bien puedes escribirla.
3. Marca **Instalación personalizada (avanzada)** si deseas modificar alguno de los valores predeterminados de la instalación. En los pasos siguientes, se detallarán las opciones que puedes ajustar.
4. Haz clic en **Siguiente** para continuar. Si está marcado la **Instalación personalizada (avanzada)** continúa en el **Paso 3**, y en caso contrario continúa en el **Paso 8**.

***

## Paso 3: Selección de componentes (instalación personalizada)

En esta pantalla, podrás elegir qué componentes de la aplicación deseas instalar:

![Selección de componentes](https://3624397791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-10965883f4b4a094032014051d6ec369a53f1104%2Fseleccion_componentes.png?alt=media)

1. Algunos componentes son obligatorios, por ello aparecen marcados y deshabilitados.
2. Se recomienda dejar la selección por defecto, si no estás seguro de qué componentes seleccionar.
   * **Módulo de firma**: Selecciona este componente si necesitas instalar y configurar el módulo de firma. Y selecciona **Creación e inicialización** para crear y configurar los ficheros y herramientas de este módulo.
   * **Core**: Selecciona el componente **Requisitos previos** para instalar los paquetes redistribuibles de Microsoft Visual C++ necesarios para instalar y configurar el módulo Editran Core.
   * **Interfaz gráfica**: Selecciona este componente para instalar la versión escritorio de la aplicación. Y selecciona **Requisitos previos** para instalar los paquetes redistribuibles de Microsoft Visual C++ necesarios para el funcionamiento de la interfaz gráfica.
   * **Base de datos**: Selecciona el componente **Creación e inicialización** para crear e inicializar la base de datos.
3. Haz clic en **Siguiente** para continuar.

***

## Paso 4: Configuración. Puertos (instalación personalizada)

En esta pantalla, puedes modificar los puertos asignados por defecto a los distintos servicios de la aplicación:

![Configuración. Puertos](https://3624397791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-3c6850ef576c1e139f468f955b1b4b82dd911468%2Fconfiguracion_puertos.png?alt=media)

Si no estás seguro, se recomienda mantener los valores predeterminados. Sin embargo, si sabes que algún puerto está en uso, es conveniente cambiarlo.

Haz clic en **Siguiente** para continuar.

***

## Paso 5: Configuración. Base de datos (instalación personalizada)

En esta pantalla, puedes modificar las credenciales de acceso a la base de datos:

![Configuración. Base de Datos](https://3624397791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-facfc57d161922918123a72f71f5448e3a649adb%2Fconfiguracion_base_de_datos.png?alt=media)

Si deseas cambiarlas, ingresa un usuario y una contraseña (ambos son obligatorios). La contraseña debe coincidir con la confirmación, de lo contrario se mostrará un error.

Haz clic en **Siguiente** para continuar.

***

## Paso 6: Configuración. Certificado (instalación personalizada)

En esta pantalla, puedes seleccionar los archivos de un certificado propio autofirmado:

* **Certificado**: Archivo del certificado (.pem).
* **Clave del certificado**: Archivo de la clave privada (.key).

![Configuración. Certificado](https://3624397791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-c2ecdba9f0c522758c2d08d998a28d714e5b21d5%2Fconfiguracion_certificado.png?alt=media)

1. Esta información es opcional. Si no especificas un certificado, el instalador utilizará un certificado autofirmado provisional. Aunque es funcional, no tiene validez y deberá reemplazarse por un certificado SSL emitido por una autoridad certificadora.
2. Si deseas utilizar tu propio certificado, marca la opción **Especificar un certificado SSL** y selecciona los archivos correspondientes mediante el icono o introduce la ruta y el nombre manualmente.
3. Haz clic en **Siguiente** para continuar.

***

## Paso 7: Licencia (instalación personalizada)

En esta pantalla, puedes seleccionar el archivo de licencia (.dat) si lo tienes. Este paso es opcional.

![Fichero de licencia](https://3624397791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-89e1c092c2b85bddf2a863d31249ea42902f6333%2Ffichero_licencia.png?alt=media)

Haz clic en **Siguiente** para continuar.

***

## Paso 8: Resumen

En esta pantalla, se te mostrará un resumen de la instalación que se va a realizar:

![Resumen de la instalación](https://3624397791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-3c6db7d38c4ec88fd721734b9d0051aa9ae40417%2Fresumen_instalacion.png?alt=media)

Se mostrará, entre otras, la siguiente información:

* Versión a instalar
* Tipo de instalación (Normal)
* Directorios
* Espacio disponible y requerido
* Puertos
* ...

Haz clic en **Siguiente** para continuar.

1. Antes de comenzar el proceso de instalación, se realizan una serie de validaciones para verificar que los parámetros de la instalación sean correctos.
2. Si se detecta algún problema, como un puerto en uso, se mostrará un mensaje de error en pantalla.
3. Una vez identificados todos los problemas, si los hubiera, aparecerá la siguiente pantalla: ![Errores de validación](https://3624397791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-5c123e6962b564ef2aa3031fe1348f7d0d86cfff%2Ferrores_validacion.png?alt=media)
4. Si has marcado **instalación personalizada**, vuelve al **Paso 4**. De lo contrario, regresa al **Paso 2**, marca **Instalación personalizada (avanzada)** y corrige los valores incorrectos.

***

## Paso 9: Confirmación

En esta pantalla se te indicará que está todo listo para realizar la instalación:

![Listo para instalar](https://3624397791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-90b50d732b39578b97f0ba3216d2244544dc8cd8%2Fconfirmacion_instalacion.png?alt=media)

Haz clic en **Siguiente** para comenzar el proceso de instalación.

***

## Paso 10: Instalación en proceso

La instalación comenzará y se mostrará el progreso junto con los procesos en ejecución:

![Instalación en proceso](https://3624397791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-fa8919f71c74a8161f82608ce9e698e6664bbc35%2Finstalacion_en_proceso.png?alt=media)

1. Dependiendo de los componentes seleccionados, se mostrarán diferentes pantallas durante el proceso de instalación.
2. En el caso de que no hayas marcado **instalación personalizada** o, si lo hiciste, hayas seleccionado el componente **Base de datos. Creación e inicialización** en el **Paso 3**, se creará e inicializará la base de datos.

   ![Creación e inicialización de la base de datos](https://3624397791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-0d078a99700955770dd5b6a9a940b89873f84034%2Fcreacion_inicializacion_base_de_datos.png?alt=media)
3. En el caso de que no hayas marcado **instalación personalizada** o, si lo hiciste, hayas seleccionado el componente **Core. Requisitos Previos** en el **Paso 3**, se te pedirá instalar los *paquetes redistribuibles de Microsoft Visual C++*, necesarios para la instalación y configuración del módulo Editran Core.

   ![Instalación de los paquetes redistribuibles de Microsoft Visual C++](https://3624397791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-2dbe347cf0e90626c57be3658d901c5d596565eb%2Finstalacion_paquetes_redistribuibles.png?alt=media)

   * Acepta los términos de la licencia y haz clic en **Instalar para continuar**, o en **Cerrar** si no deseas instalarlos.
   * Espera a que finalice la instalación de los paquetes redistribuibles y luego haz clic en **Cerrar** para continuar con la instalación de Editran Connect.
4. Del mismo modo, si has marcado **instalación personalizada** y seleccionado el componente **Interfaz gráfica. Requisitos Previos** en el **Paso 3**, se instalarán los *paquetes redistribuibles de Microsoft Visual C++* necesarios para el correcto funcionamiento de la interfaz gráfica. El proceso de instalación es idéntico al descrito en el punto anterior.
5. Si los servicios no se inician correctamente, aparecerá un mensaje de advertencia. Consulta el apartado *Solución de problemas* para identificar la causa.

Espera a que el proceso termine.

***

## Paso 11: Instalación finalizada

Una vez finalizada la instalación, se mostrará una pantalla indicando que el proceso ha terminado

![Instalación finalizada](https://gitlab.devops.onesait.com/onesait/disruptors/ecosystems-editran/editran-documentation/-/blob/public/connect/3.1/instalacion/broken-reference)

Haz clic en **Terminar**.

**¡Listo!** Ahora tienes la aplicación **Editran Connect** instalada en tu sistema.

Se crearán accesos directos en el menú de inicio y en el escritorio para acceder a la aplicación.

***

## Solución de problemas

#### 1. Errores durante la instalación

Si encuentras algún error durante el proceso de instalación, verifica los siguientes puntos:

* **Espacio en disco**: Asegúrate de que haya suficiente espacio disponible para la instalación.
* **Compatibilidad del sistema**: Verifica de que tu sistema operativo y procesador sean compatibles.
* **Permisos de administrador**: Ejecuta el instalador con privilegios de administrador.
* **Antivirus o firewall**: Comprueba que tu antivirus o firewall no estén bloqueando la instalación. Si es necesario, desactívalos temporalmente durante el proceso.

Para obtener más información sobre el error, consulta el archivo de registro de la instalación (log).

#### 2. Los servicios no se inician

Si la instalación fue exitosa, pero los servicios no se inician, verifica lo siguiente:

* **Permisos de usuario**: Verifica que el usuario que inicia los servicios tenga los permisos necesarios.
* **Dependencias**: Asegúrate de que todos los servicios necesarios estén en funcionamiento. Por ejemplo, el servicio *Editran Connect Data* debe estar iniciado antes de iniciar el servicio *Editran Connect Base*.
* **Puerto en uso**: Confirma que el puerto 443 *(Editran Connect Server)* o 5432 *(Editran Connect Data)* no esté ocupado por otro servicio. Puedes utilizar herramientas como `netstat` para verificar los puertos en uso.
* **Firewall**: Comprueba que el firewall de Windows o cualquier otro firewall de terceros no esté bloqueando los puertos utilizados por los servicios.
* **Configuración de la base de datos**: Verifica que la base de datos esté correctamente configurada y accesible. Asegúrate de que las credenciales de acceso sean correctas y que el servidor de base de datos esté en funcionamiento.
* **Dependencias de software**: Verifica que los *paquetes redistribuibles de Microsoft Visual C++* estén correctamente instalados.
* **Conflictos de software**: Asegúrate de que no haya otros programas o servicios en conflicto con los servicios de **Editran Connect**. Comprueba que la aplicación **Editran Core Connect** está desinstalada.
* **Licencia**: Verifica que el archivo de licencia (`licencia.dat`) esté presente y sea válido. Esto implica que los servicios *Editran Servicio Licencia* y *Editran Connect Base* no se inicien.
* **Entorno local**: El servicio *Editran Connect Base* no se iniciará hasta que no esté configurado un entorno local en el módulo de *Editran Core*.

Para obtener más detalles sobre posibles errores, revisa los archivos de registro (log).

***

## Archivos de registro

A continuación, se muestra una tabla con los diferentes archivos de log, su descripción, nombre y ubicación.

| **Descripción**                                   | **Archivo(s)**                 | **Ubicación**                      |
| ------------------------------------------------- | ------------------------------ | ---------------------------------- |
| Registro de la instalación                        | `installbuilder_installer.log` | `%USERPROFILE%\AppData\Local\Temp` |
| Registro de inicio y estado de los servicios      | `*.out, *log`                  | `%INSTALL_DIR%\services\logs`      |
| Registro de errores y eventos de la base de datos | `logfile`                      | `%INSTALL_DIR%\data`               |
| Registro de errores y eventos de la aplicación    | `*.log`                        | `%INSTALL_DIR%\logs`               |
| Registro de errores y eventos del módulo Core     | `*.out, *log`                  | `%INSTALL_DIR%\core\log`           |
| Registro de errores y eventos de licencia         | `*.log`                        | `%INSTALL_DIR%\core\bin\SL\log`    |

***

## Servicios

A continuación, se muestra una tabla con los diferentes servicios de la aplicación, su descripción y las dependencias necesarias para iniciarse.

| **Nombre**                | **Descripción**                                | **Dependencias para iniciarse** |
| ------------------------- | ---------------------------------------------- | ------------------------------- |
| Editran Connect Base      | Servicios de Editran Connect                   | Editran Connect Data            |
| Editran Connect Data      | Servicio de base de datos para Editran Connect |                                 |
| Editran Connect Server    | Servidor web para Editran Connect              |                                 |
| Editran Connect Sign      | Servicios de firma para Editran Connect        | Editran Connect Data            |
| Editran Servicio Base     | Protocolo EDITRAN para transmision de ficheros | Editran Servicio Licencia       |
| Editran Servicio Licencia | Atiende las peticiones del API de Licencia V2  |                                 |

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.editran.onesait.com/documentacion-editran/connect-v3.1/instalacion/windows_instalacion.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
