Generating precompiled JavaServer Pages for a WebSphere® Application Server Liberty profile

If you are importing applications from a WebSphere® Application Server Liberty profile (WebSphere® Application Server Version 8.5 and higher), manual JSP precompilation is required (the Liberty profile does not include a stand-alone JSP compiler). This topic describes the steps required for setting up manual JSP precompilation.

Procedure

Follow the instructions for creating a Liberty profile server at the WebSphere® Application Server Network Deployment Knowledge Center. For WebSphere® Application Server Version 8.5.5, see the Creating a Liberty profile server by using developer tools topic.

In the Liberty profile server.xml file, add this to the server description section:

    <jspEngine prepareJSPs="0"/>
    <webContainer deferServletLoad="false"/>

For example:

<server description="new server">

    <!-- Enable features -->
    <featureManager>
        <feature>jsp-2.2</feature>
        <feature>localConnector-1.0</feature>
    	  <feature>appSecurity-2.0</feature>
		      <feature>restConnector-1.0</feature>
    </featureManager>

    <!-- To access this server from a remote client 
         add a host attribute to the following element, 
         e.g. host="*" -->
    <httpEndpoint httpPort="9080" httpsPort="9443" id="defaultHttpEndpoint"/>

...
    <jspEngine prepareJSPs="0"/>
    <webContainer deferServletLoad="false"/>
...
</server>

The server.xml file is described at the the WebSphere® Application Server Center. For WebSphere® Application Server Version 8.5.5, see the Liberty profile: Configuration elements in the server.xml file topic.

Start the server in debug mode, using one of these methods:
- Add a -Dwas.debug.mode=true JVM argument, as described in Setting generic JVM arguments in the WebSphere® Application Server V8.5 Liberty profile.
- Follow the instructions for starting and stopping a server at the the WebSphere® Application Server Network Deployment Knowledge Center. For WebSphere® Application Server Version 8.5.5, see the Starting and stopping a server by using developer tools topic.

Results

After completing these steps, import your Java™ applications from the WebSphere® Application Server Liberty profile by following the steps in Importing existing Java applications from Apache Tomcat and WebSphere Application Server Liberty profile application servers.