Upgrade notes - 6.12

Warning

This documentation describes upgrading from 6.11.x to 6.12.

Note

Enonic XP 6.12 now requires minimum Java 1.8.92

Upgrade Steps

1. Backup the installation

Backup you current installation. This is described in Backup and Restore.

You could also do a dump of the system, but then you will loose versions if you have to reload it.

2. Install new version

Download Enonic XP http://repo.enonic.com/public/com/enonic/xp/distro/6.12.0/distro-6.12.0.zip and install according to your setup.

Tip

Remember to update any startup scripts you might have to launch your new installation given a server restart

3. Configure XP_HOME

The next step depends on your setup. Do you have your $XP_HOME folder outside or inside the $XP_INSTALL folder?

Outside the $XP_INSTALL - folder:

Make sure the new installation points to the correct $XP_HOME folder.

Inside the $XP_INSTALL - folder:

Copy your $OLD_XP_INSTALL/home folder to the the new $NEW_XP_INSTALL/ (on all nodes).

4. Stop the old installation

5. Start the new installation

6. Configure apps to build with 6.12

In 6.12 we have made several strucutural changes to Enonic XP. This affects how you build your own apps with Gradle.

The Gradle plugin for building Enonic applications are not included in the distribution anymore. This helps us improve the build tools without waiting for a new release of XP every time. Here is how to make build scripts work for 6.12.x:

Before you would probably have something like this in the beginning of your build.gradle file:

buildscript {
    plugins {
        repositories {
            mavenLocal()
            jcenter()
            maven {
                url 'http://repo.enonic.com/public'
            }
        }

        dependencies {
            classpath "com.enonic.xp:gradle-plugin:${xpVersion}"
        }
    }
}

apply plugin: 'com.enonic.xp.app'
...

Now you can write the same block as:

plugins {
    id 'com.enonic.xp.app' version '1.0.13'
}

All the rest will be the same. You can look at https://github.com/enonic/starter-vanilla for an example of how to use plugin.