Upgrading from previous versions
This page contains information about changes in this release which can affect upgrading from previous versions. Note that it includes information about changes from the previous version (12.0) - if you’re upgrading from an older version, we recommend you read the respective “Upgrading from previous versions” pages of those versions.
Minimum Java 7
Oracle has stopped supporting Java 6 back in Feb 2013 (Oracle Java SE Support Roadmap). Starting 12.1, Java 6 is no longer supported with XAP as well, and the minimum requirement is Java 7.
(Note that Java 7 is no longer supported by Oracle as well - we strongly recommend upgrading to the latest Java 8 update)
GS-Agent New Syntax
GS-Agent supports a new, user-friendly syntax and semantics, side-by-side with the previous behaviour. In a nutshell:
A) You can use
-- instead of
gsa. prefix. For example,
--gsc=2 will start 2 GSCs, equivalent to
B) GS-Agent defaults to 2 GSCs, 2 global GSMs and 2 global LUSs. This forces you to explicitly disable each of those. For example, if you want to start 2 GSCc without any global LUS or GSM, you’d specify:
gsa.gsc 2 gsa.global.gsm 0 gsa.global.lus 0. However, using the new syntax automatically disables defaults, so you can simply specify
Note that the previous syntax is still fully supported and unchanged - if you’ve written scripts based on it in previous versions, they will behave the same in 12.1. We do recommend upgrading to the new syntax as soon as possible - it will simplify your scripts.
For more information see The Runtime Environment.
Replication Configuration Semantics
We’ve made some changes in replication configuration semantics. Most users upgrading from earlier version will either not notice this change, or will experience more predictable behaviour. However, if you’ve modified the default configuration settings, we recommend you read the relevant section (Weight Policy) before upgrading, and verify how this change affects your system in a test environment. If needed, this change can be disabled to restore the previous semantics.
For more information see Weight Policy
New XAP Manager
XAP 12.1 offers a simplified management experience using the XAP Manager, which unifies GSM and LUS components, as well as an embedded Zookeeper (including more resilient leader election algorithm) and a RESTful management API.
This is not a requirement for upgrading - you can perform a simple upgrade and continue using the service grid as-is. However, we recommend you learn about this and make the necessary changes to leverage it, as future improvements will be built on top of it.
For more information see XAP Manager.
Using the Administration API with XAP.NET
The Administration API code was extracted to a separate JAR file, but the configuration file was not updated accordingly. To use this administration tool, modify the
DefaultApp.config file to include the xap-admin jars.
For example, C:\GigaSpaces\XAP.NET-12.1.1-x64\NET v4.0\Config\DefaultApp.config. Add the following:
Third Party Upgrades
- Jetty support has been enhanced to include version
- Curator integration has been upgraded to
- Lucene integration has been upgraded to
6.4.2(affects geospatial and full text search)
- Spatial4J integration has been upgraded to
In addition, the JVM bundled with XAP.NET hase been upgraded to Java 8 update 121.
Deprecations and Removed APIs
- Elastic Processing Unit is deprecated, and will be removed in future releases.
SpaceConfigurer.destroy()has been removed - use
intmodifiers have been removed - use explicit type modifiers instead (e.g.
- Event subscription with
NotifyComTypehas been removed - there’s no longer any benefit in changing the default notify communication type.