After creating a data grid in XSLD,
configure the eXtreme Scale client with the Liberty elasticCacheClient-1.0
feature.
Before you begin
- Before using
elasticCacheClient
feature to setup
an eXtreme Scale client in Liberty, you need to have a data grid running on an eXtreme server. One
way to do this is to create a data grid in XSLD. As a
general example of steps, see Lesson 3: Creating a data grid.
- Locate the
server.xml
file in xsld_install_root/wlp/usr/servers/cs-default-<hostname>
About this task
Enabling the elasticCacheClient-1.0
feature allows web applications that run on
the web server to use eXtreme Scale client APIs.
Procedure
-
Open the server.xml file and add the
elasticCacheClient-1.0
feature.
Example
<featureManager>
<feature>elasticCacheClient-1.0</feature>
</featureManager>
-
Access the data grid from a Java™ API.
An example of how to connect to a data grid that uses a Java API in a
servlet:
import com.ibm.websphere.objectgrid.ElasticCacheClientConnectionHelper;
import com.ibm.websphere.objectgrid.ObjectGrid;
……
ObjectGrid aObjGrid = null;
aObjGrid = ElasticCacheClientConnectionHelper.connect("gridname");
Note: Add
the <wlp>\dev\ibm-api\com.ibm.ws.xs.client_1.1.jar
file to compile these APIs
in a development environment.
-
Connect to a different host.
By default, the elasticCacheClient-1.0
feature provides a default
configuration to connect to localhost: 2809.
An example on how configuration can be added to the
server.xml to
connect to a different
host.
<elasticCacheClient >
<elasticCacheCatalogCluster>
<server host="remotehost" port="20031" />
</elasticCacheCatalogCluster>
</elasticCacheClient>