Dashboard > GridGain User Guide > Table Of Contents > Installation Instructions
Installation Instructions
Added by architect, last edited by architect on May 23, 2008  (view change)
Labels: 
(None)


Versions

GridGain releases follow this versioning schema:

Version Name Features Compatibility
x.x.X Point Release No significant new features. Bug fixes only. Fully backward-compatible.
x.X.x Minor Release Significant improvements. Cumulative bug fixes. May introduce certain incompatible changes to API.
X.x.x Major Release Significant new features. Likely to introduce incompatible changes to API and design.

Download

GridGain can be downloaded by clicking on this http://www.gridgain.com/downloads.html.

GridGain is available in one of the following formats:

*.exe Windows GUI Installer
*.sh Unix/Linux GUI Installer
*.dmg Mac OS Installer
  *.zip Windows ZIP Archive
  *.tar.gz Unix TAR Archive
Windows Vista

Depending on configuration of your Windows Vista you may need to run installer "As Administrator".

When you run GridGain first time on Windows Vista depending on your security configuration you may be asked to allow the network connectivity required by GridGain. You will need to allow the network activity requested. Since before you allow it that communication is not allowed GridGain will fail first time but will resume working normally after communication is allowed next time.

Java 5 or Java 6 Required

All releases of GridGain can be used with Java 5 and Java 6 runtimes.

JRocket VM ver. 1.5.8

BEA JRockit ver. 1.5.8 has shown problems with NIO functionality in our test. Although it may not be JRockit's problem we recommend not using this version and use alternative VM or other versions.

Download Java

Java 5
If you would like to download Java 5 click on this link http://java.sun.com/javase/downloads/index_jdk5.jsp

Java 6
To download latest release of Java click on this link http://java.sun.com/javase/downloads/index.jsp.
NOTE: only limited testing has been performed for Java6 platform.

Installation

Developer Friendly

All GridGain installers are developer friendly and produce no changes to the underlying system additionally to the copied software files. GridGain installers (GUI or archives):

  • Do not create environment variables (except for Windows for release 1.6.1 and later)
  • Do not modify Windows registry or startup scripts
  • Do not modify file permissions
  • Do not create users or user groups
GRIDGAIN_HOME and JAVA_HOME
  • Remember to manually set GRIDGAIN_HOME variable after any installation pointing to the folder where GridGain was installed.
    • Make sure there is no trailing '\' or '/' in the GRIDGAIN_HOME path.
  • Make sure that you need to have JAVA_HOME pointing to Java 5 or Java 6 installation.

Once installation is complete the installation folder will have the following structure:

|-- apache
|-- bin
|-- config
|   |-- ...
|-- examples
|   |-- ...
|-- javadoc
|-- libs
|-- src
|-- work
    |-- ...

Windows GUI

This is preferable installer as it properly converts new-lines between UNIX and Windows and performs other formatting actions.

Windows GUI installer comes in a form gridgain-windows-x.x.x.exe. To run the installer just run EXE file and follow installation instructions:

Console mode
If the installer is invoked with the -c argument, the interaction with the user is performed in the terminal from which the installer was invoked. The same applies to the uninstaller.

Unattended mode
If the installer is invoked with the -q argument, there is no interaction with the user, the installation is performed automatically with the default values. The same applies to the uninstaller.

Prior to release 1.6.1 once installation is complete you need to add GRIDGAIN_HOME variable to your environment. On Windows XP and Vista go to System Properties -> Advanced -> Environment Variables and add new variable GRIDGAIN_HOME pointing to the installation root.

Make sure there is no trailing '\' in the GRIDGAIN_HOME path.

To uninstall run uninstall.exe in GRIDGAIN_HOME folder.

Windows ZIP Archive

This installers comes in a form gridgain-windows-x.x.x.zip. To run it simply run it with any ZIP utility. Note that this installation method does not perform any new-line translations so the resulting source code for XML and Java may have wrong new-line formatting.

