> 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-en/instalacion/linux_actualizacion.md).

# Linux update

This guide will help you upgrade the version of **Editran Connect** on Linux, step by step. The upgrade can be performed to change versions or reinstall a component of the current version.

***

## Prerequisites

Before starting the upgrade process, you must make sure to:

1. have an installed version of **Editran Connect** before proceeding with the upgrade.
2. If you are coming from 2.1.x or earlier, uninstall **Editran Core Connect**. This will avoid conflicts between both applications.
3. Make sure that the user performing the upgrade has administrator permissions.

> It is recommended to make a full backup of the data, folders and files of **Editran Core Connect** before uninstalling it. Likewise, before upgrading **Editran Connect**, it is essential to make a full backup. This will ensure that you can restore the information if any problem occurs during the process.

***

## Graphical environment installation

The installation steps are described below. The process is quite simple and quick to carry out. Make sure you have a desktop environment installed (for example, GNOME, KDE).

## Step 1: Start

Run the installation package, which will show the following welcome screen:

![Installation start](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-6612b0906b09a0a3aacb6bb76c24cebe5f02421f%2Finicio_instalacion.png?alt=media)

1. Grant permissions to the installation file, if necessary:

   ```bash
   sudo chmod +x EditranConnect-3.0.x-linux-x64.run
   ```
2. Run the installer:

   ```bash
   sudo ./EditranConnect-3.0.x-linux-x64.run
   ```
3. Click on **Next** to begin the process

***

## Step 2: Component selection

On this screen, you can choose which application components you want to install:

![Component selection](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-4427ba19351ab1c14cbad9064ade5604582b4404%2Fupgrade_seleccion_componentes.png?alt=media)

1. Some components are mandatory to upgrade, so they appear marked and disabled.
2. Some components are recommended to upgrade, so they appear marked and enabled.
3. It is recommended to leave the default selection if you are not sure which components to select.
   * **Java**: Select this component if you need to upgrade or reinstall the Java software.
   * **PostgreSQL**: Select this component if you need to upgrade or reinstall the PostgreSQL database engine software.
   * **Nginx**: Select this component if you need to upgrade or reinstall the Nginx web server software, or if you need to change the SSL certificate.
   * **Signature module**: Select this component if you need to upgrade or reinstall the signing module.
4. Click on **Next** to continue.

***

## Step 3: Notice

On this screen, you will be informed that the installer detects a previous version of **Editran Connect** installed on the system. In addition, you will be told that the installation will upgrade the current version to the new version. Make sure you do not have any instance of **Editran Connect** open during the upgrade process.

![Upgrade notice](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-e4f8ebf6b1dca2e9e0823ad00612f897d06ce65d%2Fupgrade_aviso.png?alt=media)

Click on **Next** to continue. If the component **PostgreSQL** or **Nginx** is marked, continue to the **Step 4**, and if not continue in the **Step 5**.

***

## Step 4: Linux distribution

On this screen, you can select the Linux distribution you are using:

![Linux distribution](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-30ba2f0a3bebf03077f0b2ade0c7f89d190934bd%2Fdistribucion_linux.png?alt=media)

1. Select the Linux distribution you are using. If you are not sure, you can leave the default option.
   * **Debian**: For Debian-based distributions (Ubuntu, Mint).
   * **Red Hat**: For Red Hat-based distributions (Fedora, CentOS).
   * **Other distributions**: For other distributions not officially supported.
2. It is important to select the correct distribution, as this will affect the installation of the packages necessary for the application to work.
3. Click on **Next** to continue.

***

## Step 5: Configuration. Certificate

This screen will be available if the component **Nginx** is selected in the **Step 2**. Otherwise, this step will be skipped. You can select the files of your own self-signed certificate:

* **Certificate**: Certificate file (.pem).
* **Certificate key**: Private key file (.key).

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

