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

Installation on z/OS

The easiest way to install GridGain on z/OS is to follow the manual installation procedure.

Prerequisites

  • Java 8+, tested with IBM J9 VM.

Installation

  1. Download the GridGain binary as a zip archive.

  2. Unzip the zip archive into the installation folder in your system.

  3. (Optional) Enable any of the modules you might want to use.

  4. After unpacking the distribution package, make sure that all text files (e.g. xml, .sh, text, properties) are properly tagged as text and have a UTF-8 or ISO 8859-1 encoding. Use the chtag utility to do that.

    The following command adds a txtflag to all files in the {GRIDGAIN_HOME}/bin directory.

    chtag -t -R -c ISO8859-1 gridgain-community-8.7.17/bin/

    Run this command on the configuration file and the license file.

  5. Now you can launch a node.

    To verify that installation is successful, go to the distribution directory and run the following command:

    gridgain-community-8.7.17/bin/ignite.sh -v config/default-config.xml

    If the node starts successfully, you will see the following message in the console:

    node startup

Running

  • Set the MEMLIMIT parameter. The parameter defines the limit on memory for a single process. Set it to a value that is larger than the RAM memory required for your GridGain nodes, including Heap and Off-Heap data regions.

  • We recommend to always specify -Dfile.encoding=UTF-8 JVM argument. You do not need to specify it if you start GridGain by running ignite.sh. However, if you start nodes from custom code, add it to the startup parameters of your application.

  • If you are going to use the Native Persistence feature, set the IGNITE_WAL_MMAP system property (or environment variable) to false, for example, by adding -DIGNITE_WAL_MMAP=false JVM argument.

  • Configure static discovery instead of the default multicast option. Specify the TcpDiscoverySpi.localAddress property and the IgniteConfiguration.localHost property with the preferred IP address for the current host.

  • If you are going to use log4j for logging, add the following parameter to every appender in the log4j configuration:

    <param name="Encoding" value="IBM-1047"/>
  • If the sqlline utility is used, it should be invoked as TERM=dumb bin/sqlline.sh to avoid incorrect terminal detection.

Performance recommendations

  • For nodes with a persistent storage, increase the dataStorage.checkpointThreads value. The default value is 4, but we recommend you set it to a value between 16 and 32 on z/OS nodes for best checkpointing speed.

  • If your load profile includes intensive network usage, consider the following TcpCommunicationSpi parameters: socketWriteTimeout=5000 (ms), usePairedConnections=true, pick the connectionsPerNode value from between 2 and 8.

  • Nodes may benefit from a larger striped pool size, increase it by setting IgniteConfiguration.stripedPoolSize to 32.