Once installation is complete you need to add GRIDGAIN_HOME variable to your environment. On Windows XP and Vista go to System Properties -> Advanced -> Environment Variables and add new variable GRIDGAIN_HOME pointing to the installation root.

Make sure there is no trailing '\' in the GRIDGAIN_HOME path.

To uninstall simply remove the installation folder.

Unix/Linux GUI

This is preferable installer as it properly converts new-lines between UNIX and Windows and sets proper execution flags for Shell scripts.

Unix GUI installer comes in a form gridgain-unix-x.x.x.sh. To run the installer type the following and follow installation instructions:

$ sh gridgain-unix-x.x.x.sh

Console mode
If the installer is invoked with the -c argument, the interaction with the user is performed in the terminal from which the installer was invoked. The same applies to the uninstaller.

Install4J ver. 4.0.6

As of version 4.0.6, Install4J installer has bug that prevents shell installer to work in console mode. Ticket# 1000428 has been filed with ej-technolgoies.

Unattended mode
If the installer is invoked with the -q argument, there is no interaction with the user, the installation is performed automatically with the default values. The same applies to the uninstaller.

After installation is complete set GRIDGAIN_HOME environment variable to point to a new installation. Usually, you would add the following line to ~/.bashrc or ~/.bash_profile file (assuming you are using bash as your shell):

export GRIDGAIN_HOME=/opt/gridgain

and run it again:

. ~/.bashrc

Make sure there is no trailing '/' in the GRIDGAIN_HOME path.

To uninstall type the following in GRIDGAIN_HOME folder:

sh uninstall.sh

Unix TAR Archive

This installer comes in form of gridgain-unix-x.x.tar.gz. Note that this installation method does not perform any new-line translations so the resulting source code for XML and Java sources may have wrong new-line formatting. To install, type the following:

$ tar xfz gridgain-unix-x.x.x.tar.gz

This will create gridgain folder with installation in your current folder.

After installation is complete set GRIDGAIN_HOME environment variable to point to a new installation. Usually, you would add the following line to ~/.bashrc or ~/.bash_profile file (assuming you are suing bash as your shell):

export GRIDGAIN_HOME=/opt/gridgain

and run it again:

. ~/.bashrc

Make sure there is no trailing '/' in the GRIDGAIN_HOME path.

Note that since this type of installer is just an archive extractor it will not set proper execution flags on Shell scripts. To do so manually execute the following:

$ chmod +x $GRIDGAIN_HOME/bin/*.sh

Note, you may need to use sudo or su command if you don't have sufficient privileges to change files in installation folder.

To uninstall simply remove the installation folder.

Compiz vs. Metacity

Under certain version of Compiz window manager the installer GUI may not work properly. In such case, you will need to switch to default window manager:

$metacity --replace

Mac OS X GUI

This is preferable installer as it properly converts new-lines between Mac OS X and Windows and sets proper execution flags for Shell scripts.

Mac OS X GUI installer comes in a form gridgain-macos-x.x.x.dmg. To run the installer double click on installer icon or type the following and follow installation instructions:

$ sh gridgain-macos-x.x.x.dmg

Console mode
If the installer is invoked with the -c argument, the interaction with the user is performed in the terminal from which the installer was invoked. The same applies to the uninstaller.

Unattended mode
If the installer is invoked with the -q argument, there is no interaction with the user, the installation is performed automatically with the default values. The same applies to the uninstaller.

After installation is complete set GRIDGAIN_HOME environment variable to point to a new installation. Usually, you would add the following line to ~/.bashrc or ~/.bash_profile file (assuming you are using bash as your shell):

export GRIDGAIN_HOME=/opt/gridgain

and run it again:

. ~/.bashrc

Make sure there is no trailing '/' in the GRIDGAIN_HOME path.

To uninstall type the following in GRIDGAIN_HOME folder:

sh uninstall.sh

Powered by Atlassian Confluence, the Enterprise Wiki. (Version: 2.2.10 Build:#528 Nov 29, 2006) - Bug/feature request - Contact Administrators