Front cover WebSphere Application Server Community Edition 2.0 User Guide Installation and migration Configuration and administration Application packaging and deployment Carla Sadtler Mohamed Ahmed Rafael Thomas Goz Coutinho Gianluca Finocchiaro Anish Pathadan Susil Piyanandana ibm.com/redbooks International Technical Support Organization WebSphere Application Server Community Edition 2.0 User Guide April 2008 SG24-7585-00 Note: Before using this information and the product it supports, read the information in “Notices” on page ix. First Edition (April 2008) This edition applies to WebSphere Application Server Community Edition version 2.0.0.0 and later. © Copyright International Business Machines Corporation 2008. 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 Notices . ix Trademarks . .x Preface . xi The team that wrote this book . xi Become a published author . xii Comments welcome. xiii Chapter 1. Overview . 1 1.1 What is WebSphere Application Server Community Edition. 2 1.2 Components of Community Edition. 2 1.3 Community Edition architecture overview . 2 1.4 Why choose Community Edition V2.0. 3 1.5 What is new in V2.0 . 4 1.5.1 Support for Java Enterprise Edition V5. 4 1.5.2 Support for additional Apache open source projects . 5 1.5.3 Support for additional platforms . 5 1.5.4 Other enhancements . 5 1.6 Support and training . 6 1.6.1 Free trial support. 6 1.6.2 Paid support . 6 1.6.3 Training . 6 1.7 Summary of references. 7 Chapter 2. Planning . 9 2.1 System requirements . 10 2.1.1 Recommended platforms . 10 2.1.2 Recommended JVMs . 11 2.1.3 Recommended database managers. 11 2.1.4 Recommended LDAP servers. 12 2.2 Things to consider. 12 2.2.1 Nature of the applications . 12 2.2.2 Migration path to other WebSphere Application Servers . 13 2.2.3 Environment management . 14 2.2.4 Standards and processes . 14 2.3 Summary of references. 15 Chapter 3. Community Edition installation. 17 3.1 Downloading Community Edition V2.0 . 18 3.1.1 Application server only . 18 3.1.2 Application server and IBM SDK. 18 3.1.3 Sample applications . 19 3.1.4 Community Edition WTP Server Adapter for Eclipse . 20 3.1.5 Verifying the integrity of the downloads . 20 3.2 Installing and uninstalling the IBM SDK V1.5 . 20 3.2.1 Attended mode installation on Windows . 21 3.2.2 Unattended mode (silent install) on Windows. 21 3.2.3 Verifying that IBM SDK successfully installed. 22 3.2.4 Uninstalling the IBM SDK . 23 © Copyright IBM Corp. 2008. All rights reserved. iii 3.3 Installing and uninstalling Community Edition V2.0 . 23 3.3.1 Attended mode installation on Windows . 24 3.3.2 Unattended (silent) install . 25 3.3.3 Attended mode uninstall . 25 3.3.4 Unattended mode uninstall . 26 3.4 Troubleshooting installation problems. 27 3.4.1 Installation problems on Linux, AIX, and Solaris platforms. 27 3.4.2 Installation problems on Windows platforms. 27 3.5 Automatically starting a Community Edition server. 28 3.5.1 Starting the server at system reboot time . 28 3.5.2 Running Community Edition Server as a managed service . 28 3.6 Summary of references. 29 Chapter 4. Extending the topology . 31 4.1 Community Edition application server clustering. 32 4.2 Clustering example using Apache HTTP Server. 33 4.2.1 Installing and configuring two instances of Community Edition . 34 4.2.2 Enabling session affinity in application servers. 34 4.2.3 Enabling clustering in the application server. 35 4.2.4 Deploying the sample application . 39 4.2.5 Configuring the Apache HTTP Server. 41 4.3 Configuring multiple server instances . 43 4.3.1 Configuration management. 44 4.3.2 Multiple server instances using a single repository. 44 4.4 Summary of references. 46 Chapter 5. Configuration and administration. 47 5.1 Starting and stopping the application server . 48 5.1.1 Starting an application server . 48 5.1.2 Stopping the application server. 48 5.2 Using the administrative console . 49 5.2.1 Securing the administrative console . 52 5.3 Configuration using the config.xml file . 53 5.4 Configuring the Web container . 53 5.4.1 Changing port numbers ..