Document Tree
Document Properties
Last Modified
Added to KB
Public Access
Doc Type
Release Notes
Gradle Tools
Related Product
  • Patch - Intershop archived
Public Release Notes - Gradle Tools - Version 2.3


This Gradle Tools version are included in Intershop 7 version 7.5.2. It can also be used along with all Intershop 7 versions - 7.5.x.

This Gradle Tools version is based on Gradle 2.3.


Verify Your Existing Projects

If you already have an environment for developing CI-based Intershop releases, please check your existing projects' files. If they contain properties like


then mere importing of the new Gradle Tools 2.3 delivery may break your existing builds. Please change those properties to point to a more specific version 2.0.+ or 2.1.+ accordingly.

 Migrate Tools Version

To use Gradle Tools version 2.3 with Intershop 7 version to 7.5.1, perform the following steps to migrate your environment:

  1. Import the delivery containing the Gradle Tools 2.3 into your repository, see the previous version's recipe "Import Intershop Delivery" in Cookbook - Setup CI Infrastructure (valid to version 2.1).
  2. Adapt your repository server configuration according to the recipe "Configure Artifact Repository Server" in Cookbook - Setup CI Infrastructure:
    • If you don't use the public repository, you can skip creation and assignment of the ishRepo proxy repository.
    • In any case you have to create the components repository group.
  3. Regenerate corporate plugin configuration and corporate distribution by following the recipe "Create Sources From Intershop Templates" in Cookbook - Setup CI Infrastructure. Run the tasks createCorporateConfiguration and createCorporateDistribution.
  4. Build the corporate plugin configuration and the corporate distribution by triggering the automated CI processes.
  5. For both, your assembly and component set, perform the following steps:
    • Change the Gradle distribution used by the Gradle Wrapper by modifying the property distributionUrl in gradle/wrapper/
    • In your files, change the following properties if existent: for updated Gradle Tools
  6. In settings.gradle deployment files raise the version of deployment-bootstrap to 'com.intershop:deployment-bootstrap:2.3.+'.

 New and Noteworthy

Updated Gradle Version to 2.3

Intershop Gradle Tools 2.3 are based on Gradle 2.3. The previous version 2.1 was based on Gradle 2.1.

See Gradle's own release notes for changes:

Dependency Management for Third-Party Libraries


Incubating Feature

This feature is incubating and may change in future versions of Gradle Tools. This allows Intershop to incorporate invaluable feedback until the feature is completed, which will be announced in a future release note.

We introduced a new way for cartridges of dealing with dependencies to third-party libraries using Gradle-based dependency management. This approach can be used with all Intershop 7 CI releases, given that you are using Gradle Tools 2.3 or later.

See Cookbook - Gradle Build Tools (Using Third-party Libraries in a Cartridge) for further documentation on how to use this feature.

Running Integration Tests during Assembly Build

Gradle Tools 2.3 introduces the functionality to run integration tests during the assembly build, see Concept - Gradle Assembly Tools for details.

Fixed Issues

It Is Not Possible to Integrate JaCoCo and JUnit Results in SonarQube


It was not possible to integrate JaCoCo in the SonarQube Analysis. It was also not possible to send the JUnit result files to SonarQube during the analysis.


There was no workaround.


JUnit and JaCoCo result files are included in the SonarQube analysis, if this kind of files are available.

Database Dump Is Also Deployed for Host Types webserver and solr


The database dump is deployed for those host types, that include the local directory. This is not useful for the webserver or solr hosts.


Add the following snippet to your assembly deployment logic:

Assembly's deploy.gradle
deployment {
    files {
        databaseDump {
            if (!(deploymentBootstrap?.hostType?.hostType?.name in ['appserver', 'all']))
                exclude { true }


Starting with Gradle Tools 2.3, the dump file will only be deployed for host types appserver and all by default.

When using custom host types, you can explicitly configure deployment of the dump file in the deployment DSL:

database {
    deployDump = true

Service Creation Issues on Windows


When executing the post-install script installServices.bat with administrator privileges, the following errors occur:

Could not create service Enfinity_AppServer1, check C:\eserver1\local\bin\isservice.exe Enfinity_AppServer1 \""C:\eserver1\local\bin\nodemanager.bat -win32service -background\install.log


Could not create service Enfinity_ApacheWebServer1, check C:\eserver1\local\httpd\bin\httpd.exe -k runservice -n Enfinity_ApacheWebServer1 -f C:\eserver1\local\httpd\conf\install.log


Create the services manually with the following commands:

  1. sc create Enfinity_AppServer1 binPath= "C:\eserver1\local\bin\isservice.exe Enfinity_AppServer1 \"C:\eserver1\local\bin\nodemanager.bat -win32service -background\"" displayname= "INTERSHOP Application Server (1)" obj= ".\username" password= "password" start= demand
  2. sc create Enfinity_ApacheWebServer1 binPath= "C:\eserver1\local\httpd\bin\httpd.exe -k runservice -n Enfinity_ApacheWebServer1 -f C:\eserver1\local\httpd\conf\httpd.conf" displayname= "INTERSHOP HTTP Server (1)" obj= ".\username" password= "password" start= auto

Replace the highlighted parts accordingly.


The problems are fixed in Gradle Tools 2.3.

Host Type all Does Not Inherit includeJavadoc Flag


When deploying the host type all with environment development, Javadoc is not deployed.


Set the flag to include Javadoc manually in the deployment DSL:

developer {
    includeJavadoc = true
    javadocDirectory = new File('[...]')


The host type all will inherit the includeJavadoc flag, so that per default Javadoc is deployed when:

  • Any other host type defines includeJavadoc as true, and

  • The environment is set to development.

Known Issues

Dependency Management for Third-Party Libraries

A patch release Gradle Tools 2.3.1 is available, that fixes the following issues:

  • Libraries defined as libs dependency are not part of testRuntime, i.e. the classes are not available while executing unit tests during the cartridge's build process. This may lead to test failures like

    java.lang.NoClassDefFoundError: org/slf4j/LoggerFactory
  • The newly introduced assembly task checkLibsCollisions may fail with ConcurrentModificationException if the defined libraries are not already present in the local Gradle cache.

Class Collision Check for Third-Party Library Dependency Management


The newly introduced assembly task checkLibsCollisions inspects dependency metadata to find the jar files to analyse. This is problematic when excluding certain jar files from the tools cartridge, because this exclusion can only happen during deployment, which does not influence the current collision check.


There are two ways to avoid assembly build failure because of a false positive:

  • Avoid executing this task altogether by either not invoking it explicitly or excluding execution of this task with -x checkLibsCollisions. You should still execute this task periodically to spot conflicts not intended.
  • Tell the task to ignore certain conflicting classes via regex:

    Assembly build.gradle Snippet
    checkLibsCollisions {
        excludes << /^some.*Regex.*/


The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.
The Intershop Knowledge Portal uses only technically necessary cookies. We do not track visitors or have visitors tracked by 3rd parties. Please find further information on privacy in the Intershop Privacy Policy and Legal Notice.
Knowledge Base
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to if you experience login issues,
or if you want to register as customer.