This page describes an older version of the product. The latest stable version is 16.4.

XAP Java Installation


GigaSpaces XAP Java edition is 100% pure Java based, and therefore can run on any UNIX or Windows machine that supports Java.

Prior to Installation

Prior to the XAP installation, make sure:

  • Review the release notes for the supported platforms.
  • JDK (6 or later) is installed (latest JDK 7 is recommended)
  • Set the JAVA_HOME environment variable to the JDK (not JRE) directory (for example, D:\java\jdk1.7.0_70).
  • Set the PATH environment variable to include JAVA_HOME\bin (for example, %JAVA_HOME%\bin;%SystemRoot%\system32;%SystemRoot%
  • Optional: The network and machines running GigaSpaces are configured to enable multicast (see the Multicast Configuration for more information).
  • Set the NIC_ADDR environment variable to the machine’s IP address on each machine running XAP.
Note

Use a JDK and not JRE - Have a JDK (Java Development Kit) installed and not a JRE (Java Runtime Environment) on each machine running XAP.

Installing on Windows

gshome-directory Unzip the ZIP file using your favorite unzip tool (e.g., WinZip) to the location of your choice (c:\ or d:\ recommended - C:\Program Files is NOT recommended as it include a space as part of the folder name). Unzipping the file creates a <XAP Root> directory (e.g. gigaspaces-xap-premium-10.0.1-ga) with the following files and folders:

win_dirtree_XAP95.jpg

What’s Next?

Installing on Linux

Step 1. Navigate into the directory where you want to install GigaSpaces XAP, e.g. \opt directory, and execute an unzip command using the path to the XAP zip file. For example:

build-filename
unzip gigaspaces-xap-premium-10.0.1-ga-b11800.zip

Step 2. Make sure all sh file(s) in the /bin and the /examples directory are in executable mode, meaning you can run them from your machine. To check this, use the ls \-all command for the relevant directory, and make sure that x is included in the file permissions.

Step 3. Make sure all the machines running XAP can ping each other and their hosts file include the machine IP.

What’s Next?

Important Tips

Before you begin working with GigaSpaces, it is recommended to review the Performance Tuning and Considerations sections and apply the required changes. For example, you may need to update the max file descriptors limit before you begin.

See also:

The recommendation is to review at least the following sections: