Downloading and Installing
The GigaSpaces GigaSpaces and GigaSpaces applications are 100% pure Java based, and therefore can run on any UNIX or Windows machine that supports Java.
Before installing GigaSpaces or GigaSpaces, do the following:
- Review the Supported Platforms section of the release notes.
- Make sure that Java is installed (Java 8 or 11).
GigaSpaces/GigaSpaces locates Java via the standard
PATH environment variables.
To install GigaSpaces or GigaSpaces, download and unzip the application package to the location of your choice. Unzipping the file creates a
$GS_HOME directory (e.g.
If you are downloading the package to a Linux machine or a Mac, best practice is to unzip the package via the CLI to avoid problems with read/write permissions on the files.
Do not use a path with spaces (such as
C:\Program Files\xap). In some scenarios they may break.
Linux users: Make sure all
sh files in the
/examples folders are in executable mode, so 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.
By default, GigaSpaces and GigaSpaces use multicast network discovery. If your environment does not support multicast, or you experience other network issues, refer to Network Configuration for more information.
Before you begin working with GigaSpaces products, it is recommended to review the Performance Tuning section and apply the required changes in your system. For example, you may need to update the max file descriptors limit before you begin.
It is strongly recommended to read the following sections in addition to the above, which explain how to further fine-tune your environment for better application performance, and how to assess system performance:
- To verify a local installation, a remote installation, and the cluster configuration, refer to the Testing System Environment section.
- See GigaSpaces Basics or Data Grid Basics for a step-by-step introduction to GigaSpaces and GigaSpaces, including sample code.