1. The application's signing certificate will be updated.
2. This information is optional. If you do not specify a certificate, the installer will use a temporary self-signed certificate. Although it is functional, it is not valid and must be replaced by an SSL certificate issued by a certificate authority.
3. If you want to use your own certificate, check the option **Specify an SSL certificate** and select the corresponding files using the icon or type the path and name manually.
4. Click on **Next** to continue.

***

## Step 6: License

On this screen, you can select the license file (.dat) if you have one. This step is optional.

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

Click on **Next** to continue.

***

## Step 7: Summary

On this screen, a summary of the installation to be performed will be shown:

![Installation summary](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-174246cf1481f0944eb08613399597d0b79ebe4c%2Fupgrade_resumen_instalacion.png?alt=media)

Among others, the following information will be displayed:

* Version to install
* Installation type (Upgrade)
* Directories
* ...

Click on **Next** to continue.

***

## Step 8: Confirmation

This screen will indicate that everything is ready to perform the installation:

![Ready to install](https://gitlab.devops.onesait.com/onesait/disruptors/ecosystems-editran/editran-documentation/-/blob/public/connect/3.1/instalacion/broken-reference)

Click on **Next** to begin the installation process.

***

## Step 9: Installation in progress

Before carrying out the installation itself, a backup copy of the files and folders from the previous installation will be made.

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

The backup will be stored in a directory with the same name as the application directory, adding the .backup extension at the end. **Default path**: `/opt/EditranConnect.backup`.

Later, the installation will begin and the progress will be shown along with the running processes:

![Installation in progress](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-e1dcf5bfbc8d7433c32c84d8d07dece9a9b8d821%2Finstalacion_en_proceso.png?alt=media)

1. Depending on the selected components, different screens will be shown during the installation process.
2. If the component **PostgreSQL** is selected in the **Step 2**, and the installed PostgreSQL version is earlier than the version included in the installer, you will be asked whether you want to upgrade PostgreSQL to the latest version.

   ![PostgreSQL version selection](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-dfb14c90fc4b2344cfda371a7586bb3c6cab8925%2Fupgrade_postgresql.png?alt=media)

   * Make sure that the installed PostgreSQL version is compatible with your machine's operating system. If it is not compatible or you are not sure, select **No**.
   * If you select **Yes**, PostgreSQL will be upgraded.
3. If the services do not start correctly, a warning message will appear. See the section *Troubleshooting* to identify the cause.

Wait for the process to finish.

***

## Step 10: Installation completed

Once the installation is complete, a screen will be shown indicating that the process has finished

![Installation completed](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-727a5d6c8bbce4f1e1fff0a76bd51978991ff457%2Finstalacion_finalizada.png?alt=media)

Click on **Finish**.

**Done!** You now have the **Editran Connect** updated.

***

## Text-mode installation

The installation steps are described below. The process is quite simple and quick to carry out. Make sure you have a console or terminal environment available.

## Step 1: Start

1. Grant permissions to the installation file, if necessary:

   ```bash
   sudo chmod +x EditranConnect-3.0.x-linux-x64.run
   ```
2. Run the installation package. The parameter `--mode text` indicates that you want to perform the installation in text mode. It is not necessary if the system does not have a graphical environment:

   ```bash
   sudo ./EditranConnect-3.0.x-linux-x64.run --mode text
   ```
3. If you want to check the installation parameters, you can run the following command:

   ```bash
   sudo ./EditranConnect-3.0.x-linux-x64.run --mode text
   ```

***

## Step 2: Component selection

Next, you can choose which application components you want to install:

![Component selection](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-f8e0ad01fbae650c048a033e7734efd487b2f609%2Fupgrade_seleccion_componentes_text.png?alt=media)

1. Some components are mandatory, so they cannot be edited or selected.
2. Some components are recommended to upgrade, so they appear marked and enabled.
3. It is recommended to leave the default selection if you are not sure which components to select.
   * **Java**: Type **Y** in this component if you need to upgrade or reinstall the Java software.
   * **PostgreSQL**: Type **Y** in this component if you need to upgrade or reinstall the PostgreSQL database engine software.
   * **Nginx**: Type **Y** in this component if you need to upgrade or reinstall the Nginx web server software, or if you need to change the SSL certificate.
   * **Signature module**: Type **Y** in this component if you need to upgrade or reinstall the signing module.
4. Press **Enter** to continue, or type **N** if you want to modify the component selection.

## Step 3: Notice

Next, you will be informed that the installer detects a previous version of **Editran Connect** installed on the system. In addition, you will be told that the installation will upgrade the current version to the new version. Make sure you do not have any instance of **Editran Connect** open during the upgrade process.

![Upgrade notice](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-245140167699a6751a967e4e28118b11b4e59cb1%2Fupgrade_aviso_text.png?alt=media)

Press **Enter** to continue. If the component **PostgreSQL** or **Nginx** is selected, continue to the **Step 4**, and if not continue in the **Step 5**.

***

## Step 4: Linux distribution

Next, you can select the Linux distribution you are using:

![Linux distribution](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-3a3b3ce0eef5f8764bfe8154ffae1cc638a32355%2Fdistribucion_linux_text.png?alt=media)

1. Indicate the Linux distribution you are using. If you are not sure, you can leave the default option.
   * **Debian**: For Debian-based distributions (Ubuntu, Mint).
   * **Red Hat**: For Red Hat-based distributions (Fedora, CentOS).
   * **Other distributions**: For other distributions not officially supported.
2. It is important to select the correct distribution, as this will affect the installation of the packages necessary for the application to work.
3. Type the distribution number and press **Enter** to continue.

***

## Step 5: Configuration. Certificate

This information will be available if the component **Nginx** is selected in the **Step 2**. Otherwise, this step will be skipped. You can select the files of your own self-signed certificate:

* **Certificate**: Certificate file (.pem).
* **Certificate key**: Private key file (.key).

![Configuration. Certificate](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-a172a3c9eee67ba5fefabc91e43de4cfab9aa804%2Fconfiguracion_certificado_text.png?alt=media)

1. The application's signing certificate will be updated.
2. This information is optional. If you do not specify a certificate, the installer will use a temporary self-signed certificate. Although it is functional, it is not valid and must be replaced by an SSL certificate issued by a certificate authority.
3. If you want to use your own certificate, type **Y** in **Specify an SSL certificate**.
4. Press **Enter** to continue.
5. Then type the name and path of the certificate files.

***

## Step 6: License

Next, you can select the license file (.dat) if you have one. This step is optional.

![License file](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-b6b0f9b4e5672fb7fc7ed50431cb3b7e475c8982%2Ffichero_licencia_text.png?alt=media)

1. Type the name and full path of the license file, if you want to specify it.
2. Press **Enter** to continue.

***

## Step 7: Summary

Next, you will be shown a summary of the installation to be performed:

![Installation summary](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-c22bfe90f97a436d3e3bcf6417d0c6ec5269b427%2Fupgrade_resumen_instalacion_text.png?alt=media)

Among others, the following information will be displayed:

* Version to install
* Installation type (Upgrade)
* Directories
* ...

Press **Enter** to continue.

***

## Step 8: Confirmation

Next, you will be informed that everything is ready to perform the installation:

![Ready to install](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-93ff9aa22d966f4209e36ab797c83b26ee9e1a74%2Fconfirmacion_instalacion_text.png?alt=media)

1. Type **N** if you do not want to start the installation process.
2. Press **Enter** to continue.

***

## Step 9: Installation in progress

Before carrying out the installation itself, a backup copy of the files and folders from the previous installation will be made.

The backup will be stored in a directory with the same name as the application directory, adding the .backup extension at the end. **Default path**: `/opt/EditranConnect.backup`.

Later, the installation will begin and the progress will be shown along with the running processes:

![Installation in progress](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-b2e40503d069aa9fd90462d552df319cd43e1d03%2Finstalacion_en_proceso_text.png?alt=media)

1. If the component **PostgreSQL** is selected in the **Step 2**, and the installed PostgreSQL version is earlier than the version included in the installer, you will be asked whether you want to upgrade PostgreSQL to the latest version.

   ![PostgreSQL version selection](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-a91f54e8f3b2492a1ce02454eb6681a4c3a09537%2Fupgrade_postgresql_text.png?alt=media)

   * Make sure that the installed PostgreSQL version is compatible with your machine's operating system. If it is not compatible or you are not sure, type **N**.
   * If you type **Y**, PostgreSQL will be upgraded.
2. If the services do not start correctly, a warning message will appear. See the section *Troubleshooting* to identify the cause.

Wait for the process to finish.

***

## Step 10: Installation completed

Once the installation is finished, a message will be displayed indicating that the process has ended

![Installation completed](https://1190478111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-3cc8959c4d41e830c0193131dd755a4b7f467eb8%2Finstalacion_finalizada_text.png?alt=media)

**Done!** You now have the **Editran Connect** updated.

***

## Troubleshooting

#### 1. Errors during installation

If you encounter any errors during the installation process, check the following points:

* **Disk space**: Make sure there is enough available space for installation.
* **System compatibility**: Verify that your operating system and processor are compatible.
* **Administrator permissions**: Run the installer with superuser (root) permissions to avoid permission problems.
* **Antivirus or firewall**: Check that your antivirus or firewall is not blocking the installation. If necessary, temporarily disable them during the process.

For more information about the error, check the installation log file (log).

#### 2. The services do not start

If the installation was successful, but the services do not start, check the following:

* **Dependencies**: Make sure all required services are running. For example, the service *Editran Connect Data* must be started before starting the service *Editran Connect Base*.
* **Port in use**: Confirm that port 443 *(Editran Connect Server)* or 5432 *(Editran Connect Data)* is not being used by another service. You can use tools such as `netstat` to check the ports in use.
* **Firewall**: Check that there is no firewall blocking the ports used by the services.
* **Database configuration**: Check that the database is correctly configured and accessible. Make sure the access credentials are correct and that the database server is running.
* **Software conflicts**: Make sure there are no other programs or services conflicting with the services of **Editran Connect**. Check that the application **Editran Core Connect** is uninstalled.
* **Linux distribution**: Verify that the Linux distribution selected during the installation is correct.
* **License**: Verify that the license file (`license.dat`) is present and valid. This implies that the services *Editran License Service* and *Editran Connect Base* will not start.
* **Local environment**: The service *Editran Connect Base* will not start until a local environment is configured in the *Editran Core*.

For more details about possible errors, check the log files.

***

## Log files

Below is a table with the different log files, their description, name, and location.

| **Description**                 | **File(s)**                    | **Location**                    |
| ------------------------------- | ------------------------------ | ------------------------------- |
| Installation log                | `installbuilder_installer.log` | `/tmp`                          |
| Service startup and status log  | `*.out, *log`                  | `%INSTALL_DIR%/services/logs`   |
| Database error and event log    | `logfile`                      | `%INSTALL_DIR%/data`            |
| Application error and event log | `*.log`                        | `%INSTALL_DIR%/logs`            |
| Core module error and event log | `*.out, *log`                  | `%INSTALL_DIR%/core/log`        |
| License error and event log     | `*.log`                        | `%INSTALL_DIR%/core/bin/SL/log` |

***

## Services

Below is a table with the different application services, their description, and the dependencies required to start them.

| **Name**                | **Description**                          | **Dependencies to start** |
| ----------------------- | ---------------------------------------- | ------------------------- |
| Editran Connect Base    | Editran Connect services                 | Editran Connect Data      |
| Editran Connect Data    | Database service for Editran Connect     |                           |
| Editran Connect Server  | Web server for Editran Connect           |                           |
| Editran Connect Sign    | Signature services for Editran Connect   | Editran Connect Data      |
| Editran Base Service    | EDITRAN protocol for file transfer       | Editran License Service   |
| Editran License Service | Handles requests from the License V2 API |                           |

***


---

# 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-en/instalacion/linux_actualizacion.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.