For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

Understanding Configuration

Different ways of configuring a GridGain cluster, including Spring XML configuration and programmatic configuration.

This chapter explains different ways of configuring a GridGain cluster.

Overview

When you start a GridGain node, you need to provide configuration parameters to the node. Basically, all configuration parameters are defined in an instance of the IgniteConfiguration class. You can set the parameters either programmatically or via an XML configuration file. These 2 ways are fully interchangeable.

The XML configuration file is a Spring Bean definition file that must contain the IgniteConfiguration bean. When starting a node from the command line, pass the configuration file as a parameter to the ignite.sh|bat script, as follows:

ignite.sh ignite-config.xml

If you don't specify a configuration file, the default file {GRIDGAIN_HOME}/config/default-config.xml is used.

Spring XML Configuration

To create a configuration in a Spring XML format, you need to define the IgniteConfiguration bean and set the parameters that you want to be different from the default. For detailed information on how to use XML Schema-based configuration, see the official Spring documentation.

In the example below, we create an IgniteConfiguration bean, set the workDirectory property, and configure a partitioned cache.

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd">

    <bean class="org.apache.ignite.configuration.IgniteConfiguration">
        <property name="workDirectory" value="/path/to/work/directory"/>

        <property name="cacheConfiguration">
            <bean class="org.apache.ignite.configuration.CacheConfiguration">
                <!-- Set the cache name. -->
                <property name="name" value="myCache"/>
                <!-- Set the cache mode. -->
                <property name="cacheMode" value="PARTITIONED"/>
                <!-- Other cache parameters. -->
            </bean>
        </property>
    </bean>
</beans>

Programmatic Configuration

Create an instance of the IgniteConfiguration class and set the required parameters, as shown in the example below.

See the IgniteConfiguration javadoc for the complete list of parameters.

See the API docs for details.

This page is: Copyright © 2026 MariaDB. All rights reserved.

Last updated

Was this helpful?