Grails 3 Upgrading from 3.2.x to 3.3.0

Upgrading and/or migration is one of the most frequent jobs nowadays in IT world. As big step upgrading of grails from 3.2.x to 3.3.0 can be a tricky task. Updates and upgrades are going out on monthly or even on weekly basis. If you want to upgrade your Grails(open source web application framework) project there are several steps to follow:

In this post:

Why to upgrade Grails Project
The steps of upgrading 3.2.x to 3.3.0
- changes in build.gradle
- new dependencies
- new spring security pluggin
- change hibernate version
- update - build.properties
Grails configuration - Windows
- Set grails environmental variables
- Check grails configuration
Grails configuration - Linux or MacOS
Groovy/Grails proxy configuration

Why to upgrade Grails Project

The biggest incentive for me to upgrade to 3.3.0 was the size of the generated war file. I was able to reduce the size with 30 - 50 % (depending on the app). Many dependencies are change or removed.

For new generated empty applications:
3.2.x ~ 80 MB war file
3.3.0 ~ 40 MB war file

The steps of upgrading 3.2.x to 3.3.0

read the changes logs
3 Upgrading from Grails 3.2.x
upgrade Grails version(check section - Grails configuration)
generate empty app with 3.3.0 with profile web:
I use it as reference what's new - files, configuration, dependencies,

grails create-app bookstore --profile web --features hibernate,asset-pipeline

change files:

build.gradle - dependencies align with the new version. In my case changes were:

replaced my old section with the newly generated section in the new app

     classpath "org.grails:grails-gradle-plugin:$grailsVersion"
      classpath "com.bertramlabs.plugins:asset-pipeline-gradle:2.14.2"
     classpath "org.grails.plugins:hibernate5:${gormVersion-".RELEASE"}"
 }

new dependencies

    compile "org.grails:grails-web-boot"
    compile "org.grails:grails-logging"
    compile "org.grails:grails-plugin-rest"
    compile "org.grails:grails-plugin-databinding"
    compile "org.grails:grails-plugin-i18n"
    compile "org.grails:grails-plugin-services"
    compile "org.grails:grails-plugin-url-mappings"
    compile "org.grails:grails-plugin-interceptors"
    compile "org.grails.plugins:cache"
    compile "org.grails.plugins:events"

change spring security pluggin:
compile 'org.grails.plugins:spring-security-core:3.0.3'
new one is - compile 'org.grails.plugins:spring-security-core:3.2.0.M1'
change hibernate version:
compile "org.hibernate:hibernate-core:5.1.1.Final"
new one is - compile "org.hibernate:hibernate-core:5.1.5.Final"
remove:
compile "org.hibernate:hibernate-ehcache:5.1.1.Final"
build.properties - change gradle and grails properties

grailsVersion=3.3.0
gormVersion=6.1.6.RELEASE
gradleWrapperVersion=3.5

gradle-wrapper.properties - in folder ..\IdeaProjects\fanta\gradle\wrapper\ - change gradle version
this change was needed due to an error at boot time of the app
maybe is not needed.
Find all imports:
grails.transaction.Transactional
and replace them by: grails.gorm.transactions.Transactional
enum types stored value change - my enumeration were stored as numbers. After the upgrade store values were changed to strings. In order to change back this behavior you need to go to your enum declaration (your domain file where you use this domain and add this line of code:

    static mapping = {
        field1 enumType : "ordinal"
        field2 enumType : "ordinal"
        field3 enumType : "ordinal"
    }

gradle clean or import the gradle change via IDE

Grails configuration - Windows

download the .zip files - Grails Download
extract it the libraries path(depending on your needs): C:\Users\user\Libraries\gradle-3.5-all\gradle-3.5\bin
update environmental variables with the new one (see section set environmental variables)
change proxy settings(if needed) - (see section proxies)

Grails, Gradle and Groovy proxies

Grails proxy configuration

in bin folder(of grails installation or unarchived folder)
copy file: grails.bat -> grailsNoProxy.bat
change file: grails.bat - add this line:

set GRAILS_OPTS=-Dhttp.proxyHost=your.proxy.com -Dhttp.proxyPort=8080 -Dhttps.proxyHost=your.proxy.com -Dhttps.proxyPort=8080

Gradle proxy

for gradle proxy go to:
C:\Users\user.gradle
create file
gradle.properties
and put:
systemProp.https.proxyHost=your.proxy.com
systemProp.https.proxyPort=8080
systemProp.http.proxyHost=your.proxy.com
systemProp.http.proxyPort=8080

Groovy proxy configuration

in bin folder(of groovy installation or where the zip was folder extracted)
copy file: groovy.bat -> groovyNoProxy.bat
change file: groovy.bat - add this line:

set GRAILS_OPTS=-Dhttp.proxyHost=your.proxy.com -Dhttp.proxyPort=8080 -Dhttps.proxyHost=your.proxy.com -Dhttps.proxyPort=8080

Set grails environmental variables

Set grails variables for windows

Notice that you need to change the versions with your versions of the libraries. There 4 required variables: GRADLE_HOME, GRAILS_HOME, GROOVY_HOME and JAVA_HOME.

    GRADLE_HOME=C:\user\Software\Libraries\Grails\gradle-2.13
    GRAILS_HOME=C:\user\Software\Libraries\Grails\grails-3.1.7\grails-3.1.7
    GROOVY_HOME=C:\user\Software\Libraries\apache-groovy-sdk-2.4.6\groovy-2.4.6
    JAVA_HOME=C:\Program Files\Java8\jdk1.8.0_91

Set Path variable

   setx path "%PATH%;%JAVA_HOME%\bin;%GRAILS_HOME%\bin;%GROOVY_HOME%\bin;%GRADLE_HOME%\bin;

Check grails configuration

Open terminal or command shell
Type

  grails -v
  gradle -v
  gradle -v
  java -v

If any of this return command not found this means that your configuration is wrong.
sample output of grails -v

| Grails Version: 3.3.0
| Groovy Version: 2.4.11
| JVM Version: 1.8.0_111

Grails configuration - Linux or MacOS

The main page of the SDK is SDK man Installation .
Just lunch those commands in terminal.
In case that you use Intellij IDE and since it uses system grails installations it's not needed any other actions.

Gradle

$ sdk install gradle

Grails

$ sdk install grails

Groovy

$ sdk install groovy