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
Steps to Install Etendo in JAR Format
-
Clone Etendo Base project in a temporal directory.
-
Copy the sources in
/opt/EtendoERP
folder. -
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=-Xmx2g -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
-
Change the build.gradle file, deleting core version section and uncomment the core dependency in the dependencies section The following code is an example, you must modify your current file
plugins { id 'java' id 'war' id 'groovy' id 'maven-publish' id 'com.etendoerp.gradleplugin' version 'latest.release' } // Delete this section // etendo { // coreVersion = "[<version>,<version>)" // } dependencies { /* To use Etendo in JAR format delete the Etendo section and uncomment the following line. Then when executing any gradle command the core will be dynamically downloaded as a dep> Set up the credentials in gradle.properties file */ implementation('com.etendoerp.platform:etendo-core:<version>') //Add other dependencies bellow }
-
Modify the
gradle.properties
file with your environment variables, if it is necessary: -
Dependencies
- Setup
- Installation
-
Start the Tomcat, in case of Linux you can run:
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.
-
Copy the sources in
/opt/EtendoERP
folder. -
Modify the
gradle.properties
file with your GitHub Credentials. Create the credentials by following this guide. -
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 thecoreVersion = "(<version>,<version>)"
. The following code is an example, you must modify your current fileplugins { id 'java' id 'war' id 'groovy' id 'maven-publish' id 'com.etendoerp.gradleplugin' version 'latest.release' } etendo { coreVersion = "<version>" } dependencies { /* To use Etendo in JAR format delete the Etendo section and uncomment the following line. Then when executing any gradle command the core will be dynamically downloaded as a dep> Set up the credentials in gradle.properties file implementation('com.etendoerp.platform:etendo-core:<version>') */ //Add other dependencies bellow }
-
Expand Etendo Base
-
Modify the
gradle.properties
file with your environment variables, if it is necessary: -
Setup: to apply or create the initial configurations
- Installation: Create the database, compile the sources and deploy to Apache Tomcat
-
Make sure you have the following PostgreSQL configuration in your
postgresql.conf
, this file is located wherever you have postgresql installedNote
After modifying the file restart postgresql
-
Start the Tomcat, in case of Linux you can run:
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.