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 includeJAVA_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.
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:
What’s Next?
- To verify a local installation, a remote installation, and the cluster configuration, refer to the Testing System Environment section.
- See the Quick Start Guide for your first steps with XAP.
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?
- To verify a local installation, a remote installation, and the cluster configuration, refer to the Testing System Environment section.
- See the Quick Start Guide for your first steps with XAP.
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.
The recommendation is to review at least the following sections: