Monday, 25 May 2020

Infinispan 11.0.0.CR1

Dear Infinispan community,

we’ve just released 11.0.0.CR1 which comes loaded with quite a few features and improvements.

Cross-Site Replication Improvements

The cross-site replication feature received two major improvements:

  • Support for multiple site masters

    The new algorithm is able to take advantage of multiple site masters, distributing load between them. If your environment is capable, increase the number of site masters in RELAY2 configuration:

    <relay.RELAY2 site="LON" max_site_masters="1000"/>
  • Conflict detection and resolution for Asynchronous Cross-Site Replication

    Taking advantage of vector clocks, in asynchronous mode, Infinispan is able to detect conflicts. A conflict happens when 2 or more sites update the same key at the same time. Conflicts are resolved based on the site’s names. Updates from the site lexicographically lower, take priority, in case of conflicts. As an example, if you have 3 sites, LON, NYC and SFO, conflicts between LON and NYC discards updates from NYC and keeps the updates from LON. You can choose the priority by prepending a number to the site name. For example, if you want updates from NYC to take priority, you can set the site name to “1-NYC”.

In a future update, Infinispan will allow you to set a custom conflict resolution algorithm.

Non-blocking internals

  • All thread pools collapsed into two pools: blocking and non-blocking


  • A new non-blocking Store SPI


  • More accurate segment rebalancing

  • Scaling without state-transfer (experimental)


  • SearchManager, CacheQuery are deprecated. Users are encouraged to migrate to Ickle String queries obtained from Search.getQueryFactory

Server Security

  • The server is now secure by default

  • New encrypted properties realm

  • Simplified authentication and authorization configuration to be as automatic as possible

Other Server changes

  • Datasources

  • Runtime logging configuration

  • Server report


  • User Tool merged into CLI

  • CLI can be compiled natively

  • Non-interactive usage


  • Lots of UX improvements

Kubernetes/OpenShift operator

  • Cache CR

  • Service .Expose with Ingress and Route

Container images

  • Images based upon ubi-minimal:8.2

  • Native generation of config files in all images

  • Native server image available at infinispan/server-native (Experimental)


  • Added procedural content for rolling upgrades, Cache CR with the Operator, server patching, misc CLI commands, using RemoteCacheConfigurationBuilder.

  • Procedural content for different upgrade and migration tasks included in Upgrade Guide.

  • Operator and Spring Boot Starter guides now provide stable and development versions from the index page.

  • Updated index.html and throughout documentation to improve high-level context and aid retrievability.

  • Getting Started content updated and streamlined.

  • Applied several modifications, additions, and removals to documentation via community feedback.

Get it, Use it, Ask us!

Please download, report bugs, chat with us, ask questions on StackOverflow.

Posted by Tristan Tarrant on 2020-05-25
Tags: release

Tuesday, 03 March 2020

Infinispan 11.0.0.Alpha2 and 10.1.3.Final

Dear Infinispan community,

we’ve just tagged a couple of releases.

First off is the second Alpha release of what will eventually become Infinispan 11. The release notes may not be exciting, but it is mostly preparatory work for the big features we are working on: vastly improved async cross-site replication, monitoring, query improvements, the console and the CLI, and more.

We also released a micro-update to 10.1 which fixes quite a few bugs, especially in the way we handle JMX and MP metrics and further improves the documentation.

New release naming scheme

Starting with the next development release of Infinispan 11, we will be adopting a new naming scheme. We will no longer be using the Alpha and Beta monikers, but we will use a progressive Dev suffix to indicate that it’s a development release. The next release will therefore be called 11.0.0.Dev03.

Get it, Use it, Ask us!

Please download, report bugs, chat with us, ask questions on StackOverflow.

Posted by Tristan Tarrant on 2020-03-03
Tags: release

Tuesday, 03 March 2020

Infinispan Documentation Strategy

Hi there, Infinispan community.

I’m sure by now you’ve noticed a few changes in the docs so I’d like to take the opportunity to explain what’s been going on.

Let’s go.

Set the Controls

