Enabling the webApp feature in the Liberty profile

About this task

When you install the WebSphere® Application Server Liberty profile, it does not include session replication. However, if you use the data grid with the Liberty profile, then you can replicate sessions so that if a server goes down, the application users do not lose session data.

When you add the webApp feature to the server definition and configure the session manager, you can use session replication in your data grid applications that run in the Liberty profile.

Procedure

Add the following webApp feature to the Liberty profile server.xml file. The webApp feature includes the client feature; however, it does not include the server feature. You likely want to separate your web applications from the data grids. For example, you have one Liberty profile server for your web applications and a different Liberty profile server for hosting the data grid.
<featureManager>
<feature>eXtremeScale_webapp-1.1</feature>
</featureManager>

Results

Your web applications can now persist its session data in a data grid.

Example

See the following example of a server.xml file, which contains the webApp feature that you use when you connect to the data grid remotely.
<server description="Airport Entry eXtremeScale Getting Started Client Web Server">
<!--
This sample program is provided AS IS and may be used, executed, copied and modified
without royalty payment by customer
(a) for its own instruction and study,
(b) in order to develop applications designed to run with an IBM WebSphere product,
either for customer's own internal use or for redistribution by customer, as part of such an
application, in customer's own products.
Licensed Materials - Property of IBM
5724-X67, 5655-V66 (C) COPYRIGHT International Business Machines Corp. 2012
-->
<!-- Enable features -->
<featureManager>
<feature>eXtremeScale.webapp-1.1</feature>
</featureManager>

<httpEndpoint id="defaultHttpEndpoint"
host="*"
httpPort="${default.http.port}"
httpsPort="${default.https.port}" />

<xsWebApp objectGridName="session" catalogHostPort="remoteHost:2809" securityEnabled="false" />

</server>

What to do next

The webApp feature has meta type properties that you can set on the xsWebApp element of the server.xml file. For more information, see Liberty profile xsWebApp feature properties.