GridGain Developers Hub

Licensing

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.

Specifying License

There are several ways you can specify a license file:

  • If you launch GridGain nodes by executing ignite.sh, you can replace the default license file in the GridGain installation directory with your license file. Simply overwrite $GRIDGAIN_HOME/gridgain-license.xml with the license file you received from GridGain.

  • Specify the GridGainConfiguration.licenseUrl property in the node configuration file:

    <bean class="org.apache.ignite.configuration.IgniteConfiguration">
        <property name="pluginConfigurations">
            <list>
                <bean class="org.gridgain.grid.configuration.GridGainConfiguration">
                    <property name="licenseUrl" value="/my/directory/gridgain-license.xml"/>
                </bean>
            </list>
        </property>
    </bean>
    GridGainConfiguration ggCfg = new GridGainConfiguration();
    
    ggCfg.setLicenseUrl("/my/directory/gridgain-license.xml");
    
    IgniteConfiguration cfg = new IgniteConfiguration();
    
    cfg.setPluginConfigurations(ggCfg);
    
    Ignite ignite = Ignition.start(cfg);
    This API is not presently available for C++. You can use XML configuration.

    The license URL can be:

    • An absolute path on the file system;

    • A relative path, which is interpreted relative to the directory from where you launch the node.

    • A URL to a HTTP resource.

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 the next section.

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.31, 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.