The mission is to provide quality documentation for the Infinispan community. But how do you define what that means? What is quality documentation?

Documentation exists to help you solve problems. And the effectiveness of documentation in helping you do so is generally a good yardstick for measuring quality.

Over time I’ve defined what I believe to be the primary criteria for effective technical documentation:

  • Technically accurate and complete.

  • Concise.

  • Task-oriented.

Defining the Strategy

Perhaps the most challenging aspect for working on the Infinispan documentation set is getting into that sweet spot that exists between the bleeding edge and the gardening.

The bleeding edge is where the action happens. Ideally docs should stay up to date with the code base and go through the same iterations, making improvements with each development cycle.

Gardening is how I like to think of the maintenance work that docs require. Much like an actual garden, documentation requires continual upkeep and management to avoid turning into an overgrown, unnavigable jungle of information.

As a team we’ve been implementing a documentation strategy to overcome these challenges and achieve our mission of delivering quality tech docs. This strategy centers around two things:

Focusing on the tasks

As I mentioned previously, documentation exists to help you solve problems. Nobody ever sits down and reads the docs like you would a novel. Usually you dip in when you hit a snag or are trying to work out how to do something.

Procedural content should provide a set of end-to-end steps that help you succeed with your goals.

Documentation that enumerates all available parameters and explains each possible value is great but if it doesn’t tell you how to combine parameters in the right way or when to set them, then it’s just giving users a long rope to go hang themselves with.

So hopefully one of the biggest things you’ll notice in the Infinispan documentation is that we’re adding more procedures. We want to give you the recommended fast path that gets you up and running as quickly as possible.

Taking a topic-based approach

Topics are logical units of information that can stand alone and map to various information types, of which the three most common are Task, Concept, and Reference.

One of the benefits of a topic-based writing is that it helps simplify things. A big obstacle for any kind of writing is just getting a handle on what you need to explain. Technical writers get writer’s block too.

Topic-based writing helps to eliminate that obstacle and take the struggle out of developing content. Start with the task and break things down according to classification and figuring what you need to write becomes much easier.

At the same time topic-based writing reduces maintenance overhead. A huge win for topics is that they allow reuse. Write something once and use it in different contexts as needed.

Quick Tour of the Repository Layout

Now that I’ve explained some of the motivation, I’d like to briefly delve into how we’ve organized the docs.

Documentation source lives in documentation/src/main/asciidoc and has three main subdirectories:

  • /topics

    Topics are all the different pieces of information that make up the documentation. Asciidoc files in this directory are prefixed with proc_* for procedural content, con_* for concepts, and ref_* for reference material.

    Apart from the prefixes, topic filenames should be readable and match headings as they appear in the rendered version.

  • /stories

    These are asciidoc files prefixed with assembly_* that organize topics into complete, end-to-end sets of content that target specific use cases .

  • /titles

    These are the main asciidoc files that pull together all the user stories into the titles in the Infinispan community documentation.

Finding the Balance

We really believe in all the changes we’ve been making to the docs. It’s been exciting to see just how much transformation the doc set has undergone in just over a year (PR 6674).

However, given that Infinispan is a community project, we also recognize that these changes have the potential to discourage contributions. Most documentation updates that come from community contributors are small edits or minor updates, usually one or two lines of text. Moving to a topic-based structure adds complexity and creates extra work to make those small changes because you have to sift through many more asciidoc files.

Planning for the new docs strategy was done with core contributors with the goal to preserve and encourage community participation. There have been doc PRs that introduced structural changes that others didn’t agreed with. Getting rejected and going back to the drawing board can feel like a setback but ultimately it’s about finding the solution where everyone’s a winner.

There is a balance to be had and, like so many things, you find it through conversation.

So, on that note, I’ll leave it with a request to join us and keep the conversation going.

Posted by Don Naro on 2020-03-03
Tags: documentation

Monday, 24 February 2020

Infinispan Operator 1.1.1 is out!

We’re pleased to announce version 1.1.1 of the Infinispan Operator for Kubernetes and OpenShift.

