Installation

Overview

This section explains how to install a new Etendo environment. It includes:

Tutorial about the Etendo installation.
The steps to install Etendo.

Tutorial

Requirements

This section outlines the System Requirements.

Info

The Docker Management module allows for the distribution of the infrastructure needed to configure Etendo Classic within Etendo modules, which include Docker containers for each service. Specifically, the Docker Management module includes the PostgreSQL Database Service and the Dockerized Tomcat Service module. If these containers are used, the services must be launched, and then follow with the installation guide.

PostgreSQL Configuration

Check this article to configure PostgreSQL correctly: PostgreSQL Configuration

Install Etendo

JAR Format Source Format ISO

Steps to Install Etendo in JAR Format

Clone Etendo Base project in a temporal directory.

cd /tmp
git clone https://github.com/etendosoftware/etendo_base.git EtendoERP

Copy the sources in /opt/EtendoERP folder.

mv EtendoERP/* /opt/EtendoERP/
cd /opt/EtendoERP

Modify the gradle.properties file with your GitHub Credentials. Create the credentials by following this guide.

nexusUser=
nexusPassword=
githubUser= username
githubToken=*******

context.name=etendo

bbdd.sid=etendo
bbdd.port=5432
bbdd.systemUser=postgres
bbdd.systemPassword=syspass
bbdd.user=tad
bbdd.password=tad

org.gradle.jvmargs=-Dfile.encoding=UTF-8

Change the build.gradle file, uncomment the core dependency in the dependencies section:
```
implementation('com.etendoerp.platform:etendo-core:<version>')
```
Info

To know the available versions of Etendo Classic, please visit the Release Notes page.

Modify the gradle.properties file with your environment variables, if it is necessary:

nexusUser=
nexusPassword=
githubUser= username
githubToken=*******

context.name=etendo

bbdd.sid=etendo
bbdd.port=5432
bbdd.systemUser=postgres
bbdd.systemPassword=syspass
bbdd.user=tad
bbdd.password=tad

Dependencies
```
./gradlew dependencies
```
Setup
```
./gradlew setup
```
Installation
```
./gradlew install smartbuild
```
Start the Tomcat, in case of Linux you can run:
```
sudo /etc/init.d/tomcat start
```
Note

If you want to run Etendo locally, go to Run Etendo Development Environment.
Open your browser in https://<Public server IP>/<Context Name>

Steps to Install Etendo in Sources Format

Clone Etendo Base project in a temporal directory.

cd /tmp
git clone https://github.com/etendosoftware/etendo_base.git EtendoERP

Copy the sources in /opt/EtendoERP folder.

mv EtendoERP/* /opt/EtendoERP/
cd /opt/EtendoERP

Modify the gradle.properties file with your GitHub Credentials. Create the credentials by following this guide.

nexusUser=
nexusPassword=
githubUser= username
githubToken=*******
context.name=etendo

bbdd.sid=etendo
bbdd.port=5432
bbdd.systemUser=postgres
bbdd.systemPassword=syspass
bbdd.user=tad
bbdd.password=tad

org.gradle.jvmargs=-Dfile.encoding=UTF-8

By default, the latest core version available will be expanded but if there is a need to change it, edit the build.gradle file changing the coreVersion = "(<version>,<version>)".
```
etendo {
    coreVersion = "<version>"
}
```
Info

To know the available versions of Etendo Classic, please visit the Release Notes page.
Expand Etendo Base
```
./gradlew expand 
```

Modify the gradle.properties file with your environment variables, if it is necessary:

context.name=etendo

bbdd.sid=etendo
bbdd.port=5432
bbdd.systemUser=postgres
bbdd.systemPassword=syspass
bbdd.user=tad
bbdd.password=tad

Setup: to apply or create the initial configurations
```
./gradlew setup
```
Installation: Create the database, compile the sources and deploy to Apache Tomcat
```
./gradlew install smartbuild
```
Make sure you have the following PostgreSQL configuration in your postgresql.conf, this file is located wherever you have postgresql installed
```
lc_numeric = 'en_US.UTF-8'
max_locks_per_transaction = 128
```
Note

After modifying the file restart postgresql
Start the Tomcat, in case of Linux you can run:
```
sudo /etc/init.d/tomcat start
```
Note

If you want to run Etendo locally, go to Run Etendo Development Environment.
Open your browser in https://<Public server IP>/<Context Name>

Steps to Install the ISO with Internet Connection

Download the ISO from the release notes page.
Burn the ISO image into a USB stick. It is recommended to use balenaEtcher on Linux and Rufus on Windows. Alternatively, you can begin with your preferred virtualizer.
Start the system using the ISO image. You will be prompted:
- Network Connections: Verify that you are on a network with an internet connection and that an IP address is correctly assigned to your server.
- Guide Storage Configuration: Select the disk where you want to run the installation. If you only have one disk, proceed to the next step.
- Storage Configuration: Same as the previous step.
- Profile Setup: Enter your name, the server's name, and the user etendo with the password of your choice.
Wait for the operating system installation and server upgrade to take place. When prompted, select reboot now.
After the restart, the final server configuration will begin. Wait for it to finish, and the server will be ready.

Steps to Install the ISO without Internet Connection

If you do not have an internet connection during installation, follow these additional steps:

Follow the same procedure outlined in the previous section, Steps to Install the ISO with Internet Connection up to the network configuration stage.
- Network Configuration: In this section, if you do not have an internet connection, select Continue without internet.
After the operating system installation is complete, restart the server as prompted.
Log in to the server using the username and password you configured during installation.
Configure the network settings as desired to establish an internet connection.
Once connected to the internet, log in as the superuser: sudo su.
Begin the installation process by running the command: etendo-install.
After the installation is finished, the server will be ready for use.