License Setup

This section explains how to set up the initial 30-day evaluation license, and also provides additional related information.

Applying the License

After you download a commercial edition from the Download Center, you will receive an email with a license key for the evaluation period. To start the evaluation period, open the license file located in $GS_HOME/gs-license.txt with any text editor, and copy the license key from the email to a blank line in the file. For example:

# License can also be set via the GS_LICENSE environment variable or com.gs.licensekey system property
Product=XAPClosed GigaSpaces eXtreme Application Platform.
Provides a powerful solution for data processing, launching, and running digital services;Version=17.0.0;Type=ENTERPRISE;Customer=yourname@yourcompany.com;Expiration=2022-Dec-31;Hash=PNXrPIPANOOddPNQFdQQ

If you're using Docker images for evaluation, add the -e GS_LICENSE=... option to the Docker run command, using the license key in the email.

The same evaluation license is used for all downloaders, enabling you to evaluate the full GigaSpaces Enterprise edition, which contains all of the available features for all commercial editions.

After you have applied the license, you can access all of the available features for the duration of the 30-day evaluation period without any limitations. When the evaluation license expires, the next time you restart the data grid you will only have access to the open-source functionality. Contact GigaSpaces support to purchase a license for the edition that meets your needs. After the new license is applied, the relevant functionality will once again be available.

The license key can be viewed in the application logs. When the system starts, it writes an information summary to the logs and console, including the license key. You can use the logs to verify that you are using the correct license key.

License Validation on Start-Up

The license is validated whenever the service grid is started. If the license is invalid for some reason (for example, if it is expired), the system will report a problem with the license and terminate. If the license expires while the system is up and running, it will continue to run. However, if a system components fails and tries to restart, it will fail because the license is not valid.

License Lookup Order

The system looks for the license key in the following locations, in the following order:

  1. The com.gs.licensekey system property.

  2. The GS_LICENSE environment variable.

  3. A gs-license.txt file in the Classpath.

  4. A gs-license.txt file in the GigaSpaces installation folder (can be explicitly set using com.gs.home system property)

  5. A gs-license.txt file in the current directory.