This release has focused on fixing bugs and improving robustness, mainly related to the following:

  • improving reconcile flow stability

  • reducing Operator CPU load

  • cleaning up logs

Our community documentation on has also been updated and improved. You can find some of the changes at:

Automatic Upgrades

If you installed the Infinispan Operator on Red Hat OpenShift with the Automatic Approval upgrade policy, your cluster should already be running the latest versions (Infinispan Operator 1.1.1 with Infinispan 10.1.2.Final).

We would like to hear opinions from you about the automated upgrade process, so get in touch if you have any issues or want to give any feedback.

Get it, Use it, Ask us!

Try the simple tutorial for the Operator, which has been updated for this version.

You can report bugs, chat with us, ask questions on StackOverflow.

Finally, a detailed list of issues and features for this version can be found here.

Posted by Vittorio Rigamonti on 2020-02-24
Tags: release operator

Thursday, 20 February 2020

Infinispan Server configuration

The new Infinispan Server introduced in version 10.0 is quite different from the WildFly-based one we had up to 9.x. One of the big differences is that the new server’s configuration is just an extension of the embedded configuration.

The XML snippet below shows the configuration used by the server "out-of-the-box":


   <cache-container name="default" statistics="true"> (1)
      <transport cluster="${}" stack="${infinispan.cluster.stack:tcp}" node-name="${}"/>

   <server xmlns="urn:infinispan:server:10.1"> (2)
         <interface name="public"> (3)
            <inet-address value="${infinispan.bind.address:}"/>

      <socket-bindings default-interface="public" port-offset="${infinispan.socket.binding.port-offset:0}"> (4)
         <socket-binding name="default" port="${infinispan.bind.port:11222}"/>
         <socket-binding name="memcached" port="11221"/>

      <security> (5)
            <security-realm name="default">
               <!-- Uncomment to enable TLS on the realm -->
               <!-- server-identities>
                     <keystore path="application.keystore" relative-to="infinispan.server.config.path"
                               keystore-password="password" alias="server" key-password="password"
               <properties-realm groups-attribute="Roles">
                  <user-properties path="" relative-to="infinispan.server.config.path" plain-text="true"/>
                  <group-properties path="" relative-to="infinispan.server.config.path" />

      <endpoints socket-binding="default" security-realm="default"> (6)
         <hotrod-connector name="hotrod"/>
         <rest-connector name="rest"/>

Let’s have a look at the various elements, describing their purposes:

1 The cache-container element is a standard Infinispan cache manager configuration like you’d use in embedded deployments. You can decide to leave it empty and create any caches at runtime using the CLI, Console or Hot Rod and RESTful APIs, or statically predefine your caches here.
2 The server element holds the server-specific configuration which includes network, security and protocols.
3 The interface element declares named interfaces which are associated with specific addresses/interfaces. The default public interface will use the loopback address unless overridden with the -b switch or the infinispan.bind.address system property. Refer to server interfaces documentation for a detailed list of all possible ways of selecting an address.
4 The socket-bindings element associates addresses and ports with unique names you can use later on configuring the protocol endpoints. For convenience, a port offset can be added to all port numbers to ease starting multiple servers on the same host. Use the -o switch or the infinispan.socket.binding.port-offset system property to change the offset.
5 The security element configures the server’s realms and identities. We will ignore this for now as this deserves its own dedicated blog post in the near future.
6 The endpoints element configures the various protocol servers. Unless overridden, all sub protocols are aggregated into a single-port endpoint which, as its name suggests, listens on a single port and automatically detects the incoming protocol, delegating to the appropriate handler.

