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

# Puesta en marcha Linux

Esta guía te ayudará en los pasos necesarios para ejecutar por primera vez la aplicación **Editran Connect** después de haber sido instalada correctamente en un sistema Linux.

***

## Requisitos previos

* La instalación se ha completado sin errores y **Editran Connect** esté instalado correctamente.
* Los servicios necesarios están correctamente instalados. Puedes verificarlo ejecutando:

```bash
sudo systemctl list-unit-files --type=service | grep editran
```

* Verifica, ejecutando:

```bash
  sudo systemctl list-units --type=service | grep editran
```

que los servicios requeridos para la ejecución inicial de **Editran Connect** están en funcionamiento:

* Editran Connect Base
* Editran Connect Data
* Editran Connect Server
* Editran Connect Sign

***

## Paso 1: Licencia

> ⚠️ Salta este paso si ya tienes un fichero de licencia válido.

**Editran Connect** 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).

1. Genera el fichero con el *HostID*. Puedes hacerlo ejecutando:

   ```bash
   sudo ./hostid -a > hostid.txt
   ```

   desde la línea de comandos en el directorio `/core/bin` de la instalación de **Editran Connect**.
2. El fichero generado tienes que enviarlo en un correo electrónico al equipo de soporte para que puedan generar tu licencia personalizada.
3. Cuando el equipo de soporte disponga de la nueva licencia generada, recibirás un correo electrónico con un archivo adjunto que debes descargar.
4. Es responsabilidad del administrador de **Editran Connect** proteger este fichero para que no se pueda modificar, ya que eso ocasionaría que el sistema dejase de funcionar.

***

## Paso 2: Copiar el fichero de licencia

> ⚠️ Salta este paso si ya indicaste el fichero de licencia durante la instalación.

1. El fichero debe copiarse en la carpeta `/core/bin/SL` de la instalación de **Editran Connect**, con el nombre `licencia.dat`. Si no existe, el sistema no funcionará correctamente.
2. Reinicia el servicio *Editran Servicio Licencia* ejecutando lo siguiente:

   ```bash
   sudo systemctl restart editran.sl.service
   ```

   Si no se reinicia, el servicio no funcionará correctamente.

***

## Paso 3: Inicio

A continuación, puedes iniciar la aplicación de las siguientes maneras:

* Abre un navegador web y escribe la URL `https://localhost:443/` o `https://<tu_dominio>:443/`.
* Si es la primera vez que accedes, es posible que el navegador te advierta sobre un certificado no válido. Acepta el certificado para continuar.

***

## Paso 4: Registro de la aplicación

Una vez iniciada la aplicación, se te mostrará una pantalla para introducir los datos de registro de la aplicación:

![Datos de registro](https://3859228011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-9142e583c1feeb06bee023d5164dd6c62fd0e1f1%2Fdatos_registro.png?alt=media)

* **Nombre**: Nombre del usuario.
* **Apellidos**: Apellidos del usuario.
* **Empresa**: Nombre de la empresa.
* **NIF**: NIF del usuario (opcional).

Haz clic en **Continuar** para continuar con el registro.

***

## Paso 5: Validación de la licencia

En esta pantalla, deberás introducir el código de activación que te ha proporcionado el equipo de soporte.

![Validación de la licencia](https://3859228011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-205baf7d4b7acf3c715948207ef44a71a8acd2c3%2Fvalidacion_licencia.png?alt=media)

Haz clic en **Verificar** para comprobar el código de activación. Si el código no es correcto, no existe el fichero de licencia o no es válido, se mostrará un mensaje de error. En este caso, verifica que el fichero de licencia es válido y se ha copiado en la carpeta `\core\bin\SL`, además comprueba que el servicio *Editran Servicio Licencia* esté en funcionamiento.

***

## Paso 6: Datos de acceso

Una vez validada la licencia, se te pedirá que introduzcas las credencias de acceso del primer usuario de la aplicación. Este usuario tendrá acceso completo a todas las funcionalidades de **Editran Connect**.

![Datos de acceso](https://3859228011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-44cf4a63aee062c6cc55a9c01fc589aaf807b5c9%2Fdatos_de_acceso.png?alt=media)

* **Correo electrónico**: Correo electrónico del usuario con el que accederá a la aplicación.
* **Contraseña**: Contraseña del usuario. Debe contener al menos 6 caracteres, una letra mayúscula, una letra minúscula, un número y un carácter especial.
* **Repetir contraseña**: Repite la contraseña para confirmarla.

Haz clic en **Terminar** para finalizar el registro. Si la contraseña no cumple con los requisitos, se mostrará un mensaje de error. En este caso, verifica que la contraseña cumpla con los requisitos establecidos.

***

## Paso 7: Entrada en la aplicación

A continuación, se te mostrará una pantalla de acceso a la aplicación. Introduce el correo electrónico y la contraseña del usuario que acabas de crear.

![Inicio de sesión](https://3859228011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-af602fb0d6dd72c109eb7856ae284d8c33d62448%2Finicio_de_sesion.png?alt=media)

* **Correo electrónico**: Correo electrónico del usuario.
* **Contraseña**: Contraseña del usuario.
* **Recuérdame**: Marca esta opción si deseas que la aplicación recuerde tu contraseña para futuros accesos.

Haz clic en **Iniciar sesión** para acceder a la aplicación.

***

## Paso 8: Configuración de la aplicación. Dirección IP

Una vez que hayas accedido a la aplicación, se te mostrará una pantalla para introducir los datos de la configuración local, en concreto de la dirección IP. Esta configuración es necesaria para que la aplicación funcione correctamente.

![Configuración de la aplicación. Dirección IP](https://3859228011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-2f3bd9d7a25d403a3e2143ef8cdf545359194a95%2Fconfiguracion_aplicacion_direccion_ip.png?alt=media)

Estos datos podrán ser modificados a través de la opción correspondiente dentro del menú *Configuración local* de la aplicación.

1. Introduce la dirección IP local y el puerto.
2. Haz clic en **Guardar** para guardar los datos de la configuración.

***

## Paso 9: Configuración de la aplicación. Código local

Por último, debes configurar el código local de la aplicación. Para ello debes acceder a la opción *Códigos locales* del menú *Configuración local* de la aplicación. Esta configuración es necesaria para que la aplicación funcione correctamente.

![Configuración de la aplicación. Código local](https://3859228011-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-376dcf1dc7b583bac97f4c06bfe5859502279027%2Fconfiguracion_aplicacion_codigo_local.png?alt=media)

1. Haz clic en **Nuevo código local** para crear un nuevo código local.
2. Introduce el código local y la descripción del mismo.
3. Haz clic en **Guardar** para guardar los datos del nuevo código local.
4. Inicia el servicio *Editran Servicio Base* ejecutando lo siguiente:

   ```bash
   sudo systemctl start editran.base.service
   ```

***

## Solución de problemas

#### 1. La aplicación no se inicia

Si la aplicación no se inicia, verifica lo siguiente:

* **Servicios**: Asegúrate de que los servicios requeridos para la ejecución inicial de **Editran Connect** estén correctamente instalados y en funcionamiento. Puedes verificarlo ejecutando:

```bash
 sudo systemctl list-units --type=service | grep editran
```

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 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 no hay un firewall 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.
* **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, dirección IP y código local.

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 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-3.2/instalacion/linux_inicio.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.