Enabling WebSphere eXtreme Scale for managed Liberty servers

You can enable WebSphere® eXtreme Scale support for managed Liberty servers in IBM® Modernized Runtime Extension for Java™ (MoRE).

When the eXtreme Scale client is installed into Liberty, MoRE automatically adds the elasticCacheClient-1.0 feature to the feature manifest for all managed servers on that node. Applications that use WebSphere eXtreme Scale can access eXtreme Scale programmatically through the provided APIs. However, applying additional configuration for eXtreme Scale by using Liberty server configuration elements that are made available by the eXtreme Scale feature is not supported at this time.

Before you begin

Ensure that the following prerequisites are met before enabling eXtreme Scale support:

A WebSphere eXtreme Scale client version 8.6.2.0 or higher that supports Java 17 and Jakarta EE 10 must be installed into each Liberty installation on each node in your cell where you want to enable this capability.
WebSphere eXtreme Scale 8.6.2.1 or later supports Java 21.
Install the eXtreme Scale client by using IBM Installation Manager or other supported methods.

Important: When switching between Liberty installations on a MoRE node, ensure the WebSphere eXtreme Scale client is installed in the target Liberty installation.

About this task

After you install the eXtreme Scale client, the managed Liberty servers on the node are automatically updated to include the elasticCacheClient-1.0 feature, enabling eXtreme Scale capabilities for your applications.

Procedure

Install the WebSphere eXtreme Scale client into each of your Liberty installations by using IBM Installation Manager. Ensure that the installationDirectory parameter points to the Liberty installation directory.


cd <IIM_HOME>/tools
./imcl install com.ibm.websphere.WXSCLIENT.was8.v86_8.6.2000.20250924_0006 
-repositories <absolute_file_path_to_the_repository_file> 
-installationDirectory <path_to_Liberty_installation> 
-sharedResourcesDirectory <path_to_shared_resources_directory> 
-acceptLicense 
-prompt


cd <IIM_HOME>\tools
imcl.exe install com.ibm.websphere.WXSCLIENT.was8.v86_8.6.2000.20250924_0006
-repositories <absolute_file_path_to_the_repository_file> 
-installationDirectory <path_to_Liberty_installation> 
-sharedResourcesDirectory <path_to_shared_resources_directory> 
-acceptLicense 
-prompt

Deploy your application to the managed Liberty server.
For more details, see Deploying applications to managed Liberty targets.
Verify connectivity and functionality.
Identify operations in your application that interact with the eXtreme Scale data grid, and perform create, read, update, and delete (CRUD) operations. For more information, see IBM WebSphere eXtreme Scale product page.