Front cover IBM WebSphere Application Server V8.5 Administration and Configuration Guide for Liberty Profile Anil Esen Toshiyuki Iue Neil Patterson Jennifer Ricciuti Redbooks International Technical Support Organization IBM WebSphere Application Server V8.5 Administration and Configuration Guide for Liberty Profile October 2015 SG24-8170-01 Note: Before using this information and the product it supports, read the information in “Notices” on page ix. Second Edition (October 2015) This edition applies to WebSphere Application Server V8.5.5.7 Liberty profile. © Copyright International Business Machines Corporation 2013, 2015. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents IBM Redbooks promotions . vii Notices . ix Trademarks . .x Preface . xi Authors. xi Now you can become a published author, too! . xiii Comments welcome. xiii Stay connected to IBM Redbooks . xiv Chapter 1. Overview of IBM WebSphere Application Server Liberty for administrators . 1 1.1 Introduction to WAS Liberty . 2 1.1.1 Java EE 7 and Liberty. 3 1.2 Product editions . 4 1.2.1 Liberty licensing . 7 1.2.2 The Liberty Repository . 7 1.3 Runtime architecture . 8 1.4 Feature configuration . 10 1.5 Directory structure. 13 1.6 Configuration files . 18 1.7 System management . 20 1.7.1 Topologies . 21 1.8 Security . 22 1.9 Multi-server environments. 24 1.9.1 Using multiple non-clustered Liberty servers . 25 1.9.2 Using Liberty collectives and clustered servers . 26 1.10 Serviceability and troubleshooting . 28 1.11 Application development and deployment tools . 30 Chapter 2. Liberty for the cloud . 31 2.1 Liberty in the cloud . 32 2.1.1 Why Liberty is an ideal runtime for the cloud . 32 2.1.2 Liberty licensing . 32 2.2 Administration of Liberty on cloud platforms . 33 2.2.1 Software as a service . 34 2.2.2 Containers. 34 2.2.3 Platform as a service . 35 2.2.4 Infrastructure as a service. 36 Chapter 3. Installing and updating Liberty . 37 3.1 Configuring the Java Runtime. 38 3.2 Installation using downloaded files and archives . 39 3.2.1 Installation by extracting a Java archive file . 39 3.2.2 Installation by extracting a ZIP archive file . 40 3.3 Installation by IBM Installation Manager using the GUI . 41 3.3.1 Install Liberty and IBM WebSphere SDK Java Technology Edition for Liberty. 41 3.3.2 Install features and addons without connecting to the Internet. 43 © Copyright IBM Corp. 2013, 2015. All rights reserved. iii 3.4 Installation on z/OS . 44 3.4.1 Install WebSphere Application Server Liberty for z/OS. 44 3.4.2 Install Liberty Repository features and addons. 45 3.4.3 Install IBM WebSphere SDK Java Technology Edition for Liberty . 46 3.5 Considerations for upgrading Liberty V8.5.0 to V8.5.5 . 46 3.6 Installing content from Liberty Repository . 47 3.6.1 Installing assets by using the installUtility command . 48 3.6.2 The IBM WebSphere Liberty Repository. 48 3.6.3 The Liberty Asset Repository Service. 48 3.6.4 Local directory-based repositories . 50 3.7 Updating Liberty . 51 3.7.1 In-place update . 52 3.7.2 Side-by-side update . 52 Chapter 4. Working with Liberty profile servers. 55 4.1 Working with the bootstrap.properties file . 56 4.2 Working with the server.xml file . 56 4.2.1 Adding new configuration options . 56 4.2.2 Using include syntax . 57 4.2.3 Using variables in configuration files. 59 4.2.4 Encrypting passwords. 60 4.3 . Using WebSphere developer tools to work with the configuration61 4.4 Liberty command-line utilities . 62 4.4.1 Packaging a Liberty server . 62 4.4.2 Installing config snippets with the configUtility . 63 4.4.3 Application client commands. 65 4.5 Use the configuration dropins folder to specify server configuration. 66 4.6 Configuring dynamic application updates . 66 4.7 Starting and stopping the server using the command line . 67 4.8 Classloaders and shared libraries. 68 Chapter 5. Administering the WebSphere Liberty profile . 71 5.1 Installing the sample environment. 72 5.1.1 The Liberty environment . 72 5.1.2 Installing Jython . ..