GridGain Developers Hub
GitHub logo GridGain iso GridGain.com
GridGain Software Documentation

Licensing

How to Get or Update Your GridGain License

You will need a new license file when installing (or updating to) GridGain Enterprise Edition (EE) or Ultimate Edition (UE).

To get a new license file, contact your GridGain representative, who will send you a license file.

Because the name of the file must not change, you basically replace one gridgain-license.xml file with another and the new license will be detected automatically (can take up to 1 minute).

The basic process is to copy the license file to each distribution folder used to start GridGain nodes.

Centralized License File

Optionally, you can use the org.gridgain.grid.configuration.GridGainConfiguration.setLicenseUrl property and put the file in a shared space available to all of the hosts of GridGain nodes. This means that updating the license will require replacing only a single file.

Switching Between GridGain Editions

The easiest way to transition between GridGain editions is to:

  1. Get a new license from GridGain.

  2. Download new binaries from the GridGain site and unzip them into a new directory.

  3. Put your license file into the root folder of your new installation.

If you switch between GridGain editions, you must update your dependencies to match. See GridGain Editions and Java Dependencies.

To use GridGain Community Edition libraries as dependencies in your projects, see Ignite Dependencies in GridGain Projects.

Community Edition Dependencies in GridGain Projects

To reference GridGain CE dependencies within your GridGain EE or UE project, add the GridGain repository to your .pom file:

<repositories>
    <repository>
        <id>GridGain External Repository</id>
        <url>http://www.gridgainsystems.com/nexus/content/repositories/external</url>
    </repository>
</repositories>

GridGain Editions and Java Dependencies

When switching between GridGain editions (CE/EE/UE), you will need to make some changes in your .pom file.

General Dependencies

Applies to:

  • Moving from GridGain Professional version to Community Edition.

  • Upgrading GridGain Enterprise or Ultimate Edition from GridGain version 8.7.2 and lower to version 8.7.3 and higher.

Beginning with version 8.7.3, and as a substitute for the Professional version, GridGain released the Community Edition.

The difference in dependencies between Community Edition and Professional is the version number and groupId. So if you want to make transition from Professional (~2.7.2) to the Community Edition (8.7.2+) change gridgain.version to the version of GridGain you’re using (8.7.5, for example) and groupId to org.gridgain as below:

<dependency>
    <groupId>org.gridgain</groupId>
    <artifactId>ignite-core</artifactId>
    <version>${gridgain.version}</version>
</dependency>

Enterprise Edition Dependencies

When moving from Community Edition to Enterprise Edition, you need to add one additional dependency: gridgain-core

<dependency>
    <groupId>org.gridgain</groupId>
    <artifactId>gridgain-core</artifactId>
    <version>${gridgain.version}</version>
</dependency>

Where gridgain.version is 8.x.x.

Ultimate Edition Dependencies

Moving to GridGain Ultimate Edition requires one more dependency in addition to the dependencies in the Enterprise Edition: gridgain-ultimate:

<dependency>
    <groupId>org.gridgain</groupId>
    <artifactId>gridgain-ultimate</artifactId>
    <version>${gridgain.version}</version>
</dependency>

Where gridgain.version is 8.x.x.