Upgrade Etendo to Any Version

Overview

This guide explains how to upgrade your Etendo environment to the latest version, or any version you want.

Upgrade Etendo

Warning

In case of upgrading the Core to 23.1.0 or newer, you must run ./gradlew wrapper --gradle-version 7.3.2 to upgrade the Gradle version.

Warning

In case of upgrading the Core from Etendo 21Q4.X, you must remove the modules com.smf.securewebservices, com.smf.smartclient.boostedui, com.smf.smartclient.debugtools, as they are distributed in the Core.

Warning

From Etendo 22Q1, the Nexus credentials should not be required interactively. You must set them in the gradle.properties file, since Gradle resolves and checks dependencies periodically. githubUser=USER > githubToken=TOKEN

Resolving the Etendo Gradle Plugin

From Etendo 22Q1, Etendo uses a standard gradle plugin to execute all the gradle tasks. To work with the plugin you need to specify in the root project from where the plugin will be resolved.

Update the settings.gradle file with the next content.

settings.gradle

pluginManagement {
    repositories {
        mavenCentral()
        gradlePluginPortal()
        maven {
            url 'https://maven.pkg.github.com/etendosoftware/com.etendoerp.gradleplugin'
            credentials {
                username "${githubUser}"
                password "${githubToken}"
            }
        }
        maven {
            url 'https://repo.futit.cloud/repository/maven-public-snapshots'
        }
    }
}

// Add modules subprojects
new File("${this.rootDir}/modules").listFiles().each {
    if (it.directory && new File(it, 'build.gradle').exists()) {
        include(":modules:${it.name}")
    }
}

rootProject.name = "etendo"

Add in the build.gradle file the Etendo Gradle Plugin Version compatible with your core version. For example, for version 1.5.0:
build.gradle
```
plugins {
    id 'com.etendoerp.gradleplugin' version '1.5.0'
}
```

Delete if the old plugin exists removing the "apply from" line:

Terminal

apply from: 'https://repo.futit.cloud/repository/static-public-releases/com/etendo/etendo/latest/etendo-latest.gradle'

JAR CoreSource Core

Warning

If you upgrade from a source Etendo instance, read Core Format Migration, because some directories must be deleted.

Create a backup of your environment, following the Etendo Backup and Restore Tool.

Verify the target version inside build.gradle

build.gradle

dependencies {
implementation('com.etendoerp.platform:etendo-core:<version>')
}

Compile your environment:

Terminal

./gradlew update.database compile.complete smartbuild

Verify any compilation errors that may arise due to incompatible customization or modifications.

Success

Your Etendo environment is now updated!

Verify the target version inside build.gradle. For example, for versions 23.1.x;
build.gradle
```
// latest.release will download the most recent stable version (Not recommended)
// Any other Gradle/Maven version sintax works, for example : [22.1.0,)
etendo {
    coreVersion = "[22.1.0,23.2.0)"
}
```
Info

You can declare a specific version (e.g. '1.0.0') or an interval of versions:
- [begin, end] - Both versions are included
- (begin, end) - Both versions are not included
- [begin, ) - From a base version to the latest one
And the other possible combinations.
Create a backup of your environment.
Run the following command to update the core:
Terminal
```
./gradlew expandCore
```

Compile your environment:

Terminal

./gradlew update.database compile.complete smartbuild

Verify any compilation errors that may arise due to incompatible customization or modifications.

Success

Your Etendo environment is now updated!