> 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_instalacion.md). # Windows installation This guide will help you install **Editran Connect** on your Windows operating system, step by step. *** ## Prerequisites * **Operating system**: Windows 10, Windows 11, Windows Server 2019 or later. * **Processor**: x64 (64 bits) * **Disk space**: The space required by the software is 1 GB, but for its operation and depending on the amount of data managed by the installation, a minimum of 10 GB is recommended. * **Memory**: For execution, a minimum of 4 GB of RAM will be required. * **Email server**: Compatible with the Simple Mail Transfer Protocol (SMTP). * **Certificate**: Self-signed own certificate on server for https web connection (443 by default) * **Permissions**: User with administrator permissions and start services. If you have the application installed **Editran Core Connect**, you must uninstall it before proceeding with the installation of **Editran Connect**. This will avoid conflicts between both applications. It is recommended to make a full backup of the data, folders, and files of **Editran Core Connect** before uninstalling it. *** ## Installation The installation steps are described below. The process is quite simple and quick to perform. ## Step 1: Start Run the installation package, which will display 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 **Next** to begin the process *** ## Step 2: Installation directory The installer will ask you to select the directory where you want to install the application. ![Installation directory](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-7900a7015c7e00cfab627e8e0ae6dfef454776c7%2Fdirectorio_instalacion.png?alt=media) 1. **Default path**: `C:\EditranConnect`. 2. If you prefer a different directory, click the icon and select the new location, or you can type it in. 3. Check **Custom installation (advanced)** if you want to change any of the default installation values. In the following steps, the options you can adjust will be detailed. 4. Click **Next** to continue. If the **Custom installation (advanced)** continues in the **Step 3**, and otherwise continue in **Step 8**. *** ## Step 3: Component selection (custom installation) 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-10965883f4b4a094032014051d6ec369a53f1104%2Fseleccion_componentes.png?alt=media) 1. Some components are mandatory, so they appear checked and disabled. 2. It is recommended to leave the default selection if you are not sure which components to select. * **Signing module**: Select this component if you need to install and configure the signature module. And select **Creation and initialization** to create and configure the files and tools for this 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 install the desktop version of the application. And select **Prerequisites** to install the Microsoft Visual C++ redistributable packages required for the graphical interface to work. * **Database**: Select the component **Creation and initialization** to create and initialize the database. 3. Click **Next** to continue. *** ## Step 4: Configuration. Ports (custom installation) On this screen, you can modify the ports assigned by default to the different application services: ![Configuration. Ports](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-3c6850ef576c1e139f468f955b1b4b82dd911468%2Fconfiguracion_puertos.png?alt=media) If you are not sure, it is recommended to keep the default values. However, if you know that a port is in use, it is advisable to change it. Click **Next** to continue. *** ## Step 5: Configuration. Database (custom installation) On this screen, you can modify the database access credentials: ![Configuration. Database](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-facfc57d161922918123a72f71f5448e3a649adb%2Fconfiguracion_base_de_datos.png?alt=media) If you want to change them, enter a username and a password (both are required). The password must match the confirmation, otherwise an error will be displayed. Click **Next** to continue. *** ## Step 6: Configuration. Certificate (custom installation) On this screen, you can select the files for a self-signed own certificate: * **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. 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. 2. 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. 3. Click **Next** to continue. *** ## Step 7: License (custom installation) On this screen, you can select the license file (.dat) if you have it. 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 **Next** to continue. *** ## Step 8: Summary On this screen, you will be shown a summary of the installation to be performed: ![Installation summary](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-3c6db7d38c4ec88fd721734b9d0051aa9ae40417%2Fresumen_instalacion.png?alt=media) Among other things, the following information will be shown: * Version to install * Installation type (Normal) * Directories * Available and required space * Ports * ... Click **Next** to continue. 1. Before starting the installation process, a series of validations are performed to verify that the installation parameters are correct. 2. If any problem is detected, such as a port in use, an error message will be displayed on the screen. 3. Once all problems have been identified, if any, the following screen will appear: ![Errores de validación](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-5c123e6962b564ef2aa3031fe1348f7d0d86cfff%2Ferrores_validacion.png?alt=media) 4. If you have checked **custom installation**, go back to the **Step 4**. Otherwise, go back to the **Step 2**, check **Custom installation (advanced)** and correct the incorrect values. *** ## Step 9: Confirmation On this screen, you will be informed that everything is ready to perform 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 **Next** to start the installation process. *** ## Step 10: Installation in progress The installation will begin and the 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. In case you have not checked **custom installation** or, if you did, you have selected the component **Database. Creation and initialization** in the **Step 3**, the database will be created and initialized. ![Database creation and initialization](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-0d078a99700955770dd5b6a9a940b89873f84034%2Fcreacion_inicializacion_base_de_datos.png?alt=media) 3. In case you have not checked **custom installation** or, if you did, you have selected the component **Core. Prerequisites** in the **Step 3**, you will be asked to install the *Microsoft Visual C++ redistributable packages*, necessary for the installation and configuration of the Editran Core module. ![Installation of 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. 4. Likewise, if you have checked **custom installation** and selected the component **Graphical interface. Prerequisites** in the **Step 3**, the *Microsoft Visual C++ redistributable packages* necessary for the proper functioning of the graphical interface will be installed. The installation process is identical to the one described in the previous point. 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 11: Installation completed Once the installation is complete, a screen will be displayed indicating that the process has finished ![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 **Finish**. **Done!** You now have the application **Editran Connect** installed on your system. Shortcuts will be created in the start menu and on the desktop to access the application. *** ## 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 space available for the installation. * **System compatibility**: Verify that your operating system and processor are compatible. * **Administrator permissions**: Run the installer with administrator privileges. * **Antivirus or firewall**: Check that your antivirus or firewall is not blocking the installation. If necessary, disable them temporarily during the process. For more information about the error, consult the installation log file. #### 2. 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 being used 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 that 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 that there are no other programs or services conflicting with **Editran Connect**. Check that the application **Editran Core Connect** is uninstalled. * **License**: Verify that the license file (`licencia.dat`) is present and valid. This means 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, 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` | | Startup and service status log | `*.out, *log` | `%INSTALL_DIR%\services\logs` | | Database errors and events log | `logfile` | `%INSTALL_DIR%\data` | | Application errors and events log | `*.log` | `%INSTALL_DIR%\logs` | | Core module errors and events log | `*.out, *log` | `%INSTALL_DIR%\core\log` | | License errors and events log | `*.log` | `%INSTALL_DIR%\core\bin\SL\log` | *** ## Services Below is a table with the different services of the application, their description and the dependencies required to start them. | **First 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 | Signing services for Editran Connect | Editran Connect Data | | Editran Base Service | EDITRAN protocol for file transmission | Editran License Service | | Editran License Service | Handles License V2 API requests | | *** --- # 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_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.