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

# Windows update

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

> If you come from a version earlier than 3.x of **Editran Connect** (Not from versions of Editran Open), after performing the update you must carry out the process detailed in the section **Post-Update** located further down on this page.

## Prerequisites

Before starting the update process, make sure that:

1. you have a version of **Editran Connect** installed before proceeding with the update.
2. If you're coming from 2.1.x or earlier, uninstall **Editran Core Connect**. This will avoid conflicts between both applications.
3. Verify that the user performing the update 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 updating **Editran Connect**, it is essential to make a full backup. This will ensure that you can restore the information in case any problem occurs during the process.

## Installation

The following describes the installation steps. The process is quite simple and quick to carry out.

## Step 1: Start

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

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

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://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-f7e6926484153267a47365f3796dbf6ec42340d4%2Fupgrade_seleccion_componentes.png?alt=media)

1. Some components are mandatory to update, which is why they appear checked and disabled.
2. Some components are recommended to update, which is why they appear checked and enabled.
3. It is recommended to leave the default selection if you are not sure which components to choose.
   * **Java**: Select this component if you need to update or reinstall the Java software.
   * **PostgreSQL**: Select this component if you need to update or reinstall the PostgreSQL database engine software.
   * **Nginx**: Select this component if you need to update 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 update or reinstall the signature module.
   * **Core**: Select the component **Prerequisites** to install the Microsoft Visual C++ redistributable packages required to install and configure the Editran Core module.
   * **Graphical interface**: Select this component to update the desktop version of the application. And select **Prerequisites** to install the Microsoft Visual C++ redistributable packages required for the graphical interface to work.
4. Click on **Next** to continue.

***

## Step 3: Notice

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

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

Click on **Next** to continue.

***

## Step 4: Configuration. Certificate

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

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

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

1. The application 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 with 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 enter the path and name manually.
4. Click on **Next** to continue.

***

## Step 5: License

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

![License file](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-89e1c092c2b85bddf2a863d31249ea42902f6333%2Ffichero_licencia.png?alt=media)

Click on **Next** to continue.

***

## Step 6: Summary

On this screen, you will be shown a summary of the installation that is going to be performed:

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

Among other things, the following information will be shown:

* Version to install
* Current installed version
* Installation type (Update)
* Directories
* ...

Click on **Next** to continue.

***

## Step 7: Confirmation

On this screen you will be told that everything is ready to carry out the installation:

![Ready to install](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-90b50d732b39578b97f0ba3216d2244544dc8cd8%2Fconfirmacion_instalacion.png?alt=media)

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

***

## Step 8: Installation in progress

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

![Backup copy](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-543166b0ba02a7b2a5bdc8bf232c11390219bfb7%2Fcopia_seguridad.png?alt=media)

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

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

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

1. Depending on the selected components, different screens will be shown during the installation process.
2. If you have selected the component **Core. Prerequisites** in the **Step 2**, you will be prompted to install the *Microsoft Visual C++ redistributable packages*, required for the installation and configuration of the Editran Core module.

   ![Installation of the Microsoft Visual C++ redistributable packages](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-2dbe347cf0e90626c57be3658d901c5d596565eb%2Finstalacion_paquetes_redistribuibles.png?alt=media)

   * Accept the license terms and click **Install to continue**, or **Close** if you do not want to install them.
   * Wait for the installation of the redistributable packages to finish and then click **Close** to continue with the installation of Editran Connect.
3. Likewise, if you have selected the component **Graphical interface. Prerequisites** in the **Step 2**, the *Microsoft Visual C++ redistributable packages* necessary for the correct functioning of the graphical interface will be installed. The installation process is identical to the one described in the previous point.
4. If the component **PostgreSQL** is selected in **Step 2**, and the installed PostgreSQL version is earlier than the version included in the installer, you will be asked whether you want to update PostgreSQL to the latest version.

   ![PostgreSQL version selection](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%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 updated.
5. 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 9: Installation completed

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

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

Click on **Finish**.

**Done!** Now you have the application **Editran Connect** updated.

## Post-Update

This section only affects us if we are coming from version 2.x or earlier of **Editran Connect**

In version 3.x, changes occur in the Editran protocol (5.3), along with a set of improvements to the product architecture. This requires that after updating from Editran Connect 2.x to Editran Connect 3.x, the data for P. must be regenerated.

The following process requires Connect to be updated to 3.x and the editran cfg folder to be empty (or, failing that, that there are no previous sessions), as well as the connect base services and editran-license running.

### Steps to follow

1. Run migraContacto -u, if the message "Local configuration updated" appears continue to the next step, otherwise review the backend log (editranConnect/logs/connect-back).
2. Run migraCanales -c, if the message "Channel update to DES/RSA completed successfully" appears continue to the next step, otherwise review the backend log
3. Run migraCanales -u, if the message "Channels registered in editranP" appears continue to the next step, otherwise review the backend log
4. Review the txt files in the core/log/migrar folder indicated above to see the changes that have arisen (if a file was not generated, it is probably because there were no changes to make)

If there are channels that have switched to RSA cryptography, they must be edited to add exchange keys; until then they will not work because they will give an incorrect RSA key error (a "?" placeholder is left).

If a contact had protocol version 4.1, all their channels will already have been registered with 5.0 in editranP.

Review integration scripts to stop using the old session alias and start using the local-remote-app code.

**Once everything has been migrated, the editran base service can be started.**

## Troubleshooting

### Errors during installation

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

* **Administrator permissions**: Run the installer with administrator privileges.
* **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, see the installation log file.

### The services do not start

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

* **User permissions**: Verify that the user starting the services has the necessary permissions.
* **Dependencies**: Make sure that all necessary 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 occupied by another service. You can use tools such as `netstat` to check the ports in use.
* **Firewall**: Check that the Windows firewall or any other third-party firewall is not blocking the ports used by the services.
* **Database configuration**: Verify that the database is correctly configured and accessible. Make sure the access credentials are correct and that the database server is running.
* **Software dependencies**: Verify that the *Microsoft Visual C++ redistributable packages* are correctly installed.
* **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.
* **License**: Verify that the license file (`license.dat`) is present and valid. This implies that the services *Editran License Service* and *Editran Connect Base* do 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, review 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` | `%USERPROFILE%\AppData\Local\Temp` |
| 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.

| **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 the requests of the V2 License 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-3.2-en/instalacion/windows_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.