The rest-connector has a special role in the new server, since it now also handles administrative tasks. It is therefore required if you want to use the CLI or the Console. You may wish to have the protocols listen on different ports, as outlined in the configuration below:


   <cache-container name="default" statistics="true">
      <transport cluster="${}" stack="${infinispan.cluster.stack:tcp}" node-name="${}"/>

   <server xmlns="urn:infinispan:server:10.1">
         <interface name="public">
            <match-interface value="eth0"/>
         <interface name="admin">

      <socket-bindings default-interface="public" port-offset="${infinispan.socket.binding.port-offset:0}">
         <socket-binding name="public" port="${infinispan.bind.port:11222}"/>
         <socket-binding name="admin" interface="admin" port="${infinispan.bind.port:11222}"/>

            <security-realm name="default">
               <properties-realm groups-attribute="Roles">
                  <user-properties path="" relative-to="infinispan.server.config.path" plain-text="true"/>
                  <group-properties path="" relative-to="infinispan.server.config.path" />

      <endpoints socket-binding="admin" security-realm="default">
         <hotrod-connector name="hotrod" socket-binding="public"/>
         <rest-connector name="rest"/>

This creates two socket bindings, one named public bound to the eth0 interface and one named admin bound to the loopback interface. The server will therefore listen for Hot Rod traffic only on the public network and for HTTP/REST traffic on the admin network.

For more details on how to configure Infinispan Server, refer to our documentation.

In the next blog post we will have an in-depth look at security.

Posted by Tristan Tarrant on 2020-02-20
Tags: server



JUGs alpha as7 asymmetric clusters asynchronous beta c++ cdi chat clustering community conference configuration console data grids data-as-a-service database devoxx distributed executors docker event functional grouping and aggregation hotrod infinispan java 8 jboss cache jcache jclouds jcp jdg jpa judcon kubernetes listeners meetup minor release off-heap openshift performance presentations product protostream radargun radegast recruit release release 8.2 9.0 final release candidate remote query replication queue rest query security spring streams transactions vert.x workshop 8.1.0 API DSL Hibernate-Search Ickle Infinispan Query JP-QL JSON JUGs JavaOne LGPL License NoSQL Open Source Protobuf SCM administration affinity algorithms alpha amazon annotations announcement archetype archetypes as5 as7 asl2 asynchronous atomic maps atomic objects availability aws beer benchmark benchmarks berkeleydb beta beta release blogger book breizh camp buddy replication bugfix c# c++ c3p0 cache benchmark framework cache store cache stores cachestore cassandra cdi cep certification cli cloud storage clustered cache configuration clustered counters clustered locks codemotion codename colocation command line interface community comparison compose concurrency conference conferences configuration console counter cpp-client cpu creative cross site replication csharp custom commands daas data container data entry data grids data structures data-as-a-service deadlock detection demo deployment dev-preview devnation devoxx distributed executors distributed queries distribution docker documentation domain mode dotnet-client dzone refcard ec2 ehcache embedded query equivalence event eviction example externalizers failover faq final fine grained flags flink full-text functional future garbage collection geecon getAll gigaspaces git github gke google graalvm greach conf gsoc hackergarten hadoop hbase health hibernate hibernate ogm hibernate search hot rod hotrod hql http/2 ide index indexing india infinispan infinispan 8 infoq internationalization interoperability interview introduction iteration javascript jboss as 5 jboss asylum jboss cache jbossworld jbug jcache jclouds jcp jdbc jdg jgroups jopr jpa js-client jsr 107 jsr 347 jta judcon kafka kubernetes lambda language leveldb license listeners loader local mode lock striping locking logging lucene mac management map reduce marshalling maven memcached memory migration minikube minishift minor release modules mongodb monitoring multi-tenancy nashorn native near caching netty node.js nodejs nosqlunit off-heap openshift operator oracle osgi overhead paas paid support partition handling partitioning performance persistence podcast presentations protostream public speaking push api putAll python quarkus query quick start radargun radegast react reactive red hat redis rehashing releaase release release candidate remote remote events remote query replication rest rest query roadmap rocksdb ruby s3 scattered cache scripting second level cache provider security segmented server shell site snowcamp spark split brain spring spring boot spring-session stable standards state transfer statistics storage store store by reference store by value streams substratevm synchronization syntax highlighting testing tomcat transactions uneven load user groups user guide vagrant versioning vert.x video videos virtual nodes vote voxxed voxxed days milano wallpaper websocket websockets wildfly workshop xsd xsite yarn zulip

back to top