Chapter 4. An overview of the Liberty profile 95
For more information, see the WebSphere Application Server V8.5 Information Center at:
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-ba
se-dist&topic=cwlp_feat_mgmt
4.2 Installing the Liberty profile
You can use any of the following methods to install the Liberty profile:
Extracting an archive file that contains the distribution image to a local folder
Using Installation Manager
Installing the Liberty profile developer tools
For more information about installing the Liberty profile, see 9.8, “Planning for the Liberty
profile” on page 268.
4.3 Configuring the Liberty profile
The Liberty profile configuration operates from a set of built-in configuration defaults. You can
specify only the required changes for your environment by using a simple XML format. This
section provides details about how to configure the Liberty profile.
4.3.1 Liberty profile configuration characteristics
The Liberty profile configuration has the following characteristics:
The persistent configuration has these characteristics:
Described in XML files
Small, easy to back up, and easy to copy to another system
Human readable and editable in a text editor
Shareable with the entire application development team
Composed such that features can add configurations to the system easily
The runtime configuration has these characteristics:
Injected into the owning components on an update
Dynamically composable so that configuration for features can be added to or removed
from the system easily
Supports zero cost migration between releases
Configuration used by components is dynamically responsive to updates and forgiving.
Missing values are assumed and unrecognized properties are ignored.
4.3.2 Simplified configuration
A Liberty profile server configuration consists of a bootstrap.properties file, a server.xml
file and any (optional) files that are included by these files. The bootstrap.properties file
specifies properties that need to be available before the main configuration is processed.
These properties are kept to a minimum. The server.xml file is the primary configuration file
for the server, and the file that users work with the most.
96 WebSphere Application Server V8.5 Concepts, Planning, and Design Guide
The server.xml file (and any files included with it) has a simple XML format that is suitable for
text editors. The only required entry is to indicate that the file contains a server definition, as
shown in Example 4-1.
Example 4-1 Server definition entry in the server.xml file
<server/>
You need to specify only overrides and additions to the default configuration values.
Example 4-2 shows values that change the transaction timeout value.
Example 4-2 Transaction configuration entry in the server.xml file
<transaction timeout=”30”/>
Example 4-3 shows an example of using a list of values. This example lists the features that
are provided by the server.
Example 4-3 List of features in the server.xml file
<featureManager>
<feature>jsp-2.2</feature>
<feature>derby-10.8</feature>
</featureManager>
When a resource, such as an application, is configured, provide only the attributes that are
unique for the resource. The other attributes can remain with their default values, as
illustrated in Example 4-4.
Example 4-4 An application entry in the server.xml file
<application location="tradelite.war" />
Example 4-5 shows an example of a complete server configuration to run a web application.
Example 4-5 A complete server configuration defined in the server.xml file
<server>
<featureManager>
<feature>jsp-2.2</feature>
<feature>derby-10.8</feature>
</featureManager>
<transaction timeout=”30”/>
<logging traceSpecification=”webcontainer=all=enabled:*=info=enabled” />
<application type="war" id="tradelite" name="tradelite"
location="tradelite.war"/>
<jdbcDriver id="DerbyEmbedded" libraryRef="DerbyLib"/>
<library id="DerbyLib">
<fileset dir="${shared.resource.dir}/derby" includes="derby.jar"/>
</library>
< datasource id="DefaultDatasource" jdbcDriverRef="DerbyEmbedded"
jndiName="DefaultDatasource">
<properties createDatabase="create"
databaseName="${shared.resource.dir}/data/product"/>
</datasource>
</server>

Get WebSphere Application Server V8.5 Concepts, Planning, and Design Guide now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.